使用 Docker 部署
在继续操作之前,我们推荐您先阅读《写在前面》,这可以快速帮助你了解 Halo。
此文档仅提供使用默认 H2 数据库的 Docker 运行方式,主要用于体验和测试,在生产环境我们不推荐使用 H2 数据库,这可能因为操作不当导致数据文件损坏。如果因为某些原因(如内存不足以运行独立数据库)必须要使用,建议按时备份数据。
如果需要使用其他数据库部署,我们推荐使用 Docker Compose 部署:使用 Docker Compose 部署环境搭建
- Docker 安装文档:https://docs.docker.com/engine/install/
部署 Halo
镜像说明
Halo 主要区分为社区版和付费版,这两个版本使用不同的 Docker 镜像,以下是 Docker Hub 的官方镜像地址:
- Halo 付费版镜像:包括 Halo 专业版 和 Halo 商城版,包含社区版的所有功能,并提供额外的付费功能,部分付费功能需要使用许可证激活
- Halo 社区版镜像:使用 Halo 的开源仓库构建,不包含任何付费功能,也不支持激活许可证
镜像名称由以下组成:
<version> 表示 Halo 的具体版本号,比如 2.26.0,版本命名方式遵循 SemVer,即 <major>.<minor>.<patch>
除了具体版本号的标签之外,Halo 还提供了 :<major> 和 :<major>.<minor> 的标签,比如:
halohub/halo-pro:2:代表整个 Halo 2 的最新版本halohub/halo-pro:2.20:代表 Halo 2.20 的最新版本
以上是 Docker Hub 的官方镜像地址,如果你的服务器因为网络原因导致拉取速度缓慢,也可以使用我们自行搭建的镜像库:
- 付费版:
registry.fit2cloud.com/halo/halo-pro - 社区版:
registry.fit2cloud.com/halo/halo
后续文档将使用 registry.fit2cloud.com/halo/halo-pro 为例,如果你需要安装社区版,需要将 halo-pro 替换为 halo。
创建容器
注意:此命令默认使用自带的 H2 Database 数据库。如需使用 PostgreSQL,请参考:使用 Docker Compose 部署
- -it:开启输入功能并连接伪终端
- -d:后台运行容器
- --name:为容器指定一个名称
- -p:端口映射,格式为
主机(宿主)端口:容器端口,可在application.yaml配置。 - -v:工作目录映射。形式为:
-v 宿主机路径:/root/.halo2,后者不能修改。
运行参数详解:
数据库配置:
为了保持部署流程的简洁,此文档仅提供了必要的配置示例,完整的配置选项列表可查阅:配置说明
测试访问
用浏览器访问 /console 即可进入 Halo 管理页面,首次启动会进入初始化页面。
如果需要配置域名访问,建议先配置好反向代理以及域名解析再进行初始化。如果通过 http://ip:端口号 的形式无法访问,请到服务器厂商后台将运行的端口号添加到安全组,如果服务器使用了 Linux 面板,请检查此 Linux 面板是否有还有安全组配置,需要同样将端口号添加到安全组。
激活许可证
可以参考 许可证激活 进行激活,社区版无需此步骤。