我发现宝塔官方的halo docker应用部署的时候,会出现很多很多错误所以我做了这个教程
这个教程将会基于Halo博客官方的Docker Compose 部署教程并添加一些小提示
环境搭建
- Docker 安装文档:https://docs.docker.com/engine/install/
- Docker Compose 安装文档:https://docs.docker.com/compose/install/
1.在系统任意位置创建一个文件夹,此文档以 ~/halo 为例。
mkdir ~/halo && cd ~/halo
2.创建 docker-compose.yaml(在你创建的文件夹里创建一个空白文档把它命名为 docker-compose.yaml)
我们这里将直接使用Halo + MySQL的方式搭建docker版的Halo(由于新版本的docker已经不支持version字段,所以我直接删除了)
services:
halo:
image: registry.fit2cloud.com/halo/halo:2.21
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:mysql://halodb:3306/halo
- --spring.r2dbc.username=root
# MySQL 的密码,请保证与下方 MYSQL_ROOT_PASSWORD 的变量值一致。
- --spring.r2dbc.password=填上密码
- --spring.sql.init.platform=mysql
# 外部访问地址,请根据实际需要修改
- --halo.external-url=http://localhost:8090/
halodb:
image: mysql:8.1.0
restart: on-failure:3
networks:
halo_network:
command:
- --default-authentication-plugin=caching_sha2_password
- --character-set-server=utf8mb4
- --collation-server=utf8mb4_general_ci
- --explicit_defaults_for_timestamp=true
volumes:
- ./mysql:/var/lib/mysql
- ./mysqlBackup:/data/mysqlBackup
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "--silent"]
interval: 3s
retries: 5
start_period: 30s
environment:
# 请修改此密码,并对应修改上方 Halo 服务的 SPRING_R2DBC_PASSWORD 变量值
- MYSQL_ROOT_PASSWORD=填上密码
- MYSQL_DATABASE=halo
networks:
halo_network:
现在回到宝塔面板添加数据库

尽量在数据库名填上halo,创建完之后在上面的字段中替换原来的密码
在宝塔的docker设置里面设置加速URL(不设置的话会出现network错误)
如果你在配置加速的时候出现了错误:

原因及解决:
原本的docker配置文件异常,一般情况下是空文件导致的
依次打开:/etc/docker/daemon.json,添加内容
{
"registry-mirrors": [
"https://pull.xzxo.cn"
]
}
3.部署 Halo 服务(在你创建的文件夹里点,那个终端,执行这个命令)
docker-compose up -d
这个时候服务就启动了,去你的服务器里开放8090端口,即可通过IP正常访问,如果你要配置域名请使用反向代理。
问题
如果你在部署服务当中出现了问题。那么首先看错误的日志。如果是端口被占用,那么请打开宝塔docker选项选择容器把,占用端口的服务删掉(大概可能是因为你部署过halo之后没有成功部署占用的端口)
如果出现了网络错误,那请在宝塔docker这个页面下删除你部署过的halo的网络
如果有其他问题,你可以在下方评论,我将会积极回答。