Hexo+GitHub Pages一条龙

分类于 Other

使用Hexo搭建框架

Hexo是一个快速、简洁且高效的博客框架。Hexo使用Markdown（或其他标记语言）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

在学习使用Hexo搭建博客之前，可以先去Hexo的官方文档上看看，里面有较为详尽的搭建过程。

准备环境

安装Hexo之前需要安装Node.js和Git这两个应用程序。

通过查看版本号的方式来判断相关的应用程序是否安装成功。

查看node.js版本
node -v

查看npm版本
npm -v

使用淘宝镜像源（http://registry.npm.taobao.org），全局安装cnpm包到系统中，后续可以通过cnpm来加速npm包的安装过程。
npm install -g cnpm --registry=http://registry.npm.taobao.org

查看cnpm版本
cnpm -v

查看git版本
git -v

安装并使用Hexo

新建一个文件夹用于存放你的博客文件，右击该文件夹点击“Git Bush Here”。

安装Hexo
cnpm install -g hexo-cli

查看hexo版本
hexo -v

生成博客并初始化博客
hexo init

启动本地博客服务
hexo s

按照回显提示在浏览器中打开
http://localhost:4000/
即可在本地访问博客。

Ctrl+C停止服务，至此，你的博客已经在本地搭建完成了！

使用GitHub远端部署

在GitHub建立个人仓库
在Repository name一栏中
填写仓库名YourGithubName.github.io（YourGithubName为你的GitHub名称）
点击Create repository创建个人仓库

安装部署插件

在blog目录下打开Git Bush（右击文件夹）进行安装
cnpm install --save hexo-deployer-git

配置git身份

全局配置git身份
git config --global user.name "username"
git config --global user.email "email"

（将username和eamil换成的你的GitHub名称和邮箱）

配置本地ssh

在此使用ssh部署的方法，而不是https部署，避免了每次远端部署都需要输入账号密码的麻烦。

配置_config.yml

配置_config.yml文件中# Deployment项

1
2
3

type: 'git'
repo: git@github.com:YourGithubName/YourGithubName.github.io.git
branch: master

（YourGithubName为你的GitHub名称）

生成密钥

ssh-keygen -t rsa -C "GitHub邮箱"
一路回车，密钥将在C:\Users\用户名\ .ssh 下生成.

配置远端ssh

配置密钥

以下二选一即可。

全局

登陆 GitHub ，进入 Settings 页面，选择左边栏的 SSH and GPG keys，点击 New SSH key，添加公钥

1 2	Tiltle: 随便 Key: 公钥（id_rsa.pub中的内容）

点击 Add SSH key 完成添加。

仅博客

登陆 GitHub ，进入博客仓库的 Settings 页面，选择左边栏的 Deploy keys，点击 Add depoly key，添加公钥，公钥内容如上，要勾选 Allow write access，点击 Add key 完成添加。

验证连接

ssh -T git@github.com
窗口显示 “Are you sure……”
一路回车（Yes）.
显示 “Hi xxx! You’ve successfully authenticated……” 即连接成功.

hexo三连

每次部署都需进行hexo三连。
hexo cl && hexo g &&hexo d

远程访问博客

访问 https://YourGithubName.github.io
（YourGithubName为你的GitHub名称）
远端部署完成！

编写文章

博文存放于博客根目录下 source\_posts 文件夹里面。

写博文使用的语言是Markdown语言。

在此推荐的编辑器是Typora。

2021年11月，Typora 成为收费软件，法海之路论坛的大佬对此进行了补丁修复，由于一些原因，法海之路论坛原文内容已经下架，下面两个链接是镜像站的内容。
Typora - 法海之路 (joytion.cn)
Typora - 法海之路 (mhtsec.com)

更换主题

Themes | Hexo
Hexo 官方的主题库。

更换主题以及配置主题的方法在主题的相关说明文档中会有说明，在此不再进行赘述。

配置域名

购买域名

前往腾讯云注册域名

解析域名

添加解析记录

登入域名控制台选择对应域名点击解析.

点击添加记录添加两条记录.

记录一

主机记录 @
记录类型 CNAME
线路类型 默认
记录值 username.github.io(可访问自己博客的地址)
TTL（秒） 600

记录二

主机记录 www
记录类型 A
线路类型 默认
记录值 xxx.xxx.xxx.xxx（填写自己博客公网ip）
TTL（秒） 600

配置域名

仓库配置

进入对应的github仓库，点击settings,在Custom domain一栏内填写已解析的域名，点击save保存.
勾选强制https（Enforce HTTPS）.

本地配置

在博客项目根目录下source文件夹内用记事本打开CNAME（无后缀）文件，填写解析好的域名即可.

还有一些步骤需要跟随腾讯云的指引完成.

配置CDN

在此使用Netlify进行CDN的配置。

部署仓库

进入官网，注册并关联GitHub账号，进入后台管理页面
依次点击Sites-New site from Git-GitHub-Authorize Netlify by Netlify
选择好对应的仓库后进行授权
配置好相关信息后点击Deploy site完成部署
部署完成后，Netlify会自动生成一个随机的二级域名
你可以通过这个域名访问你的博客，也可以在Site Settings进行修改

配置域名

在Netlify控制台进入对应的项目
点击Set up a custom domain添加域名www.xxxxx.xxx
添加好后点击Verify完成验证

在自己购买的域名后台设置域名解析，可以删除之前的解析记录，添加新的两条CNAME记录
第一条 @ 随机的二级域名
第二条 www 随机的二级域名
至此配置完成