Mac 下使用 Docker 部署 FastGPT 构建 AI 私有知识库

OneAPI 示例配置：

environment:
  - OPENAI_BASE_URL=http://localhost:13000/v1
  - CHAT_API_KEY=sk-xxxxxxxx # OneAPI 后台生成的 Key

2. 其他配置

如有需要，可修改 DEFAULT_ROOT_PSW 设置管理员密码。默认情况下，登录用户名为 root，密码为 1234。

四、启动服务

在 docker-compose.yml 同级目录下执行以下命令：

# 拉取最新镜像
docker-compose pull

# 后台启动服务
docker-compose up -d

启动后，可通过 Docker 管理工具或命令行检查状态：

docker ps

确保所有服务状态均为 Up。

五、初始化 MongoDB 副本集

FastGPT 4.6.8 版本后使用了 MongoDB 事务，要求运行在副本集模式下。副本集无法自动初始化，需手动操作。

1. 进入容器

docker exec -it mongo bash

2. 连接数据库

mongo -u root -p <你的密码> --authenticationDatabase admin

3. 初始化副本集

rs.initiate({
  _id: "rs0",
  members: [
    { _id: 0, host: "mongo:27017" }
  ]
})

4. 检查状态

rs.status()

如果提示 rs0 状态，代表运行成功。

六、Mac M2/M3 芯片常见问题解决

在 Mac M2/M3 芯片上部署时，可能会遇到 MongoDB 启动失败的问题，报错提示 WARNING: MongoDB 5.0+ requires a CPU with AVX support。这是因为部分旧版镜像不支持 ARM64 架构的 AVX 指令集。

解决方案

修改 docker-compose.yml 中的 MongoDB 镜像源，使用官方支持的 ARM64 镜像：

services:
  mongo:
    image: mongo:5.0.18  # 替换为官方 mongo 镜像
    # 原阿里云镜像可能不兼容

保存后重启服务：

docker-compose down
docker-compose up -d

再次检查容器日志，确认 MongoDB 进程正常启动。

七、访问与使用

启动成功后，可通过 http://localhost:3000 访问界面。

• 账号: root
• 密码: 1234 (或在配置中设置的 DEFAULT_ROOT_PSW)

公网访问与安全

若需将服务部署到公网，强烈建议增加一层 Nginx 反向代理，绑定域名并使用 HTTPS 证书。

Nginx 配置示例：

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

八、扩展接入其他模型

除了 OpenAI 系列，FastGPT 支持接入讯飞、360 等其他国内大模型。方法是通过 OneAPI 包装这些模型的 API。

1. 在 OneAPI 中添加对应平台的模型配置。
2. 修改 FastGPT 的 config.json，增加对应平台的 model 参数。
3. 确保 OPENAI_BASE_URL 指向 OneAPI 的地址。

这样即使没有 ChatGPT 权限，也可以利用国内免费或付费的 AI 资源构建私有知识库。

九、总结

本文详细记录了在 Mac 环境下使用 Docker 部署 FastGPT 的全过程，重点解决了 M2 芯片下的 MongoDB 兼容性问题及 OneAPI 集成方案。通过此流程，您可以快速搭建属于自己的 AI 智能知识助手，实现数据的向量化存储与智能问答。