riwa-ionic/packages/distribute/DEPLOY.md

Docker 部署指南

Riwa App 分发页使用预构建模式部署，无需在服务器上安装依赖，快速启动。

📋 前置要求

• 本地环境: Node.js 20+, pnpm
• 服务器环境: Docker, Docker Compose

🚀 快速部署

1. 本地构建

# 安装依赖
pnpm install

# 构建生产版本
pnpm run build

# 或使用部署脚本
./deploy.sh

构建完成后会生成 .output/ 目录。

2. 上传到服务器

方式一：上传整个项目（推荐）

# 使用 rsync 上传（排除 node_modules）
rsync -avz --exclude 'node_modules' --exclude '.nuxt' --exclude '.git' \
  ./ user@your-server:/path/to/riwa-distribute/

# 或使用 scp
scp -r .output Dockerfile docker-compose.yml .dockerignore \
  user@your-server:/path/to/riwa-distribute/

方式二：使用 Git（推荐用于生产环境）

# 服务器上
git clone your-repo
cd riwa-distribute

# 本地构建后，将 .output 目录上传
rsync -avz .output/ user@your-server:/path/to/riwa-distribute/.output/

3. 服务器上启动

# SSH 登录到服务器
ssh user@your-server

# 进入项目目录
cd /path/to/riwa-distribute/

# 启动容器
docker-compose up -d

# 查看日志
docker-compose logs -f

# 查看运行状态
docker-compose ps

📊 访问应用

• 应用地址: http://your-server:3000
• API 健康检查: http://your-server:3000/api/version

🔧 常用命令

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

# 重启服务
docker-compose restart app

# 停止服务
docker-compose down

# 更新部署（本地构建后）
./deploy.sh
rsync -avz .output/ user@your-server:/path/to/riwa-distribute/.output/
docker-compose restart app

🎯 生产环境建议

使用 Nginx 反向代理

server {
    listen 80;
    server_name distribute.riwa.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

配置 SSL

# 使用 Let's Encrypt
sudo certbot --nginx -d distribute.riwa.com

环境变量配置

在服务器上创建 .env 文件：

NODE_ENV=production
HOST=0.0.0.0
PORT=3000

修改 docker-compose.yml 加载环境变量：

services:
  app:
    env_file:
      - .env

🔄 更新部署流程

# 1. 本地拉取最新代码
git pull origin main

# 2. 本地构建
pnpm run build

# 3. 上传构建产物
rsync -avz .output/ user@your-server:/path/to/riwa-distribute/.output/

# 4. 服务器重启
ssh user@your-server "cd /path/to/riwa-distribute && docker-compose restart app"

📈 监控和日志

# 实时日志
docker-compose logs -f app

# 查看最近 100 行日志
docker-compose logs --tail=100 app

# 查看容器状态
docker stats riwa-distribute

# 健康检查
curl http://localhost:3000/api/version

🐛 故障排查

容器无法启动

# 查看详细日志
docker-compose logs app

# 检查构建产物
ls -la .output/

# 重新构建镜像
docker-compose build --no-cache app

端口被占用

修改 docker-compose.yml 中的端口映射：

ports:
  - "8080:3000"  # 改为其他端口

🔐 安全建议

1. 使用非 root 用户运行容器
2. 配置防火墙规则
3. 启用 HTTPS
4. 定期更新 Docker 镜像
5. 使用环境变量管理敏感信息

📦 最小部署文件

如果只想上传最少文件，只需要：

.output/              # 构建产物（必需）
Dockerfile           # Docker 配置（必需）
docker-compose.yml   # Docker Compose 配置（必需）
.dockerignore        # 可选