部署 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 文件,导致仓库的自定域名设置失效)