📌 目录#

1. 为什么使用 SSH
2. 生成 SSH Key
3. 将公钥添加到 GitHub
4. 测试 SSH 连接
5. 克隆主仓库
6. 写文章
7. 提交并推送
8. 验证部署结果
9. 多人协作写作流程
10. 多设备写作建议
11. 多账号协作建议
12. 国内环境使用技巧
13. SSH 常见问题排查
14. 仓库结构说明
15. 自动化部署说明
16. 安全注意事项

🌟 为什么使用 SSH#

SSH 是 GitHub 官方推荐的方式，因为：

• 一次配置，永久免密
• 国内访问更稳定
• 不依赖 GitHub 网页
• 多设备写作更方便
• 安全性更高

🌟 生成 SSH Key#

在新电脑执行：

1
ssh-keygen -t ed25519 -C "你的邮箱"

一路回车即可。

生成的文件：

1
~/.ssh/id_ed25519        # 私钥（不能泄露）
2
~/.ssh/id_ed25519.pub    # 公钥（要添加到 GitHub）

🌟 将公钥添加到 GitHub#

在手机或任意能打开 GitHub 的设备：

1. GitHub → Settings
2. 左侧：SSH and GPG keys
3. 点击 New SSH key
4. 粘贴 id_ed25519.pub 内容
5. 保存

🌟 测试 SSH 连接#

回到电脑终端：

1
ssh -T git@github.com

看到：

1
Hi acuherb! You've successfully authenticated

表示成功。

用下面命令告诉git你是谁，要不然推送不过去 git config —global user.name “acuherb” git config —global user.email “209729051+acuherb@users.noreply.github.com”

🌟 克隆主仓库#

你要克隆的是写作仓库：

1
git clone git@github.com:acuherb/acuherb-blog.git

⚠ 必须使用 SSH 地址，不要用 HTTPS。

克隆后目录结构示例：

1
acuherb/
2
  content/
3
  layouts/
4
  assets/
5
  hugo.toml
6
  .github/workflows/

🌟 写文章#

文章放在：

1
content/posts/

你可以：

• 新建 .md
• 修改已有文章
• 使用 publishDate 写未来文章
• 使用 Hugo frontmatter 设置标签、分类、封面等

示例 frontmatter：

1
---
2
title: "文章标题"
3
date: 2025-01-01
4
publishDate: 2025-02-01
5
tags: ["tag1", "tag2"]
6
categories: ["category"]
7
---

🌟 提交并推送#

1
git add .
2
git commit -m "add new post"
3
git push

push 成功后：

• GitHub Actions 自动构建
• 自动部署到 acuherb.github.io
• 未来文章按 publishDate 自动上线

🌟 验证部署结果#

打开：

https://acuherb.xyz

• publishDate 是过去 → 立即上线
• publishDate 是未来 → 定时构建时自动上线

🌟 多人协作写作流程#

多人写作时的黄金法则：

1
git pull --rebase

1
git add .
2
git commit -m "更新了文章：xxx"

1
git push

1
Updates were rejected because the remote contains work that you do not have locally.

1
git pull --rebase
2
git push

🌟 多设备写作建议#

• 每台电脑生成自己的 SSH key
• 每台电脑都添加 .pub 到 GitHub
• 每台电脑都用 SSH 地址克隆仓库
• 设置统一 Git 信息：

1
git config --global user.name "acuherb"
2
git config --global user.email "你的主邮箱"

🌟 多账号协作建议#

你有两个账号（主账号 + 副账号），建议：

这样：

• 两个账号都能 push
• 不会混淆权限
• 不影响安全性

🌟 国内环境使用技巧#

国内访问 GitHub 网页不稳定，但 SSH 通常能用。

如果 SSH 22 端口不通，可以改用 443：

编辑：

1
~/.ssh/config

添加：

1
Host github.com
2
  Hostname ssh.github.com
3
  Port 443
4
  User git

几乎 100% 能连。

🌟 SSH 常见问题排查#

1
git remote -v

1
git@github.com:acuherb/acuherb.git

🌟 仓库结构说明#

你的系统采用双仓库结构：

你只需要操作主仓库。

🌟 自动化部署说明#

GitHub Actions 会：

• 监听 push
• 自动构建 Hugo
• 自动推送到 acuherb.github.io
• 定时构建（未来文章自动上线）

你不需要手动部署。

🌟 安全注意事项#

• 不要泄露私钥 id_ed25519
• 不要把别人加入部署仓库
• 不要手动修改 acuherb.github.io
• 不要用 HTTPS 克隆仓库
• 不要把私钥复制到多台电脑