0xav10086の部屋

1. GitHub 网页端设置：开启与保护#

由于我的仓库是 Fork 来的，GitHub 为了安全会默认锁定自动化脚本。

• 启用 Actions：必须手动进入仓库的 Actions 选项卡，点击 “I understand my workflows, go ahead and enable them” 才能激活工作流。

• 配置加密保险箱 (Secrets)：

  • 路径：Settings -> Secrets and variables -> Actions -> Repository secrets -> New repository secrets。

  • 原则：千万不要在代码中明文写入 IP、用户名或私钥。

  • 必填条目：SSH_HOST (IP)、SSH_USER (通常为 root)、SSH_KEY (完整的 私钥 内容)。

2. CI.yml 编写：自动化的指令集#

针对“本地构建 dist，GitHub 搬运”的需求，核心配置如下：

• 触发条件 (on)：设置为 push: branches: [master]，确保你每次 git push 都会触发部署。

• 搬运工具 (rsync)：推荐使用 Burnett01/rsync-deployments，因为它比单纯的 SSH 命令更擅长处理文件夹同步。

• 关键代码段：

1
    with:
2
      switches: -avzr --delete       # -a 同步属性, --delete 保持目标与源完全一致
3
      path: dist/                    # 仓库中的源目录
4
      remote_path: /var/www/blog      # VPS 上的目的地
5
      remote_host: ${{ secrets.SSH_HOST }}
6
      remote_user: ${{ secrets.SSH_USER }}
7
      remote_key: ${{ secrets.SSH_KEY }}

3. VPS 端设置：安全门禁与接收#

VPS 是部署的终点，必须配置好接收权限。

• SSH 密钥对：

  • 使用 ed25519 算法生成，更安全高效。

  • 公钥 (.pub) 必须存放在 VPS 的 ~/.ssh/authorized_keys 中。

  • 私钥 交给 GitHub Secrets。

• 权限规范（SSH 极其挑剔）：

  • ~/.ssh 目录：700。

  • authorized_keys 文件：600。

• 环境准备：

  • 手动创建目标目录：mkdir -p /var/www/blog。

  • 配置 Nginx：将 root 指向该目录，并使用 Certbot 开启 HTTPS。详细的配置过程可以参照how-to-configuration-HTTPS这篇教程。

1
# 生成密钥
2
ssh-keygen -t ed25519 -N "" -f ~/.ssh/id_ed25519 -C "github-actions-deploy"
3

4
# 信任该公钥
5
cat ~/.ssh/id_ed25519.pub >> ~/.ssh/authorized_keys
6

7
# 确保 .ssh 目录权限为 700
8
chmod 700 ~/.ssh
9

10
# 确保 authorized_keys 权限为 600
11
chmod 600 ~/.ssh/authorized_keys
12

13
# 确保 /root 或 /home/用户 目录没有赋予过高的组权限
14
chmod 755 /root

4. 验证工作是否修复#

你可以点击 GitHub 上的 “Run workflow”。如果权限配置正确，你会看到日志显示：

• 绿色对勾 (✔️)：恭喜，部署成功。

• 红色叉号 (❌)：出错了。点击进去看具体的错误日志（比如 Permission denied 或者 No such file or directory）。

当在 Actions 页面看到 红叉 (❌) 时，可以根据日志快速定位：

5. 终极工作流#

以后更新博客只需要：

1. 本地：写文章。

2. 本地：pnpm build（生成最新的 dist）。

3. 本地：git add . -> git commit -> git push。

4. 云端：GitHub 自动把文件推送到 VPS。

5. 结果：刷新 0xav10086.space 即可看到更新。