部署 Hexo

 · 2020-5-29 · 次阅读


部署 Hexo

部署到 GitHub

#准备工作

如果没有账号,请点此前往 GitHub 注册一个 GitHub 账号。

新建一个公开仓库,仓库名格式为 your_username.github.io 例如你的 GitHub 用户名是 easyhexo ,那么你的仓库地址名称就应该是 easyhexo.github.io

创建完成后记下该仓库的 HTTPS/SSH 地址,一般格式为 https://github.com/your_username/your_reponame.git 在下一步会用到。

安装部署插件

$ npm install hexo-deployer-git --save
$ npm install hexo-server --save

配置 Git

如果你只是安装好了 Git 但没有配置过你的 Git ,那么现在需要做的第一件事情就是设置你的 Git 用户名和邮箱。 在 Git Bash 中执行以下两条命令配置你的用户名和邮箱,这里建议用户名和邮箱与你的 GitHub 用户名和邮箱保持一致。

$ git config --global user.name "Your_user_name"
$ git config --global user.email Your_email@example.com

提醒

每次 Git 提交时都会附带这两条信息,用于记录是谁提交的更新,并且会随更新内容一起被记录到历史记录中。简单说,是用来标记的你的身份的~

配置站点 _config.yml 文件

deploy:
  type: git # 类型填git
  repo: <repository url> # 你的Github仓库地址
  branch: master # 分支名称。默认填写 master 如果您使用的是 GitHub ,程序会尝试自动检测。
  message: # 提交信息可以自定义,不填的则默认为提交时间

发布到 GitHub

在本地的 Hexo 站点根目录下,执行如下命令即可部署到 GitHub Pages 上。

$ hexo clean && hexo d -g

提醒

如果是第一次使用,会弹出一个登录框,需要登录你的 GitHub 账号。

自定义域名

如果你拥有个人域名,请用 A 记录解析到以下 IP 中的任意一个。如果使用 CNAME 请解析到你的 GitHub 仓库名称。

  • 185.199.108.153
  • 185.199.109.153
  • 185.199.110.153
  • 185.199.111.153

参考表格

记录类型 主机记录 解析路线 记录值 MAX 优先级 TTL(秒)
A @ 默认 185.199.110.153 - 600
CNAME @ 默认 GitHub博客仓库名称 - 600

打开仓库设置,找到 GitHub Pages 项目,修改 Custom domain 选项的值为你的自定义域名(不带 http 等前缀)

勾选 Custom domain 选项下的 Enforce HTTPS 选项,强制开启 Https 。如果遇到 Enforce HTTPS 选项无法打开,可以稍等一会儿再尝试。

提醒

同时需要在本地的 source 目录新建一个 CNAME 文件,内容为你的自定义域名(不带 http 等前缀)。否则无法使用自定义域名功能( hexo d 生成的文件没有 CNAME 文件,导致仓库的自定域名设置失效)