Linux云服务器部署Halo博客全流程实操手册

在开始部署Halo博客之前，需要完成一些基础的准备工作，确保服务器环境满足运行要求。

• 服务器要求：一台运行主流Linux发行版（如CentOS 7/8、Ubuntu 20.04/22.04）的云服务器，建议配置至少1核CPU、2GB内存。
• 环境依赖：Halo依赖于Java运行时环境，需要预先安装JDK 17或更高版本。
• 网络与安全：确保服务器的80（HTTP）和443（HTTPS）端口已对外开放。为了安全起见，建议使用非root用户操作，并配置SSH密钥登录。

完成以上准备后，即可通过SSH工具连接到您的云服务器，开始部署流程。

安装必要运行环境

我们需要在服务器上安装Halo博客系统所依赖的软件，主要是Java环境。

以下是在Ubuntu系统上安装OpenJDK 17的示例命令：

sudo apt update
sudo apt install openjdk-17-jdk -y

安装完成后，可以通过运行 java -version 来验证安装是否成功。接下来，为了便于管理和维护，我们创建一个专用的系统用户来运行Halo服务。

• 创建用户：sudo useradd -m -s /bin/bash halo
• 切换用户：sudo su
  halo

下载并安装Halo

我们将使用官方提供的一键安装脚本，这是最便捷的安装方式。

在之前创建的 halo 用户下，执行以下命令：

curl -o /home/halo/install.sh https://dl.halo.run/script/install.sh
bash /home/halo/install.sh

脚本执行过程中，它会自动完成下载Halo Jar包、创建systemd服务单元文件等所有步骤。安装成功后，Halo服务默认会在后台启动，并监听8090端口。

您可以通过命令 sudo systemctl status halo 来检查Halo服务的运行状态。

配置域名与反向代理

直接通过IP和端口访问服务不够友好且不安全，我们需要配置域名和反向代理，并启用HTTPS加密。

首先安装Nginx作为反向代理服务器：

sudo apt install nginx -y

然后在 /etc/nginx/conf.d/ 目录下为您的博客创建一个配置文件，例如 halo.conf。

配置文件内容示例如下：

server {
    listen 80;
    server_name your_domain.com; # 替换为你的域名
    location / {
        proxy_pass http://127.0.0.1:8090;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

保存配置后，测试Nginx配置并重载服务：

sudo nginx -t
sudo systemctl reload nginx

接下来，使用Certbot申请免费的SSL证书：

sudo apt install certbot python3-certbot-nginx -y
sudo certbot –nginx -d your_domain.com

Certbot会自动修改Nginx配置，将HTTP请求重定向到HTTPS。

初始化与访问博客

所有服务配置完成后，现在可以通过浏览器访问您的域名来初始化Halo博客了。

在浏览器地址栏输入 https://your_domain.com，您将看到Halo的初始化安装界面。

• 按照页面提示，设置管理员账号、密码和博客名称等基本信息。
• 点击安装按钮，系统会自动完成初始化。
• 安装成功后，您会自动跳转到博客后台管理界面，在这里您可以开始撰写文章、更换主题和管理评论。

您的博客前台可以通过直接访问域名来查看，部署流程至此全部完成。

日常管理与维护

博客上线后，需要进行一些日常的维护工作以确保其稳定运行。

重要提示：请务必定期备份您的博客数据。Halo的数据默认存储在 ~/.halo2 目录下，建议将此目录定期打包备份到安全的地方。