最終更新日: 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 | ソースコード・イシュートラッカー |