从零到一：GitHub Actions + Caddy 全自动部署静态网站实战

# 更新系统包
sudo apt update && sudo apt upgrade -y

# 安装 Caddy（现代化的 Web 服务器，自动 HTTPS）
sudo apt install caddy

# 安装 Node.js 环境
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

# 创建网站根目录并授权
sudo mkdir -p /var/www/my-site
# 注意：请务必将 `caddy` 用户替换为你的实际用户名
sudo chown -R caddy:caddy /var/www/my-site
sudo chmod -R 755 /var/www/my-site

sudo nano /etc/caddy/Caddyfile

# /etc/caddy/Caddyfile
example.com, www.example.com {
    # 网站根目录（必须与后续自动化部署的目录一致）
    root * /var/www/my-site
    # 启用静态文件服务器
    file_server
    # 对单页应用(SPA)至关重要：使前端路由正常工作
    try_files {path} /index.html
    # 启用压缩
    encode gzip zstd
}

# 检查配置语法
sudo caddy validate --config /etc/caddy/Caddyfile
# 重启服务
sudo systemctl restart caddy
# 检查服务状态
sudo systemctl status caddy

# 生成一对新的密钥，专用于自动化部署
ssh-keygen -t ed25519 -f ~/.ssh/id_github_actions -N ""

这将生成两个文件：

- **私钥** (`~/.ssh/id_github_actions`)：**绝密**，相当于你的“钥匙”。

- **公钥** (`~/.ssh/id_github_actions.pub`)：可以公开，相当于“锁芯”。

name: Deploy to Production

on:
  push:
    branches: [ main ] # 仅在推送到 main 分支时触发

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest

    steps:
      # 1. 拉取代码
      - name: Checkout code
        uses: actions/checkout@v4

      # 2. 设置 Node.js 环境 (以 Nuxt 项目为例)
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '24' # 使用你项目所需的 Node 版本
          cache: 'pnpm' # 如果用 npm 则改为 'npm'

      # 3. 安装依赖
      - name: Install dependencies
        run: pnpm install

      # 4. 打包文件
      - name: Build
        run: pnpm run build # 这会生成 .output 目录

      # 4. 将构建产物同步到云服务器
      - name: Deploy to Server via Rsync
        uses: burnett01/rsync-deployments@7.0.1
        with:
          switches: -avz --delete # 递归、压缩、同步删除（保持两端完全一致）
          path: .output/public/ # Nuxt 静态文件输出目录
          remote_path: /var/www/my-site/ # 服务器目标目录，必须与 Caddyfile 中配置一致
          remote_host: ${{ secrets.SERVER_HOST }}
          remote_user: ${{ secrets.SERVER_USER }}
          remote_key: ${{ secrets.SSH_PRIVATE_KEY }}

**关键配置说明**：

- `path`: 你的静态网站构建输出目录。对于其他框架：

    - VitePress: `docs/.vitepress/dist/`

    - Next.js (SSG): `out/`

    - Vue CLI: `dist/`

    - Hugo: `public/`

- `remote_path`: 必须与服务器上 Caddy 配置的 `root` 目录完全一致。

- `switches: --delete`: 确保服务器上的文件是构建结果的精确镜像，自动删除多余文件。

git add .github/workflows/deploy.yml
git commit -m “feat: 添加自动化部署工作流”
git push origin main

# 查看 Caddy 实时日志
sudo journalctl -u caddy -f

# 查看 SSH 认证日志（排查连接问题）
sudo tail -f /var/log/auth.log