新版: https://www.z16388.top/2026/04/03/hexo-github-actions/
之前写了一篇域名绑定的教程,但是只有域名没有东西也不行啊。其实早在前几天就想写这样一篇总结性教程了,但是一直没有抽出时间。我这个博客最初也是在朋友的帮助之下搭建的,这个技术并不难用,在此分享给大家。
hexo是一个基于node.jsd静态博客框架,然后使用Github Pages来存放我们的博客。
账号注册
我们需要以下的账号:
github:用于存放页面,是一个非常流行的开源社区,拥有众多的开源项目。
多说:用来实现博客的评论和点赞。
七牛云:用来存放博客中使用的图片。
阿里云:如果你需要一个域名,可以到阿里云购买。
CNZZ:如果你需要统计你的博客访问,可以使用CNZZ。除此之外还有百度统计,谷歌统计等。
环境搭建
你需要下载以下几种软件:
Node.js:用来生成静态页面,hexo的环境。
Git Bash:把本地的内容提交到github上的软件。
Markdown Pad:用来写博客。
NotePad++:一款比较好的记事本,用来修改配置文件。
在github创建一个新的项目,命名为:
YourUserName.github.io
开始安装
Node.js和Git Bash安装好之后,首先,创建一个文件夹,比如叫<code>blog</code>,用于存放你的博客相关的文件。然后进入文件夹,开始安装hexo。
右键,<code>git bash here</code>,打开git bash,然后运行安装命令:
npm install -g hexo
然后执行初始化命令:
hexo init
打开根目录下的_config.yml配置文件,修改最后的信息为:
1 | deploy: |
按照备注修改相关的参数,比如博客的名字,你的姓名等等。除此之外,你还可以到hexo的官网的主题页面,去下载你喜欢的主题,放在themes文件夹下。需要修改的参数大部分在主题的配置文件上。当然这一步你以后都可以去做。
执行命令:
npm install hexo-deployer-git –save
配置ssh:
如果是Linux系统或者是Mac,则先需要进入配置文件所在的位置,需要先执行:
cd ~/.ssh
Windows系统的话,可以直接进行下面的步骤:
git config –global user.name “name”
git config –global user.email “email”
ssh-keygen -t rsa -C “邮件地址@youremail.com”
输入好上面的代码之后,三次回车即可。后面的两次为你提交项目时使用的密码,直接回车可以省略。
创建完ssh之后,需要到github进行配置。打开文档中的.ssh文件夹下的<code>id_rsa.pub</code>文件,复制所有内容。登陆到你的github,Setting->SSH and GPG keys->New SSH Key,将刚刚复制的内容粘贴进去即可。
执行配置命令:
hexo deploy (或者是缩写:hexo d)
至此,博客搭建完成,你可以在浏览器输入http://YourUserName.github.io来访问。每次对博客修改之后,我们都需要先生成(<code>hexo g</code>),再提交到git(<code>hexo d</code>)。当然,我们可以先进行本地预览,运行本地的服务器(<code>hexo s</code>),然后用浏览器访问localhost:4000/。<code>hexo g</code>和<code>hexo d</code>可以合并成一个指令:<code>hexo d -g</code>
hexo的常用命令和写博客使用的markdown语法请参考:
hexo常用命令:http://www.z16388.top/2016/09/09/hexo%E5%B8%B8%E7%94%A8%E5%91%BD%E4%BB%A4/
Markdown常用语法:http://www.z16388.top/2016/09/09/Markdown%E5%B8%B8%E7%94%A8%E8%AF%AD%E6%B3%95/