baodan/QUICK_START.md

# 🚀 快速部署指南

## 最小化部署（推荐）

直接拉取官方镜像，无需本地构建，5 分钟完成部署。

### 镜像大小

| 镜像 | 大小 | 说明 |
|------|------|------|
| `langgenius/dify-api` | ~900MB | API 服务 |
| `langgenius/dify-web` | ~170MB | Web 前端 |
| `pgvector/pgvector:pg15` | ~300MB | 数据库 |
| `redis:7-alpine` | ~30MB | 缓存 |
| **总计** | **~1.4GB** | 比完整版节省 16GB |

### 一键部署

**Linux/Mac:**
```bash
chmod +x quick-deploy.sh
./quick-deploy.sh
```

**Windows:**
```cmd
quick-deploy.bat
```

### 手动部署

```bash
# 1. 拉取镜像
docker pull pgvector/pgvector:pg15
docker pull redis:7-alpine
docker pull langgenius/dify-api:latest
docker pull langgenius/dify-web:latest

# 2. 启动服务
docker compose -f docker-compose.minimal.yml up -d

# 3. 等待初始化（约 1-2 分钟）
docker compose -f docker-compose.minimal.yml logs -f

# 4. 访问系统
# 浏览器打开 http://localhost:3000
```

## 访问地址

| 服务 | 地址 | 说明 |
|------|------|------|
| 管理后台 | http://localhost:3000 | Dify 后台 |
| API 服务 | http://localhost:5001 | 后端 API |

## 默认账号

- **邮箱**: taiyi@baodan.com
- **密码**: taiyi1224

## 服务说明

最小化部署包含 4 个核心服务：

| 服务 | 必要性 | 说明 |
|------|:------:|------|
| db | ✅ | PostgreSQL 数据库 |
| redis | ✅ | Redis 缓存 |
| dify-api | ✅ | API 服务 |
| dify-worker | ✅ | 异步任务处理 |
| dify-web | ✅ | Web 前端 |

**已移除的服务**（节省空间）：
- ❌ sandbox — 代码执行沙箱（848MB）
- ❌ plugin_daemon — 插件守护进程（2.3GB）

## 常用命令

```bash
# 查看服务状态
docker compose -f docker-compose.minimal.yml ps

# 查看日志
docker compose -f docker-compose.minimal.yml logs -f

# 停止服务
docker compose -f docker-compose.minimal.yml down

# 重启服务
docker compose -f docker-compose.minimal.yml restart

# 停止并删除数据
docker compose -f docker-compose.minimal.yml down -v
```

## 下一步

1. **访问管理后台**：http://localhost:3000
2. **配置模型**：在后台添加 LLM API Key（如 DeepSeek、OpenAI）
3. **创建应用**：创建聊天应用或 Workflow
4. **配置知识库**：上传保险相关文档
5. **测试对话**：验证系统功能

## 完整版部署

如需完整功能（代码沙箱、插件支持），使用完整版：

```bash
docker compose -f docker-compose.dify.yml up -d
```

完整版镜像大小：~17.5GB

## 故障排查

### 端口冲突

```bash
# 检查端口占用
netstat -tulpn | grep -E ':(5001|3000|5433|6380)'

# 修改端口映射
# 编辑 docker-compose.minimal.yml
ports:
  - "5002:5001"  # 将 5001 改为 5002
```

### 服务启动失败

```bash
# 查看详细日志
docker compose -f docker-compose.minimal.yml logs dify-api

# 重启服务
docker compose -f docker-compose.minimal.yml restart
```

### 数据库连接失败

```bash
# 检查数据库状态
docker compose -f docker-compose.minimal.yml exec db pg_isready -U postgres

# 查看数据库日志
docker compose -f docker-compose.minimal.yml logs db
```

## 文件清单

```
baodanagent/
├── docker-compose.minimal.yml  # 最小化部署配置
├── quick-deploy.sh             # Linux/Mac 快速部署脚本
├── quick-deploy.bat            # Windows 快速部署脚本
└── QUICK_START.md              # 本文档
```

## 环境要求

- Docker 20.10+
- Docker Compose 2.0+
- 磁盘空间：2GB+
- 内存：4GB+

---

**部署时间**: ~5 分钟
**镜像大小**: ~1.4GB
**推荐场景**: 快速体验、开发测试、资源受限环境