Hexo博客部署到VPS

网上大部分教程都是将Hexo部署到GitHub Pages上面,本文主要介绍如何部署到VPS。

VPS环境:Ubuntu 16.04。

准备工作

网上流传的武功秘籍分为两种:

  • 将Hexo项目上传到VPS上面后执行 hexo server,之后配置Nginx反向代理,让域名指向 http://localhost:4000
  • 将Hexo在本地通过 hexo generate 生成静态文件,在通过 hexo deploy 部署到VPS上面,使用Nginx直接做Web服务器。

相比第二种方式,第一种每次写博客与更新博客时候的操作会很繁琐。所以我们使用第二种方式进行部署,这样既可以将静态文件deploy到VPS上,也可以上传到Github上用作备份,操作性和安全性上都要胜于前者。

而对于第二种方式而言,常用的又有 git hookrsync 两种自动部署解决方案。

本文主要介绍git hook部署过程。

Git Hooks自动部署

部署原理

我们在本地编辑文本,然后使用Git远程部署到VPS的Git仓库。hexo d命令实际上只deploy了本地的public文件夹,Git Hooks实际上就是当Git仓库收到最新的push时,将Git仓库接受到的内容复制到VPS上的网站目录内。相当于完成了手动将public文件夹复制到VPS的网站根目录里。

安装配置Git

安装Git

通过SSH连接VPS,执行:apt-get install git,完成后通过git --version查看Git版本,若显示版本信息则说明安装成功。

创建git用户

执行:adduser git,根据提示设置密码。

赋予git用户sudo权限

执行:

1
2
chmod 740 /etc/sudoers
vim /etc/sudoers

找到以下内容:

1
2
# User privilege specification
root ALL=(ALL:ALL) ALL

root ALL=(ALL:ALL) ALL这一行下面添加git ALL=(ALL:ALL) ALL

保存退出后,修改回文件权限:

1
chmod 440 /etc/sudoers

关闭git用户shell权限

我们也可以通过:

1
ssh [email protected] IP

ssh连接服务器,登录到服务器上,对服务器进行各种操作,这通常很不安全,也不合适,我们只需要能对仓库操作就可以了,不需要更大的权限。

因此我们关闭git用户shell权限,执行:

1
vim /etc/passwd

将最后一行的git:x:1001:1001:,,,:/home/git:/bin/bash修改为git:x:1001:1001:,,,:/home/git:/usr/bin/git-shell

这样,git用户可以正常通过ssh使用git,但无法登录shell,因为我们为git用户指定的git-shell每次一登录就自动退出

初始化git仓库

1
2
3
4
cd /home/git                //切换到git用户目录
mkdir blog.git //创建git仓库文件夹,以blog.git为例
cd blog.git //进入仓库目录
git init --bare //使用--bare参数初始化为裸仓库,这样创建的仓库不包含工作区

注意:裸仓库没有工作区,因为服务器上的Git仓库纯粹是为了共享,所以不让用户直接登录到服务器上去改工作区,并且服务器上的Git仓库通常都以.git结尾。

创建网站目录

1
2
cd /var/www/                //切换目录
mkdir blog //创建网站目录,以blog为例

配置SSH

1
2
3
4
cd /home/git                //切换到git用户目录
mkdir .ssh //创建.ssh目录
cd .ssh
vim authorized_keys

然后将本地的公钥复制到authorized_keys文件里(公钥即本地执行cat ~/.ssh/id_rsa.pub查看的内容)。

注意:收集所有需要登录的用户的公钥,就是他们自己的id_rsa.pub文件,把所有公钥导入到/home/git/.ssh/authorized_keys文件里,一行一个。

用户组管理

1
2
ll /home/git/
ll /var/www/

确保blog.git.sshblog目录的用户组权限为git:git,若不是,执行下列命令:

修改用户权限的命令:

1
2
>chown -R 用户名.组名 /目录
>
1
2
3
chown -R git.git /home/git/blog.git/
chown -R git.git /home/git/.ssh/
chown -R git.git /var/www/blog/

安装配置nginx

安装nginx

执行:apt-get install nginx,若输入nginx -V可以看到nginx版本信息,则安装成功。

配置nginx

执行:

1
2
3
cd /etc/nginx/sites-available               //切换目录
cp default default.bak //备份默认配置
vim default //修改配置

参考配置文件内容:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
server {
listen 80 default; #默认监听80端口
root /var/www/blog; #网站根目录
server_name tding.top, www.tding.top; #网址
access_log /var/log/nginx/blog_access.log;
error_log /var/log/nginx/blog_error.log;
error_page 404 = /404.html;

location ~* ^.+\.(ico|gif|jpg|jpeg|png)$ {
root /var/www/blog;
access_log off;
expires 1d;
}

location ~* ^.+\.(css|js|txt|xml|swf|wav)$ {
root /var/www/blog;
access_log off;
expires 10m;
}

location / {
root /var/www/blog;
if (-f $request_filename) {
rewrite ^/(.*)$ /$1 break;
}
}

location /nginx_status {
stub_status on;
access_log off;
}
}

保存退出后,启动nginx:

1
systemctl start nginx

设置开机自动启动:

1
systemctl enable nginx

查看运行状态:

1
systemctl status nginx

显示running表示成功运行。

配置Git Hooks

创建post-receive文件

git用户下执行(这里我用root用户执行上述命令,然后更改了文件所有者为git.git):

1
2
cd /home/git/blog.git/hooks     //切换到hooks目录下
vim post-receive //创建文件

复制下面的内容到post-receive文件中:

1
2
3
4
5
6
7
8
9
10
11
#!/bin/bash
echo "post-receive hook is running..."

GIT_REPO=/home/git/blog.git
TMP_GIT_CLONE=/tmp/blog
PUBLIC_WWW=/var/www/blog

rm -rf ${TMP_GIT_CLONE}
git clone $GIT_REPO $TMP_GIT_CLONE
rm -rf ${PUBLIC_WWW}/*
cp -rf ${TMP_GIT_CLONE}/* ${PUBLIC_WWW}

为什么不直接将裸仓库克隆到 Web 根目录下呢?我之前也一直被这个问题困扰,感觉先克隆到 tmp 目录再拷贝到 Web 根目录是多此一举。后来我觉得可能是出于项目安全的考虑,在执行 cp 命令的时候,.git 作为隐藏目录不会被拷贝到 Web 根目录下,也就避免了将整个仓库历史暴露在 Web 服务中。

赋予可执行权限:

1
chmod +x post-receive

本地操作

尝试连接

在本地打开Git Bash:

1
ssh [email protected]的ip

若默认端口不是22,则需要在后面加上-p 端口号

1
ssh [email protected]的ip -p 2022

或者在.ssh文件夹下创建一个config文件,内容如下:

1
2
3
4
5
Host 服务器IP
HostName 服务器IP
User git
Port 端口号
IdentityFile ~/.ssh/id_rsa

这里可能会出现以下错误:

1
2
3
4
5
6
7
8
9
10
IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
Someone could be eavesdropping on you right now (man-in-the-middle attack)!
It is also possible that a host key has just been changed.
The fingerprint for the ECDSA key sent by the remote host is
SHA256:NgaCW7iTlWetUGGkX1uHepNs88G/pCYa9zrDouTQvhM.
Please contact your system administrator.
Add correct host key in /c/Users/dta05/.ssh/known_hosts to get rid of this message.
Offending ECDSA key in /c/Users/dta05/.ssh/known_hosts:6
ECDSA host key for [167.xxx.xxx.xxx]:2022 has changed and you have requested strict checking.
Host key verification failed.

原因分析:

It is also possible that a host key has just been changed.

我之前对ssh服务器重装了系统,导致所有与原系统建立过ssh连接的系统都无法再建立连接,因为在于原系统建立首次连接时,双方相互记录了对方的公钥(ssh基于非对称密钥技术),在ssh服务主机重装系统后,公钥改变了,任以旧版本公钥的主机自然是无法与新系统连接的。

网上还有分析为ssh主机被人黑了,并在消除入侵记录时对known_hosts文件做了改动。

解决方案:

删除~/.ssh/known_hosts文件,或者如果你可以判断出known_hosts中原ssh服务器的公钥,删去那部分,

然后再次建立新的连接,即可获得新的公钥。

配置Hexo

打开本地博客根目录下的_config.yml文件,找到最后的deploy配置,修改为:

1
2
3
4
5
6
7
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
# repo: [email protected] IP:/~/blog.git # 默认端口生效使用
# repo: ssh://[email protected] IP:端口/~/blog.git # 默认端口不生效使用,设置端口
branch: master

到此,Hexo建站就全部配置部署完毕了。

参考

赞赏一杯咖啡
0%