首页 Configuration

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

VPS 环境：Ubuntu 18.04。

# 准备工作

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

  • 将 Hexo 项目上传到 VPS 上面后执行 hexo server ，之后配置 Nginx 反向代理，让域名指向 http://localhost:4000。
  • 将 Hexo 在本地通过 hexo generate 生成静态文件，在通过 hexo deploy 部署到 VPS 上面，使用 Nginx 直接做 Web 服务器。
  • 相比第二种方式，第一种每次写博客与更新博客时候的操作会很繁琐。所以我们使用第二种方式进行部署，这样既可以将静态文件 deploy 到 VPS 上，也可以上传到 Github 上用作备份，操作性和安全性上都要胜于前者。
  • 而对于第二种方式而言，常用的又有 git hook 和 rsync 两种自动部署解决方案。

本文主要介绍 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 权限

执行：

chmod 740 /etc/sudoers
vim /etc/sudoers

找到以下内容：

## User privilege specification
root    ALL=(ALL:ALL) ALL
# 在 root ALL=(ALL:ALL) ALL 这一行下面添加
git ALL=(ALL:ALL) ALL

保存退出后，修改回文件权限：

chmod 440 /etc/sudoers

# 关闭 git 用户 shell 权限

我们也可以通过：

ssh git@VPS IP

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

因此我们关闭 git 用户 shell 权限，执行：

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 仓库

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

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

# 创建网站目录

cd /home/wwwroot/                //切换目录
# 由于我想直接将博客放在 /home/wwwroot/ 下，所以并没有创建 blog 目录
mkdir blog                  //创建网站目录，以blog为例

# 配置 SSH

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 文件里，一行一个。

# 用户组管理

ll /home/git/
ll /home/wwwroot/

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

修改用户权限的命令：

# chown -R 用户名。组名 / 目录
chown -R git.git /home/git/blog.git/
chown -R git.git /home/git/.ssh/
chown -R git.git /home/wwwroot/

安装配置 Nginx

由于我之前已经装过了 nginx，nginx 安装内容来源于网络，仅供参考。

# 安装 Nginx

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

# 配置 nginx

执行：

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

参考配置文件内容：

server {
    listen 80 default;              #默认监听 80 端口
    root /home/wwwroot;             #网站根目录
    server_name nightfury.top, www.nightfury.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 /home/wwwroot;
        access_log   off;
        expires      1d;
    }
    location ~* ^.+\.(css|js|txt|xml|swf|wav)$ {
        root /home/wwwroot;
        access_log   off;
        expires      10m;
    }
    location / {
        root /home/wwwroot;
        if (-f $request_filename) {
        rewrite ^/(.*)$  /$1 break;
        }
    }
    location /nginx_status {
        stub_status on;
        access_log off;
    }
}
保存退出后，启动 nginx：
systemctl start nginx
设置开机自动启动：
systemctl enable nginx
查看运行状态：
systemctl status nginx
显示 running 表示成功运行。
# 配置 Git Hooks
# 创建 post-receive 文件
git 用户下执行（这里我用 root 用户执行上述命令，然后更改了文件所有者为 git.git，就是 chown -R git:git post-receive ）：
cd /home/git/blog.git/hooks  //切换到hooks目录下
vim post-receive             //创建文件
复制下面的内容到 post-receive 文件中：
#!/bin/bash
echo "post-receive hook is running..."
GIT_REPO=/home/git/blog.git
TMP_GIT_CLONE=/tmp/blog
PUBLIC_WWW=/home/wwwroot
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 服务中。
赋予可执行权限：
chmod +x post-receive
# 本地操作
# 尝试连接
在本地打开 Git Bash：
ssh git@VPS的ip
若默认端口不是 22，则需要在后面加上 -p 端口号：
ssh git@VPS的ip -p 2022
返回结果应该如下：
->ssh git@nightfury.top
->Welcome to Ubuntu 18.04 LTS (GNU/Linux 4.14.129-bbrplus x86_64)
 * Documentation:  https://help.ubuntu.com
 * Management:     https://landscape.canonical.com
 * Support:        https://ubuntu.com/advantage
 * Strictly confined Kubernetes makes edge and IoT secure. Learn how MicroK8s
   just raised the bar for easy, resilient and secure K8s cluster deployment.
   https://ubuntu.com/engage/secure-kubernetes-at-the-edge
 * Canonical Livepatch is available for installation.
   - Reduce system reboots and improve kernel security. Activate at:
     https://ubuntu.com/livepatch
Last login: Mon Aug 14 15:56:58 2023 from 159.226.177.100
fatal: Interactive git shell is not enabled.
hint: ~/git-shell-commands should exist and have read and execute access.
Connection to nightfury.top closed.
提示无法登录 shell 是正常的，因为我们在之前就为 git 用户指定了 git-shell 每次一登录就自动退出。
# 配置 Hexo
打开本地博客根目录下的_config.yml 文件，找到最后的 deploy 配置，修改为：
## Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  - type: git
    repo: git@github.com:szNightFury/szNightFury.github.io.git
    branch: master
  - type: git
    repo: git@nightfury.top:/home/git/blog.git
    branch: master
到此，Hexo 建站就全部配置部署完毕了。
  
 更新于   阅读次数  次