概述

本文详细讲述如何利用宝塔面板【Java项目一键部署 3.5】快速安装Halo轻量博客程序（开源Java博客系统）。
相关版本说明：
宝塔面板：免费版 7.4.5
Halo版本：halo-1.5.3.jar
mysql版本：5.7 +

环境准备

宝塔安装Java项目一键部署 3.5

1、进入宝塔面板->软件商店->找到【Java项目一键部署 3.5】->安装。
2、安装好后，点击 设置->容器管理->选择容器版本:tomcat8->安装版本。
说明：这一步安装完成后，会发现默认自带也安装好了jdk1.8，路径为 /usr/java/jdk1.8.0_121

linux 安装多版本JDK共存

由于halo-1.5.3版本要求最低要求jdk11的，所以我们接下来再安装jdk11。
（注意避坑：第一次我是选择安装了目前最新版的jdk18，到运行halo-1.5.3项目时报错了，原因是Java项目一键部署 3.5里的springboot版本和jdk18不兼容，冲突报错了，所以最后还是降回jdk11才成功。）

1、去官方下载jdk11版本 java版本下载页面

找到 Java SE 11
下载 jdk-11.0.15_linux-x64_bin.tar.gz
上传到 /usr/java

2、解压

用root用户登录到 /usr/java 执行解压命令

tar -zxvf  jdk-11.0.15_linux-x64_bin.tar.gz

解压成功后，/usr/java目录下两个jdk目录共存

jdk1.8.0_121
jdk-11.0.15

3、设置jdk11为默认的java

查看当前默认java，发现还是jdk1.8

java -version

重新选择设置默认java

alternatives --config java

执行结果

There are 1 programs which provide 'java'.

  Selection    Command
-----------------------------------------------
*  +1           /usr/java/jdk1.8.0_121/jre/bin/java

发现根本找不到jdk11，所以我们先去安装一下jdk11，执行命令

alternatives --install /usr/bin/java java /usr/java/jdk-11.0.15/bin/java 2

再次执行

alternatives --config java

执行结果变为

There are 2 programs which provide 'java'.

  Selection    Command
-----------------------------------------------
*  + 1           /usr/java/jdk1.8.0_121/jre/bin/java
2           /usr/java/jdk-11.0.15/bin/java
Enter to keep the current selection[+], or type selection number: 

这时选择 #选择标识2，回车键执行，就是以jdk-11.0.15为默认的java
再次查看确认当前java版本

java -version

结果为

java version "11.0.15" 2022-04-19 LTS

大功告成

安装数据库相关

1、安装mysql

进入宝塔面板->软件商店->找到【MySQL 5.7.34】->安装。

2、安装phpMyAdmin

进入宝塔面板->软件商店->找到【phpMyAdmin 4.4】->安装。

安装Halo

新增网站

进入宝塔面板->网站->添加站点

填写你本次要建站的域名，例如：it.yangersao.com
Halo 目前支持 H2 及 MySQL 数据库，
官方推荐使用 H2，
如果你选择的是H2，
那么添加站点时就不用选择数据库。
本次我选择的是Mysql数据库，
所以需要选择创建Mysql数据库，
并且按照官方文档选择utf8mb4字符集，
用户名写：halodb
由于我们不需要PHP，所以PHP版本选纯净态
创建成功后，
你要记录下数据库的相关配置信息，
后面修改halo的配置要用到。

上传运行包

从官方获取halo-1.5.2.jar上传到 /data/web/Halo下，这个路径没有强制规定，你可以放在其他目录，部署的时候你能找到就行。

创建 工作目录

mkdir ~/.halo && cd ~/.halo

关于工作目录的介绍，参考官方文档的介绍

配置文件

下载示例配置文件到 工作目录

wget https://dl.halo.run/config/application-template.yaml -O ./application.yaml 

编辑配置文件

vim application.yaml
# 你需要做如下几个步骤：

# 注释 H2 database configuration.部分
# 启用 MySQL database configuration.部分
# 修改 datasource 下的 url 中的 ip 地址部分为容器名称并修改密码为您设定的 MySQL 密码

修改后的application.yaml文件内容如下:

server:
  port: 8090

  # Response data gzip.
  compression:
    enabled: false
spring:
  datasource:

    # H2 database configuration.
    #driver-class-name: org.h2.Driver
    #url: jdbc:h2:file:~/.halo/db/halo
    #username: admin
    #password: 123456

    # MySQL database configuration.
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/halodb?characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
    username: halodb
    password: xxxxxxxx

  # H2 database console configuration.
    h2:
    console:
      settings:
        web-allow-others: false
      path: /h2-console
      enabled: false

halo:

  # Your admin client path is https://your-domain/{admin-path}
  admin-path: admin

  # memory or level
  cache: memory

部署Halo

进入宝塔面板->软件商店->Java项目一键部署 3.5->设置->Springboot->添加项目

项目路径：选择前面我们上传的 /data/web/Halo/halo-1.5.2.jar
JDK版本：就选择默认的，前面我们已经把系统默认的设置为jdk11，所以配置选择  JDK  /usr/bin/java
项目域名：就填写前面建站时的填的域名，例如 it.yangersao.com
项目端口：自动生成，不用修改
root运行：勾选
最后点【确定】就进入自动部署了。2分钟左右就部署成功

修改网站配置文件

为了能直接使用域名访问，省去每次都带上端口号。我们还需要修改一下网站的配置文件。
进入宝塔面板->网站->找到前面我们创建的网站->设置->配置文件 把之前系统自动生成的所有内容都删掉，改成

server
{
    listen 80;
    server_name it.fkman.com; #改成你的域名
    location / {
        proxy_pass http://127.0.0.1:6789; #改成你的端口
    }
    access_log  /www/wwwlogs/it.fkman.com.log; #改成你的路径
    error_log  /www/wwwlogs/it.fkman.error.log; #改成你的路径
}

安装向导

直接访问你的域名 例如 https://it.fkman.com，进入安装向导，按照页面提醒简单填写配置，即可完成安装。