小白也能懂！VPS 上部署 Halo 博客超详细教程

大家好呀！我是你们的非专业数码博主，最近刚搞定在 VPS 上搭 Halo 博客，过程踩了不少坑，所以整理了这份超详细的教程，保证小白跟着步骤走也能成功！毕竟咱也不是程序员，所以全程不用复杂代码，都是复制粘贴就能搞定的操作，放心看～

一、准备工作：先把需要的东西凑齐

在开始之前，咱们得先准备好 3 样东西，就像做饭前要准备食材一样，少一样都不行哦：

1. 一台 VPS 服务器

可以选阿里云、腾讯云、华为云这些常见的，新手建议选「轻量应用服务器」，配置不用太高，1 核 2G 内存、40G 硬盘就够起步了，系统选「CentOS 7」（别问为什么，跟着选准没错，兼容性最好）。买的时候记得选「按年付」，比按月付划算，新人还有优惠，一般一年就几十块钱。

2. 一个域名（可选但推荐）

就像给博客起个 “网址名字”，比如xxx.com，没有域名也能通过 VPS 的 IP 访问，但有域名更方便记忆。可以在买 VPS 的平台一起买，买完后要记得做「域名备案」（国内服务器必须备案，国外 / 香港服务器不用），备案过程有点麻烦但不复杂，跟着平台提示填信息就行，一般 1-2 周能下来。

3. 两个工具

• 「FinalShell」：用来连接 VPS 服务器的，就像 “远程控制” 一样，官网能免费下载，Windows 和 Mac 都能用。

• 「浏览器」：随便一个都行，比如 Chrome、Edge，最后用来访问和设置博客。

二、第一步：连接 VPS 服务器（像登 QQ 一样简单）

1. 打开 FinalShell，新建连接

打开软件后，点击左上角「+」号，选择「SSH 连接」，然后填这些信息：

• 名称：随便起，比如 “我的 Halo 博客”

• 主机：填你 VPS 的公网 IP（在 VPS 控制台能找到，比如阿里云的 “公网 IP 地址”）

• 端口：默认 22，不用改

• 用户名：默认是root（大部分服务器初始用户名都是这个，不确定的看 VPS 购买时的说明）

• 密码：填 VPS 的初始密码（买完 VPS 后，控制台会有 “重置密码” 的选项，先重置一个自己记得住的密码）

2. 连接服务器

填完信息后点「确定」，然后双击左边列表里的连接名称，会弹出一个提示框，点「接受并保存」，如果密码没错，就会进入一个黑色的 “命令行界面”，这就说明连接成功啦！

三、第二步：搭建环境（复制粘贴代码就行）

Halo 博客需要 “Java 环境” 才能运行，就像手机需要安卓系统才能装 APP 一样。咱们不用懂 Java，只要把下面的代码一行一行复制到黑色命令行里，每复制一行按一下「Enter 键」就行，等前一行执行完（出现新的命令提示符）再复制下一行。

1. 安装 Java 环境

执行以下命令：

yum install -y java-1.8.0-openjdk-devel.x86_64

执行完后，输入java -version并按 Enter，如果出现 “openjdk version 1.8.0_xxx” 的字样，就说明 Java 装好了。

2. 创建存放 Halo 的文件夹

执行以下命令，在服务器中创建专门存放博客文件的文件夹：

mkdir -p /opt/halo

不用管路径是什么，复制执行就好。

3. 下载 Halo 安装包

执行以下命令，下载 Halo 最新稳定版（当前为 v2.12.0）：

wget https://github.com/halo-dev/halo/releases/download/v2.12.0/halo-2.12.0.jar -O /opt/halo/halo.jar

注意：如果后续 Halo 出了新版本，可将 “v2.12.0” 换成最新版本号（去 Halo 官网能看到最新版本），但新手先用这个版本，稳定不容易出错。

执行完后，等进度条到 100%，就说明下载好了。

4. 创建 Halo 配置文件

先执行命令进入halo文件夹：

cd /opt/halo

再执行以下命令初始化配置：

java -jar halo.jar --init

执行后会出现配置选项，咱们按下面的提示选：

• 数据库类型：直接按 Enter（默认选 H2，新手不用改，简单）

• 数据库路径：直接按 Enter（默认路径就行）

• 博客端口：直接按 Enter（默认 8090，后面访问要用）

• 博客地址：填你的 VPS 公网 IP，比如 “http://123.45.67.89”（别填域名，先用水印 IP 测试）

• 管理员账号：自己设一个，比如 “admin”

• 管理员密码：自己设一个，要记好，后面登录博客要用

填完后按 Enter，会提示 “初始化完成”，这一步就搞定了。

四、第三步：启动 Halo 博客（让博客 “跑起来”）

1. 启动 Halo

在刚才的命令行里输入下面的代码，按 Enter：

java -jar halo.jar

等一会儿，出现 “Started HaloApplication in xxx seconds” 的字样，就说明博客启动成功了！

注意：这时候不要关 FinalShell 的窗口，一关博客就停了。

2. 开放服务器端口

这一步很重要！不然浏览器访问不到博客。要去 VPS 的控制台设置 “安全组”，以常见平台为例：

• 阿里云：登录控制台 → 找到你的服务器 → 点「防火墙」或「安全组」→ 点「添加规则」

• 腾讯云 / 华为云：操作类似，在 “安全组” 模块添加规则

规则设置统一如下：

• 端口范围：填8090/8090

• 授权对象：填0.0.0.0/0（允许所有人访问）

• 规则方向：选 “入方向”

• 保存规则

找不到位置的话，搜一下平台的 “安全组设置教程”，很简单。

五、第四步：访问并设置博客（图形界面，小白友好）

1. 第一次访问博客

打开浏览器，在地址栏输入 “你的 VPS IP:8090”，比如123.45.67.89:8090，按 Enter。

如果能看到 Halo 的登录页面，就说明前面的步骤都没问题啦！

输入第三步设置的管理员账号和密码，点登录，就能进入博客的后台管理界面。

2. 简单设置一下（必做 3 件事）

（1）改博客名称

在后台左边点「设置」→「基本设置」，把 “博客标题” 改成你想要的名字，比如 “我的小窝”，改完点「保存」。

（2）换主题

Halo 默认主题比较简单，在左边点「外观」→「主题」，里面有很多免费主题，选一个喜欢的，点「启用」，博客首页就会变样啦。

（3）写第一篇文章

在左边点「内容」→「文章」，点右上角「新建文章」，写标题和内容，写完点「发布」。

然后在浏览器里输入 “你的 VPS IP:8090”，就能看到自己写的文章了，超有成就感！

六、第五步：让博客 “一直运行”（关掉 FinalShell 也不影响）

刚才启动博客的方式，关掉 FinalShell 窗口博客就停了，咱们得设置成 “开机自启”，这样就算服务器重启，博客也会自己运行。

1. 创建自启服务文件

在 FinalShell 的命令行里输入下面的代码（先确保你在/opt/halo文件夹里，如果不在，先执行cd /opt/halo）：

sudo tee /etc/systemd/system/halo.service > /dev/null <<EOF

[Unit]

Description=Halo Service

Documentation=https://docs.halo.run

After=network.target

[Service]

Type=simple

User=root

WorkingDirectory=/opt/halo

ExecStart=/usr/bin/java -jar halo.jar

Restart=on-failure

RestartSec=5s

[Install]

WantedBy=multi-user.target

EOF

复制完按 Enter，没有报错就说明文件创建好了。

2. 设置开机自启并启动服务

依次执行下面 3 行代码，每执行一行按 Enter：

systemctl daemon-reload

systemctl enable halo

systemctl start halo

执行完后，输入systemctl status halo并按 Enter，如果看到 “active (running)” 的绿色字样，就说明自启设置成功了！

这时候就算关掉 FinalShell，博客也能一直运行啦。

七、可选：绑定域名（让网址更好记）

如果有域名，咱们可以把域名绑定到 VPS IP 上，这样访问 “你的域名：8090” 就能进博客，不用记长长的 IP 了。

1. 域名解析

去买域名的平台（比如阿里云域名控制台），找到「域名解析」，点「添加记录」，按以下要求填写：

• 记录类型：选「A」

• 主机记录：填@（表示直接用域名访问，比如xxx.com），或填www（表示用www.xxx.com访问）

• 记录值：填你的 VPS 公网 IP

• TTL：默认 600，不用改

保存后，等 10-30 分钟（域名解析需要时间），就能用域名访问博客了（比如xxx.com:8090）。

2. 去掉端口号（进阶，可选）

现在访问博客需要加 “:8090” 端口号，想直接用域名访问（不用加端口），可以安装 Nginx 做 “反向代理”，这个稍微复杂一点，新手可以先不加端口用着，后面熟悉了再折腾。如果想试的话，评论区告诉我，我再出个补充教程～

八、常见问题：踩过的坑帮你避开

1. 浏览器访问不了博客？

• 先检查安全组有没有开放 8090 端口（最常见的问题）

• 再检查 Halo 有没有启动：执行systemctl status halo，如果不是 running，执行systemctl start halo

• 再检查 IP 和端口有没有输错：比如多写了一个空格，或者端口号错了

2. 忘记管理员密码？

在 FinalShell 里执行以下命令：

cd /opt/halo

rm -rf .halo

java -jar halo.jar --init

重新设置管理员账号密码即可（注意：之前的文章会丢失，所以记得定期备份哦）。

3. 想升级 Halo 版本？

先停止 Halo 服务：

systemctl stop halo

再下载新版本安装包（将 “新版本号” 替换为实际版本，比如 v2.13.0）：

wget https://github.com/halo-dev/halo/releases/download/新版本号/halo-新版本号.jar -O /opt/halo/halo.jar

最后启动 Halo：

systemctl start halo

升级前最好备份一下博客数据，避免意外丢失。

好啦，以上就是小白在 VPS 上部署 Halo 博客的全部步骤，其实真的不难，只要跟着一步一步来，肯定能成功！如果过程中遇到其他问题，欢迎在评论区留言，我会尽量帮大家解答～ 最后祝大家都能拥有自己的专属博客！