Halo 2.25.4 官方 jar 包 + 中文启动指南,Java + Spring Boot 写的现代化博客 / CMS 系统,GitHub 23k+ stars。
Halo 2.25.4 现代化博客 CMS 整站 JAR
你是不是想搭一个独立博客,WordPress 太重、Typecho 太老、Hexo 又要会 Git?Halo 是这两年 Java 圈火起来的现代化博客 / CMS 系统 — 后台体验像 Notion,主题 / 插件市场一键装,GitHub 23k+ stars。但新人拿到 halo-2.25.4.jar 直接 java -jar 跑,90% 会卡在「控制台密码找不到」「8090 端口被占」「数据库怎么连」上。这次把官方 jar + 启动指南整理成下载包。
为什么这件事值得做
Java 圈新宠:Halo 2 是国内团队开发的现代化博客系统,后台界面体验接近 Notion,主题市场一键切换,GitHub 上 23k+ stars 还在增长
独立部署很省心:官方提供 docker-compose + systemd + jar 三种部署方式,任选其一就能跑
扩展市场丰富:主题 / 插件市场一键装,SEO、备份、统计、CDN 都现成
新人启动坑多:第一次跑 jar 包常卡在端口冲突、H2 数据库切换 MySQL、控制台初始密码找不到
📌 速查表:Halo 启动 3 命令 →java -jar halo-2.25.4.jar(前台)→ 后台http://localhost:8090/console(初始密码在终端打印)→ 关掉就Ctrl+C。生产用java -jar halo-2.25.4.jar --spring.profiles.active=prod。
5 个挑选 / 避坑思路
第 1 招:[判断标准] 看 Java 版本要求:Halo 2.25 要求 Java 17+,低于 17 启动会报错
UnsupportedClassVersionError。先java -version看版本,不够就装 Adoptium Temurin 17。zip 里 README.txt 写了 Windows / Linux / macOS 三套装 Java 的方法。第 2 招:[避坑点] 端口 8090 别冲突:Halo 默认监听 8090,如果跑过 Notion 这类本地服务会冲突。启动前先
netstat -ano | findstr 8090(Windows)或lsof -i :8090(macOS/Linux)查占用。改端口用--server.port=8888参数。第 3 招:[关键参数] H2 数据库 vs MySQL:新装默认用内嵌 H2 数据库,重启数据还在。要换 MySQL 编辑
application-prod.yml里的 spring datasource 段。zip 里有默认 prod 配置示例,直接改连接串。第 4 招:[易踩坑] 控制台初始密码在哪:第一次启动后,终端会打印一行
随机生成的初始密码是: xxxxxxxx,复制粘贴进http://localhost:8090/console登录。如果终端关闭找不到,就删.halo2/目录重启重新生成。第 5 招:[场景建议] 个人博客 vs 企业站:个人博客 → 默认主题够用,加上评论 + SEO 插件即可。企业站 → 用 [Halo Pro](https://halo.run/themes) 主题市场专业模板 + 反垃圾评论 + 备份插件 + CDN 加速。
下载包里有什么
halo-2.25.4.jar(119MB 官方整站包,含所有依赖)
application.yml 默认配置(H2 内嵌数据库)
application-prod.yml 生产配置示例(MySQL 连接模板)
README.txt 启动指南(Windows / Linux / macOS 三套启动步骤)
📦 2026-07-25 更新:zip 已处理成「无 md 版」 — 所有 .md 文档已转 .txt(0 个,jar 包本身无 md),启动步骤都用纯文本描述,Windows 记事本可直接打开。
为什么必须下载
比官网 jar 包多一个 application-prod.yml 生产配置示例(官方文档要翻 5 篇文章才讲完),还有Windows / Linux / macOS 三套启动指南。下载就少踩 3 小时坑。
# Windows 启动三步走 java -version # 确认 17+ java -jar halo-2.25.4.jar # 启动,看终端打印的初始密码 # 浏览器开 http://localhost:8090/console 粘贴密码登录
避坑点速查
❌ Java 版本低于 17 启动报错
UnsupportedClassVersionError❌ 端口 8090 被占用又不查直接启动,导致连接失败
❌ 终端关闭找不到初始密码,以为 Halo 装坏了
❌ 编辑 application.yml 不重启就生效,改完必须 Ctrl+C 重启
❌ H2 换 MySQL 不备份数据,丢所有文章
✅ 先 java -version 确认 17+ 再启动
✅ 第一次启动看终端,把初始密码复制到记事本
✅ 切换 MySQL 前先在后台 → 系统 → 备份 导出 H2 数据
✅ 生产部署用 systemd 服务 + MySQL + 反向代理
✅ 主题 / 插件市场一键装,不用手动下载
