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:

chmod +x quick-deploy.sh
./quick-deploy.sh

Windows:

quick-deploy.bat

手动部署

# 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）

常用命令

# 查看服务状态
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. 测试对话：验证系统功能

完整版部署

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

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

完整版镜像大小：~17.5GB

故障排查

端口冲突

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

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

服务启动失败

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

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

数据库连接失败

# 检查数据库状态
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 推荐场景: 快速体验、开发测试、资源受限环境