Ubuntu服务器部署hexo博客

---

本文介绍一种在Ubuntu服务器上部署Hexo博客的简易方法。

准备工作

首先按照hexo官方文档在本地安装好Node.js、git。

本地Hexo安装及初始化

hexo-cli是Hexo的命令行工具，可用于快速新建、发布、部署博客；hexo-server是Hexo的内建服务器，可用于部署前的预览和测试。-g 选项，表示全局安装。

npm install hexo-cli hexo-server -g

执行下列命令，Hexo将会在指定文件夹中新建所需要的文件。

hexo init <folder>
cd <folder>
npm i

在_config.yml中修改配置

参考官网说明自由配置

一些建议配置
default_layout: draft  // 该字段位于在Writing部分。将其从post修改为draft，表示每篇博文默认都是草稿，必须经过发布之后才能在博客站点上访问。

小试牛刀——新建博客草稿并发布

执行如下命令，创建一篇博文

hexo new <title>   # <title>为自定义的文章标题

在本地用编辑器编辑生成的.md文件，如：

---
layout: default_layout
title: 汉诺塔问题
date: 2017-08-01 22:51:09
tags: 递归
---

### 以下为正文

保存后发布（default_layout为draft时）

hexo publish <filename>

若文件default_layout为post，或文件保存在 ./source/_posts目录下，直接执行

hexo generate

执行以下命令，启动服务器。打开浏览器即可在本地看到自己刚发布的文章，默认情况下，访问网址为： http://localhost:4000/。

hexo server

完成本地端的操作之后，可以开始服务器的配置了。

通过ssh远程登录云服务器后，创建私有Git仓库，并修改目录的所有权和用户权限。

在/var/repo/下，创建一个名为hexo_static的裸仓库（bare repo）。

sudo mkdir /var/repo/
sudo chown -R $USER:$USER /var/repo/
sudo chmod -R 755 /var/repo/
cd /var/repo/
git init --bare hexo_static.git

配置Nginx托管文件目录

创建/var/www/hexo目录，用于Nginx托管，并修改目录的所有权和权限

sudo mkdir -p /var/www/hexo
sudo chown -R $USER:$USER /var/www/hexo
sudo chmod -R 755 /var/www/hexo

修改Nginx的default设置，将其中的root指令指向/var/www/hexo目录。

sudo vim /etc/nginx/sites-available/default

...
server {
    listen 80 default_server;
    listen [::]:80 default_server ipv6only=on;

    root /var/www/hexo; # 需要修改的部分
    index index.html index.htm;
...

保存并退出文件。
重启 Nginx 服务，使得改动生效

sudo service nginx restart

创建Git钩子

在服务器上的裸仓库hexo_static创建一个钩子，在满足特定条件时将静态HTML文件传送到Web服务器的目录下，即/var/www/hexo。

在自动生成的 hooks 目录下创建一个新的钩子文件：

vim /var/repo/hexo_static.git/hooks/post-receive

在该文件中添加两行代码，指定 Git 的工作树（源代码）和 Git 目录（配置文件等）。

#!/bin/bash

git --work-tree=/var/www/hexo --git-dir=/var/repo/hexo_static.git checkout -f

保存并退出文件，并让该文件变为可执行文件。

chmod +x /var/repo/hexo_static.git/hooks/post-receive

至此，服务器端配置基本完成。

通过Git部署

通过Git将Hexo生成的静态内容推送到服务器。

继续编辑_config.yml文件

url: http://<YourDomain>   # 没有绑定域名时填写服务器的实际IP地址。

找到Deployment部分，按照如下情况修改:

deploy:
    type: git
    repo: ubuntu@<IP>:/var/repo/hexo_static
    branch: master

保存并退出文件。

安装一个Hexo包，负责将博客所需的静态内容发送到设置好的Git仓库。

npm install hexo-deployer-git --save

安装好后可以测试部署：

hexo generate && hexo deploy

成功后，就可以在浏览器输入自己的域名/IP访问自己的博客网站了。

以后增加、修改文章/配置文件/代码后，执行hexo generate && hexo deploy即可生效。