@ -3,8 +3,12 @@ title: 使用 Docker Compose 部署
description: 使用 Docker Compose 部署
description: 使用 Docker Compose 部署
---
---
```mdx-code-block
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import DockerArgs from "./slots/_docker-args.md"
import DockerArgs from "./slots/_docker-args.md"
import DockerRegistryList from "./slots/_docker-registry-list.md"
import DockerRegistryList from "./slots/_docker-registry-list.md"
```
:::info
:::info
在继续操作之前，我们推荐您先阅读[《写在前面》](../prepare.md)，这可以快速帮助你了解 Halo。
在继续操作之前，我们推荐您先阅读[《写在前面》](../prepare.md)，这可以快速帮助你了解 Halo。
@ -35,185 +39,183 @@ import DockerRegistryList from "./slots/_docker-registry-list.md"
2. 创建 `docker-compose.yaml`
2. 创建 `docker-compose.yaml`
此文档提供两 种场景的 Docker Compose 配置文件，请根据你的需要**选择一种**。
此文档提供几 种场景的 Docker Compose 配置文件，请根据你的需要**选择一种**。
:::info
:::info
需要注意的是，此文档为了更加方便的管理配置，所有与 Halo 相关的配置都使用 Docker 容器启动参数代替，所以无需创建 application.yaml 文件。
需要注意的是，此文档为了更加方便的管理配置，所有与 Halo 相关的配置都使用 Docker 容器启动参数代替，所以无需创建 application.yaml 文件。
:::
:::
1. 创建 Halo + PostgreSQL 的实例：
< Tabs queryString = "current" >
< TabItem value = "halo-postgresql" label = "Halo + PostgreSQL" default >
```yaml {23-29,43} title="~/halo/docker-compose.yaml"
```yaml {23-29,43} title="~/halo/docker-compose.yaml"
version: "3"
version: "3"
services:
services:
halo:
halo:
image: registry.fit2cloud.com/halo/halo:2.18
image: registry.fit2cloud.com/halo/halo:2.18
restart: on-failure:3
restart: on-failure:3
depends_on:
depends_on:
halodb:
halodb:
condition: service_healthy
condition: service_healthy
networks:
networks:
halo_network:
halo_network:
volumes:
volumes:
- ./halo2:/root/.halo2
- ./halo2:/root/.halo2
ports:
ports:
- "8090:8090"
- "8090:8090"
healthcheck:
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8090/actuator/health/readiness"]
test: ["CMD", "curl", "-f", "http://localhost:8090/actuator/health/readiness"]
interval: 30s
interval: 30s
timeout: 5s
timeout: 5s
retries: 5
retries: 5
start_period: 30s
start_period: 30s
command:
command:
- --spring.r2dbc.url=r2dbc:pool:postgresql://halodb/halo
- --spring.r2dbc.url=r2dbc:pool:postgresql://halodb/halo
- --spring.r2dbc.username=halo
- --spring.r2dbc.username=halo
# PostgreSQL 的密码，请保证与下方 POSTGRES_PASSWORD 的变量值一致。
# PostgreSQL 的密码，请保证与下方 POSTGRES_PASSWORD 的变量值一致。
- --spring.r2dbc.password=openpostgresql
- --spring.r2dbc.password=openpostgresql
- --spring.sql.init.platform=postgresql
- --spring.sql.init.platform=postgresql
# 外部访问地址，请根据实际需要修改
# 外部访问地址，请根据实际需要修改
- --halo.external-url=http://localhost:8090/
- --halo.external-url=< http: / / localhost:8090 / >
halodb:
halodb:
image: postgres:15.4
image: postgres:15.4
restart: on-failure:3
restart: on-failure:3
networks:
networks:
halo_network:
halo_network:
volumes:
volumes:
- ./db:/var/lib/postgresql/data
- ./db:/var/lib/postgresql/data
healthcheck:
healthcheck:
test: [ "CMD", "pg_isready" ]
test: [ "CMD", "pg_isready" ]
interval: 10s
interval: 10s
timeout: 5s
timeout: 5s
retries: 5
retries: 5
environment:
environment:
- POSTGRES_PASSWORD=openpostgresql
- POSTGRES_PASSWORD=openpostgresql
- POSTGRES_USER=halo
- POSTGRES_USER=halo
- POSTGRES_DB=halo
- POSTGRES_DB=halo
- PGUSER=halo
- PGUSER=halo
networks:
networks:
halo_network:
halo_network:
```
```
:::info
:::info
此示例的 PostgreSQL 数据库容器默认没有设置端口映射，如果需要在容器外部访问数据库，可以自行在 `halodb` 服务中添加端口映射， `5432` 。
此示例的 PostgreSQL 数据库容器默认没有设置端口映射，如果需要在容器外部访问数据库，可以自行在 `halodb` 服务中添加端口映射， `5432` 。
:::
:::
< / TabItem >
< TabItem value = "halo-mysql" label = "Halo + MySQL" >
2. 创建 Halo + MySQL 的实例：
```yaml {23-29,51} title="~/halo/docker-compose.yaml"
version: "3"
```yaml {23-29,51} title="~/halo/docker-compose.yaml"
version: "3"
services:
halo:
services:
image: registry.fit2cloud.com/halo/halo:2.18
halo:
restart: on-failure:3
image: registry.fit2cloud.com/halo/halo:2.18
depends_on:
restart: on-failure:3
halodb:
depends_on:
condition: service_healthy
halodb:
networks:
condition: service_healthy
halo_network:
networks:
volumes:
halo_network:
- ./halo2:/root/.halo2
volumes:
ports:
- ./halo2:/root/.halo2
- "8090:8090"
ports:
healthcheck:
- "8090:8090"
test: ["CMD", "curl", "-f", "http://localhost:8090/actuator/health/readiness"]
healthcheck:
interval: 30s
test: ["CMD", "curl", "-f", "http://localhost:8090/actuator/health/readiness"]
timeout: 5s
interval: 30s
retries: 5
timeout: 5s
start_period: 30s
retries: 5
command:
start_period: 30s
- --spring.r2dbc.url=r2dbc:pool:mysql://halodb:3306/halo
command:
- --spring.r2dbc.username=root
- --spring.r2dbc.url=r2dbc:pool:mysql://halodb:3306/halo
# MySQL 的密码，请保证与下方 MYSQL_ROOT_PASSWORD 的变量值一致。
- --spring.r2dbc.username=root
- --spring.r2dbc.password=o#DwN& JSa56
# MySQL 的密码，请保证与下方 MYSQL_ROOT_PASSWORD 的变量值一致。
- --spring.sql.init.platform=mysql
- --spring.r2dbc.password=o#DwN& JSa56
# 外部访问地址，请根据实际需要修改
- --spring.sql.init.platform=mysql
- --halo.external-url=http://localhost:8090/
# 外部访问地址，请根据实际需要修改
- --halo.external-url=http://localhost:8090/
halodb:
image: mysql:8.1.0
halodb:
restart: on-failure:3
image: mysql:8.1.0
networks:
restart: on-failure:3
halo_network:
networks:
command:
halo_network:
- --default-authentication-plugin=caching_sha2_password
command:
- --character-set-server=utf8mb4
- --default-authentication-plugin=caching_sha2_password
- --collation-server=utf8mb4_general_ci
- --character-set-server=utf8mb4
- --explicit_defaults_for_timestamp=true
- --collation-server=utf8mb4_general_ci
volumes:
- --explicit_defaults_for_timestamp=true
- ./mysql:/var/lib/mysql
volumes:
- ./mysqlBackup:/data/mysqlBackup
- ./mysql:/var/lib/mysql
healthcheck:
- ./mysqlBackup:/data/mysqlBackup
test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "--silent"]
healthcheck:
interval: 3s
test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "--silent"]
retries: 5
interval: 3s
start_period: 30s
retries: 5
environment:
start_period: 30s
# 请修改此密码，并对应修改上方 Halo 服务的 SPRING_R2DBC_PASSWORD 变量值
environment:
- MYSQL_ROOT_PASSWORD=o#DwN& JSa56
# 请修改此密码，并对应修改上方 Halo 服务的 SPRING_R2DBC_PASSWORD 变量值
- MYSQL_DATABASE=halo
- MYSQL_ROOT_PASSWORD=o#DwN& JSa56
- MYSQL_DATABASE=halo
networks:
halo_network:
networks:
```
halo_network:
```
:::info
此示例的 MySQL 数据库容器默认没有设置端口映射，如果需要在容器外部访问数据库，可以自行在 `halodb` 服务中添加端口映射， `3306` 。
:::info
:::
此示例的 MySQL 数据库容器默认没有设置端口映射，如果需要在容器外部访问数据库，可以自行在 `halodb` 服务中添加端口映射， `3306` 。
< / TabItem >
:::
< TabItem value = "halo-h2" label = "Halo + H2" >
:::warning
3. 仅创建 Halo 实例（使用默认的 H2 数据库）：
不推荐在生产环境使用默认的 H2 数据库，这可能因为操作不当导致数据文件损坏。如果因为某些原因（如内存不足以运行独立数据库）必须要使用，建议按时[备份数据](../../user-guide/backup.md)。
:::
:::warning
不推荐在生产环境使用默认的 H2 数据库，这可能因为操作不当导致数据文件损坏。如果因为某些原因（如内存不足以运行独立数据库）必须要使用，建议按时[备份数据](../../user-guide/backup.md)。
```yaml {19-24} title="~/halo/docker-compose.yaml"
:::
version: "3"
```yaml {19-24} title="~/halo/docker-compose.yaml"
services:
version: "3"
halo:
image: registry.fit2cloud.com/halo/halo:2.18
services:
restart: on-failure:3
halo:
volumes:
image: registry.fit2cloud.com/halo/halo:2.18
- ./halo2:/root/.halo2
restart: on-failure:3
ports:
volumes:
- "8090:8090"
- ./halo2:/root/.halo2
healthcheck:
ports:
test: ["CMD", "curl", "-f", "http://localhost:8090/actuator/health/readiness"]
- "8090:8090"
interval: 30s
healthcheck:
timeout: 5s
test: ["CMD", "curl", "-f", "http://localhost:8090/actuator/health/readiness"]
retries: 5
interval: 30s
start_period: 30s
timeout: 5s
command:
retries: 5
# 外部访问地址，请根据实际需要修改
start_period: 30s
- --halo.external-url=http://localhost:8090/
command:
```
# 外部访问地址，请根据实际需要修改
< / TabItem >
- --halo.external-url=http://localhost:8090/
< TabItem value = "external-db" label = "使用外部数据库" >
```
```yaml {7,12-20} title="~/halo/docker-compose.yaml"
version: "3"
4. 仅创建 Halo 实例（ ，
services:
```yaml {7,12-20} title="~/halo/docker-compose.yaml"
halo:
version: "3"
image: registry.fit2cloud.com/halo/halo:2.18
restart: on-failure:3
services:
network_mode: "host"
halo:
volumes:
image: registry.fit2cloud.com/halo/halo:2.18
- ./halo2:/root/.halo2
restart: on-failure:3
command:
network_mode: "host"
# 修改为自己已有的 MySQL 配置
volumes:
- --spring.r2dbc.url=r2dbc:pool:mysql://localhost:3306/halo
- ./halo2:/root/.halo2
- --spring.r2dbc.username=root
command:
- --spring.r2dbc.password=
# 修改为自己已有的 MySQL 配置
- --spring.sql.init.platform=mysql
- --spring.r2dbc.url=r2dbc:pool:mysql://localhost:3306/halo
# 外部访问地址，请根据实际需要修改
- --spring.r2dbc.username=root
- --halo.external-url=http://localhost:8090/
- --spring.r2dbc.password=
# 端口号 默认8090
- --spring.sql.init.platform=mysql
- --server.port=8090
# 外部访问地址，请根据实际需要修改
```
- --halo.external-url=http://localhost:8090/
< / TabItem >
# 端口号 默认8090
< / Tabs >
- --server.port=8090
```
运行参数详解：
运行参数详解：
Ryan Wang
4 months ago
committed by
GitHub