本文介绍一种在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
即可生效。