hexo博客部署到服务器

不使用github pages，改为自己的服务器。将代码托管到gtihub，使用webhook实现github与服务器同步推送代码，并且安装hexo-admin来实现后台管理与服务器到github上的推送。

购买服务器

服务器商千千万，自行挑选一个靠谱的。

注意：国内各服务商有学生优惠套餐，但是只能购买大陆服务器，且大陆服务器需要备案才能使用，备案很麻烦，要花十几到二十天左右。但是便宜稳定。

进入服务商的购买页面，选择配置。

若是一键选择套餐购买，需要选择地区、选择服务器的配置、选择服务器镜像系统、服务器带宽(越大则服务器能承受的压力越大)、购买时长。

若是自定义配置，需要选择购买的计时方式、配置的详细选择，更多的系统选择以及自定义镜像、存储空间。

总结就是越强越贵，时间越长越贵。个人博客不需要非常好的配置，推荐系统选择linux

注意：大陆服务器需要至少购买3个月时长才可以进行备案。

假如是国外服务器，则购买后可以直接进行部署了。如果是头铁选了国内，则需要先进行备案(大概20天左右。备案流程放到最后。)

我使用的宝塔控制面板，简单方便无脑。安装宝塔后，可以在控制面板进行操作来操作自己的服务器。

注：若服务器操作过程出现无法挽回的问题，可以在服务器控制台重装系统。

连接服务器

首先下载putty、xhell等连接工具，我使用的是finalshell，用哪个都可以，原理都一样，用服务器商自带的登陆功能也可以。打开后界面如图。

点击文件夹，新建一个连接，选择SSH连接

名称自定义，主机为上一步的ip地址。填写完后点击确定。

(国外服务器可勾选智能加速，国内则不勾选)此时我使用的是美国服务器，所以勾选了海外加速。

可以看到新建了一个服务器连接，ssr为刚刚自定义的名称，后面有ip地址和端口号，和服务器主机名。

双击该连接，进入服务器，连接成功出现如图所示界面。

如果出现该窗口

点接受并保存。

部署到服务器

解析域名

注：若github page有绑定域名的话，先把绑定解除，并且将解析暂停，否则会冲突。

---

到域名管理处，点击解析

按照如图所示添加两条记录，一个主机记录选@（直接输入域名即可进入网站），一个选www（前面加上www可进入网站），也可以自定义一个前缀，但在后面站点配置时要加进去。

记录类型选A，指向一个IP地址，然后在记录值处填自己服务器的公网IP。

主机记录说明：

安装宝塔面板

根据官方教程进行安装。

宝塔Linux面板安装教程

若安装完成不能使用，则需要放行端口：

腾讯云：https://www.bt.cn/bbs/thread-1229-1-1.html

阿里云：https://www.bt.cn/bbs/thread-2897-1-1.html

华为云：https://www.bt.cn/bbs/thread-3923-1-1.html

进入服务器，根据自身系统输入安装命令，命令失效则看官方教程，有备用命令

Centos安装命令：

yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh

Ubuntu/Deepin安装命令：

wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh

Debian安装命令：

wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && bash install.sh

Fedora安装命令:

wget -O install.sh http://download.bt.cn/install/install_6.0.sh && bash install.sh

以cenOS为例：

输入命令进行安装

输入y，安装宝塔，然后稍等片刻

如图安装完成，会显示控制面板的url以及用户名和密码

安装完成后，就可以关闭finalShell了，打开浏览器，输入该地址，并输入刚刚显示的用户名和密码，进入面板

这里建议进入后修改登陆面板的帐号与密码，不使用默认生成的。并且将面板的网址保存起来，方便以后直接输入网址进入面板。

进入面板后，会出现如下提示，进行安装软件。可以根据需求进行安装，也可以直接点一键安装，推荐LNMP，且选择极速安装，编译安装太慢。

创建站点

宝塔面板安装完成后，在导航栏点击网站，选择添加站点。

设置如下，在域名处填写自己的域名，可填写多个 （填写进的域名在解析完成后可以访问到该网站）

生成站点后，点击网站名或者后面的设置，可以进入站点设置来添加一些新的域名以及二级域名等等。

其中abc为自定义的二级域名，想不想设置随意。设置了就需要在解析时填写对应的主机记录。

点击添加后如下，这样用户可以通过以下域名访问到该服务器部署的网站，如果不想让github.io的地址也访问到该服务器，可以删除。

添加的域名需要解析到服务器才可以正常使用。

添加完成后关闭设置即可。

最后到域名管理处。进行解析。添加记录如下

• 记录值：www和@各添加一次，
• 记录类型：选A
• 线路类型：默认
• 记录值：你的服务器IP地址

结果如下（若有自定义二级域名等等，需要再添加上。）

等待几分钟生效，即可通过域名访问该服务器。

使用webhook实现同步页面

虽然服务器是配置好了，但是宝塔并不支持代码托管，也就是说使用hexo d命令推送的代码并不能推到宝塔上来实现更新网站。于是使用webhook来实现与github代码同步。

原理：

安装宝塔WebHook

在宝塔面板导航栏点击软件商店。搜索 webhook 点击安装。

配置webhook

安装完成后，点击设置，(可以勾选首页显示。)

点击添加，名称随意，执行脚本先随便填写一点内容，点击提交后再编辑脚本。

（若出现编辑不能保存的情况，则在宝塔面板的右上角点修复）

添加完成后点击编辑，删除原来随意填写的内容，添加如下代码并修改gitHttp。

注：

1. 原代码有一个$1变量，在后面的密钥部分的URL地址最后通过param=X，将X作为 该变量传入脚本，但因为我无论怎么改都会出现参数错误，因此将该变量删掉了。然后改一下代码，将​$1的参数替换为固定的值，只要站点目录存在就没问题。
2. 大概是因为自己设置了保存博客源代码的分支为默认分支的原因，用原代码里面的有一句git pull总是拉不过来文件，在服务器上手动拉取发现拉取的是博客源代码的分支。故在原代码中将git pull改成git pull origin master来指定拉取静态页面的分支。

#!/bin/bash
echo ""
#输出当前时间
date --date='0 days ago' "+%Y-%m-%d %H:%M:%S"
echo "Start"
#git项目路径
gitPath="/www/wwwroot/【站点根目录】"
#git 网址
gitHttp="【仓库git地址】"

echo "Web站点路径：$gitPath"

#判断项目路径是否存在
if [ -d "$gitPath" ]; then
        cd $gitPath
        #判断是否存在git目录
        if [ ! -d ".git" ]; then
                echo "在该目录下克隆 git"
                sudo -Hu www git clone $gitHttp gittemp --depth=1
                sudo mv gittemp/.git .
                sudo rm -rf gittemp
        fi
        #拉取最新的项目文件
        echo "拉取最新文件"
        sudo -Hu www git reset --hard origin/master
        sudo -Hu www git pull origin master
        #设置目录权限
        echo "设置目录权限"
        sudo chown -R www:www $gitPath
        echo "End"
        exit
else
        echo "该项目路径不存在"
        echo "End"
        exit
fi

更新： 在指令语句前加入sudo，授予管理员权限，避免执行失败

gitHttp路径为github代码仓库的地址，需要到代码库中查看(带.git尾缀的地址，即hexo部署时配置 _config.yml时填写的地址。)，点击复制键进行复制

粘贴后格式应该如下

gitHttp="https://github.com/XXXXXX.git"

随后点击右下角的保存即可。

github配置hook

编辑完成后，点击查看密钥

复制好密钥以及下方URL的&前面的内容（全复制也可以）

进入github的网站代码库的设置，导航栏选webhook，然后点击Add webhook

填写内容

填写好后点击Add webhook。

然后回到面板，点击测试，然后在日志中查看结果。

同时回到github的webhook界面，编辑刚刚的钩子

在最下面可以看到成功的信息。

这样以后在本地进行的deploy，服务器最自动钩取github仓库的master分支，实现将博客部署到服务器上。然后使用域名就可以进行访问(不要加https://)。

添加SSL证书，开启https协议

注：若出现访问拒绝的话，注意是否加了https协议。

没有配置SSL证书的话，用https访问会被拒绝。SSL证书有收费的也有免费的。

宝塔自带免费证书，但要求实名认证。

接下来以个人服务商腾讯云的免费证书为例，

按步骤填写即可注册证书。添加后下载证书，然后解压。

若关闭了界面，可以在SSL证书处下载证书

打开下载好的文件夹，打开Apache

打开.crt和.key结尾的文件。

然后在宝塔面板进入站点的设置，图中点击网站名或者设置都可以

如图，在SSL界面其他证书里，将.key结尾的密钥放入左边，.crt结尾的证书放入右边，保存，然后强制HTTPS，即可开启https协议。

源代码同步到服务器（舍弃）

更新（必看）：

本来是想的利用hexo-admin实现在服务器上开启后台管理，然后就能实现理想中的功能：

1. 本地操作完博客后，源代码+静态页面+文章都可以同步到服务器上

2. 服务器操作完博客后，源代码+静态页面+文章也都同步到本地

这样的话，我可以在本地尝试修改主题与配置，满意后进行推送同步到服务器。在没有hexo与git环境时（如临时用其他电脑或者用手机），然后又不能安装或者不想安装的话，可以通过hexo-admin后台来写文章并deploy，等到了自己的电脑上直接克隆就可以完成同步了。

但在配置时发现了一个问题，hexo-admin提供的deploy功能貌似仅支持以hexo开头的命令，如hexo d、hexo new "文章名" ，我试图加入git命令然后就报错了。

这就导致我能成功将本地的源代码、静态页面推送到服务器，但是用hexo-admin新建然后写的文章是没办法自动保存到github上来克隆到本地的。再考虑到安装插件的问题，一些功能需要安装一些插件（如音乐播放器、live2D、加入视频等等）。插件是不会被推送的，若想推送插件的话，每次推送都要等待很长时间。

综上，故暂时舍弃源代码同步到服务器，让服务器仅保存静态页面就行了。所以下面的内容可以不用看了。

PS：关于能否使用git命令的问题已经提交到github上的Issues，如果有解决办法的话希望能留言告诉我。

在服务器上部署hexo

关于CentOS的安装git、Node.js我遇到一些问题，参考了下面两篇文章完美解决，故这里就不说安装方法了，直接看这两篇就行了。

CentOS安装Git参考链接：
https://www.cnblogs.com/imyalost/p/8715688.html

注：Hexo需要10版本以上才能支持，默认安装的话版本开头为6，需要安装最新版本才可以，我就用默认安装Node.js的方法结果最后hexo安装失败。

CentOS安装最新版Node.js参考链接：

https://www.jianshu.com/p/4a9449506924

安装hexo指令：

npm install hexo-cli -g

警告不用理会。

克隆保存在github上的博客代码

通过cd命令切换到想保存博客根目录的文件夹下，例如我打算把博客的根目录放在 /www下，则输入cd /www，

然后克隆在github上的博客源代码，例如我的命令为

git clone https://github.com/lluuiq/lluuiq.github.io.git，后面是仓库地址，改为自己的。

git clone 【仓库地址】

这样在输入该指令的文件夹下会出现【yourusername】.github.io的文件夹，里面放着博客的源代码。

若想改个名字的话，在包含根目录的文件夹下（我的是/www）输入下面指令

mv 【yourusername】.github.io 【newname】

我将文件夹名称改为wa2000，下面的wa2000文件夹都是博客根目录。

在服务器上的hexo根目录已经建成，接下来就是同步github上的源代码仓库，使得当github仓库的文件更新时，服务器上的博客源代码也会同步更新。

服务器上的hexo同步github

宝塔与webhook安装

步骤同 部署到服务器

设置webhook

与上方内容相同，但需要更改的是分支名选择存放博客目录的分支

个人的配置（参照修改）

git项目路径：gitPath="/www/wa2000"

git网址：gitHttp="https://github.com/lluuiq/lluuiq.github.io.git"

分支名：source

#!/bin/bash
echo ""
#输出当前时间
date --date='0 days ago' "+%Y-%m-%d %H:%M:%S"
echo "Start"
#git项目路径
gitPath="【你的博客根目录地址】"
#git 网址
gitHttp="【你的仓库地址】"

echo "Web站点路径：$gitPath"

#判断项目路径是否存在
if [ -d "$gitPath" ]; then
        cd $gitPath
        #判断是否存在git目录
        if [ ! -d ".git" ]; then
                echo "在该目录下克隆 git"
                git clone $gitHttp gittemp
                mv gittemp/.git .
                rm -rf gittemp
        fi
        #拉取最新的项目文件
        git reset --hard origin/【你的分支名】
        git pull
        #设置目录权限
        chown -R www:www $gitPath
        echo "End"
        exit
else
        echo "该项目路径不存在"
        echo "End"
        exit
fi

添加webhook后，参考上方内容与仓库进行链接即可。

创建站点

如图点击添加站点。

添加域名可以加前缀，但加了前缀也要加入对应的解析。根目录后面一定要是public文件夹，生成的静态页面会保存在该文件夹中，只有将该文件夹设为根目录网站才会正常显示，最后点击提交即可创建。

然后回到服务器，安装必要包

npm install hexo --save
npm install --save hexo-deployer-git

输入github的用户名与密码

git config --global user.email "【github邮箱】"
git config --global user.name "【github用户名】"

配置SSH

配置SSH免去每次推送都要帐号密码，任意地方输入下方指令，【注释】部分可用自己邮箱，github,也可以不加-C

ssh-keygen -t rsa -C "【注释】"

中间都按回车就行了，然后到ssh存放的地方

cd ~/.ssh
vim id_rsa.pub

打开id_rsa.pub后，复制里面的公钥（用finalshell的话直接在下方的文件目录里双击打开也可以）

然后到如图地方添加公钥

然后到仓库的地方，复制ssh地址

（若本来就是ssh地址则跳过）打开根目录的配置文件_config.yml，将deploy下的repository改为ssh地址。

在博客的根目录下生成静态页面并尝试推送到github

hexo clean
hexo g
hexo d

注：若出现下方情况则使用下方命令删除.user.ini

chattr -i 【.user.ini路径】
rm -rf 【.user.ini路径】

若出现下方情况则修改ssh配置

vim /etc/ssh/sshd_config

找到 RSAAuthentication与PubkeyAuthentication，将注释去掉，并确定AuthorizedKeysFile后面为.ssh/authorized_keys且可用。

然后重启ssh服务。

/sbin/service sshd restart

再次执行hexo d可能会出现下方警告

该警告是让你将github的IP加入host，可以无视，也可以加进去去掉警告。

vim /etc/hosts

然后在里面加入【警告中的IP地址】 github.com，保存并退出即可。

清除、生成、推送都成功后，重启宝塔面板

/etc/init.d/bt restart

重启后，在本地使用推送将博客源代码推到github时，服务器上会自动拉取进行同步。

接下来就是在服务器上开启远程后台管理了。

开启后台管理（舍弃）

使用hexo-admin插件开启后台管理功能，可以通过网页进入后台管理文章，也可以通过内置的脚本实现部署与推送。

放行4000端口

到宝塔面板的安全里放行4000端口，说明随意填。

以腾讯云为例，到服务器的管理处放行4000端口。

注意：hexo s命令不支持https，在输入网站时不要加https

测试推送

git操作官方文档，或者百度git指令查询详细用法。

在根目录处执行下方执行指令

git add .
git commit -m "【更新说明，随便填】"
git push origin 【博客源代码分支名】

出现上方提示说明可以进行推送。

如果保存源代码的分支不是默认的，要在git push后面空一格加上origin 【博客源代码分支名】

若提示

则输入

git remote add origin 【github仓库的ssh地址】

编写脚本

在根目录创建一个文件夹存放脚本（直接放根目录也行，但后面记得更改配置的路径），名称随意，我用admin作为文件夹名，deploy作为脚本名。然后进入创建的文件夹，新建并编辑一个脚本文件

我的代码为mkdir admin与vim deploy.sh

mkdir 【新建的文件夹】
cd 【创建的文件夹】
vim 【脚本名】.sh

在脚本文件中输入下方指令，“save blog”里面是更新说明，自定义填写。

#!/usr/bin/env sh
hexo g
hexo d

然后按ESC，接着输入:wq保存并退出。

这样当用后台管理时，会先生成静态页面，再进行部署，部署完成后会将源代码推送到github。

可自行修改需要的命令，例如加入hexo clean，也可以加一些其他自己需要的命令。

为刚刚脚本授予权限

chmod +x 【脚本名】.sh

然后执行该脚本看看效果，如果一切顺利，则可以进行下一步。效果大概如图：

脚本配置好后，开启开机自动启动hexo s命令来启动后台，因为hexo-admin

在创建的存放脚本的文件夹中新建自启脚本（同样名称自定义）

cd 【存放脚本的文件夹】
vim 【自启脚本文件名】.sh

然后输入命令，cd后面的路径要换成自己的博客根目录路径，例如我的为cd /www/wa2000

#!/bin/bash
cd 【博客根目录路径】
hexo s

写完后同样按ESC，输入:wq保存并退出

添加权限

chmod +x 【自启脚本名】.sh

然后返回服务器的根目录，打开etc/rc.d/rc.local

cd ~
vim /etc/rc.d/rc.local

在下面添加脚本路径，如我的脚本存放目录为/www/blog/admin/server.sh，添加效果如下

然后保存并退出。

执行下方命令授权

chmod +x /etc/rc.d/rc.local

然后重启服务器

reboot

稍等片刻进入http://【域名】:4000，若能进入，说明配置成功。

安装hexo-admin并配置

参考文档：Easy Hexo hexo-admin官网

服务器上进入博客根目录，然后输入命令安装hexo-admin

npm install --save hexo-admin

安装完成后即可通过http://【域名】:4000/admin 进入后台。接下来进行一些配置。

进入后台的设置界面，点击红框内的链接。

如图，填入登陆后台用的用户名与密码，secret能为密码进行加密，随意填自己喜欢的短语就行。

将生成的代码拷贝到博客根目录下的配置文件_config.yml中，并添加deployCommand

deployCommand的内容单引号内为一条指令

./admin/deploy.sh指运行保存在admin文件夹内的deploy.sh，将路径改为自己的脚本运行指令即可。

保存，然后重启服务器。

关于网站备案的琐事

到购买服务器/域名的服务商那里有详细的备案流程说明，这里仅记录个人备案遇到的坑。以腾讯云举例。

腾讯云备案流程

1. 国家规定服务器需要购买至少3个月才能备案

   学生套餐优惠只能购买三次，一次最短购买一个月时长，最长为一年时长，本来抱着试试的心态只买了一个月，结果发现居然要至少3个月才能备案，于是只能再去用学生套餐来延长时长，本来三次机会，结果花了两次机会只买了一年一个月，如果确定想用大陆服务器并且想长时间使用的话，建议一次购买最长时长，10元/月算非常便宜了。

2. 审核时间长

   首先需要先为域名进行实名认证，实名认证后备案需要申请幕布进行拍照(给你邮过去，免邮)，等幕布到了以后按要求拍照并上传，填写关于网站的资料以及服务器的资料，最后提交。

   大概腾讯那边审核一两天，然后腾讯帮你提交到审核局审核个10天左右(最晚一个月，个人经历时间为10天左右)，审核通过后会给你工信部备案号，但还要到全国互联网安全管理服务平台再提交一次备案，不过这个审核较快，一天就通过了。通过后会给你联网备案号。

   以百度为例上面的为工信部备案号，下面的为联网备案号。

3. 关于在全国互联网安全管理服务平台备案

   注意：里面有一个为网站填写信息的，有个选择网站是否为交互类型，如果不是论坛、有注册功能的那种一定要选择否，选是的话需要到当地公安局一趟进行当面审核。这是为了保证网站安全所以需要到公安局进行审核，并且填写大概7-8页厚的表格。