170 lines
3.6 KiB
Markdown
170 lines
3.6 KiB
Markdown
# 🚀 快速部署指南
|
||
|
||
## 最小化部署（推荐）
|
||
|
||
直接拉取官方镜像，无需本地构建，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
|
||
**推荐场景**: 快速体验、开发测试、资源受限环境
|