Skip to content

Release history

Halo releases

A powerful and easy-to-use website building tool (documentation in Chinese).

Back to tool Latest release

All releases

33 shown

v2.24.2 Bug fix
Notable features
  • Improved UA parsing accuracy in login device management
Full changelog

功能优化

  • 提升登录设备管理中 UA 信息解析的准确性 by @JohnNiang in https://github.com/halo-dev/halo/pull/9921

问题修复

  • 解决“保持登录会话”功能在特定情况下可能失效的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/9928
  • 修复通过 URL 下载大文件（如插件安装包）时因响应体大小限制导致下载失败的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/9931
  • 修复通过 PostFinder#random 随机获取文章时可能返回少于请求的文章的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/9932

Full Changelog: https://github.com/halo-dev/halo/compare/v2.24.1...v2.24.2

View release on GitHub
v2.24.1 Security relevant
Security fixes
  • Improved target URL validation for personal center attachment uploads via URL, mitigating server request abuse risk (reported by JD-Security SHENYI Team).
Notable features
  • Added `random` method to `PostFinder` for retrieving random articles
Full changelog

安全性修复

  • 加强了个人中心通过 URL 上传附件时的目标地址校验，降低服务端请求被滥用的风险

问题修复

  • 修复登录时勾选记住我后撤销设备后不起作用的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/9899
  • 修复 2.24.0 自动为主题资源加版本参数功能在部分边缘场景下路径拼接错误的问题 by @ruibaby in https://github.com/halo-dev/halo/pull/9897

开发者相关

  • 为 PostFinder 添加 random 方法以支持随机获取文章 by @JohnNiang in https://github.com/halo-dev/halo/pull/9918

致谢

感谢 JD-Security SHENYI Team 报告的安全漏洞。

Full Changelog: https://github.com/halo-dev/halo/compare/v2.24.0...v2.24.1

View release on GitHub
v2.24.0 Bug fix
Notable features
  • Plugin detail page management improvements
  • Reload plugin support in Console plugin management
  • Select current role when creating personal token
Full changelog

新特性

功能优化

问题修复

开发者相关

依赖更新

Full Changelog: https://github.com/halo-dev/halo/compare/v2.23.2...v2.24.0

View release on GitHub
v2.23.3 Bug fix

Fixed creation of articles to allow setting an author.

Full changelog

问题修复

  • 修复编辑器图片、视频、音频类型的对齐图标显示不正确的问题 by @ruibaby in https://github.com/halo-dev/halo/pull/9852
  • 修复创建文章时无法设置作者的问题 by @ruibaby in https://github.com/halo-dev/halo/pull/9862
  • 修复部分包含 Finder API 的插件可能在升级后无法正常启动的问题 by @ruibaby in https://github.com/halo-dev/halo/pull/9853
  • 修复附件插件未实现缩略图生成功能时出现大量警告日志的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/9878

Full Changelog: https://github.com/halo-dev/halo/compare/v2.23.2...v2.23.3

View release on GitHub
v2.23.2 Bug fix
⚠ Upgrade required
  • Upgraded Spring Boot to version 4.0.4
Full changelog

问题修复

  • 解决当富文本编辑器中嵌套其他编辑器时所导致的异常滚动问题 by @LIlGG in https://github.com/halo-dev/halo/pull/8436
  • 解决 FormKit Array 渲染图片时可能出现的报错问题 by @LIlGG in https://github.com/halo-dev/halo/pull/8495
  • 修复 FormKit Iconify 自定义图片时，表单可能出现自动关闭的问题 by @ruibaby in https://github.com/halo-dev/halo/pull/8497

依赖更新

  • 升级 Spring Boot 至 4.0.4 by @JohnNiang in https://github.com/halo-dev/halo/pull/8434

开发者相关

  • 修复标签归档页面缺少 _templateId 变量的问题 by @Copilot in https://github.com/halo-dev/halo/pull/8485

Full Changelog: https://github.com/halo-dev/halo/compare/v2.23.1...v2.23.2

View release on GitHub
v2.23.1 New feature
Notable features
  • Description field added to article tags
Full changelog

功能优化

  • 为文章标签添加描述字段 by @baocai27 in https://github.com/halo-dev/halo/pull/8418

依赖更新

  • 升级 MariaDB 驱动，提升兼容性 by @JohnNiang in https://github.com/halo-dev/halo/pull/8423

Full Changelog: https://github.com/halo-dev/halo/compare/v2.23.0...v2.23.1

View release on GitHub
v2.23.0 Breaking risk
⚠ Upgrade required
  • Before upgrading Halo, upgrade the Application Market plugin to at least 1.16.0.
  • After upgrading Halo, verify that all plugins function correctly and report any issues to their authors.
Breaking changes
  • Upgraded Spring Boot runtime to version 4 (minimum required).
Notable features
  • Added scroll‑to‑top button on theme and plugin settings pages
  • Added "Apply width to full article" option for editor images
  • Allowed setting author page article count in post settings
Full changelog

⚠️ 重要提示

  • 此版本升级了 Spring Boot 4 版本，已知有少部分插件不兼容，包括应用市场插件，建议在升级 Halo 前先升级应用市场插件（1.16.0）
  • 建议升级 Halo 之后检查是否有异常的插件，如有异常，请向插件作者报告

新特性

功能优化

问题修复

依赖更新

开发者相关

Full Changelog: https://github.com/halo-dev/halo/compare/v2.22.11...v2.23.0

View release on GitHub
v2.22.14 Bug fix

Fixed the issue where the first image gets overwritten when copying or pasting images in the editor.

Full changelog

问题修复

  • 解决在编辑器中复制或粘贴图片时首张图片会被覆盖的问题 by @LIlGG in https://github.com/halo-dev/halo/pull/8333

Full Changelog: https://github.com/halo-dev/halo/compare/v2.22.13...v2.22.14

View release on GitHub
v2.22.13 Bug fix

Fixed the null value rendering exception in the Array component.

Full changelog

问题修复

  • 解决 Array 组件空值渲染异常的问题 by @LIlGG in https://github.com/halo-dev/halo/pull/8305

Full Changelog: https://github.com/halo-dev/halo/compare/v2.22.12...v2.22.13

View release on GitHub
v2.22.12 Bug fix
Notable features
  • Array component adapted for most Halo components and supports Select remote data source
Full changelog

功能优化

  • 为 Array 组件适配 Halo 中的大部分组件并支持 Select 远程数据源 by @LIlGG in https://github.com/halo-dev/halo/pull/8267

问题修复

  • 解决 Sercet 组件 UI 过长且处于最后一行时会出现边框被遮挡的问题 by @LIlGG in https://github.com/halo-dev/halo/pull/8268

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.22.11...v2.22.12

View release on GitHub
v2.22.11 Bug fix
Notable features
  • Homepage article list now shows private articles
  • Optimized theme installation and update experience
Full changelog

功能优化

  • 解决首页文章列表中不显示私有文章的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8246
  • 优化主题安装和更新体验 by @JohnNiang in https://github.com/halo-dev/halo/pull/8250

问题修复

  • 修复为用户赋角色可能失效的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8256
  • 修复 Array 表单项中图标预览的样式问题 by @ruibaby in https://github.com/halo-dev/halo/pull/8253

开发者相关

  • 附件插件上传上下文新增附件分组信息 by @JohnNiang in https://github.com/halo-dev/halo/pull/8255

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.22.10...v2.22.11

View release on GitHub
v2.22.10 Breaking risk
Breaking changes
  • Removed default memory limit configuration.
Full changelog

功能优化

  • 支持修改用户角色后自动踢出所有登录会话 by @JohnNiang in https://github.com/halo-dev/halo/pull/8228
  • 优化系统性能 by @JohnNiang in https://github.com/halo-dev/halo/pull/8233
  • 允许修改默认存储策略的部分配置 by @JohnNiang in https://github.com/halo-dev/halo/pull/8230
  • 移除默认内存限制 by @JohnNiang in https://github.com/halo-dev/halo/pull/8227

问题修复

  • 解决打开历史文章会出现排版错乱的问题 by @LIlGG in https://github.com/halo-dev/halo/pull/8215
  • 修复特定条件下查询结果不符合预期的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8229

开发者相关

  • 简化 /actuator/globalinfo 端点，移除不必要的字段 by @JohnNiang in https://github.com/halo-dev/halo/pull/8236
  • 重构密钥（Secret）表单项的交互逻辑，并支持设置多个所需的 key by @ruibaby in https://github.com/halo-dev/halo/pull/8237

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.22.9...v2.22.10

View release on GitHub
v2.22.9 Bug fix

Fixed attachment deletion causing a 500 error on subsequent access.

Full changelog

问题修复

  • 解决 Formkit Toggle 组件切换无效的问题 by @LIlGG in https://github.com/halo-dev/halo/pull/8206
  • 修复编辑器转存单个图片时的成功提示信息不正确的问题 by @ruibaby in https://github.com/halo-dev/halo/pull/8217
  • 修复附件删除后再次访问时出现 500 错误 by @JohnNiang in https://github.com/halo-dev/halo/pull/8222
  • 解决标签和分类选择器嵌入至弹窗时下拉菜单会被遮挡的问题 by @LIlGG in https://github.com/halo-dev/halo/pull/8224

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.22.8...v2.22.9

View release on GitHub
v2.22.8 Bug fix
Notable features
  • Two-step verification interface now supports logout
  • Editor implements smart threshold scrolling
  • FormKit added `toggle` component
Full changelog

功能优化

  • 两步验证界面支持退出登录 by @JohnNiang in https://github.com/halo-dev/halo/pull/8182
  • 优化系统稳定性，提升并发访问量 by @JohnNiang in https://github.com/halo-dev/halo/pull/8190
  • 优化在特定情况下首页的加载速度 by @JohnNiang in https://github.com/halo-dev/halo/pull/8193
  • 减少登录设备更新频次，降低 SQL 查询量 by @JohnNiang in https://github.com/halo-dev/halo/pull/8202
  • 为编辑器实现智能阈值滚动 by @LIlGG in https://github.com/halo-dev/halo/pull/8189
  • 移除创建文章标签时设置的默认颜色 by @Copilot in https://github.com/halo-dev/halo/pull/8198

问题修复

  • 解决停止插件后可能导致系统无法正常访问的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8181
  • 修复多值索引部分查询结果不准确问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8187
  • 修复附件表单类型的移除逻辑问题，与旧版保持一致 by @ruibaby in https://github.com/halo-dev/halo/pull/8191
  • 解决默认编辑器中顶部工具栏中的对齐工具对图片、视频、音频无效的问题 by @LIlGG in https://github.com/halo-dev/halo/pull/8203

开发者相关

  • 为 FormKit 新增 toggle 组件 by @LIlGG in https://github.com/halo-dev/halo/pull/8104

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.22.7...v2.22.8

View release on GitHub
v2.22.6 Bug fix

Fixed comment count inaccuracy and plugin startup/update failures.

Full changelog

问题修复

  • 修复评论数量可能不准确的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8171
  • 修复插件可能无法启动和更新的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8170

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.22.5...v2.22.6

View release on GitHub
v2.22.5 Bug fix
Notable features
  • Optimized plugin enable/disable logic
  • Improved system and plugin startup speed
Full changelog

功能优化

  • 优化插件启用和禁用逻辑 by @JohnNiang in https://github.com/halo-dev/halo/pull/8165
  • 优化系统和插件启动速度 by @JohnNiang in https://github.com/halo-dev/halo/pull/8168

问题修复

  • 修复因插件未适配缩略图导致无法显示图片的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8159
  • 修复备份恢复后仍然保留了备份相关的数据 by @JohnNiang in https://github.com/halo-dev/halo/pull/8160
  • 修复图片链接中包含中文无法访问缩略图的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8163
  • 修复注册时同一个邮箱不同大小写仍然可重复注册的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8155
  • 修复评论管理列表可能无法正常访问的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8169

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.22.4...v2.22.5

View release on GitHub
v2.22.4 Bug fix

Fixed thumbnail access on Windows and Linux and rich‑text image paste upload failures.

Full changelog

问题修复

  • 修复最后一页数据可能包含上一页部分数据的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8138
  • 修复头像附件配置的描述文本，移除不存在的分组选项说明 by @Copilot in https://github.com/halo-dev/halo/pull/8145
  • 修复 Windows 和 Linux 下无法正常访问缩略图的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8153
  • 解决编辑器粘贴富文本内单个图片时无法正确上传的问题 by @LIlGG in https://github.com/halo-dev/halo/pull/8154

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.22.3...v2.22.4

View release on GitHub
v2.22.3 New feature
Notable features
  • Support for logging in using a verified email address
  • Metadata form support added to personal center article settings
Full changelog

功能优化

  • 支持使用已验证邮箱登录 by @JohnNiang in https://github.com/halo-dev/halo/pull/8126
  • 个人中心文章设置支持元数据表单 by @JohnNiang in https://github.com/halo-dev/halo/pull/8129

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.22.2...v2.22.3

View release on GitHub
v2.22.2 Bug fix
Notable features
  • Increased title and alias length limits for articles, pages, and categories
Full changelog

功能优化

  • 提升文章、页面、分类的标题和别名字符串长度限制，以提供更好的兼容性 by @ruibaby in https://github.com/halo-dev/halo/pull/8117

问题修复

  • 解决使用部分数据库时无法正常启动的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8115
  • 修复部分文章路由规则配置失效的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/8116

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.22.1...v2.22.2

View release on GitHub
v2.22.1 Bug fix
Notable features
  • FormKit added Switch form type
  • Iconify form type icon style optimized to no longer have fixed width for better compatibility
Full changelog

功能优化

  • 优化 Iconify 表单类型的图标样式，不再固定宽度，以提供更好的兼容性 by @ruibaby in https://github.com/halo-dev/halo/pull/8111

问题修复

  • 修复附件分组下拉选项显示不完整的问题 by @ruibaby in https://github.com/halo-dev/halo/pull/8109

开发者相关

  • 为 FormKit 添加 Swtich 表单类型 by @LIlGG in https://github.com/halo-dev/halo/pull/8095

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.22.0...v2.22.1

View release on GitHub
v2.22.0 Breaking risk
⚠ Upgrade required
  • Before upgrading, verify that all used plugins are compatible with Halo v2.22; update them promptly after upgrade.
  • Thumbnail generation logic has changed – storage directory structure differs from previous versions; re‑generate thumbnails as needed (may temporarily increase resource usage).
Breaking changes
  • Refactored part of the plugin API; some plugins may become incompatible after upgrading to Halo v2.22.0.
Notable features
  • Editor image collection feature
  • User registration support for protected usernames
  • Editor ability to add description text to images, videos, and audio
Full changelog

⚠️ 注意

  • 此版本重构了部分插件 API，升级之后可能导致部分插件无法正常使用，升级之前建议先检查你所使用的插件是否已经兼容 Halo 2.22，在升级之后建议及时更新所有能够更新的插件。
  • 此版本重构了附件缩略图的生成逻辑，并且与之前版本的存储目录结构不同，所以在升级之后可能需要按需重新生成，在这个阶段可能会导致网站资源占用较高，属于正常现象。

插件和主题的 API 变更可查阅：插件 API 变更日志 / 主题 API 变更日志

新特性

功能优化

问题修复

依赖更新

开发者相关

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.21.9...v2.22.0

View release on GitHub
v2.21.10 Bug fix
Notable features
  • Insert image option added to editor command panel
Full changelog

功能优化

  • 优化重置密码时因邮箱可输入大小写导致的问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/7901
  • 为编辑器的命令面板添加插入图片的选项 by @ruibaby in https://github.com/halo-dev/halo/pull/7803

问题修复

  • 修复潜在的内存泄漏问题 by @JohnNiang in https://github.com/halo-dev/halo/pull/7914
  • 修复离线环境下，Console 无法请求接口的问题 by @ruibaby in https://github.com/halo-dev/halo/pull/7848
  • 解决切换代码块语言时编辑器页面不正常跳动的问题 by @LIlGG in https://github.com/halo-dev/halo/pull/7839

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.21.9...v2.21.10

View release on GitHub
v2.21.9 Bug fix
Notable features
  • Back-to-previous-page after publishing article with query state preserved
  • Loading indicator added to article editor
  • Console multiline text inputs now auto‑adjust height
Full changelog

功能优化

  • 发布文章后支持回到上一页并保留查询状态 by @ruibaby in https://github.com/halo-dev/halo/pull/7775
  • 为文章编辑器添加加载状态 by @ruibaby in https://github.com/halo-dev/halo/pull/7756
  • Console 端的部分多行文本输入框支持自动高度 by @ruibaby in https://github.com/halo-dev/halo/pull/7749

问题修复

  • 修复分类和菜单链接文本显示溢出的问题 by @ruibaby in https://github.com/halo-dev/halo/pull/7760

依赖更新

  • 升级 Lucene 至 10.3.0 by @JohnNiang in https://github.com/halo-dev/halo/pull/7752
  • 升级 Gradle 至 9.1.0 by @JohnNiang in https://github.com/halo-dev/halo/pull/7776
  • 升级 Spring Boot 至 3.5.6 by @JohnNiang in https://github.com/halo-dev/halo/pull/7774

开发者相关

  • 支持使用 Buildpacks 构建并发布容器镜像 by @JohnNiang in https://github.com/halo-dev/halo/pull/7761

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.21.8...v2.21.9

View release on GitHub
v2.21.8 Bug fix
⚠ Upgrade required
  • Spring Boot dependency upgraded to version 3.5.5
Notable features
  • Removed persistent selection of group and storage policy in attachment upload component; defaults to filter-matching strategy
Full changelog

功能优化

  • 在附件上传组件中取消所选分组和存储策略的持久化，默认选择为附件列表筛选条件相同的策略和分组。 by @ruibaby in https://github.com/halo-dev/halo/pull/7738

问题修复

  • 修复部分场景下无法正常启动插件的问题。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7725
  • 解决使用 Select 组件远程请求数据时的分页问题。 by @LIlGG in https://github.com/halo-dev/halo/pull/7726
  • 修复文章贡献者中始终显示已删除用户的问题。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7745

依赖更新

  • 升级依赖 Spring Boot 至 3.5.5。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7715

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.21.7...v2.21.8

View release on GitHub
v2.21.7 Bug fix
Security fixes
  • Detects and prevents XSS attacks in comments and replies
Notable features
  • Comments display as rich text
  • Console article management opens corresponding comment list directly
  • External resources in editor can be saved to attachment library
Full changelog

新特性

  • 评论内容支持以富文本格式显示。 by @ruibaby in https://github.com/halo-dev/halo/pull/7674
  • Console 端文章管理支持直接打开对应的评论列表。 by @ruibaby in https://github.com/halo-dev/halo/pull/7681
  • 支持转存编辑器中的外部资源到附件库。 by @ruibaby in https://github.com/halo-dev/halo/pull/7687

功能优化

  • 检测评论和回复内容是否合法以防止 XSS 攻击。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7677

问题修复

  • 修复在特定情况下模板引擎可能出现内存泄漏的问题。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7678
  • 解决将粘贴 Excel 内容会变为图片的问题。 by @LIlGG in https://github.com/halo-dev/halo/pull/7689
  • 修复角色修改表单中，所选权限可能出现不完整的问题。 by @ruibaby in https://github.com/halo-dev/halo/pull/7684

开发者相关

  • Console 和 UC 路由的权限定义检查支持函数。 by @ruibaby in https://github.com/halo-dev/halo/pull/7688

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.21.6...v2.21.7

View release on GitHub
v2.21.6 Bug fix
Notable features
  • Homepage, archive page, and author page load speed optimization
  • Option to choose whether to stay logged in during social login
  • Improved SEO tag generation logic for pages
Full changelog

功能优化

  • 优化首页、归档页和作者页加载速度。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7668
  • 支持社交登录时选择是否保持登录。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7670
  • 优化页面的 SEO 标签的生成逻辑。 by @ruibaby in https://github.com/halo-dev/halo/pull/7665

问题修复

  • 修复极端场景下无法检查文章别名是否存在的问题。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7673

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.21.5...v2.21.6

View release on GitHub
v2.21.4 Bug fix
⚠ Upgrade required
  • Upgraded dependency Spring Boot to version 3.5.4
Notable features
  • View attachment thumbnail logs
  • Batch enable/disable users
  • Optimized bulk notification deletion performance
Full changelog

新特性

  • 支持查看附件缩略图记录。 by @ruibaby in https://github.com/halo-dev/halo/pull/7630

功能优化

  • 支持批量启用/禁用用户。 by @DeliciousYellow in https://github.com/halo-dev/halo/pull/7631
  • 优化通知批量删除的执行性能。 by @ruibaby in https://github.com/halo-dev/halo/pull/7634
  • 创建文章分类和标签时支持检查别名是否已存在。 by @ruibaby in https://github.com/halo-dev/halo/pull/7616
  • 创建文章时支持检查别名是否重复。 by @ruibaby in https://github.com/halo-dev/halo/pull/7617

问题修复

  • 修复运行过程中通知器可能失效的问题。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7643

依赖更新

  • 升级依赖 Spring Boot 至 3.5.4。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7640

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.21.3...v2.21.4

View release on GitHub
v2.21.3 Bug fix
⚠ Upgrade required
  • Upgraded Spring Boot to 3.5.3
  • Upgraded Tiptap to 2.24.x
  • Raised UI project pnpm version to 10.x
Notable features
  • Support remote address download into attachment library
  • Editor drag‑and‑drop performance optimization
Full changelog

新特性

  • 支持通过远程地址下载到附件库。 by @ruibaby in https://github.com/halo-dev/halo/pull/7602

功能优化

  • 优化编辑器拖拽功能的性能。 by @LIlGG in https://github.com/halo-dev/halo/pull/7601
  • 优化默认编辑器缩进逻辑。 by @LIlGG in https://github.com/halo-dev/halo/pull/7600
  • 将编辑器的工具箱按钮改为点击展开。 by @ruibaby in https://github.com/halo-dev/halo/pull/7598
  • 文章预览页面不再统计访问数据。 by @GoldenSupremeSaltedFish in https://github.com/halo-dev/halo/pull/7582

问题修复

  • 修复个人中心上传组件无法正常加载样式的问题。 by @ruibaby in https://github.com/halo-dev/halo/pull/7606
  • 修复代码输入框在全屏时，底部内容被遮挡的问题。 by @ruibaby in https://github.com/halo-dev/halo/pull/7599
  • 修复菜单项和文章分类可能出现无法拖动排序的问题。 by @ruibaby in https://github.com/halo-dev/halo/pull/7608

依赖更新

  • 升级依赖 Spring Boot 至 3.5.3。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7596
  • 升级 Tiptap 至 2.24.x by @LIlGG in https://github.com/halo-dev/halo/pull/7613

开发者相关

  • 提升 UI 项目的 pnpm 版本到 10.x。 by @ruibaby in https://github.com/halo-dev/halo/pull/7597

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.21.2...v2.21.3

View release on GitHub
v2.21.2 Bug fix
Notable features
  • Added content folding feature to the editor
Full changelog

功能优化

  • 为编辑器添加内容折叠功能。 by @ruibaby in https://github.com/halo-dev/halo/pull/7594

问题修复

  • 修复 2.20.1 中评论管理中内容的宽度问题。 by @ruibaby in https://github.com/halo-dev/halo/pull/7586

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.21.1...v2.21.2

View release on GitHub
v2.21.1 Bug fix
Notable features
  • Adjusted maximum width of Console article list title area.
  • Automatically rewrite trailing‑slash URLs.
Full changelog

功能优化

  • 调整 Console 文章列表的标题区域最大宽度。 by @ruibaby in https://github.com/halo-dev/halo/pull/7564
  • 支持自动重写尾部包含斜杠的 URL。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7559

问题修复

  • 修复堆叠部件中的部件可能无法显示设置按钮的问题。 by @ruibaby in https://github.com/halo-dev/halo/pull/7563

开发者相关

  • 重构 @halo-dev/ui-plugin-bundler-kit，以预配置的方式为插件提供 Vite 和 Rsbuild 的构建配置。 by @ruibaby in https://github.com/halo-dev/halo/pull/7568

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.21.0...v2.21.1

View release on GitHub
v2.21.0 Breaking risk
⚠ Upgrade required
  • Docker deployments are unaffected by the JDK upgrade.
  • If currently on a version older than 2.20.x, first upgrade to the latest 2.20 release before moving to v2.21.0.
  • Check plugin compatibility; some plugins may need updates due to API removals.
Breaking changes
  • Minimum JDK version increased to Java 21 for both development environments and jar‑file deployments.
  • Removed outdated API endpoints; affected plugins must be updated or adapted.
Notable features
  • Console dashboard refactored with responsive layout, persistent configuration, and plugin widget extensibility.
  • Added stacked widget and webpage embed widget to the Console dashboard.
  • Article management list now displays cover images.
Full changelog

⚠️ 提示

  • 此版本已经提升 JDK 版本至 21，意味着在开发环境和使用 jar 文件部署均需要升级 JDK 版本，Docker 部署方式无影响。
  • 此版本移除了部分旧版本的迁移脚本，所以请确保当前的版本至少为 2.20.x。如果不是，建议先升级到 2.20 的最新版本运行一段时间再升级到此版本。
  • 此版本移除了部分已经过时的 API，部分插件可能会受到影响。在测试阶段，常用插件已经完成适配，建议在升级 2.21 版本前后都检查一下插件是否有更新。如果你当前使用的插件还未完成兼容适配，请先向插件进行反馈。

新特性

  • 支持在概览页面配置外部访问地址。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7459
  • 支持在初始化页面设置外部访问地址。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7488
  • 重构 Console 端仪表盘，支持响应式布局、持久化配置，支持通过插件扩展小部件。 by @ruibaby in https://github.com/halo-dev/halo/pull/7496
  • 为仪表盘添加堆叠小部件。 by @ruibaby in https://github.com/halo-dev/halo/pull/7525
  • 为仪表盘添加网页嵌入小部件。 by @ruibaby in https://github.com/halo-dev/halo/pull/7516
  • 文章管理列表支持显示封面图。 by @ruibaby in https://github.com/halo-dev/halo/pull/7519

功能优化

  • 编辑器支持为链接设置 搜索引擎忽略链接关系。 by @Nimbus3009 in https://github.com/halo-dev/halo/pull/7444
  • 用户搜索支持根据邮箱地址。 by @liuyiwuqing in https://github.com/halo-dev/halo/pull/7441
  • 优化 Console 和 UC 中数据列表的 UI 在不同尺寸设备下的表现。 by @ruibaby in https://github.com/halo-dev/halo/pull/7383
  • 移除插件列表的时间字段，并在插件详情中显示安装时间。 by @ruibaby in https://github.com/halo-dev/halo/pull/7494
  • 优化评论管理的 UI，支持查看评论的详细数据。 by @ruibaby in https://github.com/halo-dev/halo/pull/7481
  • 将 Console 端文章列表的发布时间改为语义化时间。 by @ruibaby in https://github.com/halo-dev/halo/pull/7526
  • 优化 Console 端的对话框在移动端下的样式。 by @ruibaby in https://github.com/halo-dev/halo/pull/7512
  • 优化 Console 的全局依赖文件名，以获得更好的缓存利用率。 by @ruibaby in https://github.com/halo-dev/halo/pull/7530
  • 优化移动端的菜单，支持切换 Console / UC，支持退出登录和返回到首页。 by @ruibaby in https://github.com/halo-dev/halo/pull/7542
  • 优化移动端下文章编辑页面的样式。 by @ruibaby in https://github.com/halo-dev/halo/pull/7544
  • 移除无用的依赖，软件包的体积减少近 15%。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7549
  • 支持在附件详情弹窗中复制完整的附件地址。 by @ruibaby in https://github.com/halo-dev/halo/pull/7550

问题修复

  • 修复因 Locale 解析错误导致无法访问页面的问题。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7458
  • 修复当有已选择附件时，上传新附件导致所选附件状态异常的问题。 by @ruibaby in https://github.com/halo-dev/halo/pull/7487
  • 修复 Console 的全局搜索能搜索出系统保留用户的问题。 by @ruibaby in https://github.com/halo-dev/halo/pull/7486
  • 修复模态框标题文字溢出的问题。 by @ruibaby in https://github.com/halo-dev/halo/pull/7546
  • 修复用户资料页面头像在 Safari 浏览器下的阴影问题。 by @ruibaby in https://github.com/halo-dev/halo/pull/7551

依赖更新

  • 升级依赖 Spring Boot 至 3.5.0。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7467
  • 升级依赖 Lucene 至 10.2.1。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7476

开发者相关

  • 更新最低运行环境为 Java 21。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7451
  • 添加用户登录/登出事件。 by @liuyiwuqing in https://github.com/halo-dev/halo/pull/7440
  • UI 组件添加 VEntityContainer 组件，以优化数据列表的样式。 by @ruibaby in https://github.com/halo-dev/halo/pull/7383
  • 提供根据分组获取和更新用户预设的 API。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7495
  • 提供更易用的存储策略配置查询和更新接口。 by @JohnNiang in https://github.com/halo-dev/halo/pull/7527
  • @halo-dev/ui-plugin-bundler-kit 支持自定义 outDir 和 manifestPath。 by @ruibaby in https://github.com/halo-dev/halo/pull/7552
  • Console 页面数据列表的字段和操作选项支持扩展。 by @ruibaby in https://github.com/halo-dev/halo/pull/7553

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

Full Changelog: https://github.com/halo-dev/halo/compare/v2.20.21...v2.21.0

View release on GitHub

Beta — feedback welcome: [email protected]