admin/common-server-public

Fork 0

Files

wsl-d4 144ed3cbdf 1022

2025-10-22 09:35:58 +08:00

3.1 KiB

Raw Blame History

FastGPT Docker 部署指南

FastGPT 是一个基于大语言模型的知识库问答系统，提供开箱即用的数据处理、模型调用等能力。

快速开始

1. 创建目录并进入

mkdir fastgpt && cd fastgpt

2. 下载配置文件

# 复制 docker-compose.yml 文件
cp /mnt/e/020-awei-cloud-9900k-code/common-server-public/fastgpt/docker-compose.yml .

# 复制环境变量文件
cp /mnt/e/020-awei-cloud-9900k-code/common-server-public/fastgpt/.env.example .env

3. 配置环境变量

编辑 .env 文件，设置必要的配置：

# 必需配置
POSTGRES_PASSWORD=your_secure_postgres_password
MONGO_PASSWORD=your_secure_mongo_password
OPENAI_API_KEY=your_openai_api_key_here
JWT_SECRET=your_very_long_jwt_secret_key_here
APIKEY=your_api_key_here
FILE_TOKEN_KEY=your_file_token_key_here

# 默认管理员密码
DEFAULT_ROOT_PSW=your_admin_password

4. 启动服务

docker-compose up -d

5. 访问 FastGPT

FastGPT 主应用：http://localhost:3000

默认管理员账号：

用户名：root
密码：您在 .env 中设置的 DEFAULT_ROOT_PSW

服务说明

核心服务

FastGPT: 主应用服务（端口 3000）
PostgreSQL: 数据库服务，支持 pgvector 向量搜索
MongoDB: 文档数据库
Redis: 缓存服务

数据持久化

PostgreSQL 数据：postgres_data
MongoDB 数据：mongo_data
Redis 数据：redis_data

配置说明

必需环境变量

OPENAI_API_KEY: OpenAI API 密钥
POSTGRES_PASSWORD: PostgreSQL 数据库密码
MONGO_PASSWORD: MongoDB 数据库密码
JWT_SECRET: JWT 密钥，用于用户认证
APIKEY: FastGPT API 密钥
FILE_TOKEN_KEY: 文件上传令牌密钥

可选配置

CLAUDE_API_KEY: Claude API 密钥（可选）
VECTOR_MAX_PROCESS: 向量处理最大进程数（默认 10）
QA_MAX_PROCESS: 问答处理最大进程数（默认 10）

常用命令

# 启动服务
docker-compose up -d

# 停止服务
docker-compose down

# 查看日志
docker-compose logs -f

# 重启服务
docker-compose restart

# 更新镜像
docker-compose pull
docker-compose up -d

功能特性

📚 知识库管理
🔍 智能问答
📄 文档处理
🎯 向量搜索
🔗 多模型支持（OpenAI、Claude 等）
📊 可视化工作流
👥 多用户管理
🔐 API 管理

注意事项

安全性: 生产环境请使用强密码和密钥
端口冲突: 确保端口 3000、5432、27017、6379 未被占用
资源要求: 建议至少 4GB 内存，8GB 以上更佳
备份: 定期备份数据库数据

故障排查

服务无法启动

# 检查容器状态
docker-compose ps

# 查看具体服务日志
docker-compose logs [service-name]

数据库连接失败

确保 PostgreSQL 和 MongoDB 服务正常启动，检查环境变量配置是否正确。

API 调用失败

检查 OPENAI_API_KEY 是否有效，以及 API 配额是否充足。

3.1 KiB Raw Blame History Unescape Escape