FastGPT 的国内搭建方案

先从环境准备说起。Docker和docker-compose是绕不开的两件套，好在安装步骤已经非常成熟，直接跑一条命令就能搞定。

安装Docker时，官方脚本配合阿里云镜像，下载速度会快不少：

curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
systemctl enable --now docker

接着安装docker-compose。GitHub上的Release页面可以找到最新版，这里用的是2.20.3，架构变量uname -s和uname -m会自动适配系统环境：

curl -L https://github.com/docker/compose/releases/download/2.20.3/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

验证安装

执行下面两个命令，确保Docker和docker-compose都已正确安装：

docker -v
docker-compose -v

准备项目目录与配置文件

第一步，创建并进入项目文件夹：

mkdir fastgpt && cd fastgpt

第二步，从GitHub拉取两个关键的配置文件：docker-compose.yml是容器编排的核心，config.json则是FastGPT应用自身的配置：

curl -O https://raw.githubusercontent.com/labring/FastGPT/main/files/deploy/fastgpt/docker-compose.yml
curl -O https://raw.githubusercontent.com/labring/FastGPT/main/projects/app/data/config.json

获取OpenAI API Key

这一步相对直接。登录开发者平台后，购买对应的API-KEY（比如5美元兑换码），支付成功后邮箱会收到兑换码，把它复制下来。接着在平台页面里找到兑换码输入框，填进去，点确认。系统会自动生成一个令牌（token），把这个令牌复制出来，后续配置要用。

编辑docker-compose.yml

修改三个关键参数：

• DEFAULT_ROOT_PSW
  ：设置FastGPT的后台登录密码，默认用户名为root。

• OPENAI_BASE_URL
  ：使用OpenAI官方Key时无需改动；如果是第三方API，则改为对应地址，例如https://chat.chatgptten.com/v1。

• CHAT_API_KEY
  ：填入上一步获取的API Key。

改完之后保存。

启动FastGPT

一切就绪，运行docker-compose启动服务：

docker-compose up

登录并创建第一个知识库

启动成功后，在浏览器访问对应的地址，用root账号和刚才设置的密码登录。

进入系统后是一片空白，先创建知识库：左侧菜单栏点击“知识库”，然后右上角“新建”，给知识库起个名字，其他设置保持默认就行。

创建AI应用并关联知识库

新建一个AI应用，在配置里关联刚才创建好的知识库。这样应用就能基于库内数据来回答问题了。

以上就是从零搭建FastGPT的完整流程。几个注意点：配置文件中API的地址和密钥一定要核对正确；如果启动时遇到端口冲突，可以在docker-compose里调整映射端口；数据卷的挂载路径注意提前创建好。