動作要件
デプロイ環境の選択
Section titled “デプロイ環境の選択”EchoLore は Docker Compose で動作するため、Docker が稼働する Linux (amd64) ホストであれば任意の環境に導入できます。セキュリティ要件や運用方針に応じて以下から選択してください。
| 環境 | 向いているケース | 特徴 |
|---|---|---|
| オンプレミス (自社サーバー / 自社データセンター) | データ主権・機密性が最優先のケース | データが自社管理の閉域網から出ない。既存の監視・バックアップ基盤をそのまま利用可 |
| VPS (WebArena Indigo など) | 少人数〜中規模チームでの運用 | コスト効率が良く構築が簡単。WebArena Indigo (NTTPCコミュニケーションズ) は動作確認済み環境です。国内データセンターのため低レイテンシ |
| パブリッククラウド (Amazon EC2 など) | スケール・既存クラウド環境との統合が必要なケース | 既存の VPC・IAM・バックアップ (スナップショット) と統合しやすい。Instance Metadata Service への配慮などクラウド固有の設定に対応 |
選択の目安:
- 社外ネットワークへのデータ送出を禁止したい → オンプレミス
- 手軽に始めたい / 運用負荷を下げたい → VPS (WebArena Indigo 動作確認済み)
- AWS 上の他システムと連携したい / 将来的なスケールを見込む → EC2
いずれの環境でも、以降のドキュメント (インストール・アップデート・バックアップ) は共通の手順で利用できます。
Cloudflare プロキシによる保護 (オプション)
Section titled “Cloudflare プロキシによる保護 (オプション)”HTTP/HTTPS の前面に Cloudflare の DNS プロキシ (オレンジクラウド) を置くと、小規模 VPS でも攻撃耐性を大きく引き上げられます。特に「VPS で公開しつつ攻撃面を減らしたい」ケースと相性が良いです。
得られる効果:
| 効果 | 内容 |
|---|---|
| DDoS / WAF | エッジで攻撃を吸收。L3-L7 のフィルタリング |
| Web 面のオリジン IP 隠蔽 | https://ドメイン への攻撃・スキャンが Cloudflare に当たる |
| アクセス制御 | WAF ルールで /admin に IP 制限・国制限を追加可能 |
| Bot 対策 | ログインページへの credential stuffing を軽減 |
EchoLore 固有の注意点:
- TLS モードは Full (strict) 必須 — Flexible では Cloudflare↔オリジン間が平文になります。Traefik の ACME 証明書がそのまま使えます
- WebRTC (UDP) はプロキシ対象外 — LiveKit メディア (50000-50020/udp) と TURN (3478/udp, 5349/tcp) は Cloudflare を経由できません。RTC 用サブドメインは DNS only (グレークラウド) にしてください。オリジン IP はここから特定可能なため「完全な IP 隠蔽」にはなりません
- WebSocket — Yjs 共同編集と LiveKit シグナリングは CF 経由の WebSocket になります。アイドルタイムアウト (約 100 秒) に対し EchoLore 側のキープアライブで対応済みですが、挙動は要確認
- アップロード制限 — Free プランはリクエストボディ 100MB 上限。Wiki 添付で大きなファイルを扱う場合は注意
- ACME 証明書更新 — HTTP-01 チャレンジはプロキシ経由で動作します。TLS-ALPN-01 は使用不可
UDP ポートの防御はオリジン側 (ファイアウォール + LiveKit のみ受け付け) で担保し続けてください。Cloudflare は HTTP 面の補強であり、UDP 面の対策の代わりにはなりません。
サーバー要件
Section titled “サーバー要件”| 項目 | 必要件件 | 推奨 |
|---|---|---|
| OS | Debian 12 / Ubuntu 22.04 以降 (Linux) | — |
| メモリ | 4GB 以上 | 8GB (録画・AI 機能を使用する場合) |
| ストレージ | 20GB 以上 | 使用量に応じて |
| CPU | 2 コア以上 | 4 コア |
ソフトウェア要件
Section titled “ソフトウェア要件”ネットワーク (開放するポート)
Section titled “ネットワーク (開放するポート)”| ポート | 用途 |
|---|---|
| 80/tcp | HTTP (TLS リダイレクト) |
| 443/tcp | HTTPS |
| 3478/udp | TURN (WebRTC) |
| 5349/tcp | TURN over TLS |
| 50000-50020/udp | LiveKit RTC メディア |
ufw の設定例:
sudo ufw allow 80/tcpsudo ufw allow 443/tcpsudo ufw allow 3478/udpsudo ufw allow 5349/tcpsudo ufw allow 50000:50020/udpsudo ufw reloadDNS の A レコードをサーバーの IP アドレスに設定してください。TLS 証明書は Traefik が Let’s Encrypt (ACME) で自動取得します。
オプションの外部サービス
Section titled “オプションの外部サービス”いずれもデプロイ後に管理画面から設定できます。
- Google Cloud プロジェクト — Google SSO / Gemini / Vertex AI / GCS 用
- LLM プロバイダ — Gemini / Vertex AI / Z.ai / OpenAI 互換
- メールプロバイダ — SMTP / Resend (メール認証・招待メール用)
- ストレージプロバイダ — S3 互換 / GCS (ファイルをクラウドに置く場合)