# FastGPT Docker 部署指南

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

## 快速开始

### 1. 创建目录并进入
```bash
mkdir fastgpt && cd fastgpt
```

### 2. 下载配置文件
```bash
# 复制 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` 文件，设置必要的配置：

```bash
# 必需配置
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. 启动服务
```bash
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）

## 常用命令

```bash
# 启动服务
docker-compose up -d

# 停止服务
docker-compose down

# 查看日志
docker-compose logs -f

# 重启服务
docker-compose restart

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

## 功能特性

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

## 注意事项

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

## 故障排查

### 服务无法启动
```bash
# 检查容器状态
docker-compose ps

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

### 数据库连接失败
确保 PostgreSQL 和 MongoDB 服务正常启动，检查环境变量配置是否正确。

### API 调用失败
检查 `OPENAI_API_KEY` 是否有效，以及 API 配额是否充足。

## 更多帮助

- FastGPT 官方文档：https://doc.fastgpt.in/
- GitHub 仓库：https://github.com/labring/FastGPT
- 社区支持：https://github.com/labring/FastGPT/issues