变更
halo2.4及以上版本的构建方法发生了变更，请转至halo2.6 从源码构建jar包查看。
前言
从halo2.0开始，halo官方不再提供jar包，仅提供docker部署方式。
docker部署固然方便，但没有jar包也是遗憾。
本文以halo官方文档为基础，结合我自己的经历，记录构建halo 2.2版本jar的经历。
环境准备
- archlinux
- git
- openjdk 17
- node.js 18 (官方文档为18，arch仓库为19)
- pnpm 7
pnpm安装方法请前往官网查看。
克隆仓库
假设文件保存位置在~/下
git clone https://github.com/halo-dev/halo
git clone https://github.com/halo-dev/console
构建Console
cd ~/console
# 使用git tag命令查看最新的tag
git tag --column
# 切换到指定的tag，此处以2.2.0为例
git checkout v2.2.0
pnpm install
pnpm build:packages
pnpm build
执行命令的过程中可能有警告信息，忽略即可。
执行完上述所有命令后，进入console目录下产生的dist目录
cd dist
将该文件夹下的所有内容复制到~/halo/src/main/resources/console
mkdir -p ~/halo/src/main/resources/console
mv ./* ~/halo/src/main/resources/console
构建jar包
cd ~/halo/src/main/resources
配置相关问题
如无意外，在此文件夹下，有很多以application-*.yaml为形式的文件。其中的application.yaml文件（注意没有任何后缀）就是halo 1.x放置在工作文件夹下的配置文件。
若以源代码构建jar包的方式运行halo 2.x，该文件必须在构建jar包前就编写好。否则后期即使将它复制到halo的工作目录下，halo也不会读取配置，而是根据构建时的文件决定配置。
注意，
halo 1.x与halo 2.x的配置文件不通用，数据库同样不通用，不能直接替换。
根据halo官方Docker Compose部署方法的配置来看，创建数据库方式也稍有不同。
以mariadb为例，执行create database your_database_name character set utf8mb4 collate utf8mb4_general_ci;创建数据库。将your_database_name修改为你的数据库名称。
编辑application.yaml，以下是mariadb的配置示例
server:
port: 8090 # 修改为你的端口
compression:
enabled: true
error:
whitelabel:
enabled: false
spring:
output:
ansi:
enabled: detect
r2dbc:
url: r2dbc:pool:mariadb://localhost:3306/your_database_name # 修改为你的数据库名称
username: your_username # 修改为你的用户名
password: your_password # 修改为你的密码
sql:
init:
mode: always
platform: mysql
codec:
max-in-memory-size: 10MB
messages:
basename: config.i18n.messages
web:
resources:
cache:
cachecontrol:
max-age: 365d
halo:
external-url: http://your_url:${server.port} # 修改为你的地址
work-dir: ${user.home}/.halo2
plugin:
plugins-root: ${halo.work-dir}/plugins
attachment:
resource-mappings:
- pathPattern: /upload/**
locations:
- migrate-from-1.x
springdoc:
api-docs:
enabled: false
logging:
file:
name: ${halo.work-dir}/logs/halo.log
logback:
rollingpolicy:
max-file-size: 10MB
total-size-cap: 1GB
max-history: 0
management:
endpoints:
web:
exposure:
include: ["health", "info", "startup", "globalinfo"]
endpoint:
health:
probes:
enabled: true
info:
java:
enabled: true
os:
enabled: true
若你要使用其他数据库，参照当前目录下别的配置文件修改即可。默认配置文件不做任何修改，则是使用H2数据库。配置文件中的所有路径也可以更改为绝对路径。
开始构建
cd ~/halo
git tag --column
# 这两句命令同构建Console一样
git checkout v2.2.0
vim gradle.properties
# 构建之前需要修改 gradle.properties 中的 version 为当前 tag 的版本号。
# 如：version=2.2.0
./gradlew clean build -x check -x jar
构建完成之后，构建完成的文件在~/halo/build/libs目录下。
其他问题
用户名与密码
构建完成后初次运行，后台默认用户名是admin，默认密码则随机生成，需要到halo日志中寻找。
如图所示，密码一般在倒数几行日志中可以找到。
频繁的报错
情况类似GitHub上这些Issues
但貌似都不影响使用。