背景

目前我个人的博客是托管在Github Pages下，用的也是Github提供的免费域名，但每个程序员都有个梦想，就是有一个属于自己的博客。于是就决定趁着这段时间不忙，把Github Pages上的博客迁移到自己的服务器上，同时把这个过程记录下来，也能帮助到想要拥有自己博客的人。

需求清单

这里先简单陈列一下，搭建一个个人博客所需要的所有东西

云服务器，用于运行博客网站
域名，用于用户可以方便地访问你的博客，你也不想访问别人网站的时候，还要记住毫无规律的IP吧
备案（可选），如果服务器在大陆，那么这个是逃不了的，没有备案分分钟网站关停
Github账号，用于存储博客

接下来按照优先等级一个个详细介绍

博客仓库

初始化

第一步我们先要有一个博客仓库，用来储存所有的文章，这里我选择的是Hexo博客框架，是最近比较热门的博客框架。Hexo可以选择网站的主题，这里我选择的是nexT主题，也是Hexo框架里非常热门的主题。按照Hexo文档里的提示，我们执行

npm install -g hexo-cli，安装hexo命令行工具。注意Hexo要求系统已经安装Node.js和Git，如果没有安装过，可以移步各自的官方文档进行安装。
接着执行hexo init xxx-blog，生成hexo项目
cd xxx-blog && npm install，然后用任意编辑器打开xxx-blog文件夹，你会看到这样的目录，说明博客仓库初始化成功了
hexo s，看到控制台打印的说明博客运行成功了，访问localhost:4000就能看到博客页面了
hexo g && hexo d，部署博客到Github仓库，这里hexo会把生成的静态文件push到另一个分支，默认是gh-pages，因此我们需要分清楚， hexo的main分支是存放我们的md文章，以及hexo的配置，gh-pages分支是存放hexo generate后的html等静态文件，用于页面展示的。

基础配置

接着需要对hexo进行一些配置，hexo的配置文件在./_config.yml，下面列举几个比较重要的配置，其他配置都可以参考官方文档

网站基础信息配置，这里需要配置网站标题，作者等信息
静态资源配置，这里配置文章里引用的图片
Git部署配置，这里配置博客部署发布的Git信息如果需要 标签(tags) 、关于(about) 、搜索(search) 页面，需要在source下面新建文件夹，然后新建index.md文件，以标签为例子

markdown 复制代码

// 路径：./source/tags/index.md
---
title: tags
date: 2023-09-13 15:35:31
type: tags
---

主题配置

nexT官方推荐的配置文件是./config.next.yml，如果懒得看官方文档，可以直接使用我这份配置文件

SEO配置

参考官方文档进行基础配置，接着配置各个搜索引擎的收录，这方面的资料很多，可以参考这篇

评论系统

最开始打算用valine，毕竟是nexT主题用的最多的评论系统之一，但在nexT官方issue下提到由于valine不再开源，于是他们决定在8.1.0版本中移除valine的默认支持。所以我就把评论系统换成了disqus，可惜disqus被墙了，所以最终换成了disqusjs，通过disqus api的方式接入disqus评论。

上线

有了博客仓库后，接下来要做的事就是把网站上线到互联网，让大家访问了

云服务器

国内可以选购腾讯云，阿里云，华为云等，一般博客不需要很好的配置，1核2G足以，这里我用的是腾讯云。购买成功后，需要将自己的ssh 公钥加进服务器里。本地公钥文件在~/.ssh/id_rsa.pub里，然后在腾讯云云服务器里绑定创建成功后在密钥列表里选择刚才创建的密钥，绑定服务器即可

域名

最好在你购买的云服务器厂商里注册，绑定解析什么的比较方便，后缀推荐.com|.org，最好不要选择.cn，注册好之后在域名服务商里添加解析

部署

通过ssh登录服务器后

首先安装nginxsudo apt update && sudo apt install nginx 接着启动nginxsudo systemctl start nginx && sudo systemctl enable nginx。nginx的配置文件在/etc/nginx下

配置https证书，这里我们使用免费的Let's encrypt，注意如果在这个步骤遇到了域名无法访问的问题，请先往下解决备案后，再回来生成证书。按照Let's encrypt的教程生成证书后，会自动在nginx/sites-available目录下创建以域名为名称的配置文件，如下

text 复制代码

server {

    server_name blog.zshnb.com;

    root /home/ubuntu/blog;
    index index.html;
    location ~* ^.+.(jpg|jpeg|gif|png|ico|css|js|pdf|txt){
            root /home/ubuntu/blog;
    }

    listen [::]:443 ssl; # managed by Certbot
    listen 443 ssl; # managed by Certbot
    ssl_certificate /etc/letsencrypt/live/blog.zshnb.com/fullchain.pem; # managed by Certbot
    ssl_certificate_key /etc/letsencrypt/live/blog.zshnb.com/privkey.pem; # managed by Certbot
    include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot

}
server {
    if ($host = blog.zshnb.com) {
        return 301 https://$host$request_uri;
    } # managed by Certbot


    listen 80;
    listen [::]:80;

    server_name blog.zshnb.com;
    return 404; # managed by Certbot
}

配置完毕后执行sudo nginx -s reload

在服务器个人目录下拉取博客仓库，切换到gh-pages分支，然后便可以访问博客首页了，这里如果域名还未生效，可以通过访问ip的形式查看。

备案

因为众所周知的原因，部署在国内服务器的网站，想要合法公开，必须经过工信部备案，如果部署在海外的服务器，可以跳过这一步

云服务厂商备案，这里我以腾讯云为例子，你也可以根据自己购买的云服务厂商说明来做。首先登录腾讯云，进入备案页面，点击新增服务，填写好页面要求的信息，这里注意几个点，
1. 网站标题不要包含博客，个人姓名，容易过不了审核
2. 在审核期间把服务器关了腾讯云的审核大概1天就会通过，通过后会提交工信部管局审核，大约需要5个工作日，备案成功后会在腾讯云的备案里看到备案号，后面会用到
公安局备案，登录备案网站，按照提示填写信息提交即可，备案成功后同样会有备案号
在nexT配置里添加备案信息，参考文档

自动化

按照上面的步骤，在备案通过后，博客已经成功上线了，不过这里还存在一个问题，当我们发布新文章时，我们先要在本地写好文章，然后提交GitHub，然后本地执行hexo g && hexo d，然后ssh登录服务器，更新gh-pages，这样才能同步发布最新文章到线上，那么我们能不能把这个过程自动化呢？也就是要做到当我们提交文章到GitHub后，有什么办法能自动部署hexo，且自动更新服务器上的gh-pages分支。答案当然是有的，这里我们用GitHub action来完成这一自动化过程。大概的思路如下

把仓库clone下来
安装nodejs，进入仓库目录npm install
执行hexo g && hexo d
ssh服务器，更新gh-pages分支

这里我们需要准备一个新的ssh密钥对，用于action服务器提交GitHub和ssh服务器，一切准备完毕后，在根目录下新建./.github/workflows/deploy.yml，内容如下

yaml 复制代码

name: Deploy blog
on:
  push:
    branches:
      - main
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: checkout repo
        uses: actions/checkout@v2
      - name: prepare node env
        uses: actions/setup-node@v1
        with:
          node-version: "18.18.0"
      - uses: webfactory/ssh-agent@v0.7.0
        with:
          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}
      - name: set github profile
        run: |
          git config --global user.name 'zshnb'
          git config --global user.email 'a857681664@gmail.com'
      - name: hexo generate
        run: |
          npm i -g hexo
          npm i
          hexo clean && hexo g && hexo d
      - name: ssh remove server
        uses: appleboy/ssh-action@v1.0.0
        with:
          host: ${{ secrets.SERVER_HOST }}
          username: ${{ secrets.SERVER_USER }}
          key: ${{ secrets.SSH_PRIVATE_KEY }}
          port: 22
          script: |
            cd blog
            git pull origin gh-pages --rebase
            sudo nginx -s reload

action里用到的secrets在仓库的settings -> secrets and variables -> actions里添加

总结

至此一个个人博客就搭建完毕了，过程虽然比较多，但每个步骤都不算难，只是中间需要等待备案，比较磨人

复制代码

原文链接

Hexo个人博客搭建指南

背景