baodan/DOCKER_OPTIMIZATION.md

Docker 镜像优化指南

📊 当前镜像大小分析

镜像	大小	说明
langgenius/dify-api:latest	4.12GB	Dify 官方 API 镜像
baodanagent-dify-api:latest	4.12GB	自定义 API 镜像
langgenius/dify-plugin-daemon	2.31GB	插件守护进程
langgenius/dify-web:latest	759MB	Web 前端镜像
langgenius/dify-sandbox:0.2.15	848MB	代码执行沙箱
总计	~17.5GB	所有镜像

🔍 镜像大的原因

1. Dify 官方镜像本身就大

Dify 是一个复杂的 AI 应用平台，包含：

• Python 3.12 运行时
• PyTorch / Transformers（ML 框架）
• 向量数据库依赖（pgvector, qdrant, weaviate）
• 多种 LLM SDK（OpenAI, Anthropic, 本地模型等）
• Celery 异步任务框架
• 数据库 ORM 和迁移工具

2. 多服务架构

系统包含 6 个独立服务，每个都有自己的镜像：

• API 服务
• Web 前端
• Worker 异步任务
• Plugin Daemon 插件守护进程
• Sandbox 代码沙箱
• 数据库和缓存

✅ 已完成的优化

1. Dockerfile 优化

# 清理不必要的文件
RUN apt-get clean && \
    rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* && \
    pip cache purge 2>/dev/null || true && \
    rm -rf /root/.cache/pip

2. .dockerignore 优化

创建了 .dockerignore 文件，排除：

• 文档文件（docs/）
• 前端源码（frontend/）
• 测试文件
• 虚拟环境
• 缓存文件

3. 构建缓存优化

使用 Docker BuildKit 缓存：

DOCKER_BUILDKIT=1 docker build --cache-from ...

🚀 进一步优化方案

方案 1：清理未使用的镜像

# 查看未使用的镜像
docker images -f "dangling=true"

# 清理悬空镜像
docker image prune -f

# 清理所有未使用的镜像（谨慎使用）
docker image prune -a -f

方案 2：使用精简基础镜像

如果不需要所有 Dify 功能，可以使用 Alpine 版本：

# 替换
FROM langgenius/dify-api:latest

# 为（如果官方提供）
FROM langgenius/dify-api:alpine

方案 3：多阶段构建

# 构建阶段
FROM python:3.12-slim as builder
COPY requirements.txt .
RUN pip install --user -r requirements.txt

# 运行阶段
FROM python:3.12-slim
COPY --from=builder /root/.local /root/.local
COPY api/insurance /app/api/insurance

方案 4：禁用不需要的服务

如果不需要某些功能，可以在 docker-compose.dify.yml 中注释掉：

# 如果不需要代码沙箱
# sandbox:
#   image: langgenius/dify-sandbox:0.2.15
#   ...

# 如果不需要插件守护进程
# plugin_daemon:
#   image: langgenius/dify-plugin-daemon:0.6.1-local
#   ...

🛠️ 磁盘清理工具

使用清理脚本

# 运行清理脚本
./docker-cleanup.sh

手动清理命令

# 1. 查看 Docker 磁盘使用
docker system df

# 2. 清理停止的容器
docker container prune -f

# 3. 清理悬空镜像
docker image prune -f

# 4. 清理构建缓存
docker builder prune -f

# 5. 清理所有未使用资源（谨慎）
docker system prune -a -f

# 6. 清理所有未使用资源包括卷（非常谨慎）
docker system prune -a -f --volumes

📈 优化效果对比

优化措施	预计节省	说明
清理构建缓存	8-10GB	一次性释放
清理悬空镜像	300-500MB	定期清理
禁用不需要的服务	2-3GB	按需裁剪
使用 .dockerignore	50-100MB	每次构建

🎯 推荐优化步骤

第一步：立即释放空间

# 清理构建缓存（最大收益）
docker builder prune -f --keep-storage 2GB

# 清理悬空镜像
docker image prune -f

第二步：评估服务需求

根据实际需求决定保留哪些服务：

服务	必要性	说明
baodan-api	✅ 必须	核心 API 服务
baodan-web	✅ 必须	管理后台
baodan-worker	⚠️ 按需	异步任务（可选）
db	✅ 必须	数据库
redis	✅ 必须	缓存
plugin_daemon	⚠️ 按需	插件功能（可选）
sandbox	⚠️ 按需	代码执行（可选）

第三步：优化 Dockerfile

已优化的 Dockerfile 包含：

• 清理 apt 缓存
• 清理 pip 缓存
• 删除临时文件

第四步：定期维护

# 添加到 crontab（每周清理一次）
0 2 * * 0 cd /path/to/project && docker system prune -f >> /var/log/docker-cleanup.log 2>&1

📝 注意事项

1. 不要删除正在使用的镜像：先停止容器再删除镜像
2. 谨慎使用 --volumes：会删除所有未挂载的数据卷
3. 备份重要数据：清理前确保数据已备份
4. 保留基础镜像：避免重复下载官方镜像

🔗 相关命令参考

# 查看镜像详情
docker inspect <image_id>

# 查看镜像层
docker history <image_id>

# 导出镜像（备份）
docker save -o baodan-api.tar baodanagent-dify-api:latest

# 导入镜像（恢复）
docker load -i baodan-api.tar

# 推送到私有仓库
docker tag baodanagent-dify-api:latest your-registry.com/baodan-api:latest
docker push your-registry.com/baodan-api:latest

📊 最终优化效果

经过优化后，预计磁盘使用：

项目	优化前	优化后	节省
镜像大小	17.5GB	10-12GB	5-7GB
构建缓存	10.3GB	2GB	8GB
总计	~28GB	~14GB	~14GB

---

优化完成时间: 2026-06-19 优化状态: ✅ 已完成基础优化