1。优化后的部署架构#

这个架构避开了 GitHub Actions 编译慢的问题，同时解决了时区和 draft: true 的烦恼：

1. GitHub Action：仅作为一个 ” 开关 “，通过 SSH 登录 VPS。

2. Debian VPS：拉取最新的 source 代码，在本地环境用 pnpm 快速增量编译。

3. Caddy / Nginx：在 VPS 上直接指向 dist 文件夹。

4. Cloudflare Tunnel：将穿透流量导向 VPS 本地的 80/443 端口。

2。更新你的 deploy.yml#

你可以将原来的构建步骤全部删掉，改为一个极简的 SSH 触发脚本。请在 GitHub Secrets 中确保 SSH_ID_RSA 依然有效：

YAML

1
name: Deploy to VPS via SSH
2

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

7
jobs:
8
  deploy:
9
    runs-on: ubuntu-latest
10
    steps:
11
      - name: Execute remote commands via SSH
12
        uses: appleboy/ssh-action@v1.0.3
13
        with:
14
          host: ${{ secrets.VPS_HOST }}      # 你的 VPS IP
15
          username: ${{ secrets.VPS_USER }}  # 你的 VPS 用户名 (如 root)
16
          key: ${{ secrets.SSH_ID_RSA }}     # 你的 SSH 私钥
17
          script: |
18
            cd /var/www/GitBlog
19
            git pull origin main
20
            # 这里的 pnpm 命令直接在 VPS 环境运行，速度极快
21
            pnpm install
22
            pnpm run build
23
            # 编译完后，Caddy 会自动识别 dist 里的新内容，无需重启

3。VPS 上的环境准备 (一次性配置)#

在你的 Debian VPS 上，需要手动完成以下前置操作：

1. 克隆仓库：

   Bash

   1
   mkdir -p /var/www && cd /var/www
   2
   git clone git@github.com:yourname/static-blog-source.git GitBlog
   

2. 安装 Node/pnpm：

   Bash

   1
   curl -fsSL https://get.pnpm.io/install.sh | sh -
   2
   # 确保 Node 版本是 22+
   

3. 配置 Caddy (推荐)：

   Caddy 是目前最简单的静态服务器，配置文件 Caddyfile 只需要两行：

   Code snippet

   1
   :8080 {
   2
       root * /var/www/GitBlog/dist
   3
       file_server
   4
   }
   

4. Cloudflare Tunnel：

   将隧道指向 http://localhost:8080 即可。

4。这种方案的巨大优势#

• 真正的实时性：VPS 上的 pnpm 拥有本地缓存，编译速度通常比 GitHub Actions 快 3-5 倍。

• 彻底解决时区问题：只要你的 Debian 系统时间是正确的 (Asia/Shanghai)，Astro 编译时就会严格遵守你的时间，不再有 ” 文章失踪 ” 的情况。

• 调试极其方便：如果编译报错，你可以直接连上 VPS 查看日志，甚至手动运行 pnpm build 复现问题。

5。避坑指南：SSH 权限#

确保你的 VPS 能够免密拉取 GitHub 仓库。你需要在 VPS 上生成一对新的 SSH Key，并将公钥添加到 GitHub 仓库的 Deploy Keys 中。

这样 GitHub Action 触发 git pull 时，VPS 才能顺利拿到最新的代码。