Ubuntu 22.04 搭建 FastGPT 完整教程

一、FastGPT 简介

FastGPT 是一个基于大型语言模型（如GPT系列）构建的开源AI应用框架，支持知识库管理、AI对话和自动化流程。本教程将指导您通过Docker快速部署FastGPT服务。

---

二、环境准备

1. 系统要求

• Ubuntu 22.04 LTS

• 最低配置：2核CPU / 4GB内存 / 50GB硬盘

• 推荐配置：4核CPU / 8GB内存 / 100GB硬盘（如需运行大模型）

2. 更新系统

sudo apt update && sudo apt upgrade -y sudo apt install curl git -y

---

三、安装依赖

1. 安装 Docker

# 卸载旧版本
sudo apt remove docker docker-engine docker.io containerd runc

# 安装依赖
sudo apt install ca-certificates curl gnupg lsb-release -y

# 添加Docker官方GPG密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 添加仓库
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装Docker
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y

# 验证安装
sudo docker run hello-world

2. 安装 Docker Compose

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

---

四、部署 FastGPT

1. 克隆仓库

git clone https://github.com/labring/FastGPT
cd FastGPT

2. 配置环境文件

cp .env.example .env
cp docker-compose.yml.example docker-compose.yml

编辑 .env 文件：

nano .env

修改关键配置：

# MongoDB配置
MONGODB_PASSWORD=your_secure_password

# OpenAI API Key（或其它模型API）
OPENAI_API_KEY=sk-xxx

# 访问密钥（用于API调用）
APP_KEY=fastgpt-123456

3. 启动服务

docker-compose up -d

---

五、配置反向代理（Nginx）

1. 安装Nginx

sudo apt install nginx -y

2. 创建配置文件

sudo nano /etc/nginx/sites-available/fastgpt.conf

内容示例：

nginx

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

    location / {
        proxy_pass http://localhost: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;
    }
}

3. 启用配置并重启

sudo ln -s /etc/nginx/sites-available/fastgpt.conf /etc/nginx/sites-enabled/
sudo systemctl restart nginx

4. 配置SSL（可选）

使用Certbot获取免费证书：

sudo snap install --classic certbot
sudo certbot --nginx

---

六、访问与验证

1. 检查服务状态

docker-compose ps

正常应显示三个容器：mongo、fastgpt、fastgpt-cron

2. 访问Web界面

浏览器打开 http://your-domain.com 或 http://服务器IP:3000

3. 初始设置

• 使用默认账号：root / 密码：1234 （登录后立即修改）

---

七、常见问题

1. 端口冲突

修改 docker-compose.yml 中的端口映射：

ports:
  - "3000:3000" → "新端口:3000"

2. 数据备份

# MongoDB备份
docker exec -it mongo mongodump -u root -p $MONGODB_PASSWORD --authenticationDatabase admin -o /backup

3. 更新版本

git pull origin main
docker-compose down
docker-compose up -d --pull always

---

八、高级配置（可选）

1. 使用本地模型：修改 config.json 配置本地模型路径

2. 集群部署：通过修改 docker-compose.yml 添加多个实例

3. 监控系统：集成Prometheus+Grafana监控资源使用情况

---

通过以上步骤，您已成功在Ubuntu 22.04上部署了FastGPT应用。建议定期检查官方仓库获取最新更新和安全补丁。