史上最全的 Hexo 博客搭建配置完全指南

欢迎到我的博客查看最新文章: https://blog.clouder.im

本篇博客基于 Centos 7.x root 用户.
　　最近利用 Hexo + Github Pages 搭建了一个博客, 总体来说比较满意, 中间也踩了不少坑. 于是将我的配置过程全部记录下来, 就有了这篇博文.
　　关于 Hexo 搭建配置的博文网上还是挺多的, 但是零零散散, 这篇博文就当成是一个大合集吧. 废话不多说, 下面开始我们的正篇.

搭建

准备环境

安装 Git

sudo yum install git-core

安装 Node.js

wget -qO- https://raw.github.com/creationix/nvm/master/install.sh | sh
source ~/.bash_profile
nvm install stable

安装 Hexo

mkdir hexo
npm install -g hexo-cli
cd hexo/
hexo init

测试服务

hexo server

这时你可以打开浏览器访问 http://localhost:4000 就可以看到你刚刚搭建成功的博客页面了. 当然如果你使用的是云服务器, 那么同样可以打开 (云服务器的 ip):4000 来访问博客.

将博客部署到 Github

把博客部署到 Github 是大多数站长的选择.

注册 Github 账号

首先你要有一个 Github 账号 (已有账号可以跳过), 点此前往注册. 输入你的邮箱和你起的用户名, 密码就可以注册了. 这里我们假设你的用户名为 yunwanjia-cloud 邮箱为 371622558@qq.com (下面所有出现用户名和邮箱的内容换成你自己的就好了).

设置 user.name 和 user.email

这里要给 git 设置变量.

git config --global user.name "yunwanjia-cloud"
git config --global user.email "371622558@qq.com"

配置 SSH 密匙

ssh-keygen -t rsa -C user.email
/root/.ssh/id_rsa

然后直接输入回车回车.
　　这时进入到 /root/.ssh/ 目录下查看 id_rsa.pub 文件, 你可以使用如下命令

vi /root/.ssh/id_rsa.pub

这时就用 vim 打开了该文件, 复制文件里的所有内容 (所有内容, 一个字符都不要漏) . 然后到 Github 添加 ssh 密匙.
　　点击 New SSH key 按钮进行添加

![](https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jZG4uanNkZWxpdnIubmV0L2doL3l1bndhbmppYS1jbG91Z
　　本篇博客基于 Centos 7.x root 用户.
　　最近利用 Hexo + Github Pages 搭建了一个博客, 总体来说比较满意, 中间也踩了不少坑. 于是将我的配置过程全部记录下来, 就有了这篇博文.
　　关于 Hexo 搭建配置的博文网上还是挺多的, 但是零零散散, 这篇博文就当成是一个大合集吧. 废话不多说, 下面开始我们的正篇.

搭建

准备环境

安装 Git

sudo yum install git-core

安装 Node.js

wget -qO- https://raw.github.com/creationix/nvm/master/install.sh | sh
source ~/.bash_profile
nvm install stable

安装 Hexo

mkdir hexo
npm install -g hexo-cli
cd hexo/
hexo init

测试服务

hexo server

这时你可以打开浏览器访问 http://localhost:4000 就可以看到你刚刚搭建成功的博客页面了. 当然如果你使用的是云服务器, 那么同样可以打开 (云服务器的 ip):4000 来访问博客.

将博客部署到 Github

把博客部署到 Github 是大多数站长的选择.

注册 Github 账号

首先你要有一个 Github 账号 (已有账号可以跳过), 点此前往注册. 输入你的邮箱和你起的用户名, 密码就可以注册了. 这里我们假设你的用户名为 yunwanjia-cloud 邮箱为 371622558@qq.com (下面所有出现用户名和邮箱的内容换成你自己的就好了).

设置 user.name 和 user.email

这里要给 git 设置变量.

git config --global user.name "yunwanjia-cloud"
git config --global user.email "371622558@qq.com"

配置 SSH 密匙

ssh-keygen -t rsa -C user.email
/root/.ssh/id_rsa

然后直接输入回车回车.
　　这时进入到 /root/.ssh/ 目录下查看 id_rsa.pub 文件, 你可以使用如下命令

vi /root/.ssh/id_rsa.pub

这时就用 vim 打开了该文件, 复制文件里的所有内容 (所有内容, 一个字符都不要漏) . 然后到 Github 添加 ssh 密匙.
　　点击 New SSH key 按钮进行添加


　　点击 Add SSH key确认添加.

创建仓库

在登陆状态下打开 Github 主页, 点击 New 创建新仓库.

　　这里要注意, 这个仓库的命名是有一定格式的, 格式是: 用户名.github.io,
比如我的就是 yunwanjia-cloud.github.io (还记得我之前说的吗, 出现用户名和邮箱通通换成你自己的就好了).

　　点击 Create repository 创建该仓库. 由于我已经创建了这个仓库, 所以有报错.

配置 _config.yml

进入到博客根目录 (也就是一个名字叫 hexo 的目录, 一般在你的主目录下),
打开一个名字叫 _config.yml 的文件, 找到 deploy 这个部分, 修改成如下内容:

deploy:
    type: git
    repo: git@github.com:yunwanjia-cloud/yunwanjia-cloud.github.io.git
    branch: master

保存一下. (将所有用户名和邮箱都改成自己的, 这已经是第三次提醒了哦~)

部署

清空静态页面

hexo cl

生成静态页面

hexo g

先运行下面这条命令否则直接部署会报错

npm install hexo-deployer-git --save

然后将 public 文件内容部署到 Github 仓库