Dify を自分の VPS でセルフホスト:LLM ワークフロー、RAG ナレッジベースとプライベートゲートウェイ連携

PostgreSQL、Redis/Valkey、コードサンドボックスを含む Dify を Zenavo 上の自分の Linux サーバーにデプロイし、.zenavo.internal 経由で LiteLLM・New API・SearXNG と連携する方法を解説します。

この記事は English、简体中文、繁體中文、Español、Bahasa Indonesia でもお読みいただけます。

社内の RAG アシスタントや複数ステップの LLM ワークフローを構築する場合、プロンプト管理、ドキュメント分割、ベクトル検索、ツール呼び出し、実行ログをまとめて扱う基盤が必要になります。Dify はこれらをビジュアルなワークフローエディタと API として提供します。自分の VPS 上でセルフホストすれば、アップロードした資料や埋め込みベクトル、ログをすべて自分のサーバー内に留められ、クラウド版のワークスペース上限も気にする必要がありません。

本ガイドでは、Zenavo 上での Dify のサービス構成、.zenavo.internal を使ったモデルゲートウェイや検索エンジンとの連携、および起動時の確認ポイントを解説します。サーバー料金と Zenavo の利用料金は別々に請求されます。

1. サーバー要件とアーキテクチャ

Dify は単一コンテナではなく複数のサービスで構成されます。ドキュメントのインデックス作成やワークフローの同時実行を安定させるため、Linux サーバーを接続する際は 4 GB 以上のメモリ(同一ホストでベクトル DB も動かす場合は 8 GB 以上)を推奨します。

1 つの Zenavo プロジェクト内にすべてのサービスを配置すれば、プロジェクトプライベートネットワーク経由で相互通信でき、DB やサンドボックスをインターネットに公開する必要はありません。

コンポーネント 役割 永続化・設定のポイント
postgresql メインの RDB(pgvector を有効にすればベクトルストアも兼用) /var/lib/postgresql/data に永続ボリュームを割り当て、Backup & Restore で定期バックアップを設定
redis / valkey Celery 非同期キュー、キャッシュ、レート制限状態 再起動後もキューを保持したい場合はボリュームをマウント
dify-api & dify-worker langgenius/dify-api(MODE=api と MODE=worker) 同一の SECRET_KEY、DB URL、Redis URL、および /app/api/storage ボリュームを共有
dify-web langgenius/dify-web Next.js コンソール CONSOLE_API_URL と APP_API_URL に HTTPS ドメインを指定
dify-sandbox langgenius/dify-sandbox コードノード用隔離環境 .zenavo.internal 経由で dify-api / dify-worker からのみアクセス可能
nginx(リバースプロキシ) /console/api・/api・/v1・/files を dify-api:5001、/ を dify-web:3000 へ転送 ポート 80 で公開ドメインを紐づける唯一のエントリーポイント

Zenavo テンプレートギャラリーで AI スタックを確認するか、同一プロジェクト内に各サービスを構成してください。

2. 重要な環境変数

初回デプロイ時のログイン失敗や CORS エラーの多くは、以下の設定不一致が原因です。

  1. SECRET_KEY:強力なランダム文字列を 1 つ生成し、dify-api と dify-worker の両方にまったく同じ値を設定します。DB 内のモデルプロバイダーキーの暗号化に使われます。
  2. 公開 URL 設定:リバースプロキシのドメインと HTTPS で独自ドメイン(例:dify.example.com)を紐づけたら、CONSOLE_API_URL、CONSOLE_WEB_URL、SERVICE_API_URL、APP_API_URL、APP_WEB_URL をすべて https://dify.example.com に統一します。
  3. プライベート DB / Redis:DB_HOST に postgresql.zenavo.internal、REDIS_HOST に redis.zenavo.internal(または valkey.zenavo.internal)を指定します。公開ポートは不要です。
  4. ベクトルストア:VECTOR_STORE=pgvector を使えば、リレーショナルデータとベクトルデータを 1 つの PostgreSQL にまとめられるため、バックアップと復元によるスナップショット管理が簡単になります。

SECRET_KEY を必ずバックアップ:セルフホストした Vaultwarden などのパスワードマネージャーに SECRET_KEY を保存してください。後から変更すると保存済みのモデル認証情報が復号できなくなります。

3. モデルゲートウェイとプライベート検索の連携

同じ Zenavo プロジェクト内にモデルゲートウェイや検索エンジンを配置しておけば、.zenavo.internal 経由で安全かつ低遅延に連携できます。

  • モデルゲートウェイ(LiteLLM / New API / Magpie):Dify の Settings → Model Provider → OpenAI-API-compatible でエンドポイントに http://litellm.zenavo.internal:4000/v1(または New API / Magpie の内部アドレス)と仮想キーを設定します。予算上限や利用ログをゲートウェイ側で一元管理できます。
  • プライベート検索(SearXNG):SearXNG で JSON 出力を有効にし、Dify 組み込みの SearXNG ツールに http://searxng.zenavo.internal:8080 を指定すれば、API クォータを気にせず最新 Web 検索を組み込めます。
  • 汎用ワークフロー連携(n8n):プロンプト管理や RAG 検索は Dify に任せ、Webhook 経由で n8n に渡して Slack 通知や定期バッチ処理を実行させる構成も有効です。

4. 初期セットアップとワーカー確認

  1. すべてのサービスが Running になったら https://dify.example.com/install を開き、管理者アカウントを作成します。
  2. テストアプリを作成し、Knowledge に小さな Markdown や PDF をアップロードして Indexing から正常に完了するか確認します。
  3. 処理が Indexing のまま進まない場合は、コンソール右端の Zenavo Agent に dify-worker と redis のログを確認させるか、Claude Code と zenavo-mcp を使ってターミナルからデバッグできます。

よくある質問

ドメイン設定後に画面が真っ白になる、またはログイン後に 401 / CORS エラーが出る場合は? dify-web と dify-api の CONSOLE_API_URL・APP_API_URL が https:// 付き・末尾スラッシュなしのドメインになっているか、またリバースプロキシが /console/api と /api を dify-api のポート 5001 に転送しているか確認してください。

ナレッジベースにファイルをアップロードしても Queuing や Indexing から進みません。 dify-worker が停止している、dify-api と別の Redis を参照している、または別サービス間で /app/api/storage ボリュームが共有されておらずワーカーがファイルを読み込めていない可能性があります。

Dify と n8n はどう使い分けるべきですか? プロンプトのバージョン管理、RAG ナレッジベース、モデル比較、チャット/補完 API の公開が主目的なら Dify、400 以上の SaaS 連携や定期バッチ・Webhook 自動化が中心なら n8n が適しています。同じプロジェクト内で .zenavo.internal 経由で併用することもできます。

Zeabur 上の Dify プロジェクトを Zenavo へ移行できますか? はい。Zeabur からテンプレート YAML をエクスポートして Zenavo にインポートし(Zeabur からの移行)、Backup & Restore から PostgreSQL のバックアップを復元して(Zeabur の PostgreSQL 移行ガイド)、元の SECRET_KEY を引き継いでください。

Linux サーバーを接続するか Zenavo テンプレートギャラリーを開いて、自分のインフラ上で Dify のワークフローとナレッジベースを運用しましょう。