RAGFlow

Ce guide connecte RAGFlow — le moteur RAG open source — à RustFS comme stockage objet. RAGFlow place chaque document téléversé et chaque artefact d'analyse dans un stockage compatible S3 via sa configuration client compatible MinIO. Vous allez pointer cette configuration vers RustFS, démarrer la pile, téléverser un document dans une base de connaissances et confirmer l'objet dans le bucket. Le workflow a été vérifié avec infiniflow/ragflow:v1.0.0-rc3 et le moteur de documents Infinity.

Vous avez besoin de Docker Compose. Ce déploiement est destiné aux tests d'intégration locaux, pas à la production.

Schéma d’architectureCopy Anchor Link

Chaque tenant obtient un bucket nommé d'après son identifiant de tenant, et chaque fichier téléversé devient un objet dans ce bucket. L'analyse écrit des artefacts supplémentaires à côté du document source.

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

DépannageCopy Anchor Link

Le téléversement réussit mais rien n'apparaît dans RustFSCopy Anchor Link

Le serveur parle encore au MinIO fourni. Consultez la ligne minio: du journal de démarrage — si l'hôte n'est pas votre alias RustFS, la modification du .env n'a pas atteint le conteneur ; recréez-le avec docker compose -p ragflow up -d --force-recreate ragflow-cpu.

tcp connect error: Connection timed out au démarrageCopy Anchor Link

L'adresse du conteneur RustFS n'est pas routable depuis le réseau Compose. Rattachez RustFS au réseau Compose avec un alias comme à l'étape 1 et utilisez l'alias dans MINIO_HOST.

Authentication error: API key is invalid! sur /api/v1Copy Anchor Link

Les routes SDK /api/v1 acceptent une clé API RAGFlow (créée dans l'interface web), pas le jeton d'accès de connexion. Les routes /v1/* utilisent la session de connexion.

Erreurs de mot de passe à l'inscription ou la connexionCopy Anchor Link

RAGFlow attend le mot de passe chiffré avec sa clé publique RSA fournie avant d'atteindre l'API — l'interface web s'en charge. Utilisez l'interface pour créer les comptes, sauf à reproduire le chiffrement côté client.

Prochaines étapesCopy Anchor Link

• Consultez les notes de compatibilité S3 avant une ingestion à grande échelle.
• Créez des identifiants de production dédiés avec la gestion des clés d'accès.
• Suivez la documentation RAGFlow pour les modèles de chunks, les modèles d'embedding et les workflows d'agents sur le même bucket.