将hexo部署到VPS上

介绍如何将hexo部署到VPS上

最近心血来潮,决定将原本托管在github的hexo静态页面搬运到vps上,这里记录一下如何实现。

参考资料:

# 本地SSH配置

Hexo部署是通过git来完成的,而git又是基于ssh连接的,所以需要在本地和服务端进行ssh相关配置。

如果之前没有使用git创建过ssh。需要打开git bash, 执行以下命令:

1
2
$ git config --global user.email "你的邮箱"
$ git config --global user.name "你的用户名"

这里的邮箱和用户名都是服务器用于记录git提交记录的,然后是本地端生成ssh Key:

1
2
$ ssh-keygen -t rsa -C "你的邮箱" // 执行这个命令会提示输入用于保存的密钥名
和口令之类的,都不填

执行完后会在C:\Users\Administrator.ssh目录下生成id_rsa和id_rsa.pub两个文件,其中id_rsa.pub文件里的内容是等会要复制到服务器那里的 可以在git bash执行以下命令获取到id_rsa.pub文件里的内容。也可以直接用记事本之类的文本编辑器打开复制

1
$ cat .ssh/id_rsa.pub // 执行后可以看到公钥内容

# VPS服务器配置

首先我们配置服务器上的SSH key。如果没有ssh,则自行安装。这里不再赘述

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
# 添加hexo用户(注:这里用户名应该可以随意修改,但有人说git用户更好,待调查)
adduser hexo
# 切换到hexo用户
su hexo
# 切换到hexo用户目录
cd /home/hexo
# 创建.ssh文件夹
mkdir .ssh
# 创建authorized_keys文件并编辑
echo "id_rsa.pub中的内容" > .ssh/authorized_keys
# 如果你还没有生成公钥,那么首先在本地电脑中执行 cat ~/.ssh/id_rsa.pub | pbcopy生成公钥
# 修改相应权限
chmod 600 .ssh/authorized_keys
chmod 700 .ssh

# 配置post-update钩子

Git的钩子脚本位于版本库.git/hooks目录下,当Git执行特定操作时会调用特定的钩子脚本。当版本库通过git init或者git clone创建时,会在.git/hooks目录下创建示例脚本,用户可以参照示例脚本的写法开发适合的钩子脚本。

钩子脚本要设置为可运行,并使用特定的名称。Git提供的示例脚本都带有.sample扩展名,是为了防止被意外运行。如果需要启用相应的钩子脚本,需要对其重命名(去掉.sample扩展名)。

1
2
post-update
该钩子脚本由远程版本库的git receive-pack命令调用。当从本地版本库完成一个推送之后,即当所有引用都更新完毕后,在远程服务器上该钩子脚本被触发执行。

因此我们需要配置post-update钩子以便可以及时更新我们在VPS上存放Hexo 静态文件的目录。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
# 回到hexo目录
cd /home/hexo
# 变成hexo用户
su hexo
# 新建blog目录存放hexo静态文件
mkdir /home/hexo/blog
# 使用hexo用户创建git裸仓库,以blog.git为例
git init --bare blog.git
# 进入钩子文件夹hooks
cd blog.git/hooks/
# 启用post-update
mv post-update.sample post-update
# 添加执行权限
chmod +x post-update
# 配置post-update
vim post-update

注释如下行:

1
exec git update-server-info

添加如下代码:

1
git --work-tree="静态文件VPS存放目录" --git-dir="刚才新建的VPS git地址" checkout -f

例如:

1
git --work-tree=/home/hexo/blog --git-dir=/home/hexo/blog.git checkout -f

当然,这里直接放在/home目录不太妥当,也可以放在其他文件夹例如/usr/local/static,更符合对于不同用户的权限分离。但是注意,放在非hexo用户的目录下,需要用chmod +777给目录配置权限,否则git hock无法访问

# Nginx

nginx作为一个完成度非常高的负载均衡框架,和很多成熟的开源框架一样,大多数功能都可以通过修改配置文件来完成,使用者只需要简单修改一下nginx配置文件,便可以非常轻松的实现比如反向代理,负载均衡这些常用的功能。这里我们仅仅用到最简单的功能,但还是介绍一下比较好

# Nginx基本操作

启动nginx:

1
2
3
4
5
6
##使用systemctl
systemctl start nginx.service
#使用service
service nginx start
#或,简单粗暴的直接调用
nginx

停止nginx:

1
2
3
4
5
6
7
8
##使用systemctl
systemctl stop nginx.service
#使用service
service nginx stop
#直接强行结束
nginx -s stop
##Nginx在退出前完成已经接受的连接请求。
nginx -s quit

重启nginx: 当我们修改了nginx的某些配置,为了使配置生效,我们往往需要重启nginx,同样的,linux下依然有两种方式来重启我们的nginx服务:

1
2
3
4
5
6
##使用systemctl
systemctl restart nginx.service
#使用service
service nginx restart
#使用nginx命令重启
nginx -s reload

其他命令:检查配置文件,同时显示配置文件目录:

1
nginx -t

要注意,如果不是在本地服务器直接调试。在服务器端的各种修改很可能因为DNS解析等各种原因不能及时更新。重新nginx之后切忌多ctrl+f5刷新几次,血的教训。

# Nginx简单配置

/etc/nginx/nginx.conf是新的默认配置文件,但server块在最新版本中不在这里,而是放到了/etc/nginx/sites-available中,并在/etc/nginx/sites-enabled中用软连接控制配置。我们这里比较简单,直接修改/etc/nginx/sites-available中的default文件中的server块就行

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
server {
        # 默认监听80端口
        listen       80 default_server;
        listen       [::]:80 default_server;
        # 修改server_name为自己之前注册好的域名,没有就不用更改
        server_name  xxx.com;
        # 修改网站根目录,在这里存放你的Hexo静态文件,请自行选择或创建目录
        root         /home/hexo/blog;
        # 其他保持不变

        location / {
        }
    }

# 更新Hexo的deploy方式

找到本地Hexo博客的站点配置文件_config.yml,找到以下内容并修改:

1
2
3
4
deploy:
  type: git
  repo: [email protected]:XXXX/XXXX.github.io.git
  branch: master

可以看到这里只能上传到github一种。但我们想同时传到vps和github托管,可以吗?直接这样写就行:

1
2
3
4
5
6
deploy:
  type: git
  repo:
    github: [email protected]:XXXX/XXXX.github.io.git
    vps: [email protected]:/your/file/path
  branch: master

如果你修改了SSH端口,可以使用该方法来访问

1
vps: ssh://[email protected]:port/your/file/path

之后直接使用:

1
2
3
hexo clean
hexo generate
hexo deploy

就能同时上传到VPS和github托管了!

Licensed under CC BY-NC-SA 4.0
使用 Hugo 构建
主题 StackJimmy 设计