• 使用 Docker Compose 部署

使用 Docker Compose 部署

环境搭建

• Docker 安装文档：https://docs.docker.com/engine/install/

• Docker Compose 安装文档：https://docs.docker.com/compose/install/

创建容器组

• registry.fit2cloud.com/halo/halo

• halohub/halo

• ghcr.io/halo-dev/halo

• registry.fit2cloud.com/halo/halo:2：表示最新的 2.x 版本，即每次发布新版本都会更新此镜像。

• registry.fit2cloud.com/halo/halo:2.16：表示最新的 2.16.x 版本，即每次发布 patch 版本都会同时更新此镜像。

• registry.fit2cloud.com/halo/halo:2.16.0：表示一个具体的版本。

1. 在系统任意位置创建一个文件夹，此文档以 ~/halo 为例。
信息
注意：后续操作中，Halo 产生的所有数据都会保存在这个目录，请妥善保存。

2. 创建 docker-compose.yaml
此文档提供两种场景的 Docker Compose 配置文件，请根据你的需要选择一种。
信息
需要注意的是，此文档为了更加方便的管理配置，所有与 Halo 相关的配置都使用 Docker 容器启动参数代替，所以无需创建 application.yaml 文件。
1. 创建 Halo + PostgreSQL 的实例：
~/halo/docker-compose.yaml
信息
此示例的 PostgreSQL 数据库容器默认没有设置端口映射，如果需要在容器外部访问数据库，可以自行在 halodb 服务中添加端口映射，PostgreSQL 的端口为 5432。
2. 创建 Halo + MySQL 的实例：
~/halo/docker-compose.yaml
信息
此示例的 MySQL 数据库容器默认没有设置端口映射，如果需要在容器外部访问数据库，可以自行在 halodb 服务中添加端口映射，MySQL 的端口为 3306。
3. 仅创建 Halo 实例（使用默认的 H2 数据库）：
警告
不推荐在生产环境使用默认的 H2 数据库，这可能因为操作不当导致数据文件损坏。如果因为某些原因（如内存不足以运行独立数据库）必须要使用，建议按时备份数据。
~/halo/docker-compose.yaml
4. 仅创建 Halo 实例（使用已有外部数据库，MySQL 为例）：
~/halo/docker-compose.yaml
运行参数详解：

参数名	描述
spring.r2dbc.url	数据库连接地址，详细可查阅下方的 数据库配置
spring.r2dbc.username	数据库用户名
spring.r2dbc.password	数据库密码
spring.sql.init.platform	数据库平台名称，支持 postgresql、mysql、h2
halo.external-url	外部访问链接，如果需要在公网访问，需要配置为实际访问地址
halo.cache.page.disabled	是否禁用页面缓存，默认为禁用，如需页面缓存可以手动添加此配置，并设置为 false。
开启缓存之后，在登录的情况下不会经过缓存，且默认一个小时会清理掉不活跃的缓存，也可以在 Console 仪表盘的快捷访问中手动清理缓存。	ㅤ

数据库配置：

链接方式	链接地址格式	spring.sql.init.platform
PostgreSQL	r2dbc:pool:postgresql://{HOST}:{PORT}/{DATABASE}	postgresql
MySQL	r2dbc:pool:mysql://{HOST}:{PORT}/{DATABASE}	mysql
MariaDB	r2dbc:pool:mysql://{HOST}:{PORT}/{DATABASE}	mysql
H2 Database	r2dbc:h2:file:///${halo.work-dir}/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE	h2

警告
由于 MariaDB 数据库驱动目前存在问题，使用 MariaDB 数据库时也选择使用 MySQL 驱动，即链接地址格式为 r2dbc:pool:mysql://{HOST}:{PORT}/{DATABASE}。
详情可见：https://github.com/halo-dev/halo/issues/5534

3. 启动 Halo 服务
实时查看日志：

4. 用浏览器访问 /console 即可进入 Halo 管理页面，首次启动会进入初始化页面。
提示
如果需要配置域名访问，建议先配置好反向代理以及域名解析再进行初始化。如果通过 http://ip:端口号 的形式无法访问，请到服务器厂商后台将运行的端口号添加到安全组，如果服务器使用了 Linux 面板，请检查此 Linux 面板是否有还有安全组配置，需要同样将端口号添加到安全组。

更新容器组

1. 备份数据，可以参考 备份与恢复 进行完整备份。

2. 更新 Halo 服务
修改 docker-compose.yaml 中配置的镜像版本。

反向代理

1. 使用 Nginx Proxy Manager

2. 使用 Traefik

Nginx

Caddy 2

Traefik

1. networks 中引入已存在的网络 traefik（此网络需要 提前创建）

2. services.halo.networks 中添加网络 traefik

3. 修改外部地址为你的域名

4. 声明路由规则、开启 TLS