INFO

本页面即将停止更新，后续更新日志统一在 https://releases.halo.run/changelog 维护。

2.22.12（2026-01-26）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.12
  • halohub/halo-pro:2.22.12

功能优化

  • 优化短信服务错误日志提示（专业版 / 商业版）
  • 为 Array 组件适配 Halo 中的大部分组件并支持 Select 远程数据源 by @LIlGG in halo-dev/halo#8267

问题修复

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

2.22.11（2026-01-20）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.11
  • halohub/halo-pro:2.22.11

功能优化

问题修复

  • 修复配置 Redis 作为会话持久化存储时无法启动的问题（专业版 / 商业版）
  • 修复为用户赋角色可能失效的问题 by @JohnNiang in halo-dev/halo#8256
  • 修复 Array 表单项中图标预览的样式问题 by @ruibaby in halo-dev/halo#8253

开发者相关

2.22.10（2026-01-16）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.10
  • halohub/halo-pro:2.22.10

功能优化

问题修复

开发者相关

2.22.9（2026-01-14）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.9
  • halohub/halo-pro:2.22.9

问题修复

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

2.22.8（2026-01-09）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.8
  • halohub/halo-pro:2.22.8

功能优化

问题修复

  • 修复银行转账支付方式没有填写支付信息表单界面的问题（商业版）
  • 修复订单被手动确认支付后，支付信息界面仍然显示 去支付 按钮的问题（商业版）
  • 修复无法移除已关联订单的产品规格（商业版）
  • 解决停止插件后可能导致系统无法正常访问的问题 by @JohnNiang in halo-dev/halo#8181
  • 修复多值索引部分查询结果不准确问题 by @JohnNiang in halo-dev/halo#8187
  • 修复附件表单类型的移除逻辑问题，与旧版保持一致 by @ruibaby in halo-dev/halo#8191
  • 解决默认编辑器中顶部工具栏中的对齐工具对图片、视频、音频无效的问题 by @LIlGG in halo-dev/halo#8203

开发者相关

2.22.7（2026-01-05）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.7
  • halohub/halo-pro:2.22.7

问题修复

2.22.6（2026-01-04）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.6
  • halohub/halo-pro:2.22.6

问题修复

2.22.5（2026-01-04）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.5
  • halohub/halo-pro:2.22.5

功能优化

问题修复

2.22.4（2025-12-31）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.4
  • halohub/halo-pro:2.22.4

新特性

  • 支持微信支付（商业版）

功能优化

  • 支持清除选中的产品分类（商业版）
  • 优化支付宝电脑网站支付体验（商业版）

问题修复

  • 修复手动转账或者二维码收款支付之后无法确认支付的问题（商业版）
  • 修复最后一页数据可能包含上一页部分数据的问题 by @JohnNiang in halo-dev/halo#8138
  • 修复头像附件配置的描述文本，移除不存在的分组选项说明 by @Copilot in halo-dev/halo#8145
  • 修复 Windows 和 Linux 下无法正常访问缩略图的问题 by @JohnNiang in halo-dev/halo#8153
  • 解决编辑器粘贴富文本内单个图片时无法正确上传的问题 by @LIlGG in halo-dev/halo#8154

2.22.3（2025-12-26）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.3
  • halohub/halo-pro:2.22.3

功能优化

问题修复

  • 修复普通用户可能无法正常支付的问题（商业版）
  • 修复未登录用户添加购物车或直接购买时未跳转至登录页面（商业版）

2.22.2（2025-12-25）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.2
  • halohub/halo-pro:2.22.2

功能优化

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

问题修复

  • 解决因网关地址导致无法正常使用支付宝支付的问题（商业版）
  • 修复支付宝二维码可能出现滚动条的问题（商业版）
  • 解决使用部分数据库时无法正常启动的问题 by @JohnNiang in halo-dev/halo#8115
  • 修复部分文章路由规则配置失效的问题 by @JohnNiang in halo-dev/halo#8116

2.22.1（2025-12-25）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.1
  • halohub/halo-pro:2.22.1

功能优化

  • 优化禁用商城功能（商业版）
  • 优化 Iconify 表单类型的图标样式，不再固定宽度，以提供更好的兼容性 by @ruibaby in halo-dev/halo#8111

问题修复

  • 修复普通用户可能在个人中心看不到订单菜单项的问题（商业版）
  • 解决使用 Redis 时无法正常下单的问题（商业版）
  • 解决商城中普通用户无法填写地址的问题（商业版）
  • 修复附件分组下拉选项显示不完整的问题 by @ruibaby in halo-dev/halo#8109

开发者相关

2.22.0（2025-12-24）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.0
  • halohub/halo-pro:2.22.0

⚠️ 注意

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

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

版本说明

随着 Halo 2.22 发布，我们同时发布了 Halo 商业版，在此版本发布之后，商业版和专业版共用 halohub/halo-pro 镜像，使用许可证区分版本。

关于商业版更多信息可查阅：https://www.lxware.cn/archives/halo-shop

新特性

功能优化

问题修复

依赖更新

开发者相关

2.22.0-rc.1（2025-12-22）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.0-rc.1
  • halohub/halo-pro:2.22.0-rc.1

⚠️ 提示

建议在升级到此版本前，先查阅 2.22.0 Alpha 版本的更新日志：

功能优化

  • 优化地址输入体验（商业版）
  • 优化发货信息的文本显示（商业版）
  • 优化订单列表项布局（商业版）
  • 支持手动支付后提交支付流水号（商业版）
  • 添加关于商城的备份提示（商业版）

问题修复

  • 解决 MySQL 数据库下无法启动的问题

依赖更新

开发者相关

2.22.0-alpha.4（2025-12-21）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.0-alpha.4
  • halohub/halo-pro:2.22.0-alpha.4

⚠️ 提示

此版本为 2.22.0 的测试版本，不适用于生产环境。这个版本部分功能的内部实现做了较大变更，同时包含了部分插件 API 的变动，发布此版本的主要目的是为了可以让社区的插件和主题开发者提前适配。

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

⚠️ 商城功能提示

此版本为商城功能的测试版本，请勿用于生产环境，欢迎大家测试并反馈问题。

了解商业版

功能优化

  • 订单列表支持筛选（商业版）
  • 产品管理列表支持筛选（商业版）
  • 支持访问外部链接产品时自动跳转（商业版）
  • 前台产品列表支持筛选（商业版）
  • 重构附件选择弹窗，与上传界面融合 by @ruibaby in halo-dev/halo#8058
  • 重构附件表单类型，支持预览和直接上传 by @ruibaby in halo-dev/halo#8061

问题修复

2.22.0-alpha.3（2025-12-19）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.0-alpha.3
  • halohub/halo-pro:2.22.0-alpha.3

⚠️ 提示

此版本为 2.22.0 的测试版本，不适用于生产环境。这个版本部分功能的内部实现做了较大变更，同时包含了部分插件 API 的变动，发布此版本的主要目的是为了可以让社区的插件和主题开发者提前适配。

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

⚠️ 商城功能提示

此版本为商城功能的测试版本，请勿用于生产环境，欢迎大家测试并反馈问题。

了解商业版

功能优化

开发者相关

2.22.0-alpha.2（2025-12-15）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.0-alpha.2
  • halohub/halo-pro:2.22.0-alpha.2

⚠️ 提示

此版本为 2.22.0 的早期版本，不适用于生产环境。这个版本部分功能的内部实现做了较大变更，同时包含了部分插件 API 的变动，发布此版本的主要目的是为了可以让社区的插件和主题开发者提前适配。

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

⚠️ 商城功能提示

此版本为商城功能的早期测试版本，可能存在功能不完整或者问题较多的情况，所以请勿用于生产环境，欢迎大家测试并反馈问题。

了解商业版

功能优化

  • 优化产品属性值输入框（商业版）
  • 优化允许的注册邮箱域名列表的输入框样式（专业版 / 商业版）
  • 商品详情页面支持显示划线价格（商业版）
  • 商品详情页面的图片支持点击放大（商业版）
  • 优化产品内容编辑器全屏之后的元素定位问题（商业版）
  • 降低文章编辑器中封面的高度，并支持展开图片 by @ruibaby in halo-dev/halo#8027
  • 优化编辑器中图片的大小设置，默认不为其设置 height by @LIlGG in halo-dev/halo#8031
  • FormKit Iconify 支持手动编辑图标信息 by @ruibaby in halo-dev/halo#8033

问题修复

  • 修复因引入新依赖导致部分插件无法正常工作的问题（专业版 / 商业版）
  • 解决编辑器搜索与替换框位置不正确的情况 by @LIlGG in halo-dev/halo#8029

开发者相关

2.22.0-alpha.1（2025-12-12）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.22.0-alpha.1
  • halohub/halo-pro:2.22.0-alpha.1

⚠️ 提示

此版本为 2.22.0 的早期版本，不适用于生产环境。这个版本部分功能的内部实现做了较大变更，同时包含了部分插件 API 的变动，发布此版本的主要目的是为了可以让社区的插件和主题开发者提前适配。

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

由于 UI 的依赖库还未发布到 npm，暂时可以使用在 pkg.pr.new 中构建的版本。

⚠️ 商城功能提示

此版本为商城功能的第一个测试版本，可能存在功能不完整或者问题较多的情况，所以请勿用于生产环境，欢迎大家测试并反馈问题。

了解商业版

新特性

功能优化

问题修复

依赖更新

开发者相关

2.21.10（2025-11-06）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.10
  • halohub/halo-pro:2.21.10

功能优化

问题修复

2.21.9（2025-09-24）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.9
  • halohub/halo-pro:2.21.9

功能优化

问题修复

依赖更新

开发者相关

2.21.8（2025-09-10）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.8
  • halohub/halo-pro:2.21.8

功能优化

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

问题修复

依赖更新

2.21.7（2025-08-19）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.7
  • halohub/halo-pro:2.21.7

新特性

功能优化

问题修复

开发者相关

2.21.6（2025-08-08）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.6
  • halohub/halo-pro:2.21.6

功能优化

问题修复

2.21.5（2025-08-01）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.5
  • halohub/halo-pro:2.21.5

问题修复

2.21.4（2025-07-31）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.4
  • halohub/halo-pro:2.21.4

新特性

功能优化

问题修复

依赖更新

2.21.3（2025-07-04）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.3
  • halohub/halo-pro:2.21.3

新特性

功能优化

问题修复

依赖更新

开发者相关

2.21.2（2025-06-26）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.2
  • halohub/halo-pro:2.21.2

功能优化

问题修复

  • 修复 ALTCHA 验证码在部分页面中不起作用的问题。（专业版）
  • 修复 2.20.1 中评论管理中内容的宽度问题。 by @ruibaby in halo-dev/halo#7586

2.21.1（2025-06-19）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.1
  • halohub/halo-pro:2.21.1

功能优化

  • 优化概览页面许可证区域的权限控制，仅限超级管理员可访问。（专业版）
  • 调整 Console 文章列表的标题区域最大宽度。 by @ruibaby in halo-dev/halo#7564
  • 支持自动重写尾部包含斜杠的 URL。 by @JohnNiang in halo-dev/halo#7559

问题修复

  • 修复在非 HTTPS 环境下无法正常使用 ALTCHA 验证服务的问题。（专业版）
  • 修复堆叠部件中的部件可能无法显示设置按钮的问题。 by @ruibaby in halo-dev/halo#7563

开发者相关

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

2.21.0（2025-06-15）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.0
  • halohub/halo-pro:2.21.0

⚠️ 提示

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

新特性

功能优化

问题修复

依赖更新

开发者相关

2.21.0-beta.2（2025-06-10）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.0-beta.2
  • halohub/halo-pro:2.21.0-beta.2

⚠️ 提示

建议在升级到此版本前，先查阅 2.21.0 Alpha 版本的更新日志：

新特性

功能优化

开发者相关

2.21.0-beta.1（2025-06-06）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.0-beta.1
  • halohub/halo-pro:2.21.0-beta.1

⚠️ 提示

建议在升级到此版本前，先查阅 2.21.0 Alpha 版本的更新日志：

新特性

  • 重构 Console 端仪表盘，支持响应式布局、持久化配置，支持通过插件扩展小部件。 by @ruibaby in halo-dev/halo#7496

功能优化

  • 支持在线配置验证码服务。（专业版）
  • 移除插件列表的时间字段，并在插件详情中显示安装时间。 by @ruibaby in halo-dev/halo#7494
  • 优化评论管理的 UI，支持查看评论的详细数据。 by @ruibaby in halo-dev/halo#7481

开发者相关

2.21.0-alpha.2（2025-05-31）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.0-alpha.2
  • halohub/halo-pro:2.21.0-alpha.2

⚠️ 提示

此版本为 2.21.0 的早期版本，不适用于生产环境。这个版本移除了一些过时 API 和一些不兼容改动，发布此版本的主要目的是为了可以让社区的插件和主题开发者提前适配。具体改动方案请查阅 v2.21.0-alpha.1 中的适配列表和破坏性更新列表。

新特性

问题修复

2.21.0-alpha.1（2025-05-27）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.21.0-alpha.1
  • halohub/halo-pro:2.21.0-alpha.1

⚠️ 提示

此版本为 2.21.0 的早期版本，不适用于生产环境。这个版本移除了一些过时 API 和一些不兼容改动，发布此版本的主要目的是为了可以让社区的插件和主题开发者提前适配。具体改动方案请查阅下方的适配列表和破坏性更新列表。

从 2.21.0 开始，Halo 开发环境的最低运行环境为 Java 21。

新特性

  • 为登录、注册、发送验证码等操作添加人机验证功能（添加 --halo.captcha.enabled=true 参数）。（专业版）
  • 支持在概览页面配置外部访问地址。 by @JohnNiang in halo-dev/halo#7459

功能优化

问题修复

依赖更新

开发者相关

适配列表

VEntity 组件

此版本为了优化使用 VEntity 组件渲染的数据列表样式，引入了新的 VEntityContainer 组件，适配方式为在所有 VEntity 组件外使用
VEntityContainer 组件包裹，以下是具体步骤和示例：

升级 ⁠@halo-dev/components 包至 2.21.0 版本：

# 临时地址，等待 2.21.0 正式发布之后，可改为 @halo-dev/components@2.21.0
pnpm i https://pkg.pr.new/@halo-dev/components@7383

示例：

<script lang="ts" setup>
import { VEntity, VEntityContainer } from "@halo-dev/components"
</script>

<template>
  <VEntityContainer>
    <VEntity />
    <VEntity />
  </VEntityContainer>
</template>

完整更改方式可参考：https://github.com/halo-dev/plugin-feed/pull/66/files

破坏性更新

  • 移除过时类 run.halo.app.extension.router.selector.FieldCriteriaPredicateConverter 和
    run.halo.app.extension.router.selector.LabelCriteriaPredicateConverter，推荐用
    run.halo.app.extension.router.selector.SelectorConverter 替代。
  • 移除过时类 run.halo.app.search.SearchParam，推荐用 run.halo.app.search.SearchOption 替代。
  • 移除过时类 run.halo.app.search.post.PostDoc 和 run.halo.app.search.post.PostHit，推荐用
    run.halo.app.search.HaloDocument 替代。
  • 移除 Plugin 过时字段 spec.pluginClass，推荐在插件定义文件中移除此字段。
  • 移除 Plugin 过时字段 spec.website，推荐使用 spec.homepage 替代。
  • 移除 Plugin 过时字段 spec.require，推荐使用 spec.requires 替代。
  • 移除 SystemSetting.AuthProvider 过时字段 enabled，已经由 SystemSetting.AuthProvider 的 states 字段替代。
  • 移除 run.halo.app.extension.ExtensionMatcher 过时方法 getGvk、getLabelSelector 和 getFieldSelector。
  • 移动方法 run.halo.app.extension.MetadataOperator#metadataDeepEquals 至
    run.halo.app.extension.MetadataOperator#equals。
  • 移除 run.halo.app.extension.router.QueryParamBuildUtil 过时方法 buildParametersFromType，推荐使用
    org.springdoc.core.fn.builders.operation.Builder#parameter 替代。
  • 移除 run.halo.app.extension.router.SortableRequest 过时方法 toPredicate，推荐使用
    run.halo.app.extension.router.SortableRequest#toListOptions 替代。
  • 移除 run.halo.app.extension.router.selector.SelectorUtil 过时方法 labelSelectorsToPredicate、
    fieldSelectorToPredicate 和 labelAndFieldSelectorToPredicate，推荐使用
    run.halo.app.extension.router.selector.SelectorUtil#labelAndFieldSelectorToListOptions 替代。
  • 移除 run.halo.app.theme.finders.TagFinder 过时方法 list(Integer, Integer, Predicate, Predicate)，推荐使用
    run.halo.app.theme.finders.TagFinder#list(Integer, Integer) 替代。
  • 移除 run.halo.app.plugin.BasePlugin 过时构造函数 BasePlugin(PluginWrapper)，推荐使用 BasePlugin(PluginContext)
    替代。
  • 移除接口 GET&PUT /apis/api.console.halo.run/v1alpha1/plugins/{name}/config，推荐使用
    GET&PUT /apis/api.console.halo.run/v1alpha1/plugins/{name}/json-config 替代。
  • 移除接口 GET&PUT /apis/api.console.halo.run/v1alpha1/themes/{name}/config，推荐使用
    GET&PUT /apis/api.console.halo.run/v1alpha1/themes/{name}/json-config 替代。
  • 移除接口 POST /apis/api.halo.run/v1alpha1/indices/post，推荐使用 POST /apis/api.halo.run/v1alpha1/indices/-/search
    替代。
  • 移除接口 POST /apis/api.console.halo.run/v1alpha1/indices/post，推荐使用
    POST /apis/api.console.halo.run/v1alpha1/indices/-/rebuild 替代。

最后，请确保更新 plugin.yaml 中的 requires 字段为 >=2.21.0。

2.20.21 LTS（2025-05-15）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.21
  • halohub/halo-pro:2.20.21

功能优化

问题修复

开发者相关

2.20.20 LTS（2025-05-09）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.20
  • halohub/halo-pro:2.20.20

功能优化

问题修复

2.20.19 LTS（2025-04-27）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.19
  • halohub/halo-pro:2.20.19

新特性

功能优化

问题修复

依赖更新

开发者相关

2.20.19-beta.3（2025-04-22）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.19-beta.3
  • halohub/halo-pro:2.20.19-beta.3

问题修复

  • 修复生成手机绑定二维码可能导致系统阻塞的问题。（专业版）

2.20.19-beta.2（2025-04-20）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.19-beta.2
  • halohub/halo-pro:2.20.19-beta.2

功能优化

  • 重构移动端 App 绑定二维码的参数，优化绑定体验。（专业版）
  • 文章访问路径支持设置 /categories/{categorySlug}/{postSlug} 的形式。 by @guqing in halo-dev/halo#7331

开发者相关

2.20.19-beta.1（2025-04-15）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.19-beta.1
  • halohub/halo-pro:2.20.19-beta.1

新特性

  • 添加移动端 App 绑定功能。（专业版）

问题修复

开发者相关

2.20.18 LTS（2025-03-22）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.18
  • halohub/halo-pro:2.20.18

新特性

问题修复

2.20.17 LTS（2025-03-13）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.17
  • halohub/halo-pro:2.20.17

功能优化

问题修复

2.20.16 LTS（2025-03-10）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.16
  • halohub/halo-pro:2.20.16

新特性

功能优化

问题修复

开发者相关

  • 调整插件类的加载顺序使其遵循双亲委派机制，替代原先的 Plugin -> Dependent Plugin -> Halo 加载顺序。 by @guqing in halo-dev/halo#7258

2.20.15 LTS（2025-02-22）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.15
  • halohub/halo-pro:2.20.15

问题修复

依赖更新

2.20.14 LTS（2025-01-24）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.14
  • halohub/halo-pro:2.20.14

功能优化

  • 适配版本买断类型的许可证。（专业版）
  • 自动生成摘要仅对内容发生变更时生效。 by @guqing in halo-dev/halo#7200

问题修复

依赖更新

2.20.13 LTS（2025-01-03）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.13
  • halohub/halo-pro:2.20.13

功能优化

  • 为 UC 端发布文章的操作添加重试机制，防止出现因为锁导致的保存失败问题。 by @ruibaby in halo-dev/halo#7171

问题修复

  • 修复开启全站私有后没有权限发送登录短信验证码的问题。（专业版）
  • 修复文件类型限制能通过混合文件类型绕过检测的问题。 by @guqing in halo-dev/halo#7149
  • 修复卸载主题之后没有清理模板缓存的问题。 by @guqing in halo-dev/halo#7174

2.20.12 LTS（2024-12-17）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.12
  • halohub/halo-pro:2.20.12

新特性

功能优化

问题修复

  • 修复在较低版本浏览器中无法使用默认编辑器和附件上传功能的问题。 by @ruibaby in halo-dev/halo#7128

2.20.11 LTS（2024-12-04）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.11
  • halohub/halo-pro:2.20.11

功能优化

问题修复

依赖更新

开发者相关

2.20.10 LTS（2024-11-26）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.10
  • halohub/halo-pro:2.20.10

新特性

功能优化

问题修复

依赖更新

开发者相关

2.20.9 LTS（2024-11-12）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.9
  • halohub/halo-pro:2.20.9

新特性

功能优化

问题修复

  • 移除短信通知配置中无用的 Local 提供商。

2.20.8 LTS（2024-10-30）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.8
  • halohub/halo-pro:2.20.8

功能优化

问题修复

  • 修复使用 Secret 输入框创建 Secret 时，stringData 的 key 可能为 undefined 的问题。 by @ruibaby in halo-dev/halo#6964

依赖更新

开发者相关

2.20.7 LTS（2024-10-23）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.7
  • halohub/halo-pro:2.20.7

问题修复

  • 修复登录时切换了其他语言，但是进入 Console 之后不是所选语言的问题。 by @guqing in halo-dev/halo#6933
  • 修复使用 singlePageFinder.list() 时会提示缺少 spec.deleted 索引的问题。 by @guqing in halo-dev/halo#6922
  • 修复插件配置可能因为缺少校验导致使用时类型转换失败从而影响 Halo 使用的问题。 by @guqing in halo-dev/halo#6924
  • 修复登录页面路由会被自定义页面路由覆盖导致无法登录的问题。 by @guqing in halo-dev/halo#6926

2.20.6 LTS（2024-10-22）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.6
  • halohub/halo-pro:2.20.6

功能优化

问题修复

  • 修复当 License Code 不符合规则时，激活页面渲染异常的问题。（专业版）
  • 修复通过登录跳转到文章编辑页面时，发布文章会跳转到个人中心的问题。 by @ruibaby in halo-dev/halo#6902
  • 修复在低版本 Safari 浏览器中，注册表单中的按钮高度溢出的问题。 by @ruibaby in halo-dev/halo#6912
  • 修复文章自动生成别名不按照别名生成策略生成的问题。 by @ruibaby in halo-dev/halo#6914

2.20.5 LTS（2024-10-18）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.5
  • halohub/halo-pro:2.20.5

⚠️ Halo 2.20 LTS 重要提示

  • 此版本重构了登录相关的页面，登录入口从 /console/login 改为了 /login。
  • 在重构登录页面的过程中，也改动了登录授权相关的逻辑和 API，请在升级之后进行以下操作：
    • 升级所有登录认证相关的插件。
    • 重新在 用户 -> 身份认证 页面启用和排序三方认证方式。
    • 系统设置 -> 用户 -> 短信验证码 选项已废弃，需要升级之后去 用户 -> 身份认证 重新开启。（专业版）
    • 系统设置 -> 用户 -> 默认登录方式 选项已废弃，需要升级之后去 用户 -> 身份认证 中管理，拖动所需登录方式为第一个即可。（专业版）
  • 角色的 登录之后默认跳转位置 设置选项在此版本已移除，建议使用 /login?redirect_uri= 代替。
  • 出于安全考虑，此版本在生产环境下默认禁用了 Basic Auth 的认证方式，如有需要可以通过添加 halo.security.basic-auth.disabled=false 启动参数来启用。

功能优化

  • 修改 MySQL 表创建脚本 name 列的字符集使其大小写敏感，以保证和其他数据库表现一致。 by @guqing in halo-dev/halo#6897

问题修复

  • 修复注册表单经过通过手机号验证之后可能无法正常提交的问题。（专业版）
  • 修复非默认登录方式登录失败之后跳转至默认登录方式的问题。 by @JohnNiang in halo-dev/halo#6896
  • 修复非 HTTPS 连接下无法记住用户语言偏好的问题。 by @guqing in halo-dev/halo#6891

2.20.4 LTS（2024-10-17）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.4
  • halohub/halo-pro:2.20.4

⚠️ Halo 2.20 LTS 重要提示

  • 此版本重构了登录相关的页面，登录入口从 /console/login 改为了 /login。
  • 在重构登录页面的过程中，也改动了登录授权相关的逻辑和 API，请在升级之后进行以下操作：
    • 升级所有登录认证相关的插件。
    • 重新在 用户 -> 身份认证 页面启用和排序三方认证方式。
    • 系统设置 -> 用户 -> 短信验证码 选项已废弃，需要升级之后去 用户 -> 身份认证 重新开启。（专业版）
    • 系统设置 -> 用户 -> 默认登录方式 选项已废弃，需要升级之后去 用户 -> 身份认证 中管理，拖动所需登录方式为第一个即可。（专业版）
  • 角色的 登录之后默认跳转位置 设置选项在此版本已移除，建议使用 /login?redirect_uri= 代替。
  • 出于安全考虑，此版本在生产环境下默认禁用了 Basic Auth 的认证方式，如有需要可以通过添加 halo.security.basic-auth.disabled=false 启动参数来启用。

问题修复

  • 修复插件模板处理扩展中无法获取到请求上下文的问题。 by @guqing in halo-dev/halo#6877
  • 修复从旧版本升级到 2.20 会因为默认主题目录已经存在而无法初始化的问题。 by @guqing in halo-dev/halo#6889

开发者相关

2.20.3 LTS（2024-10-15）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.3
  • halohub/halo-pro:2.20.3

⚠️ Halo 2.20 LTS 重要提示

  • 此版本重构了登录相关的页面，登录入口从 /console/login 改为了 /login。
  • 在重构登录页面的过程中，也改动了登录授权相关的逻辑和 API，请在升级之后进行以下操作：
    • 升级所有登录认证相关的插件。
    • 重新在 用户 -> 身份认证 页面启用和排序三方认证方式。
    • 系统设置 -> 用户 -> 短信验证码 选项已废弃，需要升级之后去 用户 -> 身份认证 重新开启。（专业版）
    • 系统设置 -> 用户 -> 默认登录方式 选项已废弃，需要升级之后去 用户 -> 身份认证 中管理，拖动所需登录方式为第一个即可。（专业版）
  • 角色的 登录之后默认跳转位置 设置选项在此版本已移除，建议使用 /login?redirect_uri= 代替。
  • 出于安全考虑，此版本在生产环境下默认禁用了 Basic Auth 的认证方式，如有需要可以通过添加 halo.security.basic-auth.disabled=false 启动参数来启用。

问题修复

2.20.2 LTS（2024-10-14）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.2
  • halohub/halo-pro:2.20.2

⚠️ Halo 2.20 LTS 重要提示

  • 此版本重构了登录相关的页面，登录入口从 /console/login 改为了 /login。
  • 在重构登录页面的过程中，也改动了登录授权相关的逻辑和 API，请在升级之后进行以下操作：
    • 升级所有登录认证相关的插件。
    • 重新在 用户 -> 身份认证 页面启用和排序三方认证方式。
    • 系统设置 -> 用户 -> 短信验证码 选项已废弃，需要升级之后去 用户 -> 身份认证 重新开启。（专业版）
    • 系统设置 -> 用户 -> 默认登录方式 选项已废弃，需要升级之后去 用户 -> 身份认证 中管理，拖动所需登录方式为第一个即可。（专业版）
  • 角色的 登录之后默认跳转位置 设置选项在此版本已移除，建议使用 /login?redirect_uri= 代替。
  • 出于安全考虑，此版本在生产环境下默认禁用了 Basic Auth 的认证方式，如有需要可以通过添加 halo.security.basic-auth.disabled=false 启动参数来启用。

问题修复

2.20.1 LTS（2024-10-14）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.1
  • halohub/halo-pro:2.20.1

⚠️ 重要提示

  • 此版本重构了登录相关的页面，登录入口从 /console/login 改为了 /login。
  • 在重构登录页面的过程中，也改动了登录授权相关的逻辑和 API，请在升级之后进行以下操作：
    • 升级所有登录认证相关的插件。
    • 重新在 用户 -> 身份认证 页面启用和排序三方认证方式。
    • 系统设置 -> 用户 -> 短信验证码 选项已废弃，需要升级之后去 用户 -> 身份认证 重新开启。（专业版）
    • 系统设置 -> 用户 -> 默认登录方式 选项已废弃，需要升级之后去 用户 -> 身份认证 中管理，拖动所需登录方式为第一个即可。（专业版）
  • 角色的 登录之后默认跳转位置 设置选项在此版本已移除，建议使用 /login?redirect_uri= 代替。
  • 出于安全考虑，此版本在生产环境下默认禁用了 Basic Auth 的认证方式，如有需要可以通过添加 halo.security.basic-auth.disabled=false 启动参数来启用。

新特性

  • 支持用户在个人中心上传和访问自己的附件（需要具有对应权限）。 by @guqing in halo-dev/halo#6731
  • 支持在个人中心的文章管理界面删除用户创建的文章。 by @guqing in halo-dev/halo#6729
  • 重构登录、注册相关的页面。 by @JohnNiang in halo-dev/halo#6488
    • 登录、注册相关页面改为由后端渲染页面，提供统一的访问入口。
    • 提升页面加载性能。
    • 优化登录、注册相关页面的交互逻辑。
    • 登录、注册等页面支持通过主题或者插件提供。

破坏性更新

功能优化

问题修复

开发者相关

依赖更新

2.20.0-rc.2（2024-10-12）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.0-rc.2
  • halohub/halo-pro:2.20.0-rc.2

功能优化

  • 支持在身份认证管理中开启/关闭手机号登录。（专业版）
  • 优化登录等页面的 UI，优化低分屏下的 UI 表现，防止元素过大。 by @ruibaby in halo-dev/halo#6832

问题修复

2.20.0-rc.1（2024-10-11）

可用的 Docker 镜像：

  • registry.fit2cloud.com/halo/halo-pro:2.20.0-rc.1
  • halohub/halo-pro:2.20.0-rc.1

重要提示

  • 此版本为 2.20 LTS 的首个测试版本，请不要在生产环境升级使用，部分功能并未完全适配。
  • 此版本重构了登录相关的页面，登录入口从 /console/login 改为了 /login。
  • 在重构登录页面的过程中，也改动了登录授权相关的逻辑和 API，使用此版本时请注意升级登录认证相关的插件。
  • 角色的 登录之后默认跳转位置 设置选项在此版本已移除，建议使用 /login?redirect_uri= 代替。
  • 出于安全考虑，此版本在生产环境下默认禁用了 Basic Auth 的认证方式，如有需要可以通过添加 halo.security.basic-auth.disabled=false 启动参数来启用。

新特性

  • 支持用户在个人中心上传和访问自己的附件（需要具有对应权限）。 by @guqing in halo-dev/halo#6731
  • 支持在个人中心的文章管理界面删除用户创建的文章。 by @guqing in halo-dev/halo#6729
  • 重构登录、注册相关的页面。 by @JohnNiang in halo-dev/halo#6488
    • 登录、注册相关页面改为由后端渲染页面，提供统一的访问入口。
    • 提升页面加载性能。
    • 优化登录、注册相关页面的交互逻辑。
    • 登录、注册等页面支持通过主题或者插件提供。

破坏性更新

功能优化

问题修复

开发者相关

依赖更新

更多可查阅：历史日志

购物车

总计

¥1299

去支付