J i y ' s   数 字 花 園

1. 在项目根目录创建 .github/workflows/deploy.yml

内容是：

1
name: Deploy
2

3
on:
4
  push:
5
    branches: [main]
6

7
jobs:
8
  build-and-deploy:
9
    runs-on: ubuntu-latest
10
    steps:
11
      - uses: actions/checkout@v4
12

13
      - uses: pnpm/action-setup@v2
14
        with:
15
          version: 8
16

17
      - name: Install & Build
18
        run: |
19
          pnpm install
20
          pnpm run build
21

22
      - name: Deploy via rsync
23
        uses: burnett01/rsync-deployments@6.0.0
24
        with:
25
          switches: -avz --delete
26
          path: dist/
27
          remote_path: /var/www/blog/
28
          remote_host: ${{ secrets.SERVER_HOST }}
29
          remote_user: jiy
30
          remote_port: 2222
31
          remote_key: ${{ secrets.SSH_PRIVATE_KEY }}

当你 push 到 main 分支时，GitHub 会自动：

1. 拉取你的代码

2. 安装 Node.js 20 和 pnpm 8

3. 执行 pnpm install 和 pnpm run build → 生成静态文件在 dist/

4. 用 rsync 把 dist/ 里的所有内容同步到服务器的 /var/www/blog/ 目录

所以你要确保：

• 代码仓库用 pnpm 管理（有 pnpm-lock.yaml）

• 服务器上有一个可以 SSH 免密登陆的用户（如 jiy）

• 该用户对 /var/www/blog/ 有写权限

2. GitHub 仓库配置 Secrets

1. 进入本项目的 GitHub 仓库 → Settings → Secrets and variables → Actions
2. 点击 New repository secret，添加以下两个：

私钥格式注意：打开 id_ed25519 文件，复制所有内容，包括开头的 -----BEGIN OPENSSH PRIVATE KEY----- 和结尾的 -----END OPENSSH PRIVATE KEY-----，原样粘贴

3. 推送代码触发部署

1. 确保你的博客代码已经推送到 GitHub 仓库的 main 分支（包括 .github/workflows/deploy.yml）。

2. 推送后，GitHub 会自动开始运行这个工作流。

3. 你可以在仓库的 Actions 标签页查看运行状态和日志。

如果一切顺利，构建完成后 rsync 会把 dist/ 内容同步到服务器的 /var/www/blog/ 目录

4. 验证服务器上的文件

1
ls -la /var/www/blog/

应该能看到 index.html、assets/ 等静态文件 先直接用 Python 临时服务器测试：

1
cd /var/www/blog
2
python3 -m http.server 8080

访问 http://服务器IP:8080 就能看到博客