I self-hosted an AI support bot with FastGPT + Docker — 3 gotchas that will break your install

说明与用途

作者在 Linux 上使用 Docker 部署 FastGPT，遇到三大问题：MinIO 镜像拉取失败、CSV FAQ 头部格式错误以及缺少嵌入模型。修复后，机器人正常运行。

问题

Installing FastGPT v4.15 on a fresh Linux box with Docker fails due to missing MinIO image, incorrect CSV FAQ format, and lack of an embedding model.

结果

FastGPT deployed successfully after addressing three critical issues: using a China‑based MinIO mirror, correcting CSV FAQ header, and providing an embedding model.

工作流

• Pull FastGPT Docker images
• Replace MinIO image with registry.cn-hangzhou.aliyuncs.com/fastgpt/minio
• Prepare CSV FAQ with header q,a,indexes
• Configure embedding model (e.g., DeepSeek)
• Start Docker containers
• Verify knowledge‑base creation

证据

The MinIO image no longer pulls from Docker Hub.

来源

CSV FAQ import needs a third column. The header must be q,a,indexes, not q,a, or the import is rejected with a format error.

来源

You need an embedding model, not just a chat model. Without one, you can't even create a knowledge base ("System not embedding model"). DeepSeek alone isn't enough.

来源