上传到仓库并部署云服务商

一、引言

　　“博客写好了，却困在本地？5分钟教你把Hexo一键部署到GitHub Pages，让全世界看到你的文章！”
　　你已经完成了Hexo的本地搭建，现在只差最后一步——将它推送到GitHub Pages，让你的博客正式上线。这篇指南将手把手教你配置Git部署、绑定域名、实现自动化发布，无需复杂的服务器知识，完全免费！

二、准备工作

1.1 创建Github仓库

  1. 登录GitHub，点击右上角 + → New repository

  2. 仓库名称格式： 你的用户名.github.io （必须完全匹配用户名）

  3. 选择 Public（公共），勾选 Add a README file，后期可以改成Private（私人）的，如果用Vercel、Netilfy。

  4. 点击 Create repository

  5. 2 安装Git部署插件

  6. 在Hexo站点根目录打开终端，执行：

1
npm install hexo-deployer-git --save

三、配置部署参数

3.1 生成SSH密钥（本地终端）

1
2
3
4
ssh-keygen -t ed25519 -C "你的GitHub注册邮箱"
# 或旧系统用：ssh-keygen -t rsa -b 4096 -C "你的邮箱"

# 一路回车，使用默认路径

3.2 添加公钥到GitHub

1
2
3
# 复制公钥内容
cat ~/.ssh/id_ed25519.pub
# Windows: type %userprofile%\.ssh\id_ed25519.pub
  1. GitHub → 右上角头像 → Settings → SSH and GPG keys
  2. New SSH key → 粘贴公钥 → 标题写”Hexo Deploy” → Add SSH key

3.3 测试SSH连接
3.1 修改 _config.yml

1
2
3
4
5
6
7
# 部署配置（注意缩进）
deploy:
  type: git
  repo: git@github.com:你的用户名/你的用户名.github.io.git  # SSH地址！
  branch: main
  # 可选：自定义提交信息
  # message: "update: {{ now('YYYY-MM-DD HH:mm:ss') }}"

⚠️ repo必须用SSH格式 git@github.com:… 而不是HTTPS

四、执行命令

1
2
3
4
5
# 清除缓存 → 生成 → 部署
hexo clean && hexo generate && hexo deploy

# 或简写
hexo clean && hexo g -d

部署成功标志：

1
2
3
4
5
6
7
8
9
10
INFO  Validating config
INFO  Deploying: git
INFO  Setting up Git deployment...
INFO  Clearing .deploy_git folder...
INFO  Copying files from public folder...
INFO  文件列表...
[main xxxxxx] Site updated: 2024-XX-XX ...
To github.com:你的用户名/你的用户名.github.io.git
   xxxxxx..xxxxxx  main -> main
INFO  Deploy done: git

五、开启 Github Pages

5.2 ⚠️ 关键：手动开启GitHub Pages
这是必须的！ 新仓库默认不自动开启Pages：

  1. 进入仓库 → Settings → 左侧 Pages
  2. Source 选择 Deploy from a branch
  3. Branch 选择 main → 文件夹选 /(root) → 点击 Save
  4. 看到绿色提示 “Your site is ready to be published at…” 即开启成功.

五、验证上线

  1. 等待2-5分钟（GitHub构建需要时间）
  2. 访问 https://你的用户名.github.io
  3. 仓库 → Actions 标签页可查看构建进度