Halo 是一款强大易用的开源建站工具，它让你无需太多的技术知识就可以快速搭建一个商城、官网或其他内容管理系统。具备可插拔架构、主题套用、富文本编辑器等多重特性，支持用户根据自己的喜好选择不同类型的插件及主题模板来定制化自己的站点功能及外观。让内容创作和发布更加便捷生动。
截至目前（2025 年 Q4 季度），Halo 已经在 Docker Hub 获得了超过 280 万次下载，GitHub Star 数突破 37 k，并拥有一百多名社区贡献者。
2025 年 12 月 24 日，强大易用的开源建站工具 Halo 正式发布 2.22.0 版本。
⚠️ 重要提示
亮点更新
商城功能（专业版）
随着 Halo 2.22 的发布，我们同时上线了 Halo 商城功能。支持用户基于 Halo 站点创建店铺，上架多种类型的货品与商品支付、商品发货方式。为实体商品、虚拟商品、链接商品等销售场景提供完备的电商解决方案。
该部分功能现已纳入 Halo 商业版
编辑器更新
图片集功能
在 Halo 2.22 中，我们在编辑器中新增了图片集功能，可以同时添加多张图片并支持自定义布局。
多媒体文件支持描述文本
在 Halo 2.22 中，我们为编辑器图片、视频、音频添加了描述文本的支持。
快捷设置文章封面
在 Halo 2.22 中，我们在文章编辑器中添加了设置封面的功能，进一步简化了文章编辑流程。
设置表单优化
新的数组表单类型
在之前的版本中，我们为了让插件和主题的设置功能有更加灵活的数据定义能力，引入了名为 Repeater 的表单类型，这个表单类型可以让开发者自定义数组对象的字段，但后面观察到各个主题和插件的真实使用场景，发现这个表单类型在复杂的数据结构下很容易造成可读性问题。
为此，我们在新版本中引入了一个新的数组表单类型，名为 Array ，此类型会默认隐藏所有设置表单，仅显示数据摘要列表，可以很大程度解决可读性问题，提高用户的配置效率。
👇 旧版本 Repeater
👇 新版本 Array
附件类型支持预览和上传
在之前的版本中，附件类型的表单项仅支持输入链接或者从附件库选择附件，在 Halo 2.22 中，我们彻底重构了附件表单类型，支持了附件预览和直接上传。
新增图标表单类型
在 Halo 2.22 中，我们引入了一个全新的图标表单类型，集成了 Iconify，可以直接从 Iconify 平台选择图标，此平台汇集了主流的开源图标库，总计约 20 万图标，能够满足绝大部分需求。
该功能需要主题和插件主动适配。
附件管理优化
存储策略支持排序和隐藏
在 Halo 2.22 中，我们为附件存储策略添加了隐藏和排序的设置项，我们可以将不常用或者不会主动上传的附件存储策略进行隐藏或者调整顺序。
优化附件选择弹窗
在 Halo 2.22 中，我们优化了附件选择弹窗的操作逻辑，现在支持直接在选择界面调出上传界面，并复用选择界面所选的存储策略和分组，可以很大程度的减少操作流程。
性能优化
附件缩略图重构
2.22 版本意味着一个更加全面轻快的 Halo。
2 完整更新日志
新特性
为编辑器新增图片集功能 by @LIlGG in #7897
-
用户注册支持设置受保护用户名 by @liuyiwuqing in #7887 -
编辑器的图片、视频、音频支持添加描述文本 by @LIlGG in #7875 -
重构编辑器拖拽功能，并为其增加功能操作菜单 by @LIlGG in #7861 -
编辑器支持使用中文符号、唤起建议菜单 by @LIlGG in #7840 -
支持在文章编辑页面设置封面图 by @ruibaby in #7809 -
支持为附件存储策略设置在上传界面的显示优先级 by @ruibaby in #7805 -
支持在附件上传界面隐藏部分存储策略 by @ruibaby in #7792
功能优化
清理通知发送所残留的无用数据 by @JohnNiang in #8007
-
用户密码允许输入 . 和 ? by @xzyone in #8005 -
为阻塞操作添加超时时间以提升系统可靠性 by @JohnNiang in #8004 -
优化编辑器的整体样式和交互逻辑 by @ruibaby in #7982 -
优化 Console 和 UC 的加载速度 by @ruibaby in #7976 #7971 #7941 #7935 #8037 -
提升 Console 端代码输入框的渲染速度 by @ruibaby in #7956 #7932 -
优化个人中心身份认证设置，将三方登录与两步认证合并到一个选项卡 by @ruibaby in #7950 -
Console 和 UC 支持异步加载所需语言包，提升首屏加载速度 by @ruibaby in #7931 -
懒加载 Console 和 UC 的部分路由，优化首屏渲染速度 by @ruibaby in #7930 -
文章设置中选择作者时支持显示用户名 by @ruibaby in #7904 -
修复离线环境下，Console 无法请求接口的问题 by @ruibaby in #7848 -
解决生成缩略图时可能出现内存溢出的问题 by @JohnNiang in #7817 -
支持配置缩略图生成启用、禁用和并发量 by @JohnNiang in #7812 -
为编辑器的命令面板添加插入图片的选项 by @ruibaby in #7803 -
重构图片缩略图功能，移除缩略图记录，改为按需生成 by @JohnNiang in #7779 -
新增 Shiki 代码高亮和超链接卡片预设插件 by @ruibaby in #7785 -
优化系统性能 by @JohnNiang in #8045 -
优化文章详情页面加载 by @JohnNiang in #8047 -
优化编辑器搜索界面的样式 by @ruibaby in #8052 -
重构附件选择弹窗，与上传界面融合 by @ruibaby in #8058 -
重构附件表单类型，支持预览和直接上传 by @ruibaby in #8061 -
重构附件默认存储策略配置，统一在设置 -> 附件设置中配置 by @JohnNiang in #8092
问题修复
-
解决无法在编辑器中插入视频的问题 by @LIlGG in #7986 -
修复可能无法初始化主题配置的问题 by @JohnNiang in #7923 -
修复潜在的内存泄漏问题 by @JohnNiang in #7914 -
优化重置密码时因邮箱可输入大小写导致的问题 by @JohnNiang in #7901 -
解决切换代码块语言时编辑器页面不正常跳动的问题 by @LIlGG in #7839 -
修复可能无法正常获取附件链接的问题 by @JohnNiang in #7788
依赖更新
升级 Spring Boot 至 3.5.7 by @JohnNiang in #7871
-
升级 Spring Boot 至 3.5.9 by @JohnNiang in #8069 -
升级 Tiptap 至 3.x by @LIlGG in #7811
开发者相关
修复 @halo-dev/components 的 Dropdown 组件类型问题 by @ruibaby in #7974
-
将 @halo-dev/console-shared 重命名为 @halo-dev/ui-shared by @ruibaby in #7926 -
@halo-dev/console-shared 包提供 utils.id.uuid() 方法，用于生成 uuid by @ruibaby in #7898 -
在 @halo-dev/console-shared 包中提供 stores 对象，包含 currentUser 和 globalInfo by @ruibaby in #7858 -
支持在插件的 UI 中使用 Pinia 定义全局 Store by @ruibaby in #7858 -
在 @halo-dev/console-shared 包中提供 UI 权限检查工具 by @ruibaby in #7853 -
在 @halo-dev/console-shared 包中提供统一的 date 和 attachment 工具 by @ruibaby in #7847 -
优化索引引擎以提升索引和查询性能 by @JohnNiang in #7822 -
优化 FormKit 的 color 输入类型，支持透明度 by @ruibaby in #8003 -
为 FormKit 添加 Iconify 选择组件 by @ruibaby in #8000 -
重构 @halo-dev/components 中的 Dropdown 组件，改为完全使用 floating-vue 的原始组件 by @ruibaby in #7978 -
改进 @halo-dev/api-client 包的配置，在外部使用的时候支持 tree shaking by @ruibaby in #7966 -
FormKit Color 支持 hsl 格式，并支持手动编辑色值 by @ruibaby in #8039 -
为文章、页面等元数据表单注入当前表单的数据，以便在元数据定义中判断是否需要显示表单项 by @ruibaby in #8040
