1
2
3
4
5

用户 → HTTPS(443) → Nginx → proxy_pass http://127.0.0.1:3000
                                      ↓
                              PM2 集群模式（4实例）
                                      ↓
                      Next.js Standalone Server

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

/var/www/stativo/
├── current/              → 符号链接，指向最新 release
├── previous/             → 符号链接，指向上一个 release（回滚用）
├── releases/             → 按时间戳命名的发布版本（保留最近3个）
│   ├── 20260918112041/   → 最新部署
│   │   ├── .next/standalone/  ← PM2 实际运行入口
│   │   ├── .env.production   ← 环境配置
│   │   ├── ecosystem.config.js ← PM2 配置
│   │   └── scripts/deploy-remote.sh ← 部署脚本
│   └── ...
└── shared/              ← SSL 验证等共享文件

1

ln -sfn $(readlink /var/www/stativo/previous) /var/www/stativo/current && pm2 reload stativo

1
2
3
4
5
6
7

NEXT_PUBLIC_SITE_NAME=wescores
NEXT_PUBLIC_SITE_DOMAIN=wescores.net
NEXT_PUBLIC_SITE_URL=https://wescores.net
NEXT_PUBLIC_API_URL=https://api.6wn.net/api
AUTH_API_URL=https://api.6wn.net/api
AUTH_TRUST_HOST=true
NEXTAUTH_URL=https://wescores.net

1
2
3
4

cd C:\projects\stativo
git add .
git commit -m "type(scope): description"
git status  # 确认 "working tree clean"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

# 0. 确保代码已提交
cd C:\projects\stativo
git status  # 应显示 "working tree clean"

# 1. 打包代码（git archive HEAD，只含已提交代码）
git archive --format=tar.gz HEAD -o "$env:TEMP\stativo-deploy.tar.gz"

# 2. 上传三个文件
scp -i "c:\Users\chang\.ssh\sg-xiangyu.pem" -o ConnectTimeout=15 -o ServerAliveInterval=5 `
  "$env:TEMP\stativo-deploy.tar.gz" ec2-user@52.77.230.213:/tmp/

scp -i "c:\Users\chang\.ssh\sg-xiangyu.pem" -o ConnectTimeout=15 -o ServerAliveInterval=5 `
  "C:\projects\stativo\.env.production" ec2-user@52.77.230.213:/tmp/

scp -i "c:\Users\chang\.ssh\sg-xiangyu.pem" -o ConnectTimeout=15 -o ServerAliveInterval=5 `
  "C:\projects\stativo\scripts\deploy-remote.sh" ec2-user@52.77.230.213:/tmp/

# 3. 执行部署
ssh -i "c:\Users\chang\.ssh\sg-xiangyu.pem" -o ConnectTimeout=15 -o ServerAliveInterval=5 `
  ec2-user@52.77.230.213 "bash /tmp/deploy-remote.sh"

1
2
3
4
5
6
7
8
9

[1/8] extracting... ✓
[2/8] copying env... ✓
[3/8] pnpm install... ✓
[4/8] pnpm build... ✓
[5/8] verifying standalone... ✓
[6/8] switching current... ✓
[7/8] PM2 restart... ✓ (4 instances online)
[8/8] health check... HEALTH_OK: HTTP 200
DEPLOY_SUCCESS: /var/www/stativo/releases/YYYYMMDDHHMMSS

1
2

ssh -i "c:\Users\chang\.ssh\sg-xiangyu.pem" ec2-user@52.77.230.213 `
  "ln -sfn `$(readlink /var/www/stativo/previous) /var/www/stativo/current && pm2 reload stativo"

1
2
3
4
5
6

# 上传到服务器并同步到 shared 目录
scp -i "c:\Users\chang\.ssh\sg-xiangyu.pem" `
  "C:\projects\stativo\.env.production" ec2-user@52.77.230.213:/tmp/.env.production

ssh -i "c:\Users\chang\.ssh\sg-xiangyu.pem" ec2-user@52.77.230.213 `
  "sudo cp /tmp/.env.production /var/www/stativo/shared/.env.production && sudo chown ec2-user:ec2-user /var/www/stativo/shared/.env.production && rm /tmp/.env.production"

1

ssh -i "c:\Users\chang\.ssh\sg-xiangyu.pem" ec2-user@52.77.230.213 "pm2 reload stativo --update-env"

1
2

ssh -i "c:\Users\chang\.ssh\sg-xiangyu.pem" ec2-user@52.77.230.213 `
  "ln -sfn `$(readlink /var/www/stativo/previous) /var/www/stativo/current && pm2 reload stativo"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# SSH 连接服务器
ssh -i "c:\Users\chang\.ssh\sg-xiangyu.pem" ec2-user@52.77.230.213

# 查看 PM2 状态
pm2 list

# 查看实时日志
pm2 logs stativo --lines 50

# 重启应用（不重新部署）
pm2 reload stativo --update-env

# 检查 Nginx 配置
sudo nginx -t && sudo systemctl reload nginx

# 查看健康状态
curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:3000
curl -s -o /dev/null -w '%{http_code}' https://wescores.net

# 查看当前 release
readlink -f /var/www/stativo/current

# 查看所有 releases
ls -lt /var/www/stativo/releases/

# 查看磁盘空间
df -h

1
2
3

Stage 1: deps        → 安装全量依赖（含 devDependencies），BuildKit 缓存 pnpm store
Stage 2: builder     → 复制源码，pnpm run build:prod，BuildKit 缓存 .next/cache
Stage 3: runner     → Alpine + dumb-init，复制 standalone 产物，非 root 用户运行

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

# 1. SSH 连接服务器
ssh -i "c:\Users\chang\.ssh\sg-xiangyu.pem" ec2-user@52.77.230.213

# 2. 安装 Docker + Docker Compose v2（如未安装）
sudo yum update -y
sudo yum install -y docker
sudo systemctl enable docker
sudo systemctl start docker
sudo usermod -aG docker ec2-user
# 重新登录使 docker 组生效
exit
ssh -i "c:\Users\chang\.ssh\sg-xiangyu.pem" ec2-user@52.77.230.213
docker --version  # 验证安装

# 3. git clone 项目（如服务器上没有）
cd ~
git clone <仓库地址> stativo
cd ~/stativo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

cd ~/stativo/.docker
cp env.example env.docker
vi env.docker
# 填入真实值，参考 .env.production（域名 wescores.net、API 地址、鉴权密钥等）
# 关键项：
#   NEXT_PUBLIC_SITE_URL=https://wescores.net
#   NEXTAUTH_URL=https://wescores.net
#   AUTH_TRUST_HOST=true
#   NEXTAUTH_SECRET=NIUGOyvfaUH2Aq5DA75E9+Lh/nUy7jxxrvK2qeHdLwg=
#   AUTH_GOOGLE_ID=428668096460-mdonea4qtvcoacvqru8vrvf8mkia9n75.apps.googleusercontent.com

1
2
3
4

pm2 delete stativo
pm2 save
# 可选：如不再使用 PM2，卸载
# npm uninstall -g pm2

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

cd ~/stativo

# 拉取最新代码
git pull origin main

# 构建并启动（不启用 SSL profile）
docker compose -f .docker/docker-compose.yml up -d --build

# 等待健康检查（约 40 秒）
docker compose -f .docker/docker-compose.yml ps
# 状态应显示 "healthy"

# 验证
curl -s -o /dev/null -w '%{http_code}' http://localhost:3000
# 应返回 200

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

cd ~/stativo

# 确保域名 DNS 已指向服务器
dig wescores.net  # 应解析到 52.77.230.213

# 停止占用 80 端口的服务
sudo systemctl stop nginx  # 如有系统 Nginx

# 签发证书（6 步自动化）
bash .docker/init-ssl.sh
# 脚本会：
#   1. 停止现有容器
#   2. 创建 certbot 目录
#   3. 启动临时 Nginx 处理 ACME 验证
#   4. Certbot 签发证书
#   5. 清理临时 Nginx
#   6. 验证证书文件

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

cd ~/stativo

# 启动（含 SSL profile：应用 + Nginx + Certbot）
docker compose -f .docker/docker-compose.yml --profile ssl up -d --build

# 查看容器状态
docker compose -f .docker/docker-compose.yml --profile ssl ps
# 应看到 3 个容器：stativo-web (healthy), stativo-nginx, stativo-certbot

# 验证
curl -s -o /dev/null -w '%{http_code}' https://wescores.net
# 应返回 200

1
2
3

.docker/certbot/conf/live/wescores.net/
├── fullchain.pem
└── privkey.pem

1
2
3
4
5
6

# 服务器上执行
cd ~/stativo
git pull origin main
docker compose -f .docker/docker-compose.yml up -d --build
# 或如使用 SSL profile：
# docker compose -f .docker/docker-compose.yml --profile ssl up -d --build

1
2

cd C:\projects\stativo
ssh -i "c:\Users\chang\.ssh\sg-xiangyu.pem" ec2-user@52.77.230.213 "cd ~/stativo && git pull origin main && docker compose -f .docker/docker-compose.yml up -d --build"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

# 查看容器状态
docker compose -f .docker/docker-compose.yml ps
# 含 SSL：docker compose -f .docker/docker-compose.yml --profile ssl ps

# 查看应用日志
docker compose -f .docker/docker-compose.yml logs -f stativo

# 重启应用容器
docker compose -f .docker/docker-compose.yml restart stativo

# 停止全部容器
docker compose -f .docker/docker-compose.yml down
# 含 SSL：docker compose -f .docker/docker-compose.yml --profile ssl down

# 重建（无缓存，解决构建缓存问题）
docker compose -f .docker/docker-compose.yml build --no-cache
docker compose -f .docker/docker-compose.yml up -d

# 进入容器调试
docker exec -it stativo-web sh

# 查看容器资源使用
docker stats stativo-web

# 清理构建缓存（释放磁盘）
docker builder prune -f

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