217 lines
3.9 KiB
Markdown
217 lines
3.9 KiB
Markdown
# Docker 部署指南
|
||
|
||
Riwa App 分发页使用预构建模式部署，无需在服务器上安装依赖，快速启动。
|
||
|
||
## 📋 前置要求
|
||
|
||
- 本地环境: Node.js 20+, pnpm
|
||
- 服务器环境: Docker, Docker Compose
|
||
|
||
## 🚀 快速部署
|
||
|
||
### 1. 本地构建
|
||
|
||
```bash
|
||
# 安装依赖
|
||
pnpm install
|
||
|
||
# 构建生产版本
|
||
pnpm run build
|
||
|
||
# 或使用部署脚本
|
||
./deploy.sh
|
||
```
|
||
|
||
构建完成后会生成 `.output/` 目录。
|
||
|
||
### 2. 上传到服务器
|
||
|
||
#### 方式一：上传整个项目（推荐）
|
||
|
||
```bash
|
||
# 使用 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（推荐用于生产环境）
|
||
|
||
```bash
|
||
# 服务器上
|
||
git clone your-repo
|
||
cd riwa-distribute
|
||
|
||
# 本地构建后，将 .output 目录上传
|
||
rsync -avz .output/ user@your-server:/path/to/riwa-distribute/.output/
|
||
```
|
||
|
||
### 3. 服务器上启动
|
||
|
||
```bash
|
||
# 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
|
||
|
||
## 🔧 常用命令
|
||
|
||
```bash
|
||
# 查看日志
|
||
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 反向代理
|
||
|
||
```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
|
||
|
||
```bash
|
||
# 使用 Let's Encrypt
|
||
sudo certbot --nginx -d distribute.riwa.com
|
||
```
|
||
|
||
### 环境变量配置
|
||
|
||
在服务器上创建 `.env` 文件：
|
||
|
||
```env
|
||
NODE_ENV=production
|
||
HOST=0.0.0.0
|
||
PORT=3000
|
||
```
|
||
|
||
修改 `docker-compose.yml` 加载环境变量：
|
||
|
||
```yaml
|
||
services:
|
||
app:
|
||
env_file:
|
||
- .env
|
||
```
|
||
|
||
## 🔄 更新部署流程
|
||
|
||
```bash
|
||
# 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"
|
||
```
|
||
|
||
## 📈 监控和日志
|
||
|
||
```bash
|
||
# 实时日志
|
||
docker-compose logs -f app
|
||
|
||
# 查看最近 100 行日志
|
||
docker-compose logs --tail=100 app
|
||
|
||
# 查看容器状态
|
||
docker stats riwa-distribute
|
||
|
||
# 健康检查
|
||
curl http://localhost:3000/api/version
|
||
```
|
||
|
||
## 🐛 故障排查
|
||
|
||
### 容器无法启动
|
||
|
||
```bash
|
||
# 查看详细日志
|
||
docker-compose logs app
|
||
|
||
# 检查构建产物
|
||
ls -la .output/
|
||
|
||
# 重新构建镜像
|
||
docker-compose build --no-cache app
|
||
```
|
||
|
||
### 端口被占用
|
||
|
||
修改 `docker-compose.yml` 中的端口映射：
|
||
|
||
```yaml
|
||
ports:
|
||
- "8080:3000" # 改为其他端口
|
||
```
|
||
|
||
## 🔐 安全建议
|
||
|
||
1. 使用非 root 用户运行容器
|
||
2. 配置防火墙规则
|
||
3. 启用 HTTPS
|
||
4. 定期更新 Docker 镜像
|
||
5. 使用环境变量管理敏感信息
|
||
|
||
## 📦 最小部署文件
|
||
|
||
如果只想上传最少文件，只需要：
|
||
|
||
```
|
||
.output/ # 构建产物（必需）
|
||
Dockerfile # Docker 配置（必需）
|
||
docker-compose.yml # Docker Compose 配置（必需）
|
||
.dockerignore # 可选
|
||
```
|