保险智能客服系统 — 部署指南
🚀 快速部署
Windows 用户
deploy.bat
Linux/Mac 用户
chmod +x deploy.sh
./deploy.sh
📋 手动部署步骤
1. 环境配置
# 复制环境变量模板
cp .env.example .env
# 编辑 .env 文件，填入实际配置
# 至少需要配置：
# - JWT_SECRET（已自动生成）
# - 企微配置（如果需要企微功能）
2. 构建镜像
# 构建 API 镜像（包含 insurance 模块）
docker build -t baodanagent-dify-api:latest -f Dockerfile.dify-custom .
# 构建 Web 镜像（自定义品牌）
docker build -t baodanagent-dify-web:latest -f Dockerfile.web-custom .
3. 启动服务
# 启动所有服务
docker compose -f docker-compose.dify.yml up -d
# 查看日志
docker compose -f docker-compose.dify.yml logs -f
# 等待初始化完成（约 1-2 分钟）
4. 访问系统
5. 默认管理员账号
🔧 配置说明
必填配置
| 配置项 |
说明 |
默认值 |
JWT_SECRET |
JWT 认证密钥 |
已自动生成 |
ADMIN_PASSWORD |
管理员密码 |
taiyi1224 |
DB_PASSWORD |
数据库密码 |
taiyi1224 |
企微配置（可选）
如果需要对接企业微信，需要配置以下项：
| 配置项 |
说明 |
WECOM_CORP_ID |
企业 ID |
WECOM_SECRET |
应用密钥 |
WECOM_TOKEN |
回调 Token |
WECOM_AES_KEY |
加密 Key |
📦 服务组件
| 服务 |
端口 |
说明 |
| baodan-api |
5001 |
API 服务 + Insurance 模块 |
| baodan-web |
3000 |
Web 管理后台 |
| baodan-worker |
- |
Celery 异步任务 |
| db |
5433 |
PostgreSQL 数据库 |
| redis |
6380 |
Redis 缓存 |
| plugin_daemon |
5002 |
插件守护进程 |
| sandbox |
8194 |
代码执行沙箱 |
🛠️ 常用命令
# 查看所有服务状态
docker compose -f docker-compose.dify.yml ps
# 查看特定服务日志
docker compose -f docker-compose.dify.yml logs -f baodan-api
# 重启服务
docker compose -f docker-compose.dify.yml restart
# 停止所有服务
docker compose -f docker-compose.dify.yml down
# 停止并删除数据卷
docker compose -f docker-compose.dify.yml down -v
🔍 故障排查
1. 服务启动失败
# 查看详细日志
docker compose -f docker-compose.dify.yml logs baodan-api
# 检查容器状态
docker compose -f docker-compose.dify.yml ps
2. 数据库连接失败
# 检查 PostgreSQL 是否就绪
docker compose -f docker-compose.dify.yml exec db pg_isready -U postgres
# 查看数据库日志
docker compose -f docker-compose.dify.yml logs db
3. 端口冲突
如果端口被占用，可以修改 docker-compose.dify.yml 中的端口映射：
ports:
- "5002:5001" # 将 5001 改为 5002
📝 注意事项
- 首次启动：数据库迁移和初始化需要 1-2 分钟
- 数据持久化：数据存储在 Docker Volume 中，重启不会丢失
- 生产环境：请修改默认密码和密钥
- 备份：定期备份 PostgreSQL 数据和 Docker Volume
🔐 安全建议
- 修改默认管理员密码
- 使用强密码作为 JWT_SECRET
- 配置 HTTPS（生产环境）
- 限制数据库和 Redis 的访问权限
- 定期更新 Docker 镜像
📚 更多文档
