コンテンツにスキップ

動作要件

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 固有の注意点:

  1. TLS モードは Full (strict) 必須 — Flexible では Cloudflare↔オリジン間が平文になります。Traefik の ACME 証明書がそのまま使えます
  2. WebRTC (UDP) はプロキシ対象外 — LiveKit メディア (50000-50020/udp) と TURN (3478/udp, 5349/tcp) は Cloudflare を経由できません。RTC 用サブドメインは DNS only (グレークラウド) にしてください。オリジン IP はここから特定可能なため「完全な IP 隠蔽」にはなりません
  3. WebSocket — Yjs 共同編集と LiveKit シグナリングは CF 経由の WebSocket になります。アイドルタイムアウト (約 100 秒) に対し EchoLore 側のキープアライブで対応済みですが、挙動は要確認
  4. アップロード制限 — Free プランはリクエストボディ 100MB 上限。Wiki 添付で大きなファイルを扱う場合は注意
  5. ACME 証明書更新 — HTTP-01 チャレンジはプロキシ経由で動作します。TLS-ALPN-01 は使用不可

UDP ポートの防御はオリジン側 (ファイアウォール + LiveKit のみ受け付け) で担保し続けてください。Cloudflare は HTTP 面の補強であり、UDP 面の対策の代わりにはなりません。

項目 必要件件 推奨
OS Debian 12 / Ubuntu 22.04 以降 (Linux) —
メモリ 4GB 以上 8GB (録画・AI 機能を使用する場合)
ストレージ 20GB 以上 使用量に応じて
CPU 2 コア以上 4 コア

ネットワーク (開放するポート)

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/tcp
sudo ufw allow 443/tcp
sudo ufw allow 3478/udp
sudo ufw allow 5349/tcp
sudo ufw allow 50000:50020/udp
sudo ufw reload

DNS の A レコードをサーバーの IP アドレスに設定してください。TLS 証明書は Traefik が Let’s Encrypt (ACME) で自動取得します。

いずれもデプロイ後に管理画面から設定できます。

  • Google Cloud プロジェクト — Google SSO / Gemini / Vertex AI / GCS 用
  • LLM プロバイダ — Gemini / Vertex AI / Z.ai / OpenAI 互換
  • メールプロバイダ — SMTP / Resend (メール認証・招待メール用)
  • ストレージプロバイダ — S3 互換 / GCS (ファイルをクラウドに置く場合)