强大博客搭建全过程（1）-hexo博客搭建保姆级教程

1、 前言

本人本来使用国内的开源项目solo搭建了博客，但感觉1核CPU2G内存的服务器，还是稍微有点重，包括服务器内还搭建了数据库。如果自己开发然后搭建，耗费时间又比较多，于是乎开始寻找轻量型的博客系统。

此时hexo蓦然跟我招招手，“嘿，兄弟，是要搭建博客吗？”

“嗯嗯，是的，但我配置很低，1C2G，跑不起来太花里胡哨的博客系统。”我讪讪答道。

“我hexo是纯静态博客框架，一个快速、简洁且高效的博客框架。使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。不使用任何数据库。”hexo自豪道。

我立马眼睛一亮，随后道：“真哒，那真是太好了。但我有好多博客平台要发布博客，比如csdn、掘金、博客园、微信公众号......”

此时，一位力大无穷的搬运工走了过来，身上扛着几箱博客纸箱，拍了拍我的肩膀，然后瓮声瓮气道：“我叫ArtiPub，你要给多平台发布文章？刚好我要搬运这些博客，你这事包在我上身。”

“哈，ArtiPub壮士，hexo大侠，感谢了。但你们要怎么收费，你看我稍微有点囊中羞涩。”此时此刻我激动万分，但摸了摸口袋，只剩下今晚饭钱一块二毛五，一想到两位大侠神通广大，收费肯定不便宜，神色开始黯淡起来。

“不要钱，免费办事，我为人人，人人为我。”hexo和ArtiPub异口同声道。

只那一瞬间，我手上一箱博客纸箱，被两位大侠拽了过去，随即他们挥一挥衣袖，绝尘而去，远处传来他们豪气地笑声。稍纵片刻，不到半盏茶时间，我的博客就被搭建了起来，然后csdn、掘金、博客园、微信公众号......都出现了各篇文章，我眼中泛着激动的泪光，内心默默感谢着hexo和ArtiPub两位大侠，希望有朝一日自己也能像他们一般行侠仗义，造福百姓。

就在这时候，我准备回家，却见地上有两本武功秘籍，一本《hexo博客搭建保姆级教程》，一本《ArtiPub一键发布各平台》，这时我知道是两位大侠留给我的，于是便有了这篇文章，就让我带着大家领略这两篇武功秘籍的精髓所在吧。

2、hexo搭建博客

hexo官方中文文档：文档 | Hexo

本文思路是先在windows里安装好对应环境，放好文章后，然后生成静态文件，快速放到服务器上。

1、hexo介绍

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

2、hexo服务端操作

hexo服务端主要是搭建好基本运行的环境nginx和git，通过git搭建git-hook让客户端和服务端联动起来，能做到上传文档到git即可触发网站更新。

1、服务端配置

2、安装git和nginx

yum install -y nginx git

3、添加一个为git的用户

useradd git
passwd git
 
# 给git用户配置sudo权限
chmod 740 /etc/sudoers
vim /etc/sudoers
# 找到root ALL=(ALL) ALL，在它下方加入一行
git ALL=(ALL) ALL
 
chmod 400 /etc/sudoers

4、配置git参数

# 其中 username 和 username@XXX.com 是你注册 Gitee 的用户名和邮箱，如果账号不是邮箱注册的话，填自己的一个邮箱地址就行了
git config --global user.name "username"
git config --global user.email "username@XXX.com"

4、创建ssh密钥

su - git
mkdir -p ~/.ssh
cd ~/. ssh
 # 其中 username@XXX.com 同上，是你的注册邮箱
 ssh-keygen -t rsa -C "username@XXX.com"

然后连续3次回车，最终会生成一个文件在用户目录下，打开用户目录，找到.ssh\id_rsa.pub文件，记事本打开并复制里面的内容，打开你的gitee主页，进入个人设置 -> 添加公钥 -> 添加部署公钥，将公钥拷贝进去

测试ssh情况

#使用SSH连接Gitee:
ssh -T git@gitee.com

4、给git用户添加ssh密钥

su git
touch ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorzied_keys
chmod 700 ~/.ssh
vim ~/.ssh/authorized_keys    #将ssh密钥粘贴进去

5、创建git仓库并使用git-hooks实现自动部署

sudo mkdir -p /data/git/repo    #新建目录，这是git仓库的位置
sudo mkdir -p /data/hexo #项目部署地址
cd /data/git/repo  #转到git仓库的文件夹
sudo git init --bare hexoblog.git #创建一个名叫blog的仓库
sudo vim /data/git/repo/hexoblog/.git/hooks/post-update

post-update的内如如下：

#!/bin/bash
git --work-tree=/data/hexo --git-dir=/data/git/repo/hexoblog.git checkout -f

给post-update授权：

cd /data/git/repo/hexoblog/.git/hooks/
sudo chown -R git:git /data/git/repo/
sudo chown -R git:git /data/hexo
sudo chmod +x post-update  #赋予其可执行权限

6、配置Nginx

cd /usr/local/nginx/conf/
vim nginx.conf

nginx.conf`加入内容如下：

server {
    listen    80 default_server;
    listen    [::] default_server;
    server_name    www.beierblog.com;
    root    /data/hexo
}

检查Nginx语法并重载nginx：

7、修改git用户的默认shell环境

vim /etc/passwd
#修改最后一行
#将/bin/bash修改为/usr/bin/git-shell

8、解析域名

到你购买域名的供应商控制台，将域名解析到你的服务器即可。

3、hexo客户端操作

hexo本地端主要在本人的window系统的电脑里操作，主要做了初始化hexo、上传博客、修改主题的操作，配合git-hook能做到提交git就能在网站查看到实时变化。

1、客户端配置

2、搭建命令

首先安装node环境和git命令

• Node.js (node自带npm命令，Node.js 版本需不低于 10.13，建议使用 Node.js 12.0 及以上版本)

• Git

  Node.js 版本限制

  我们强烈建议永远安装最新版本的 Hexo，以及 推荐的 Node.js 版本。

  Hexo 版本	最低兼容 Node.js 版本
  6.0+	12.13.0
  5.0+	10.13.0
  4.1 - 4.2	8.10
  4.0	8.6
  3.3 - 3.9	6.9
  3.2 - 3.3	0.12
  3.0 - 3.1	0.10 or iojs
  0.0.1 - 2.8	0.10

这里不对node环境和git安装做过多教程，详细可看教程：

这里要注意npm需要配置国内镜像，命令如下：

# 查看 npm 源
npm config get registry
# 临时修改 npm 源安装 hexo (仅本条命令有效)
npm --registry=https://registry.npm.taobao.org install -g hexo-cli
# 或者永久修改 npm 源
npm config set registry https://registry.npm.taobao.org

3、初始化hexo

1、npm全局安装hexo

npm install -g hexo-cli

2、hexo初始化（hexoblog为自定义目录，可自行修改）

hexo init hexoblog
cd hexoblog
npm install

新建完成后，指定文件夹的目录如下：

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

目录_config.yml是配置文件，具体如何修改详见官方文档：配置 | Hexo

hexo全局安装后，使用hexo相关命令，全部命令参考：指令 | Hexo

4、启动hexo

 hexo server

5、上传博客

方式一：文件直接放入并静态化

a. 把编辑好的markdownw文件放在项目目录：${项目目录}/source/_posts。

b. 执行静态化和服务启动命令：

hexo generate & hexo server

方式二：通过命令上传文章

#切换到项目目录
cd ${项目目录}
 
#初始化文章
hexo new "博客1"
 
#进入博客根目录
cd ${项目目录}/source/_posts
 
#针对 博客1.md自行编写

6、部署配置修改（配合git）

部署文档：部署 | Hexo

a. 先安装 Hexo 发布插件

npm install hexo-deployer-git

b. 修改部署配置

cd ${项目目录}
vim _config.yml
 
# 找到deploy配置部分
# Deployment
## 部署文档: https://hexo.io/zh-cn/docs/one-command-deployment
deploy:
  type: git
  repo: root@IP:/data/git/repo/hexoblog.git # IP填写自己服务器的IP即可
  branch: master

注意：服务器所在ssh端口如果不是默认的22端口，就会失败，但hexo没有配置能修改ssh默认端口，所以git的deploy方式走不用的话，建议选择其他方式

7、部署到服务器

# 清除缓存
hexo clean
 
# 生成静态页面
hexo generate
 
# 将本地静态页面目录部署到云服务器
hexo d

自此，大功告成，可以查看自己博客情况。

4、切换主题教程（客户端操作）

本人采用主题为fluid，参考文档：fluid-dev/hexo-theme-fluid)

切换步骤：

#npm下载主题依赖
npm install --save hexo-theme-fluid
 
#__config.yml里修改配置
theme: fluid  # 指定主题
language: zh-CN  # 指定语言，会影响主题显示的语言，按需修改
 
 

创建「关于页」

首次使用主题的「关于页」需要手动创建：

hexo new page about

创建成功后，编辑博客目录下 /source/about/index.md，添加 layout 属性。

修改后的文件示例如下：

---
title: about
layout: about
---
 
这里写关于页的正文，支持 Markdown, HTML