Dify

このガイドは、オープンソースの LLM アプリケーションプラットフォーム Dify を、OpenDAL ストレージバックエンド経由で RustFS に接続します。ファイルストレージをローカルディスクから RustFS バケットに切り替え、スタックを起動し、ナレッジベースにドキュメントをアップロードして、バケット内のオブジェクトを確認します。このワークフローは Dify 1.18.0（Docker Compose）で検証しました。

Docker Compose が必要です。このデプロイはローカルでの統合テスト用であり、本番環境向けではありません。

アーキテクチャCopy Anchor Link

Dify は、アップロードされた文書・ナレッジベースのファイル・ブートストラップシークレット（.dify_secret_key、ワークスペース鍵）を、設定されたストレージバックエンド経由で永続化します。バックエンドがバケットなら、これらはコンテナのディスクには残りません。

STORAGE_TYPE=opendal
OPENDAL_SCHEME=s3
OPENDAL_S3_ENDPOINT=http://<your-rustfs-endpoint>:9000
OPENDAL_S3_BUCKET=dify
OPENDAL_S3_ACCESS_KEY_ID=<your-access-key>
OPENDAL_S3_SECRET_ACCESS_KEY=<your-secret-key>
OPENDAL_S3_REGION=us-east-1
OPENDAL_S3_ENABLE_PATH_STYLE=true
OPENDAL_S3_ROOT=/

aws s3 mb s3://dify --endpoint-url http://<your-rustfs-endpoint>:9000

docker network connect --alias rustfs <compose-network> <rustfs-container>

cd dify/docker
docker compose up -d

aws s3 ls s3://dify/ --recursive \
  --endpoint-url http://<your-rustfs-endpoint>:9000

2026-11-01 14:31:00         65 .dify_secret_key
2026-11-01 14:33:06       1674 privkeys/<tenant-id>/private.pem

aws s3 ls s3://dify/upload_files/ --recursive \
  --endpoint-url http://<your-rustfs-endpoint>:9000

2026-11-01 15:25:53        128 upload_files/<tenant-id>/0ae369a1-70ed-40e8-b3d9-0f12d0b7c699.txt

docker compose down

aws s3 rm s3://dify --recursive \
  --endpoint-url http://<your-rustfs-endpoint>:9000

トラブルシューティングCopy Anchor Link

起動ログがバケットに対して tcp connect error: Connection timed out を表示するCopy Anchor Link

スタックから RustFS のアドレスに到達できていません。Docker ブリッジ間のネットワーク分離です。手順 1 のとおり RustFS をエイリアス付きで Compose ネットワークに接続してください。

ログインが Invalid encrypted data で失敗するCopy Anchor Link

管理者のパスワードフィールドはフロントエンドが Base64 エンコードします。console API に平文を送ると失敗します。アカウント操作には Web UI を使うか、フロントエンドと同じ方法でフィールドをエンコードしてください。

文書作成時に Default model not found for text-embeddingCopy Anchor Link

high-quality インデックスモードには Dify で設定済みの embedding モデルプロバイダーが必要です。ストレージだけの検証なら economy インデックスを使うか、先にモデルプロバイダーを設定してください。

アップロードがローカルディスクに落ち続けるCopy Anchor Link

api と worker コンテナが .env 変更前の古いインスタンスです。docker compose up -d --force-recreate でスタック全体を再作成し、全サービスに新しいストレージ設定を読ませてください。

次のステップCopy Anchor Link

• 大きなナレッジベースを運用する前に S3 互換性についての注意 を確認してください。
• アクセスキー管理 で本番用の専用認証情報を作成してください。
• Dify 環境変数リファレンス に従い、プラグインデーモン固有の S3 設定や同じバケットでのマルチパート調整を活用してください。