Hexo 博客部署到腾讯云服务器全流程

本文首发于我的个人博客：https://careyq.cool

原来是部署到 github 和 coding 上的，访问速度较慢，并且图床 七牛云 自 2018年 7月起，测试域名的生命周期只有 30个自然日，这让维护博客造成了很大的麻烦，于是便准备使用服务器来进行部署了。

部署环境

• 本地环境
  • Windows10(64bit)
  • 环境：git，Node.js，hexo…
  • 生成本地静态网站
• 服务器环境
  • 腾讯云主机(CentOS 7.5 64bit)
  • 环境：git，Nginx，创建 git 用户
  • 使用 git 自动化部署发布

服务器配置

1. 安装 Git (源码包安装)

因为 yum 源仓库的 Git 版本更新不及时，所以采用源码包进行安装。

1.1 安装依赖包

yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel
yum install  gcc perl-ExtUtils-MakeMaker

通过命令 git --version 可以看到，Git 当前的版本号为 1.8.3.1，太过于陈旧，所以需要先把它移除了。

1.2 卸载旧版本的 Git

yum remove git

1.3 下载并解压

cd /usr/local/src   // 选择文件保存位置
wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.19.0.tar.gz   // 下载链接
tar -zxvf git-2.19.0.tar.gz   // 解压

git-2.19.0.tar.gz 是目前最新版本，其他版本以及之后版本可到此进行查看。解压后，会在当前目录下自动生成一个名为 git-2.19.0 的文件夹，里面就是解压出来的文件。可通过命令 ls 进行查看。

1.4 编译安装

cd git-2.19.0   // 进入文件夹
make prefix=/usr/local/git all  // 编译源码
make prefix=/usr/local/git install  // 安装至 /usr/local/git 路径

编译时，由机器配置决定速度，请耐心等待。

打开环境变量配置文件。

vim /etc/profile

在文件底部添加以下配置。

PATH=$PATH:/usr/local/git/bin   // git 的目录
export PATH

两个语句都要加上。

刷新环境变量。

source /etc/profile

最后再使用 git --version 查看版本号，已经为 2.19.0。

2. git 新用户及配置

2.1 创建 git 用户

adduser git
passwd git
chmod 740 /etc/sudoers
vim /etc/sudoers

找到以下内容。

## Allow root to run any commands anywhere
root    ALL=(ALL)       ALL

在它下面添加一行。

git ALL=(ALL) ALL

保存并退出，将权限修改回来。

chmod 400 /etc/sudoers

2.2 密钥配置

本地中，使用 Git Bash 创建密钥。

# 本地 windows gitBash
ssh-keygen -t rsa

一路回车，直至如下图，即可。

切换至 git 用户，创建 .ssh 文件夹以及 authorized_keys 文件并将本地的 id_rsa.pub 文件内容粘贴到里面。

su git
mkdir ~/.ssh
vim ~/.ssh/authorized_keys

修改权限。

cd ~
chmod 600 .ssh/authorzied_keys
chmod 700 .ssh

2.3 测试

在本地 Windows 上，使用 Git Bash 测试是否能连接上服务器。

ssh -v git@SERVER

其中 SERVER 为服务器 ip 地址。若出现以下错误提示，检查本地密钥位置是否存在 known_hosts 文件，将其删除重新测试。测试结果为，不需要密码直接进入。
错误提示：

2.4 创建网站目录

创建一个目录用于作为网站的根目录。

su root
mkdir /home/hexo    # 此目录为网站的根目录

赋予权限。

chown git:git -R /home/hexo

3. 安装配置 Nginx

注意需要 root 权限

yum install -y nginx    // 安装
systemctl start nginx.service     // 启动服务

使用 yum 安装的 nginx 在新版的 CentOS 中，需要使用 systemctl，而不是直接使用 service start nginx
此时通过服务器的公网 IP 地址访问，可以看到 nginx 的欢迎页面，表示安装成功，如下图:

3.2 配置 Nginx

使用 nginx -t 命令查看位置，一般为 /etc/nginx/nginx.conf。
使用 vim /etc/nginx/nginx.conf 命令进行编辑，修改配置文件如下：

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  staunchkai.com;    # 修改为自己的域名
    root         /home/hexo;    # 修改为网站的根目录

    # Load configuration files for the default server block.
    include /etc/nginx/default.d/*.conf;

    location / {
    }

    error_page 404 /404.html;
        location = /40x.html {
    }

    error_page 500 502 503 504 /50x.html;
        location = /50x.html {
    }
}

root 处的网站目录，需要自己创建，也就是部署上传的位置。

注意使用 nginx -t 命令检查配置文件的语法是否出错。然后使用 systemctl restart nginx.service 命令重启服务即可。

4. 自动化部署

4.1 建立 git 裸库

创建一个裸仓库，裸仓库就是只保存 git 信息的 Repository, 首先切换到 git 用户确保 git 用户拥有仓库所有权，一定要加 --bare，这样才是一个裸库。

su root
cd /home/git   # 在 git 用户目录下创建
git init --bare blog.git

这时，git 用户的 ~ 目录下就存在一个 blog.git 文件夹，可使用 ls 命令查看。再修改 blog.git 的权限。

chown git:git -R blog.git

4.2 使用 git-hooks 同步网站根目录

在这使用的是 post-receive 这个钩子，当 git 有收发的时候就会调用这个钩子。 在 blog.git 裸库的 hooks 文件夹中，新建 post-receive 文件。

vim blog.git/hooks/post-receive

填入以下内容，其中 /home/hexo 为网站目录，根据自己的填入,保存退出。

#!/bin/sh
git --work-tree=/home/hexo --git-dir=/home/git/blog.git checkout -f

保存后，要赋予这个文件可执行权限。

chmod +x /home/git/blog.git/hooks/post-receive

本地配置

在本地中，和部署到 pages 服务一样，需要先 hexo g 命令生成静态文件，通过 hexo s 命令能够正常进行本地访问，并且确保已经安装了 hexo-deployer-git。

配置 _config.yml

hexo 根目录下的 _config.yml 文件，找到 deploy。

deploy:
    type: git
    repo: git@SERVER:/home/git/blog.git     # repository url
    branch: master      # 分支

之后按照正常的流程进行部署即可。

hexo clean
hexo g
hexo d

常见错误

git-receive-pack: 未找到命令

hexo d
bash: git-receive-pack: command not found
fatal: Could not read from remote repository.

解决办法：

sudo ln -s /usr/local/git/bin/git-receive-pack  /usr/bin/git-receive-pack

git-upload-pack: 未找到命令

正克隆到 'blog'...
bash: git-upload-pack: command not found
fatal: Could not read from remote repository.

解决办法：

sudo ln -s  /usr/local/git/bin/git-upload-pack  /usr/bin/git-upload-pack

不是一个 git 仓库

fatal: 'XXXX/blog.git' does not appear to be a git repository
fatal: Could not read from remote repository.

解决办法：
确保 _config.yml 文件中 deploy 处的 repo 路径填写正确。