背景

我自己有一个用Hexo搭建的网站——，用来发布自己写的文章。文章使用阿里云的代码托管服务（以下简称CODE，使用Gitlab搭建）存储，并在ECS上进行克隆，通过Nginx进行访问。

网络图

开始的时候，我发布文章的流程如下：

在电脑上编辑文章。要发布的时候，执行hexo g -d，通过Git发布到CODE上。使用SSH登录服务器，在服务器上的网站根目录下执行git pull，完成同步。

在此之前，我把连接配置名、密钥什么的都设置好了。新版的Windows 10自带SSH客户端，因此基本上不需要下载其他的SSH客户端。

不过，上面的流程要输入好几行代码，中间等待的时间还是比较长的。后来，我将第二步和第三步用一行PowerShell命令行搞定了：

hexo g -d; ssh 之前设置好的连接配置名 "cd 服务器上的网站根目录 && git pull"

不过，这行代码太长，我一般都是在终端里面上翻历史命令，找到这一条再执行的。结果，几周前重装系统后，这条记录就没了，我还因为命令中的分隔符纠结了半天。

于是，我便想：如果能够在执行hexo g -d之后自动更新服务器上的文件，就好了。

WebHooks介绍

我以前听说，GitHub上面可以通过Travis CI这样的持续集成工具，在推送时进行测试、构建、部署等工作。

后来，我发现，Gitlab中，有一个叫WebHooks的东西，如果加以利用，可以自建属于自己的持续集成工具（其他的代码托管平台也有类似的功能，包括上面提到的GitHub）。

简单来说，WebHooks就是：当项目进行了某项操作（如提交），代码托管平台就会调用给定的URL，发送一条POST请求。至于URL那边的服务器，接收到请求之后，就可以为所欲为了——这篇文章中提到的同步存储库什么的，只是冰山一角，如果你会写一些脚本，理论上可以做到发邮件、在社交平台/即时通信平台上发送消息、甚至如前面提到的那样，自动进行测试、构建、部署。当然，和一般的请求一样，服务器也会给一个返回。不过这个返回的意义并不是非常大，相比之下，服务器内的处理流程才是最重要的。

WebHooks示意图

设置WebHooks的方法

在CODE（其他基于Gitlab的托管平台的操作流程应该也差不多）中，设置WebHooks的方式很简单：

在项目的设置中，点击“WebHooks”选项，填入接收请求的URL，选择触发事件，点击下面的“增加WEBHOOKS”，即可成功添加一条。可以看到，在“触发”的选项中，有一个“推送事件”，当推送内容至仓库后，即触发。

增加WebHooks

这样一来，我们可以写实现如下操作的代码：当接收到请求后，即在服务器中对网站根目录进行git pull操作。

其实，这种要求非常低。如果你装了宝塔面板，只要装一下“宝塔WebHook”的插件，在插件里面设置好如下的shell脚本就可以了。

cd 网站根目录git pull

点“查看密钥”，就可以看到插件给你的URL，用这个URL做WebHook的链接就行了。

宝塔WebHook给出的URL

仅在提交特定分支时调用URL

但是，我的这个仓库有两个分支：master和hexo。master分支存储生成的网页文件，hexo分支存储网站的源文件和设置。我只想让服务器在master分支被提交时更新网站内容，而hexo分支更新与否与网站无关。

Gitlab中并没有关于“提交某个特定的分支”的触发事件，但是，在调用URL的时候，会发送特定的请求头和请求体。

帮助文档中给出了比较详细的事例。比如推送事件的请求头如下：

X-Gitlab-Event: Push Hook

请求体为JSON格式的内容，如下：

{  "object_kind": "push",  "before": "95790bf891e76fee5e1747ab589903a6a1f80f22",  "after": "da1560886d4f094c3e6c9ef40349f7d38b5d27d7",  "ref": "refs/heads/master",  "user_id": 4,  "user_name": "John Smith",  "user_email": "john@example.com",  "project_id": 15,  "repository": {    "name": "Diaspora",    "url": "git@example.com:mike/diasporadiaspora.git",    "description": "",    "homepage": ";,    "git_http_url":";,    "git_ssh_url":"git@example.com:mike/diaspora.git",    "visibility_level":0  },  "commits": [    {      "id": "b6568db1bc1dcd7f8b4d5a946b0b91f9dacd7327",      "message": "Update Catalan translation to e38cb41.",      "timestamp": "2011-12-12T14:27:31+02:00",      "url": ";,      "author": {        "name": "Jordi Mallach",        "email": "jordi@softcatala.org"      }      "added": ["CHANGELOG"],      "modified": ["app/controller/application.rb"],      "removed": []    },    {      "id": "da1560886d4f094c3e6c9ef40349f7d38b5d27d7",      "message": "fixed readme",      "timestamp": "2012-01-03T23:36:29+02:00",      "url": ";,      "author": {        "name": "GitLab dev user",        "email": "gitlabdev@dv6700.(none)"      },      "added": ["CHANGELOG"],      "modified": ["app/controller/application.rb"],      "removed": []    }  ],  "total_commits_count": 4}

可以看到，请求体里面的"ref"字段中包含了推送的分支，只要做到这个操作就可以了：在服务器收到请求后，读取请求体，判断该字段中是否表示master分支，如果是，则更新网站根目录的内容。

当然，为了安全，还要验证请求头是否正确。

流程图

但是，“宝塔WebHook”插件太简单了，做不到这个。它的传值在查询字符串中，读不了请求头和请求体。这样一来，我就只能写服务器脚本来实现这个功能了。

你可以使用你熟悉的语言和框架写服务器脚本，只要能够收到请求并作出正确的反应就行了。我接触JS和Python比较多，不过Python中的Flask框架足够轻量（说实话貌似有更轻量的），开发起来也容易得多。于是，我便使用了Python和Flask框架来写这个脚本。

使用Python和Flask框架实现功能

安装好Flask，然后写入如下的代码。

基本骨架是Flask提供的Hello World示例，我翻了很多资料，东拼西凑出来可以运行的代码。不过确实非常简单。

一些必要的注释我放在代码里面了。

# flask.request是用来处理请求的from flask import Flask, request# 代码中涉及到日志import logging# 切换目录用import os# 执行外部脚本用import subprocessapp = Flask(__name__)# 这样写，URL就是http://地址:端口号/hook# WebHooks用的是POST请求@app.route('/hook', methods=['POST'])def git_hook():    # 请求头要对应；请求头有很多字段，所以找请求头中是否有这个字符串    if str(request.headers).find('X-Gitlab-Event: Push Hook')!=-1:        # 找请求体的"ref"字段是否有"master"的字样        if str(request.json['ref']).find('/master')!=-1:            # 切换目录            os.chdir('网站根目录')            # 使用subprocess.check_output执行shell脚本，脚本内被空格隔开的部分用列表装住            # 如果出错，会抛出subprocess.CalledProcessError错误，所以要用try...except接住错误            # subprocess.CalledProcessError.returncode是错误时的返回值            # subprocess.CalledProcessError.output是shell脚本在控制台上输出的字符            try:                output = subprocess.check_output(['git','pull'])            except subprocess.CalledProcessError as e:                app.logger.error('git err at %s', e.returncode)                app.logger.error('git err output:\n %s', e.output)                return 'git error'            app.logger.info('git pull master success')            return 'sucess'        else:            # 非master分支的提交            app.logger.info('not master')            # 返回不需要写那么详细            return 'sucess'    else:        # 请求头错误        app.logger.info('head error')        return 'error'

在服务器上部署代码。我用的是宝塔的Python项目管理器，因此具体的脚本我就不清楚了，反正我用了gunicorn。

之后，用Nginx进行端口的反向代理，并应用SSL。具体设置方法看网上的文档，因为我也是用宝塔的默认文档魔改的。当然，如果你对安全不那么在意的话，你也可以不用设置Nginx。这时，监听主机要设置为'0.0.0.0'。

此后就可以到CODE（Gitlab）去设置WebHooks了。如果你用了反代什么的，就根据反代的参数设置URL。如果你开了SSL，就可以点下面的“开启SSL证书验证”了。

增加完成后，要多测试。页面下方给出了测试按钮，会发送一条测试的请求。到主机的服务器上看日志、看返回结果什么的，看看执行的怎么样。

WebHooks测试

不仅要用这个测试按钮，还要在本地实际进行提交，进行测试。我上面的代码就测试了不下十次才写出点样子。

不仅仅是网站，还可以是整个项目

实际上，一开始，这个仓库只有一个分支。之所以开另一个分支，是因为我希望能够在不同的地方写文章。

和WordPress这样的博客系统不同，Hexo在线上是静态的，源文件都在本地。我此前希望自己写在线编辑器，但是因为我懒、菜，就一直没有写。后来我试了hexo-admin、hexo-myadmin这样的在线编辑器，但是前者太丑了，后者在手机端上几乎没法用。最后我找了半天，选择了hexo-hey，因为它的页面适配手机端比较好。但是，作者不更新了，手机端上也有一些问题。目前我还没有找到满意的在线编辑器。

hexo-hey的效果

要使用在线编辑器，就要把整个工作目录放上去，而不仅仅是生成的文件。我在知乎上找到了教程，将生成文件和工作目录放到不同的分支下。然后，我按照组件、用pm2执行，再用Nginx做反向代理，以便使用SSL证书，终于搞好了。

这时，如果在手机端上修改了文章的草稿（由于我修改了一些node-modules，加上我写文章并不快，所以我目前不期望在手机端上发布文章），就要：在手机端上使用SSH登录到服务器，再在工作目录下执行以下命令，以将更改上传到CODE：

git add .git commit -m "提交信息"git push

然后，回去用电脑编辑之前，也要从CODE上下载更改。更要命的是，编辑好了之后，还要上传更改，然后在服务器上下载更改，以便手机端修改。

简而言之，每次编辑前后，都要拉取、提交修改。电脑端上倒无所谓，但是手机端上执行这一系列流程挺困难的。而且，虽然关于git的所有流程都在电脑上进行，但是还是挺麻烦的，而且容易忘记拉取，一旦忘了就尴尬了。

在我写完上面的脚本之后，我想到了这个情况，便想到了一个方法：当推送hexo分支后，同时在服务器上拉取该分支。这样一来，就能省下一半的工作量。

修改起来也简单，只要在上面的代码中的# 非master分支的提交处，照着写一下hexo分支提交之后的处理方法，再测试一下，就行了。

至此，我的服务器的功能图如下：

服务器功能图