最終更新日: 2026年06月25日

テンプレート説明

独自ドメインなしでもすぐにHTTPS通信でAFFiNEが利用可能

AFFiNEは、ドキュメント編集・ホワイトボード・データベースを一体化したオープンソースのナレッジベースプラットフォームです。NotionとMiroの機能を単一のワークスペースで提供し、チームでのリアルタイム共同編集とセルフホストによるプライベートなデータ管理を両立します。

本テンプレートは、AFFiNE(Community Edition)をDocker Composeを使用してConoHa VPS上に自動構築します。インストール完了後はサービスが停止状態となるため、以下の利用手順に従って初期セットアップを行ってください。

メモ

AFFiNEのデータは /opt/affine/ 以下に保存されます。PostgreSQLのパスワードは自動生成され、/opt/affine/.env に保存されます。

仕様

対応OSイメージ

Ubuntu 24.04 LTS

主要ソフトウェア

ソフトウェア名 バージョン ライセンス 用途
AFFiNE Latest (stable) MIT(CE版) ナレッジベース・ホワイトボードプラットフォーム
pgvector Latest (pg16) MIT ベクトル検索拡張付きPostgreSQLイメージ
PostgreSQL 16 PostgreSQL License アプリケーションデータベース(pgvectorイメージに内包)
Redis 7 BSD-3-Clause / RSALv2 + SSPLv1 キャッシュ・リアルタイム同期
Nginx Latest BSD-2-Clause リバースプロキシ
Docker / Docker Compose Latest Apache 2.0 コンテナ実行環境

スタートアップスクリプト情報

項目 説明
アプリケーション利用ポート 80/tcp (HTTP)、443/tcp (HTTPS)
インストールディレクトリ /opt/affine/
管理スクリプト /root/affine-*.sh
初期状態 サービス停止中

その他

最小システム要件

  • CPU: 2コア以上(4コア以上推奨)
  • メモリ: 最小2GB、推奨4GB以上
  • ディスク容量: 20GB以上
  • ネットワーク: パブリックIPアドレス

利用手順

メモ

スタートアップスクリプトにてアプリケーションのインストールが完了するまで数分かかります。
インストール完了後、rootディレクトリに「affine-info.txt」というファイルが作成されますのでご確認ください。
ファイルが存在しない場合、作成されるまでしばらくお待ちください。
スタートアップスクリプトの実行状況は、SSH接続後に以下のコマンドで確認できます。

# tail -f /var/log/affine-setup.log

重要

テンプレート作成直後はAFFiNEサービスが停止状態です。以下の手順に従ってサービスを起動し、初期設定を行ってください。

Step 1: VPSへの接続

SSHクライアントを使用してVPSに接続します。

# ssh root@<IPアドレス>

Step 2: セットアップの実行

Dockerイメージのpullと初期セットアップを行います。

# /root/affine-manage.sh setup

Step 3: サービスの起動

AFFiNEとNginxを起動します。

# /root/affine-manage.sh start

起動完了後、ターミナルにアクセスURLが表示されます。

Step 4: 管理者アカウントの作成

AFFiNEには、用途の異なる2つのURLがあります。

URL 用途
https://<ドメインまたはIPアドレス>/ 一般ユーザー向け。サインイン・ワークスペースの利用
https://<ドメインまたはIPアドレス>/admin 管理者向け。ユーザー管理・サーバー設定

ブラウザで https://<ドメインまたはIPアドレス>/admin にアクセスしてください。初回アクセス時に自己署名証明書の警告が表示された場合は、ブラウザの警告画面でアクセスを続行してください。

初回は管理者アカウントの作成ページへ自動的にリダイレクトされます。フォームに従って管理者アカウントを登録してください。以降は /admin から管理者パネルへ、/ から一般ユーザー向けワークスペースへアクセスできます。

重要

管理者アカウントは初回に /admin へアクセスした際に作成できます。VPSを公開する前に、必ず管理者アカウントを作成してください。

Step 5: HTTPS設定(推奨)

Let’s Encryptを使用して信頼された SSL 証明書を取得します。事前にConoHaコントロールパネルのセキュリティグループでポート80および443の外部アクセスを許可し、ドメインのDNSがVPSのIPアドレスに向いていることを確認してください。

# /root/affine-letsencrypt.sh -e <メールアドレス>

Step 6: ドメイン変更(オプション)

カスタムドメインを設定する場合は、以下のスクリプトを使用します。

# /root/affine-change-domain.sh -d <新しいドメイン>

Step 7: システム診断

サービスの稼働状況を確認します。

# /root/affine-diagnose.sh

管理スクリプト一覧

スクリプト名 機能 使用例
affine-manage.sh setup Dockerイメージのpull(初回必須) # /root/affine-manage.sh setup
affine-manage.sh start サービス起動 # /root/affine-manage.sh start
affine-manage.sh stop サービス停止 # /root/affine-manage.sh stop
affine-manage.sh restart サービス再起動 # /root/affine-manage.sh restart
affine-manage.sh status 稼働状況確認 # /root/affine-manage.sh status
affine-manage.sh logs ログ表示(直近100行) # /root/affine-manage.sh logs
affine-diagnose.sh システム診断 # /root/affine-diagnose.sh
affine-letsencrypt.sh Let’s Encrypt証明書取得 # /root/affine-letsencrypt.sh -e <email>
affine-change-domain.sh ドメイン変更 # /root/affine-change-domain.sh -d <domain>

セキュリティグループ設定

ConoHaコントロールパネルのセキュリティグループで以下のポートを開放してください。

ポート番号 プロトコル 用途 必須/オプション
22 TCP SSH 任意
80 TCP HTTP 必須
443 TCP HTTPS 推奨

アプリケーションの具体的な利用方法につきましては、サービス開発元やサービス提供元の公式サイト、Wikiなどで最新情報をご確認ください。

サイト名 URL 説明
AFFiNE公式サイト https://affine.pro/ プロダクト情報・最新ニュース
AFFiNEセルフホストドキュメント https://docs.affine.pro/self-host-affine/ セルフホスト向け技術ドキュメント
AFFiNE GitHubリポジトリ https://github.com/toeverything/AFFiNE ソースコード・イシュートラッカー