使用hexo+github轻松搭建免费个人博客

布满荆棘的人生 2022-02-19 06:45 235阅读 0赞

# 前言 #

听一些大牛说，技术博客是程序员的标配，之前一直想写一个来着，但由于工作忙，又想写一个好点的，所以一拖再拖，直到工作两年了也没有自己的技术博客。其实如今搭建一个个人技术博客还算简单，其中我使用的技术就是Github+hexo。

**使用Github+hexo的好处:**

1.  github pages全是静态文件，响应速度快；
2.  免费方便，不需要服务器、不需要后台；
3.  数据安全，基于github的版本管理，想回滚到那个版本都可以；
4.  博客是基于hexo将md文件转换为html,内容可以轻松打包、转移和发布到其它的平台(CSDN支持md文件)；
5.  据说可以随意绑定自己的域名，没有进行尝试，既然是免费的，那就将免费贯彻到底；
6.  可以多样化的主题设置(官网查询)

# 环境准备 #

1.  个人github账号，没有的话可以去[官网][Link 1]注册
2.  安装[node.js][]和npm(并了解相关的知识)，建议下载后缀为.msi的64bit文件，点击安装后会自动进行环境的配置
3.  安装git for windows(或者其它的git客户端)，这个下载和安装比较简单就不提供网址

//本文使用的环境
    Windows 10
    node.js @v10.15.3
    git @2.20.1.windows.1
    hexo @1.10

# 搭建博客 #

## 1.创建git仓库 ##

新建一个名为：你的用户名.github.io的仓库，[比如我的github用户名是javacfox那我建的仓库是javacfox.github.io][github_javacfox_javacfox.github.io],我的访问地址是http://javacfox.github.io,还是很方便的(创建完后不会立即生效，需要过大概10-30分钟才生效)。

## 2.配置SSH KEY ##

SSH 为 Secure Shell 的缩写，由 IETF 的网络小组（Network Working Group）所制定；SSH 为建立在应用层基础上的安全协议。SSH 是目前较可靠，专为远程登录会话和其他网络服务提供安全性的协议。SSH可以用来解决本地和服务器的连接问题，避免直接使用用户名和密码不安全。

**在Git Bash上输入如下命令，检查是否存在ssh密钥:**

cd ~/.ssh

如果提示：No such file or directory,说明你是第一次使用git。

ssh-keygen -t rsa -C "邮件地址"

输入命令后连续回车3次，最后会生成3个文件，打开用户目录，找到.ssh\\id\_rsa.pub文件，记事本打开并复制里面的内容，打开github主页，进入个人设置->SSH AND GPG keys -> New SSH Key:  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkwNw_size_16_color_FFFFFF_t_70]  
将复制的内容粘贴到Key的框里，title随便填写，然后保存。SSH保存完后：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkwNw_size_16_color_FFFFFF_t_70 1]  
测试是否成功：

$ ssh -T git@github.com # 注意邮箱地址不用改

输入两次登录密码后，如果提示如下，则说明SSH已配置成功：

Hi javacfox! You've successfully authenticated, but GitHub does not provide shell access.
    
    然后继续配置：
    git config --global user.name "liuxianan"// 你的github用户名，非昵称
    git config --global user.email  "xxx@qq.com"// 填写你的github注册邮箱

## 3.安装hexo ##

官网： [http://hexo.io][http_hexo.io]  
github: [https://github.com/hexojs/hexo][https_github.com_hexojs_hexo]

Hexo是一个简单、快速、强大的基于 Github Pages 的博客发布工具，支持Markdown格式，有众多优秀插件和主题。有兴趣的可以上官网了解一下。

虽然很多命令可以使用windows的cmd完成，也可以使用git bash来执行，建议统一使用cmd(我是使用cmd的，目测全部可行)  
**安装：**

npm install -g hexo

**初始化：**  
在电脑的某个地方新建一个名为hexo的文件夹(名字随意)，比如我的是D:\\work\\hexo,由于这个文件夹将来就作为存放代码的地方，所以最好不要随便放。

> D:
    > cd D:work/hexo
    > hexo init

hexo会自动下载一些文件到这个目录，包括node\_modules,目录结构如下图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkwNw_size_16_color_FFFFFF_t_70 2]

> hexo g //生成
    > hexo s //启动服务

执行以上命令之后，hexo就会在public文件夹生成相关html文件，这些将来都是要提交到github的  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkwNw_size_16_color_FFFFFF_t_70 3]  
大尅浏览器访问http://localhost:4000即可看到内容，因为端口4000比较常见，可能出现端口被占用的情况，解决这个可以参考：[https://blog.csdn.net/the\_liang/article/details/81914920][https_blog.csdn.net_the_liang_article_details_81914920]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkwNw_size_16_color_FFFFFF_t_70 4]

## 4.主题的修改 ##

默认主题简单而且很丑，修改一下主题吧，这个是[官方主题][Link 2]，这个是个人比较喜欢的主题:[yilia][]

> d:
    > cd D:/work/hexo

> git clone [https://github.com/litten/hexo-theme-yilia.git][https_github.com_litten_hexo-theme-yilia.git] themes/yilia  
> 修改\_config.yml中的theme: landscape改为theme: yilia，然后重新执行hexo g来重新生成。

如果出现一些莫名其妙的问题，可以先执行hexo clean来清理一下public的内容，然后再来重新生成和发布。

## 5.上传 ##

在上传代码到github之前，一定要记得先把你以前所有代码备份下来。虽然有版本管理，也不能太依赖！

配置\_config.yml中有关deploy的部分：

//正确写法
    deploy:
      type: git
      repository: git@github.com:javacfox/javacfox.github.io.git
      branch: master
    
    //错误写法
    deploy:
      type: github
      repository: https://github.com/javacfox/javacfoc.github.io
      branch: master

**安装插件：**

npm install hexo-deployer-git --save

安装时有可能出现如下的错误：

npm WARN registry Unexpected warning for https://registry.npmjs.org/: Miscellaneous Warning EINTEGRITY: sha1-3EJpcTMwLOMBdSQ1amxht7abShg= integrity checksum failed when using sha1: wanted sha1-3EJpcTMwLOMBdSQ1amxht7abShg= but got sha512-x3LV3wdmmERhVCYy3quqA57NJW7F3i6faas++pJQWtknWT+n7k30F4TVdHvCLn48peTJFRvCpxs3UuFPqgeELg==. (104124 bytes)
    npm WARN registry Using stale package data from https://registry.npmjs.org/ due to a request error during revalidation.

可以试试npm install  
npm install xxx --registry=https://registry.npm.taobao.org  
或者安装cnpm

安装完后可能报如下的错：

+ hexo-deployer-git@1.0.0
    added 59 packages from 48 contributors and audited 6951 packages in 4.438s
    found 3 vulnerabilities (2 low, 1 moderate)
      run `npm audit fix` to fix them, or `npm audit` for details

可以使用如下命令解决：npm audit fix，如果不行就是使用: npm audit fix --force  
具体解决方法请参考：[https://blog.csdn.net/weixin\_40817115/article/details/81007774][https_blog.csdn.net_weixin_40817115_article_details_81007774]

输入hexo d就会将本次有改动的代码全部提交，没有改动的不会

[Link 1]: https://github.com/
[node.js]: https://nodejs.org/en/download/
[github_javacfox_javacfox.github.io]: http://xn--githubjavacfoxjavacfox-1q09ai38exr2a7s1aojcmu8apa44i631gma5778b9j4d26jua0358v.github.io
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkwNw_size_16_color_FFFFFF_t_70]: /images/20220219/f9e37aa5a25a4c47bad4c2d13756aee5.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkwNw_size_16_color_FFFFFF_t_70 1]: /images/20220219/62ec5f9ee7bd413194315a1f7046cad8.png
[http_hexo.io]: http://hexo.io
[https_github.com_hexojs_hexo]: https://github.com/hexojs/hexo
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkwNw_size_16_color_FFFFFF_t_70 2]: /images/20220219/8e2577e52ddb49f6bec30514a9345d92.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkwNw_size_16_color_FFFFFF_t_70 3]: /images/20220219/9c9b313255a6410297f10b5334a8f6e3.png
[https_blog.csdn.net_the_liang_article_details_81914920]: https://blog.csdn.net/the_liang/article/details/81914920
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzkzNTkwNw_size_16_color_FFFFFF_t_70 4]: /images/20220219/19e2b9f739774ca5bc4aeafb9e5c8abe.png
[Link 2]: https://hexo.io/themes/
[yilia]: https://github.com/litten/hexo-theme-yilia
[https_github.com_litten_hexo-theme-yilia.git]: https://github.com/litten/hexo-theme-yilia.git
[https_blog.csdn.net_weixin_40817115_article_details_81007774]: https://blog.csdn.net/weixin_40817115/article/details/81007774