Hexo建站指南

下载安装必要工具

git

搭建网站需要进行版本管理，故下载 git 进行使用。

下载网址： https://www.git-scm.com/download

使用说明可参考 git 官方文档：https://www.git-scm.com/doc

• 安装时，一键 next 即可
• 安装后，在文件夹内或桌面点击鼠标右键，若出现如下工具，则证明安装成功:

Node.js

Hexo 是基于 Node.js 编写的，所以需要安装一下 Node.js 和里面的 npm 工具。

网址：https://nodejs.org/en/download/

安装后检查是否安装成功

• win+R 打开运行，输入cmd：

• 检查 node.js 和 npm 是否安装成功：

hexo

hexo 即为此次搭建网站的框架

安装

• 创建一个文件夹，名字任取，作为以后网站所有文件的存储地，即本地仓库

• 进入文件夹，按住shift键点击鼠标右键，win10 选择“在此处打开 powershell 窗口”，win7 选择“在此处打开命令窗口”

• 输入命令

  1	npm install -g hexo-cli

• 安装结束，输入命令检查是否安装成功

  1

  hexo -v

初始化 hexo

• 初始化 hexo 框架

  1

  hexo init

  初始化后一般在博客文件夹会出现以下文件：

• 在文件夹内安装 npm 相关组件

  1	npm install

• 生成页面

  1

  hexo g

• 本地服务器打开查看页面

  1

  hexo s

• 若出现此页面，证明生成页面成功

  

• ctrl+C关掉本地

使用 Github 作为服务器部署 hexo 网站

配置 github

• 若没有 github 账号，则首先需要注册

  网址：https://github.com/

• 新建仓库，点击页面右上角+，新建仓库 repository

  

• 填入信息，注意仓库名必须为：你的 github 用户名.github.io

  例如：ChangeZ24.github.io

  

• 在 blog 目录内点击鼠标右键，选择在此处打开 git Bash

• 生成 SSH key

  SSH key 提供了一种与 GitHub 通信的方式，通过这种方式，能够在不输入密码的情况下，将 GitHub 作为自己的 remote 端服务器，进行版本控制

  输入命令生成 SSH key

  1 2 3 4 5 6

  git config --global user.name "github用户名" git config --global user.email "github登陆邮箱" //可以使用此命令检查是否输入正确 git config user.name git config user.email

• 创建 SSH key

  1	ssh-keygen -t rsa -C "github登陆邮箱"

  创建完成后会在我的电脑 C 盘出现 id_rsa、id_rsa.pub 文件

  

• 打开 id_rsa.pub 文件，复制里面全部内容（即 key）

• 打开 github 导入 key

  

  

  

  新建时 SSHkey 的 title 可以随便填。

• 在 git Bash 中输入以下命令检查是否导入成功

  1	ssh git@github.com

将 hexo 部署到 github

• 修改站点的配置文件_config.yml

  注意

  存储在博客目录文件下的_config.yml 为站点的配置文件

  存储在博客目录的/theme/xxx(模板名)/_config.yml 为模板的配置文件

  修改站点配置文件_config.yml 的 deploy 属性：

  1 2 3 4 5 6

  deploy: type: git # 此路径可直接在github仓库复制，如下图所示 repository: github: https://github.com/github用户名/你的github用户名.github.io.git branch: master

  repository 路径可直接在仓库页面复制 http 路径：

  

• 安装部署 git 的命令：

  1	npm install hexo-deployer-git --save

• 清理部署项目

  1 2 3 4 5 6

  hexo clean //清理项目内容 hexo g //生成页面 hexo d //部署页面 //生成部署命令可一起使用 hexo g -d

• 部署成功即可在http://github用户名.github.io查看生成的页面

  

常用的 hexo 命令

1
2
3
4
5
6

hexo clean  //清理项目缓存内容
hexo g      //生成页面
hexo d      //部署页面

hexo new page "page名" //新建页面
hexo new "文章名" //新建文章

更换主题

• 在 hexo 官网选择喜欢的模板

网址：https://hexo.io/themes/

• 在 blog 目录下打开命令行或 git Bash 输入命令下载主题

主题下载命令一般在主题页面，或预览页面主题创作人的文章里都有

1

git clone https://github.com/Shen-Yu/hexo-theme-ayer.git themes/ayer

• 修改站点配置文件_config.yml

1
2
3
4

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: ayer  #在此处修改想要使用的主题名

• 重新生成部署页面即可看到新主题下的网页

1
2
3

hexo clean  //清理项目缓存内容
hexo g      //生成页面
hexo d      //部署页面

设置自己的个人域名

目前生成的页面都是通过github提供的xxx.github.io访问，若想使用自己的个性化域名则需要以下步骤

申请域名

申请域名有很多网站，国内大多使用阿里云，不同的域名后缀价格不同，挑选自己喜欢可承受的即可。
国外域名可使用godaddy、namesilo等购买，国外域名一般不需要备案。

域名绑定

本人注册的域名时在 namesilo 购买，故以 namesilo 为例：

• 登陆 namesilo 在自己的账户页面，点击 Account Domain 后的数字，进入域名管理页面

  

• 选择 option 下的蓝色小人图标，进入解析界面

  

• 将 namesoil 自动生成的所有记录删除，即 sevice 下所有未 parking 状态的记录，一般情况为 3 条 A 记录，1 条 CNAME 记录

• 添加自己的解析内容

  • 新建一个 A 记录

    

  • 在系统 cmd 界面 ping github.io 的 ip

    

  • 在框内填写解析 ip

    

  • 新建 CNAME 记录

    

  • 域名解析

    点击 SUBMIT 之后，回到域名管理界面，等待 status 状态变为 Active，则为解析成功，一般大概需要几分钟时间。

    

在 github 关联域名

• 进入 github 博客仓库，选择 settings 进入项目设置

  

• 在 Option 界面找到 git page 属性进行以下设置

在博客目录下的 source 文件夹新建 CNAME 文件，在文件内填写自己的域名

保存时，注意选择所有文件类型，文件名仅为 CNAME，无后缀

重新部署生成页面

• 生成部署页面

1
2
3

hexo clean  //清理项目缓存内容
hexo g      //生成页面
hexo d      //部署页面

• 在浏览器输入自己的域名即可看到生成的网页

注意：记得清理浏览器缓存。

• 使用hexo new “文章名”新建文章，在博客目录的 source/_posts/下找到“文章名.md”，即可使用 Markdown 编辑自己的文章了

写好后，注意使用hexo g -d重新生成，部署页面