| # 🐳 Docker部署完整指南 | |
| 本项目提供了多种Docker部署方案，适应不同的使用场景和需求。 | |
| ## 📦 Dockerfile文件说明 | |
| ### 主要Dockerfile文件 | |
| | 文件 | 用途 | 特点 | | |
| |------|------|------| | |
| | `Dockerfile` | 单容器部署 | 前端+后端在一个容器中，简化部署 | | |
| | `Dockerfile.optimized` | 优化单容器 | 多阶段构建，镜像更小，性能更好 | | |
| | `client/Dockerfile` | 前端容器 | React应用 + Nginx，支持多容器架构 | | |
| | `server/Dockerfile` | 后端容器 | Node.js应用，支持多容器架构 | | |
| ### Docker Compose配置 | |
| | 文件 | 用途 | 特点 | | |
| |------|------|------| | |
| | `docker-compose.yml` | 生产环境 | 多容器，包含健康检查和依赖管理 | | |
| | `docker-compose.dev.yml` | 开发环境 | 支持热重载，便于开发调试 | | |
| | `docker-compose.single.yml` | 单容器部署 | 简化的单容器 + MongoDB | | |
| ## 🚀 部署方案选择 | |
| ### 方案1: 多容器部署（推荐生产环境） | |
| **优点:** | |
| - 服务分离，便于扩展 | |
| - 独立更新前端或后端 | |
| - 更好的资源管理 | |
| - 符合微服务架构 | |
| **部署命令:** | |
| ```bash | |
| # 自动部署 | |
| ./deploy.sh | |
| # 手动部署 | |
| docker-compose up --build -d | |
| # 使用Makefile | |
| make start | |
| ``` | |
| ### 方案2: 单容器部署（推荐小型部署） | |
| **优点:** | |
| - 部署简单 | |
| - 资源占用少 | |
| - 管理方便 | |
| - 适合小型应用 | |
| **部署命令:** | |
| ```bash | |
| # 使用标准版本 | |
| docker-compose -f docker-compose.single.yml up -d | |
| # 使用优化版本 | |
| docker build -t chatapp:optimized -f Dockerfile.optimized . | |
| docker run -d -p 80:80 --name chatapp chatapp:optimized | |
| # 使用Makefile | |
| make single | |
| ``` | |
| ### 方案3: 开发环境 | |
| **特点:** | |
| - 支持热重载 | |
| - 实时代码同步 | |
| - 便于调试 | |
| - 快速迭代 | |
| **部署命令:** | |
| ```bash | |
| ./start-dev.sh | |
| # 或 | |
| make dev | |
| ``` | |
| ## 🔨 构建Docker镜像 | |
| ### 交互式构建 | |
| ```bash | |
| # 使用构建脚本（推荐） | |
| ./build-docker.sh | |
| # 选择构建类型： | |
| # 1) 多容器构建 | |
| # 2) 单容器构建 | |
| # 3) 仅构建前端 | |
| # 4) 仅构建后端 | |
| ``` | |
| ### 手动构建 | |
| ```bash | |
| # 构建所有镜像 | |
| make build | |
| # 构建单个镜像 | |
| docker build -t chatapp-frontend ./client | |
| docker build -t chatapp-backend ./server | |
| docker build -t chatapp . | |
| # 构建优化版本 | |
| docker build -t chatapp:optimized -f Dockerfile.optimized . | |
| ``` | |
| ### 镜像比较 | |
| ```bash | |
| # 比较不同版本的镜像大小和性能 | |
| ./docker-compare.sh | |
| ``` | |
| ## 📊 镜像优化特性 | |
| ### 多阶段构建 | |
| - 分离构建环境和运行环境 | |
| - 减少最终镜像大小 | |
| - 提高安全性 | |
| ### 安全特性 | |
| - 非root用户运行 | |
| - 最小权限原则 | |
| - 安全的基础镜像 | |
| - 定期安全更新 | |
| ### 性能优化 | |
| - Alpine Linux基础镜像 | |
| - 优化的nginx配置 | |
| - Gzip压缩 | |
| - 静态资源缓存 | |
| - 健康检查 | |
| ## 🔧 配置说明 | |
| ### 环境变量 | |
| **后端环境变量:** | |
| ```env | |
| NODE_ENV=production | |
| MONGODB_URI=mongodb://mongo:27017/chatapp | |
| JWT_SECRET=your-secret-key | |
| PORT=5000 | |
| CLIENT_URL=http://localhost:3000 | |
| ``` | |
| **前端环境变量:** | |
| ```env | |
| VITE_API_URL=http://localhost:5000 | |
| ``` | |
| ### 端口映射 | |
| | 服务 | 容器端口 | 主机端口 | 说明 | | |
| |------|----------|----------|------| | |
| | 前端 | 80 | 3000 | React应用 | | |
| | 后端 | 5000 | 5000 | API服务 | | |
| | MongoDB | 27017 | 27017 | 数据库 | | |
| ### 数据卷 | |
| | 卷名 | 挂载点 | 用途 | | |
| |------|--------|------| | |
| | `mongo_data` | `/data/db` | MongoDB数据持久化 | | |
| | `./server` | `/app` | 开发环境代码同步 | | |
| | `./client` | `/app` | 开发环境代码同步 | | |
| ## 🧪 测试和验证 | |
| ### 功能测试 | |
| ```bash | |
| # 运行完整测试套件 | |
| ./test.sh | |
| # 使用Makefile | |
| make test | |
| ``` | |
| ### 健康检查 | |
| ```bash | |
| # 检查服务状态 | |
| make health | |
| # 查看容器状态 | |
| docker-compose ps | |
| # 查看健康检查日志 | |
| docker inspect <container_name> | jq '.[0].State.Health' | |
| ``` | |
| ### 性能测试 | |
| ```bash | |
| # 监控资源使用 | |
| docker stats | |
| # 查看镜像大小 | |
| docker images | grep chatapp | |
| # 网络性能测试 | |
| curl -w "@curl-format.txt" -o /dev/null -s http://localhost:3000 | |
| ``` | |
| ## 🔍 故障排除 | |
| ### 常见问题 | |
| **1. 容器启动失败** | |
| ```bash | |
| # 查看日志 | |
| docker-compose logs -f | |
| # 检查容器状态 | |
| docker-compose ps | |
| # 进入容器调试 | |
| docker exec -it <container_name> sh | |
| ``` | |
| **2. 端口冲突** | |
| ```bash | |
| # 检查端口占用 | |
| netstat -tulpn | grep :3000 | |
| netstat -tulpn | grep :5000 | |
| # 修改端口映射 | |
| # 编辑 docker-compose.yml 中的 ports 配置 | |
| ``` | |
| **3. 镜像构建失败** | |
| ```bash | |
| # 清理构建缓存 | |
| docker builder prune -f | |
| # 重新构建 | |
| docker-compose build --no-cache | |
| # 查看构建日志 | |
| docker build --progress=plain . | |
| ``` | |
| **4. 数据持久化问题** | |
| ```bash | |
| # 检查数据卷 | |
| docker volume ls | |
| # 备份数据 | |
| make backup | |
| # 恢复数据 | |
| make restore FILE=backup.gz | |
| ``` | |
| ## 🚀 生产环境最佳实践 | |
| ### 1. 使用优化镜像 | |
| ```bash | |
| # 使用多阶段构建的优化版本 | |
| docker build -t chatapp:optimized -f Dockerfile.optimized . | |
| ``` | |
| ### 2. 配置资源限制 | |
| ```yaml | |
| # 在docker-compose.yml中添加 | |
| services: | |
| server: | |
| deploy: | |
| resources: | |
| limits: | |
| cpus: '0.5' | |
| memory: 512M | |
| reservations: | |
| cpus: '0.25' | |
| memory: 256M | |
| ``` | |
| ### 3. 设置重启策略 | |
| ```yaml | |
| services: | |
| server: | |
| restart: unless-stopped | |
| ``` | |
| ### 4. 配置日志管理 | |
| ```yaml | |
| services: | |
| server: | |
| logging: | |
| driver: "json-file" | |
| options: | |
| max-size: "10m" | |
| max-file: "3" | |
| ``` | |
| ### 5. 使用健康检查 | |
| ```yaml | |
| services: | |
| server: | |
| healthcheck: | |
| test: ["CMD", "wget", "--spider", "http://localhost:5000/api/health"] | |
| interval: 30s | |
| timeout: 10s | |
| retries: 3 | |
| ``` | |
| ## 📈 监控和维护 | |
| ### 日志管理 | |
| ```bash | |
| # 查看日志 | |
| make logs | |
| # 实时日志 | |
| docker-compose logs -f | |
| # 特定服务日志 | |
| docker-compose logs -f server | |
| ``` | |
| ### 备份策略 | |
| ```bash | |
| # 自动备份脚本 | |
| make backup | |
| # 定时备份（crontab） | |
| 0 2 * * * /path/to/chatapp/make backup | |
| ``` | |
| ### 更新部署 | |
| ```bash | |
| # 更新应用 | |
| make update | |
| # 滚动更新 | |
| docker-compose up -d --no-deps server | |
| ``` | |
| 这个Docker部署指南提供了完整的容器化解决方案，适合各种部署场景和需求。 | |