2026 搬瓦工 VPS 部署 FastGPT 知识库实战指南

这是 FastGPT 知识库部署实战指南。考虑到使用的是 BandwagonHost VPS，其典型配置（如 CN2 GIA 套餐）内存通常在 1GB – 2GB 左右，而 FastGPT 的完整全家桶（Mongo + Postgres/pgvector + FastGPT + OneAPI）非常吃内存。因此，本方案特别增加了 “小内存优化（Swap）” 步骤，确保您的 VPS 不会因为 OOM（内存溢出）而死机。

核心部署清单

• 应用架构：FastGPT + PostgreSQL (pgvector) + MongoDB + OneAPI

• 硬件要求：建议 2GB+ 内存（若为 1GB 必须加 4GB Swap）

• 部署方式：Docker Compose（最稳健、易维护）

第一步：环境准备与防爆内存设置 (必做)

在 SSH 中依次执行以下命令，先给 VPS 增加 4GB 的虚拟内存（Swap），这是在小内存 VPS 上跑 AI 应用的“救命稻草”。

# 1. 检查当前 Swap（如果显示为 0，则必须执行下一步）
free -h

# 2. 创建 4GB Swap 文件
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 3. 设置开机自动挂载 Swap
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# 4. 调整 Swap 使用倾向（让系统更积极使用 Swap，保护物理内存）
echo 'vm.swappiness=60' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

# 5. 安装 Docker 和 Docker Compose (如果尚未安装)
curl -fsSL https://get.docker.com | bash -s docker

第二步：下载配置文件

我们将使用 FastGPT 官方推荐的 pgvector 版本，相比 Milvus 版本更轻量，适合个人和中小团队使用。

# 1. 创建部署目录
mkdir -p /root/fastgpt
cd /root/fastgpt

# 2. 下载 docker-compose.yml
# 官方源可能在国外，如果下载慢可以使用代理或手动复制
curl -O https://raw.githubusercontent.com/labring/FastGPT/main/files/docker/docker-compose-pgvector.yml

# 3. 下载 config.json (系统配置文件)
curl -O https://raw.githubusercontent.com/labring/FastGPT/main/projects/app/data/config.json

第三步：修改配置 (关键)

在启动前，您可能需要微调 docker-compose-pgvector.yml，特别是为了防止数据库占用过多资源。

使用 nano docker-compose-pgvector.yml 编辑：

1. 设置数据库密码：找到 POSTGRES_PASSWORD 和 MONGO_INITDB_ROOT_PASSWORD，建议修改为复杂的密码。

2. 修改 FastGPT 环境变量：

   • 找到 fastgpt 服务下的 DB_MAX_LINK，默认可能较高，建议改为 5（减少数据库连接数）。

3. OneAPI 端口：默认 OneAPI 占用 3001，FastGPT 占用 3000。确保您的 VPS 防火墙（如 UFW 或 搬瓦工后台的安全组）放行了这两个端口。

第四步：启动服务

# 拉取镜像并后台启动
docker compose -f docker-compose-pgvector.yml up -d

启动后，等待约 30-60 秒（数据库初始化需要时间）。

第五步：访问与模型接入

1. 登录 FastGPT：

   • 浏览器访问：http://您的VPS_IP:3000

   • 默认账号：root

   • 默认密码：1234 （登录后请立即修改）

2. 配置 AI 模型 (通过 OneAPI)：

   FastGPT 本身不直接调 OpenAI，而是通过 OneAPI 中转。

   • 浏览器访问：http://您的VPS_IP:3001

   • 默认账号：root

   • 默认密码：123456

   • 操作：

     1. 进入 OneAPI -> 渠道 -> 添加新的渠道。

     2. 类型选择 OpenAI（如果您用 GPT-4）或 DeepSeek（强烈推荐，成本极低）。

     3. 填入您的 API Key（如 sk-xxxx）。

     4. 非常重要：在“模型”列表里，手动打字添加 FastGPT 需要用到的核心模型，通常是：

        • 对话模型：gpt-4o-mini, deepseek-chat

        • 向量模型（知识库必用）：text-embedding-3-small 或 text-embedding-ada-002

        • 提示：如果您用 DeepSeek，它的向量模型尚未被 FastGPT 完美兼容，建议向量模型单独买一个 OpenAI 的 key，或者在 OneAPI 里配置一个本地向量模型（但 VPS 跑不动）。最稳妥方案是：对话用 DeepSeek，向量用 OpenAI。

3. 绑定 FastGPT：

   回到 FastGPT 界面 -> 账号设置 -> 模型配置，确保能看到您在 OneAPI 里添加的模型。

进阶建议：域名与 HTTPS（推荐）

直接用 IP 访问不安全，且无法使用某些需要 HTTPS 的功能（如语音输入）。

建议利用 Nginx 反向代理：

# Nginx 配置示例
server {
    listen 80;
    server_name kb.yourdomain.com; # 您的域名

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

现在，您的专属 AI 知识库已部署完毕。 您可以开始上传您的 PDF 文档、Markdown 笔记，构建一个真正“懂你”的私有 AI 助手了。

1、搬瓦工实时库存监控

搬瓦工实时库存：https://kucun.banwagongcn.com

2、搬瓦工最推荐套餐

1. 搬瓦工优惠码：BWHCGLUKKB
2. 搬瓦工购买教程：《搬瓦工新手用户注册和支付宝购买图文指导教程》

选择建议：

• 入门：洛杉矶 KVM 套餐，目前最便宜，可选 DC8 ZNET 等机房，CN2 GT 线路，入门之选。
• 推荐：洛杉矶 CN2 GIA-E 套餐，速度超快，可选 DC6 CN2 GIA-E/DC9 CN2 GIA/日本软银 JPOS_1/联通荷兰 EUNL_9 等机房，性价比最高。
• 高端：香港 CN2 GIA 套餐/东京 CN2 GIA 套餐，价格较高，但是速度、延迟、丢包等方面无可挑剔。

也可以关注下面的优惠通知，后面有什么新的搬瓦工优惠都会第一时间进行通知的。

1、QQ 群（禁言）

• 搬瓦工补货通知 QQ 群 3（全员禁言，仅发送通知）：250754021
• 搬瓦工补货通知 QQ 群 8（全员禁言，仅发送通知）：697178487
• 搬瓦工补货通知 QQ 群 9（全员禁言，仅发送通知）：554576821

2、TG 频道

• 搬瓦工补货通知 TG 群：@BandwagonHostNews

3、邮件通知

• 搬瓦工补货通知邮件订阅 1：点击订阅（Google Groups）
• 搬瓦工补货通知邮件订阅 2：点击此处提交邮箱地址

更多可以参考：《2022 搬瓦工优惠套餐/限量版套餐补货通知频道/QQ群》。