RAGFlow

このガイドは、オープンソースの RAG エンジン RAGFlow を、オブジェクトストレージとして RustFS に接続します。RAGFlow は MinIO 互換のクライアント設定を通じて、アップロードされたすべてのドキュメントと解析成果物を S3 互換ストレージに保存します。その設定を RustFS に向け、スタックを起動し、ナレッジベースにドキュメントをアップロードして、バケット内のオブジェクトを確認します。このワークフローは infiniflow/ragflow:v1.0.0-rc3 と Infinity ドキュメントエンジンで検証しました。

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

アーキテクチャCopy Anchor Link

テナントごとにテナント ID を名前とするバケットが割り当てられ、アップロードされた各ファイルはそのバケット内のオブジェクトになります。解析はソース文書の隣に成果物を書き込みます。

DOC_ENGINE=infinity
MINIO_HOST=<your-rustfs-endpoint>
MINIO_USER=<your-access-key>
MINIO_PASSWORD=<your-secret-key>

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

cd ragflow/docker
docker compose -p ragflow up -d

docker logs ragflow-cpu 2>&1 | grep "minio:"

minio: {'user': '...', 'password': '...', 'host': 'rustfs:9000', 'bucket': '', 'prefix_path': ''}

curl -s -X POST http://localhost:9380/api/v1/datasets \
  -H "Authorization: Bearer <your-api-key>" -H "Content-Type: application/json" \
  -d '{"name":"rustfs-kb"}'

curl -s -X POST "http://localhost:9380/api/v1/datasets/<dataset-id>/documents" \
  -H "Authorization: Bearer <your-api-key>" \
  -F "file=@rustfs-overview.txt"

{"code":0,"data":[{"chunk_method":"naive","location":"rustfs-overview.txt","name":"rustfs-overview.txt","run":"UNSTART"}]}

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

2026-11-01 16:02:41        204 rg-doc.txt

aws s3 cp s3://<tenant-id>/rg-doc.txt - \
  --endpoint-url http://<your-rustfs-endpoint>:9000

docker compose -p ragflow stop

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

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

アップロードは成功するが RustFS に何も現れないCopy Anchor Link

サーバーがまだ内蔵 MinIO と通信しています。起動ログの minio: 行を確認し、ホストが RustFS のエイリアスでなければ、.env の変更がコンテナに届いていません。docker compose -p ragflow up -d --force-recreate ragflow-cpu で再作成してください。

起動ログに tcp connect error: Connection timed outCopy Anchor Link

RustFS コンテナのアドレスが Compose ネットワークから到達可能ではありません。手順 1 のとおり RustFS をエイリアス付きで Compose ネットワークに接続し、MINIO_HOST にはエイリアスを指定してください。

/api/v1 で Authentication error: API key is invalid!Copy Anchor Link

/api/v1 の SDK ルートは RAGFlow の API キー（Web UI で作成）を受け付け、ログインのアクセストークンは受け付けません。/v1/* ルートはログインセッションを使います。

登録やログインでパスワードエラーCopy Anchor Link

RAGFlow は API に到達する前に、同梱の RSA 公開鍵でパスワードを暗号化することを求めます。Web UI はこれを自動で行います。クライアント側の暗号化を再現しない限り、アカウント作成には UI を使用してください。

次のステップCopy Anchor Link

• 大規模な取り込みの前に S3 互換性についての注意 を確認してください。
• アクセスキー管理 で本番用の専用認証情報を作成してください。
• RAGFlow ドキュメント に従い、同じバケットでチャンクテンプレート・embedding モデル・エージェントワークフローを活用してください。