encrypt65/endowise

EndoWise Docker部署

本文档介绍如何使用Docker构建和部署EndoWise应用。

🐋 快速开始

使用Docker Compose（推荐）

bash
# 构建并运行容器
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止容器
docker-compose down

应用将在 http://localhost:8080 可用。

使用Docker CLI

bash
# 构建镜像
docker build -t endowise:latest .

# 运行容器
docker run -d -p 8080:80 --name endowise-app endowise:latest

# 查看日志
docker logs -f endowise-app

# 停止容器
docker stop endowise-app
docker rm endowise-app

📦 Docker Hub

每次推送到main或develop分支时，Docker镜像会自动构建并推送到Docker Hub。

从Docker Hub拉取

bash
# 拉取镜像
docker pull YOUR_USERNAME/endowise:latest

# 运行镜像
docker run -d -p 8080:80 YOUR_USERNAME/endowise:latest

将YOUR_USERNAME替换为您的Docker Hub用户名。

可用标签

• latest - main分支的最新构建
• main - main分支构建
• develop - 开发分支构建
• v1.0.0 - 语义化版本标签
• main-abc123 - Git提交SHA标签

🏗️ 构建流程

多阶段构建流程：

1. 构建阶段：

   • 使用Node.js 20 Alpine
   • 安装依赖
   • 构建Vite应用

2. 生产阶段：

   • 使用Nginx Alpine（最小镜像体积）
   • 复制构建产物
   • 通过优化的Nginx配置提供SPA服务

🔧 配置

环境变量

Firebase配置会嵌入到构建中。如需不同环境配置：

1. 创建.env.production文件配置生产环境参数
2. 重新构建Docker镜像
3. Vite构建过程将使用生产环境变量

Nginx配置

nginx.conf包含以下特性：

• SPA路由支持（所有路由回退到index.html）
• Gzip压缩
• 安全响应头
• 静态资源缓存（1年）
• 健康检查端点

端口配置

默认端口为8080。如需修改：

bash
# Docker Compose
# 编辑docker-compose.yml，将"8080:80"修改为所需端口

# Docker CLI
docker run -d -p 自定义端口:80 endowise:latest

🚀 GitHub Actions工作流

CI/CD流水线自动执行以下操作：

• 推送至main/develop分支时构建Docker镜像
• 支持多平台构建（amd64、arm64）
• 推送至GitHub容器 registry
• 创建语义化版本标签
• 缓存层加速构建
• 生成安全证明

触发构建

bash
# 推送到main分支
git push origin main

# 创建版本标签
git tag v1.0.0
git push origin v1.0.0

# 手动触发
# 进入Actions标签页 > Build and Push Docker Image > Run workflow

🏥 健康检查

容器包含健康检查机制：

• 每30秒执行一次
• 检查nginx是否响应
• 5秒启动宽限期
• 重试3次后标记为不健康

bash
# 检查容器健康状态
docker ps
# 查找"healthy"状态

# 或使用docker inspect
docker inspect --format='{{.State.Health.Status}}' endowise-app

📊 资源占用

容器大致大小：

• 构建阶段：约500MB（Node.js + 依赖）
• 最终镜像：约40MB（Nginx Alpine + 构建产物）

运行时内存占用：约10-20MB

🔒 安全

Nginx配置包含：

• X-Frame-Options头
• X-Content-Type-Options头
• X-XSS-Protection头
• Referrer-Policy头

生产环境部署建议：

1. 使用HTTPS（配置反向代理如Traefik/Nginx）
2. 设置适当的CORS策略
3. 配置Firebase安全规则
4. 使用密钥管理工具处理敏感数据

🐛 故障排除

容器无法启动

bash
# 查看日志
docker logs endowise-app

# 检查nginx配置
docker exec endowise-app nginx -t

构建失败

bash
# 清理Docker缓存
docker builder prune

# 无缓存重建
docker build --no-cache -t endowise:latest .

端口已被占用

bash
# 查找占用端口的进程
# Windows:
netstat -ano | findstr :8080

# Linux/Mac:
lsof -i :8080

# 使用其他端口
docker run -d -p 8081:80 endowise:latest

📚 扩展资源

• Docker文档
• Nginx文档
• https://docs.github.com/packages