# 用密码（首次连上时）
ssh root@1.2.3.4
 
# 用 SSH Key（推荐，配过一次永久免密）
ssh root@1.2.3.4

# 推荐结构
/var/www/my-app/
├── releases/                # 每次部署一个独立目录（版本管理）
│   ├── 2026-07-09-10-30-00/ # 第 N 次部署
│   │   ├── .git/
│   │   ├── node_modules/
│   │   └── ...
│   └── 2026-07-08-15-20-00/
├── shared/                  # 所有版本共享的文件
│   ├── .env                 # 环境变量
│   └── uploads/             # 用户上传的文件
└── current → releases/2026-07-09-10-30-00/   # 软链接，指向当前活跃版本

# 简单版本——一个目录搞定
sudo mkdir -p /var/www/my-app
sudo chown -R $USER:$USER /var/www/my-app
cd /var/www/my-app
 
git clone git@github.com:coyafky/my-app.git .
npm install
npm run build

# 在服务器上生成 key（邮箱换成你自己的）
ssh-keygen -t ed25519 -C "server-deploy-key"
 
# 把公钥贴到 GitHub：Settings → Deploy keys → Add deploy key
cat ~/.ssh/id_ed25519.pub
# 勾 "Allow write access" 如果你要 push（一般只勾 read 即可）

#!/bin/bash
# deploy.sh — 最简单的部署脚本
 
set -e
 
APP_DIR=/var/www/my-app
cd $APP_DIR
 
echo "→ 拉取最新代码"
git pull origin main
 
echo "→ 安装依赖"
npm ci    # ci 比 install 更严格（按 lockfile 安装）
 
echo "→ 构建"
npm run build
 
echo "→ 重启应用"
pm2 reload my-app || pm2 start ecosystem.config.js
 
echo "✓ 部署完成"

# 设置目录权限
chmod 755 /var/www/my-app             # 目录
chmod 644 /var/www/my-app/index.html  # 文件
 
# 设置所有者
chown -R www-data:www-data /var/www/my-app
 
# 设置 .env 私密
chmod 600 /var/www/my-app/.env
chown www-data:www-data /var/www/my-app/.env

# 看当前用户
whoami
# 输出：root  或  deploy  或  ubuntu
 
# www-data 是什么
# www-data 是 Nginx / Apache 默认的「服务用户」
# 你的应用进程和 Nginx 都用这个用户访问文件 → 文件所有者必须 www-data

# 看当前 umask
umask
# 输出：0022
 
# umask = 「默认要减去的权限」
# 目录默认 777 - 022 = 755
# 文件默认 666 - 022 = 644

# Ubuntu / Debian
sudo apt update
sudo apt install nginx -y
 
# CentOS / RHEL
sudo yum install nginx -y
 
# 启动 + 开机自启
sudo systemctl start nginx
sudo systemctl enable nginx
 
# 检查状态
sudo systemctl status nginx
 
# 看版本
nginx -v
# nginx version: nginx/1.24.0

# /etc/nginx/sites-available/my-app.conf
 
server {
    listen 80;                                  # 监听 80 端口（HTTP）
    server_name example.com www.example.com;    # 你的域名
 
    # 静态资源：直接由 Nginx serve
    location /static/ {
        alias /var/www/my-app/public/static/;   # 文件实际路径
        expires 30d;                            # 缓存 30 天
    }
 
    # 其他请求：反向代理到应用
    location / {
        proxy_pass http://127.0.0.1:3000;       # 应用监听在 3000
        proxy_set_header Host $host;
        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;
    }
}

# 建软链接启用
sudo ln -s /etc/nginx/sites-available/my-app.conf /etc/nginx/sites-enabled/
 
# 测试配置语法
sudo nginx -t
 
# 重载 Nginx
sudo systemctl reload nginx

location / {
    try_files $uri $uri/ /index.html;    # ← 这一行是关键
    # 解释：
    #   $uri  → 试这个路径对应的文件
    #   $uri/ → 试这个路径作为目录
    #   /index.html → 都找不到的话 → 用 index.html 兜底
}

# 安装
sudo apt install certbot python3-certbot-nginx -y
 
# 一键签证书 + 自动改 Nginx 配置 + 自动续期
sudo certbot --nginx -d example.com -d www.example.com

# certbot 自动加的 server 块
server {
    listen 443 ssl;                                          # HTTPS 端口
    server_name example.com www.example.com;
 
    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
 
    # SSL 优化（certbot 默认会加）
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
 
    # ... 你的 location 配置 ...
}
 
# certbot 自动加的 HTTP→HTTPS 重定向
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

# 模拟续期（不会真续，只跑流程）
sudo certbot renew --dry-run
 
# 看续期 timer
systemctl list-timers | grep certbot
 
# 通常输出：
# Tue 2026-08-07 03:42:00 UTC  27 days Tue 2026-07-07 03:42:09 UTC  certbot.timer

# 在 GitHub repo: Settings → Secrets and variables → Actions
# 加一个 Secret: SSH_PRIVATE_KEY（值是 ~/.ssh/id_ed25519 私钥内容）

name: Deploy to Production
 
on:
  push:
    branches: [main]            # main 分支 push 触发
 
jobs:
  deploy:
    runs-on: ubuntu-latest
 
    steps:
      # 1. 检出代码
      - name: Checkout
        uses: actions/checkout@v4
 
      # 2. SSH 到服务器跑部署脚本
      - name: Deploy via SSH
        uses: appleboy/ssh-action@v1
        with:
          host: ${{ secrets.SERVER_HOST }}      # 服务器 IP
          username: ${{ secrets.SERVER_USER }}  # 部署用户名
          key: ${{ secrets.SSH_PRIVATE_KEY }}
          script: |
            cd /var/www/my-app
            ./deploy.sh

#!/bin/bash
set -e
 
cd /var/www/my-app
 
echo "→ 拉取最新代码"
git pull origin main
 
echo "→ 安装依赖"
npm ci
 
echo "→ 构建"
npm run build
 
echo "→ 重启应用"
pm2 reload my-app
 
echo "✓ 部署完成 $(date)"

upstream my_app {
    server 127.0.0.1:3000;   # 当前活跃
    # server 127.0.0.1:3001; # 下一版（部署完切到这个）
}