手把手教你搭建一个Hexo个人博客

南瓜绘2025-02-082025-04-04

前言

本篇文章会教会你从零开始搭建一个部署在vps上的Hexo博客系统（主题:anzhiyu）

Hexo优势

Hexo博客系统是直接生成静态页面，这也就意味着——快，而且静态文件更容易CDN分发快上加快！

Hexo博客可托管到GitHub Pages、GitLab Pages、Vercel 等平台这也意味着我们并不需要购买服务器

当然 Hexo博客系统的优势还有很多，这里就不一一赘述，如果你追求高效，注重性能，那么Hexo博客系统是一个不错的选择。

准备工作

购买服务器

服务器的厂商有许多，这里大家根据喜好，我选择的是阿里云99元计划点我查看更多

0ca85b0c3d52b4b6992804f826677416

如果你是大学生，那么还可以白嫖阿里云一张300元代金券（不可用于“99计划”）

还有一点要说的是，如果选择在大陆服务器上建站，那么就必须备案，备案流程自行百度。

这里以在阿里云购买为例，地域选择最近的，系统推荐使用Debian12

cdc86607e7965ca32efd2cc82de50fe0

服务器购买完来到实例控制台，这串数字就是服务器的ip，后续域名解析和远程连接需要用到

a805d97a67fcb2f71cab5ade4fb62826

购买域名

域名我推荐大家选择顶级域名，二级域名不能备案，而且一些顶级域名（例如.cn .top）在阿里云或者腾讯云第一次购买的话首年才1元阿里云域名1元购去买一个或者白嫖一个二级域名就没有必要了 注意:购买之前要看清楚次年续费价格~

域名备案

注意：域名备案只有大陆内地的服务器需要，如果您的服务器是香港或者国外的则无需备案，请忽略这一步

域名备案的全流程耗时半个月左右，可通过服务器提供商（如阿里云、腾讯云、华为云等）或网络提供商（自建服务器的选择）申请提交备案申请。这里展示阿里云备案入口，点进去按要求填写信息即可。

40c198936ced5aebdddaa5f4fca68573

域名解析

接着我们去把域名解析到服务器,按照右侧填写即可，记录值填写你的服务器ip

4d71698e9a95d9a8eeec1325841827c4

工具下载

本次需要下载两个工具，编辑文件的Vs Code和远程连接的ssh客户端工具Xshell

Xshell:Xshell

Vs CodeVs Code

官网下载安装即可Vs Code先不需要管

开始安装

安装宝塔面板

首先打开Xshell，点击新建会话，输入服务器ip，接着点右边的连接后输入用户名root以及购买服务器时填写的密码。如果像这样就表示成功。

安装宝塔面板（在XShell里Shift+insert复制，Ctrl+insert粘贴）

1	if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh ed8484bec

接着需要需要你同意安装输入y然后点回车即可

这样就代表安装完成，也可输入bt可查看如何修改更多配置

7089a6a83b6defb7d55e8a72e571d3b6

bt

接着需要去安全组放行你设置的端口

像图片中这样设置即可

d24070a2685dae045dea021fc9193593

接着在浏览器中打开外网面板地址，登录账户，选择套件LNMP

添加网站

域名填写刚才解析的域名，网站根目录选择的时候在根目录新建一个blog文件夹，php版本选择纯静态，点击确定。

685da1d982f4c1a3317344672e5df08b

申请ssl证书

选择Let’s Encrypt证书，文件验证即可，如果这里出问题，就代表你的域名解析不正确，请检查记录值中的服务器ip地址，如果你使用了CDN服务也会导致失败。

0448a310c4126ae428134bef7ccff125

配置Vs Code

等待他安装，这时候去配置一下Vs Code

打开Vs Code 安装中文插件和远程工具拓展

安装中文插件

0ad63d4abbfe8e293b7042d32262f071

接着安装remote

104cfebf8808622325a4cdb1ff8c56e5

重启Vc Code

d0f1f97c58d884ba76a432542305aeb0

可以看到已经是中文了

在这里输入

1	.ssh root@你的服务器ip

如果连接失败，我们来到C:\Users\你电脑的用户名.ssh里，把known_hosts文件删掉，重新连接即可

然后继续，输入密码，然后Vs Code会在服务器下载必要文件，稍等即可。

配置ssh免密

此时你能够发现，我们每次打开文件夹都需要输入密码，这时候就需要配置ssh免密了

首先win+r打开运行，输入cmd，打开cmd后输入

1	ssh-keygen -t rsa

把脑袋丢掉，然后一直点回车，可以看到C:\Users\你电脑的用户名\ssh中多了两个文件,我们用vscode打开“id_rsa.pub”文件，复制里面的内容，接着在Xshell里面输入

1	echo "id_rsa.pub文件里的内容，需要带引号" >> ~/.ssh/authorized_keys

此时我们已经不需要输入密码了，从现在开始我们就可以使用Vs Code编辑文件以及终端连接了。

安装nodejs

1	apt install nodejs npm -y

接着我们来验证是否安装成功

node -v

npm -v

如果出现版本号就表示没问题。

更换npm源

官方的源下载速度很慢我们这里可以去更换国内更快的源，比如说淘宝源，直接在命令行输入以下代码就行了

1	npm config set registry https://registry.npmmirror.com

安装Hexo

1	npm install hexo-cli -g

检查是否安装成功

hexo -v

接着进入blog文件夹

cd /blog

初始化hexo内容

在初始化前必须保证文件夹为空，如果有文件会报错

hexo init

安装主题

1	git clone -b main https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu

安装主题依赖

1	npm install hexo-renderer-pug hexo-renderer-stylus --save

复制主题文件到根目录

1	cp -rf ./themes/anzhiyu/_config.yml ./_config.anzhiyu.yml

我们之后改一些配置直接改根目录里的_config.anzhiyu.yml即可，无需改主题文件里面的

_config.yml

编辑主题文件

我们在根目录找到文件_config.yml,往下翻,把theme改成anzhiyu

启用主题

1	theme: anzhiyu

在_config.yml修改一些网站配置，例如：

title: 南瓜绘の小窝
subtitle: '天天开心'
description: '南瓜绘的博客'
keywords:
author: 南瓜绘
language: zh-cn
timezone: ''

关于_config.anzhiyu.yml主题文件的修改请参考安知鱼主题指南

一些Hexo命令

hexo g   ##根据_config.anzhiyu.yml的内容生成静态文件在根目录的public文件夹下
hexo cl  ##清除public下所有文件夹
hexo d   ##推送到远程仓库（我们这种方法用不到）
hexo s   ##在服务器的4000端口开启服务器进程，可以进行访问
ctrl + c  ##结束hexo博客进程