使用 Docker Compose 部署
信息
在继续操作之前，我们推荐您先阅读《写在前面》，这可以快速帮助你了解 Halo。
环境搭建
Docker 安装文档：https://docs.docker.com/engine/install/
Docker Compose 安装文档：https://docs.docker.com/compose/install/
提示
我们推荐按照 Docker 官方文档安装 Docker 和 Docker Compose，因为部分 Linux 发行版软件仓库中的 Docker 版本可能过旧。
创建容器组
目前 Halo 官方维护的 Docker 镜像仓库，可以根据自己的需求选择合适的镜像源：
registry.fit2cloud.com/halo/halo
注意
目前 Halo 2 并未更新 Docker 的 latest 标签镜像，主要因为 Halo 2 不兼容 1.x 版本，防止使用者误操作。我们推荐使用固定版本的标签，比如 2.20 或者 2.20.0。
registry.fit2cloud.com/halo/halo:2：表示最新的 2.x 版本，即每次发布新版本都会更新此镜像。registry.fit2cloud.com/halo/halo:2.20：表示最新的 2.20.x 版本，即每次发布 patch 版本都会同时更新此镜像。registry.fit2cloud.com/halo/halo:2.20.0：表示一个具体的版本。
后续文档以 registry.fit2cloud.com/halo/halo:2.20 为例。
在系统任意位置创建一个文件夹，此文档以
~/halo为例。mkdir ~/halo && cd ~/halo信息
注意：后续操作中，Halo 产生的所有数据都会保存在这个目录，请妥善保存。
创建
docker-compose.yaml此文档提供几种场景的 Docker Compose 配置文件，请根据你的需要选择一种。
信息
需要注意的是，此文档为了更加方便的管理配置，所有与 Halo 相关的配置都使用 Docker 容器启动参数代替，所以无需创建 application.yaml 文件。
Halo + PostgreSQL
Halo + MySQL
Halo + H2
使用外部数据库
~/halo/docker-compose.yaml
version: "3" services: halo: image: registry.fit2cloud.com/halo/halo:2.20 restart: on-failure:3 depends_on: halodb: condition: service_healthy networks: halo_network: volumes: - ./halo2:/root/.halo2 ports: - "8090:8090" healthcheck: test: ["CMD", "curl", "-f", "http://localhost:8090/actuator/health/readiness"] interval: 30s timeout: 5s retries: 5 start_period: 30s environment: # JVM 参数，默认为 -Xmx256m -Xms256m，可以根据实际情况做调整，置空表示不添加 JVM 参数 - JVM_OPTS=-Xmx256m -Xms256m command: - --spring.r2dbc.url=r2dbc:pool:postgresql://halodb/halo - --spring.r2dbc.username=halo # PostgreSQL 的密码，请保证与下方 POSTGRES_PASSWORD 的变量值一致。 - --spring.r2dbc.password=openpostgresql - --spring.sql.init.platform=postgresql # 外部访问地址，请根据实际需要修改 - --halo.external-url=http://localhost:8090/ halodb: image: postgres:15.4 restart: on-failure:3 networks: halo_network: volumes: - ./db:/var/lib/postgresql/data healthcheck: test: [ "CMD", "pg_isready" ] interval: 10s timeout: 5s retries: 5 environment: - POSTGRES_PASSWORD=openpostgresql - POSTGRES_USER=halo - POSTGRES_DB=halo - PGUSER=halo networks: halo_network:信息
此示例的 PostgreSQL 数据库容器默认没有设置端口映射，如果需要在容器外部访问数据库，可以自行在
halodb服务中添加端口映射，PostgreSQL 的端口为5432。运行参数详解：
数据库配置：
信息
为了保持部署流程的简洁，此文档仅提供了必要的配置示例，完整的配置选项列表可查阅：配置说明
启动 Halo 服务
docker-compose up -d实时查看日志：
docker-compose logs -f用浏览器访问 /console 即可进入 Halo 管理页面，首次启动会进入初始化页面。
提示
如果需要配置域名访问，建议先配置好反向代理以及域名解析再进行初始化。如果通过
http://ip:端口号的形式无法访问，请到服务器厂商后台将运行的端口号添加到安全组，如果服务器使用了 Linux 面板，请检查此 Linux 面板是否有还有安全组配置，需要同样将端口号添加到安全组。
更新容器组
备份数据，可以参考 备份与恢复 进行完整备份（可选，但推荐备份）。
更新 Halo 服务
修改
docker-compose.yaml中配置的镜像版本。services: halo: image: registry.fit2cloud.com/halo/halo:2.20docker-compose up -d
反向代理
你可以在下面的反向代理软件中任选一项，我们假设你已经安装好了其中一项，并对其的基本操作有一定了解。 如果你对它们没有任何了解，可以参考我们更为详细的反向代理文档：
Nginx
upstream halo {
server 127.0.0.1:8090;
}
server {
listen 80;
listen [::]:80;
server_name www.yourdomain.com;
client_max_body_size 1024m;
location / {
proxy_pass http://halo;
proxy_set_header HOST $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
Caddy 2
www.yourdomain.com
encode gzip
reverse_proxy 127.0.0.1:8090
Traefik
更新 halo 容器组的配置
networks中引入已存在的网络traefik（此网络需要 提前创建）services.halo.networks中添加网络traefik修改外部地址为你的域名
声明路由规则、开启 TLS
version: "3.8"
networks:
traefik:
external: true
halo:
services:
halo:
image: registry.fit2cloud.com/halo/halo:2.20
restart: on-failure:3
volumes:
- ./halo2:/root/.halo2
networks:
- traefik
- halo
command:
# 外部访问地址，请根据实际需要修改
- --halo.external-url=https://yourdomain.com
labels:
traefik.enable: "true"
traefik.docker.network: traefik
traefik.http.routers.halo.rule: Host(`yourdomain.com`)
traefik.http.routers.halo.tls: "true"
traefik.http.routers.halo.tls.certresolver: myresolver
traefik.http.services.halo.loadbalancer.server.port: 8090
评论区