🚀 FastGPT 私有化部署完整指南

📋 环境要求

硬件要求

最低配置:CPU: 4核内存: 8GB存储: 50GB网络: 稳定互联网连接推荐配置:CPU: 8核+内存: 16GB+存储: 100GB+ SSD网络: 10Mbps+带宽

软件环境

必需软件:- Docker: >= 20.10.0- Docker Compose: >= 2.0.0- Git: 最新版本操作系统:- Ubuntu 20.04+ (推荐)- CentOS 7+- Windows Server (支持Docker)- macOS (开发测试)

---

🐳 Docker Compose 部署（推荐）

1. 获取源码

# 克隆仓库
git clone https://github.com/labring/FastGPT.git
cd FastGPT# 切换到稳定版本
git checkout v4.9.14

2. 配置环境

# 进入部署目录
cd projects/app/docker# 复制配置文件
cp .env.template .env
cp config.json.template config.json

3. 修改配置文件

编辑 .env 文件

# 数据库配置
MONGO_PASSWORD=your_mongo_password
PG_PASSWORD=your_postgres_password# 服务端口
PORT=3000# 域名配置（可选）
DEFAULT_ROOT_PSW=your_admin_password

编辑 config.json 文件

{"SystemParams": {"gitBranch": "v4.9.14","chatApiKey": "","vectorMaxProcess": 15,"qaMaxProcess": 15,"pgHNSWEfSearch": 100},"llmModels": [{"model": "gpt-3.5-turbo","name": "GPT-3.5-turbo","apiKey": "YOUR_OPENAI_API_KEY","baseUrl": "https://api.openai.com/v1","maxTokens": 4000,"maxTemperature": 1.2}],"vectorModels": [{"model": "text-embedding-ada-002","name": "OpenAI-Ada","apiKey": "YOUR_OPENAI_API_KEY", "baseUrl": "https://api.openai.com/v1","dbConfig": {}}]
}

4. 启动服务

# 启动所有服务
docker-compose up -d# 查看服务状态
docker-compose ps# 查看日志
docker-compose logs -f fastgpt

---

⚙️ 详细配置说明

大模型配置

OpenAI 配置

{"model": "gpt-4","name": "GPT-4","apiKey": "sk-xxxxxxxx","baseUrl": "https://api.openai.com/v1","maxTokens": 8000,"maxTemperature": 1.2,"vision": true
}

国产大模型配置

// 阿里通义千问
{"model": "qwen-max", "name": "通义千问Max","apiKey": "sk-xxxxxxxx","baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1","maxTokens": 6000
}// 深度求索
{"model": "deepseek-chat","name": "DeepSeek Chat", "apiKey": "sk-xxxxxxxx","baseUrl": "https://api.deepseek.com/v1","maxTokens": 4000
}

向量模型配置

// 本地BGE模型
{"model": "bge-large-zh-v1.5","name": "BGE-Large-ZH","baseUrl": "http://localhost:6006/v1", "dbConfig": {"dimensions": 1024}
}// OpenAI Embedding
{"model": "text-embedding-3-large","name": "OpenAI-Embedding-3-Large","apiKey": "sk-xxxxxxxx","baseUrl": "https://api.openai.com/v1","dbConfig": {"dimensions": 3072}
}

---

🛠️ 本地模型部署

1. Ollama 本地部署

# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh# 拉取模型
ollama pull qwen2.5:7b
ollama pull bge-m3:latest# 启动服务
ollama serve

FastGPT 配置 Ollama

{"llmModels": [{"model": "qwen2.5:7b","name": "通义千问2.5-7B","baseUrl": "http://host.docker.internal:11434/v1","apiKey": "ollama","maxTokens": 4000}],"vectorModels": [{"model": "bge-m3:latest", "name": "BGE-M3","baseUrl": "http://host.docker.internal:11434/v1","apiKey": "ollama"}]
}

2. Xinference 部署

# 安装 Xinference
pip install xinference# 启动服务
xinference-local --host 0.0.0.0 --port 9997# 通过 Web UI 管理模型
# http://localhost:9997

---

🌐 反向代理配置

Nginx 配置

server {listen 80;server_name your-domain.com;# 重定向到 HTTPSreturn 301 https://$server_name$request_uri;
}server {listen 443 ssl;server_name your-domain.com;# SSL 证书配置ssl_certificate /path/to/cert.pem;ssl_certificate_key /path/to/key.pem;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;proxy_set_header X-Forwarded-Proto $scheme;# WebSocket 支持proxy_http_version 1.1;proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection "upgrade";}
}

---

📊 数据库管理

MongoDB 管理

# 连接 MongoDB
docker exec -it fastgpt-mongo mongo -u myusername -p mypassword# 备份数据库
docker exec fastgpt-mongo mongodump -u myusername -p mypassword -d fastgpt -o /backup# 恢复数据库
docker exec fastgpt-mongo mongorestore -u myusername -p mypassword -d fastgpt /backup/fastgpt

PostgreSQL 管理

# 连接 PostgreSQL
docker exec -it fastgpt-pg psql -U username -d postgres# 备份数据库
docker exec fastgpt-pg pg_dump -U username fastgpt > backup.sql# 恢复数据库
docker exec -i fastgpt-pg psql -U username fastgpt < backup.sql

---

🔧 常见问题解决

1. 服务启动失败

# 检查端口占用
netstat -tulpn | grep :3000# 检查磁盘空间
df -h# 重启服务
docker-compose restart

2. 内存不足

# 在 docker-compose.yml 中限制内存
services:fastgpt:deploy:resources:limits:memory: 4Greservations:memory: 2G

3. API 连接问题

# 测试 API 连通性
curl -X POST https://api.openai.com/v1/chat/completions \-H "Authorization: Bearer YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"model":"gpt-3.5-turbo","messages":[{"role":"user","content":"Hello"}]}'

---

🚀 生产环境优化

性能优化配置

# docker-compose.yml 优化
version: '3.8'
services:fastgpt:restart: alwayslogging:driver: "json-file"options:max-size: "100m"max-file: "3"deploy:resources:limits:cpus: '4.0'memory: 8Greservations:cpus: '2.0'memory: 4G

监控配置

# 添加健康检查
healthcheck:test: ["CMD", "curl", "-f", "http://localhost:3000/api/system/getInitData"]interval: 30stimeout: 10sretries: 3

---

📋 部署检查清单

部署前检查 ✅

□ 服务器资源充足
□ Docker 环境正常
□ 网络连接稳定
□ 域名解析配置
□ SSL 证书准备
□ API Key 有效

部署后验证 ✅

□ 服务正常启动
□ Web 界面可访问
□ 数据库连接正常
□ 大模型调用成功
□ 文件上传功能正常
□ 对话功能测试通过

---

🎯 总结

FastGPT 私有化部署相对简单，关键要点：

1. 环境准备：确保 Docker 环境和硬件资源充足
2. 配置管理：正确配置大模型和向量模型 API
3. 安全考虑：使用 HTTPS、强密码、防火墙配置
4. 监控维护：定期备份、日志监控、性能优化

部署成功后，你将拥有一个完全私有的 AI 知识库平台！🎉