1Panel 部署 Halo 技术博客：雨云配置、社区版镜像与升级备份

想用 Halo 写技术笔记，在 1Panel 里点击安装之前，先看清选中的镜像。Halo 社区版和付费版使用不同镜像，应用商店里出现一张 Halo 卡片，并不表示它就是社区版，也不表示里面的付费功能已经获得授权。

如果只需要个人博客，可以从社区版开始。把域名、数据库和数据目录配置好，再选主题；以后换机器或升级时，这些设置比主题外观更影响恢复。

先区分社区版与付费版

Halo 官方的社区版镜像是 halohub/halo，付费版镜像是 halohub/halo-pro；官方备用镜像仓库也分别使用 halo 与 halo-pro。社区版不包含付费功能，也不支持用许可证激活成付费版。

2026 年 10 月 6 日查看的 1Panel 应用仓库 Halo 模板使用 halohub/halo-pro:2.26.1。你面板里同步到的模板可能不同，安装前打开实际编排内容检查。选付费版时按功能需要了解许可证；要使用社区版，可以在 1Panel 的容器编排中维护官方 Docker Compose 配置，采用对应的社区版镜像。

不要只改镜像名称就保留所有付费插件，再认为部署没有区别。版本、插件和主题都应与所选版本兼容。正式站固定具体镜像版本，升级时主动检查变更，不让浮动标签在你没注意时跨过版本。

Halo 和数据库放在一台机器，建议留 4GB

购买新服务器时，可以考虑雨云“中国香港 → 极速三网[三区] → AMD EPYC → 流量不限型”的 2 核 4GB。Halo、数据库、1Panel 和代理同机运行，给内存留些余量，也方便之后观察 JVM 与数据库的实际占用。

2026 年 10 月 6 日，2 核 4GB、8Mbps 上传、15Mbps 下载，默认 40GB SSD 云盘和一个普通独立 IPv4，未使用账户优惠券时月付 53 元，消费返利 10.6 元；年付七折 445.2 元，返利 89 元。2 核 2GB 同条件月付 38 元、返利 7.6 元，年付七折 319.2 元、返利 63.8 元，上传 5Mbps、下载 10Mbps。

通过雨云入口注册，优惠码填 KuZhuJi。消费返利以积分发放，可以用于续费，或按平台规则兑换、提现；规格、时长和优惠不同，返利也不同，按“立即购买”下方显示核对。已有服务器可以先用它，不必为了安装博客再买一台。

4GB 是这个同机部署的起步建议，不是 Halo 的最低要求，也不是访问量保证。如果服务器还运行其他 Java 应用、图片处理或较大数据库，需要重新评估。

数据库、工作目录和正式 URL 一起配置

Halo 官方 Compose 文档提供 PostgreSQL、MySQL、H2 和外部数据库方案，推荐 PostgreSQL，正式站不建议使用 H2。使用外部数据库时，先创建数据库与专用用户，确认应用网络可以访问，再配置连接。

在 1Panel 容器编排中保存与你版本对应的官方配置，或者使用已经核对的应用模板。替换示例密码，保留数据库与 Halo 的数据挂载，检查主机端口是否冲突。数据库端口只供需要的应用访问，无须公开给所有互联网来源。

这些是 PostgreSQL 连接与外部地址的参数示例，数据库服务名、端口、库名和账号需按实际部署填写：

--spring.r2dbc.url=r2dbc:pool:postgresql://halodb:5432/halo
--spring.r2dbc.username=halo
--spring.r2dbc.password=REPLACE_WITH_DATABASE_PASSWORD
--spring.sql.init.platform=postgresql
--halo.external-url=https://blog.example.com

halodb 只有在同一容器网络中能解析到对应服务时才有效。别把示例密码直接用于生产，也不要把带密码的完整配置提交到公开仓库。

Halo 的容器工作目录通常是 /root/.halo2。官方示例或应用模板把主机目录挂到这里，实际主机路径从自己的编排中确认。附件与应用文件要写在持久化目录里，不能只留在容器的可丢弃文件层。

建立域名反向代理与 HTTPS，把正式 URL 写入 halo.external-url，再通过 /console 初始化管理员。初始化入口先限制为自己可访问，设置完成后开放博客。首页、文章页、后台上传图片和 RSS 都检查一次，确认没有残留 IP 或 HTTP 地址。

主题先在测试文章上调，插件按需要加

技术博客可以先准备一篇带代码块、表格、图片和长标题的测试文章。检查桌面与手机的段落宽度、代码横向滚动、图片加载，以及标题是否被重复输出。主题演示好看，不代表这些内容在自己的站里也合适。

安装插件前查看支持的 Halo 版本与许可。只需要文章、分类和搜索时，先维持少量插件；新增功能后检查后台日志、文章页与权限。主题、插件和应用同时升级，出了问题很难确定是哪一个改变了行为。

内置备份能用，但还要保留可回退的数据

Halo 从 2.8 起有内置备份与恢复功能，在 Console 中创建备份后等待后台任务完成，再下载成品。官方备份增强插件的自动备份与同步属于付费版能力，社区版不能把它当成默认附带功能；可以另外使用 1Panel 的计划任务管理备份。

如果使用商城版，内置备份不包含商城相关数据，应另做数据库备份。外部对象存储也需确认文件是否实际包含在恢复方案中，不能只看到一份备份包就认定附件已完整复制。

升级前留好内置备份、独立数据库备份、实际工作目录，以及旧镜像和插件清单。暂停写入，让这些数据属于同一批次。先在隔离副本上恢复，检查文章、附件、主题和插件，再升级副本，确认无误后安排正式站升级。

发生数据库结构变化后，换回旧镜像未必能完成回退，要一起恢复升级前的数据。恢复会覆盖发生冲突的内容，因此演练放在副本上，不要拿唯一的正式博客尝试导入一个不确定的备份。