Deploying the HEXO blog on a server

preamble

If you feel that the Blog hosting service is not enough to satisfy your own folding, you can migrate the resources to your own cloud servers

goal

• Server-side deployment of hexo blog site environment
• Client publishes articles to push to server

Preparing the environment

Essential Software for Servers

• Git
• Nginx

Client Essentials

• Git
• Node.js
• hexo

Server-side configuration (using Centos as an example)

Adding Epel sources to facilitate yum installation of Nginx

1
wget https://mirrors.tuna.tsinghua.edu.cn/epel/7/x86_64/Packages/e/epel-release-7-11.noarch.rpm
2
rpm -ivh epel-release-7-11.noarch.rpm
3
yum clean all
4
yum makecache

Install Git and Nginx

1
yum install git nginx -y

Creating Nginx Users and Groups

1
groupadd nginx
2
useradd -g nginx -s /sbin/nologin nginx

Creating the Nginx hexo site files directory

1
mkdir -pv /webdata/www/hexo
2
chown -R nginx:nginx /webdata/www/hexo

Configuring Nginx Configuration file path

1
vim /etc/nginx/nginx.conf

Required modifications

1
.....
2
server {
3
      listen       80 default_server;
4
      server_name  www.example.com;
5
      root         /webdata/www/hexo;
6
      index        index.html index.htm;
7
  }
8
.....

Run service nginx configtest to check if the syntax of nginx.conf is correct, display success and then restart service nginx restart

Git Deployment Create a file directory for private Git repository building

1
mkdir -pv /data/repository

Git Initializes Bare Libraries

1
cd /data/repository
2
git init --bare hexo.git

Creating Git hooks (hooks)

1
vim /data/repository/hexo.git/hooks/post-receive

Specify the Nginx site directory and Git repository address

1
#!/bin/bash
2
git --work-tree=/webdata/www/hexo --git-dir=/data/repository/hexo.git checkout -f

Save to exit and add execute permissions

1
chmod +x /data/repository/hexo.git/hooks/post-receive

Client Configuration

This article to the local virtual machine Centos as an example, other platforms corresponding to the search to know how to install. Install Git and Nodejs

1
yum install git nodejs -y

Install hexo

1
npm install -g hexo-cli

hexo initialization and installation

1
mkdir -pv <folder>  (/data/www/hexo)
2
hexo init <folder>
3
cd <folder>
4
npm install

For detailed configuration of hexo, please refer to hexo documentation.

Configure the local client-server connection Open the site configuration file

1
vim /data/www/hexo/_config.yml

Setting the Deployment field

1
## Docs: https://hexo.io/docs/deployment.html
2
deploy:
3
  type: git
4
  repo: root@domain && IP:/data/repository/hexo.git            # SSH default port 22
5
 #repo: ssh://root@domain && IP:prot/data/repository/hexo.git   # SSH non-default port 22
6
  branch: master

If it is too much trouble to enter the password every time you publish, you can configure client-side and server-side RSA authentication, if you don’t know you can find it through a search engine.

Configuring Git Mailboxes and Users Git requires mailbox and user configuration for initial connection

1
git config --global user.email "you@example.com"
2
git config --global user.name "Your Name"

Deploying hexo

Deploying locally generated static files to a server clear the cache

1
hexo clean

Generate static pages

1
hexo generate

Start server

1
hexo server   # Not necessary for debugging web pages

Deploying local hexo catalog files to the server But before you do that you need to install the hexo-deployer-git plugin

1
npm install hexo-deployer-git --save

Then execute the deployment

1
hexo deploy

concluding remarks

It seems to write a big push, in fact, there are not many places to configure, Blog deployment instead of simple.