使用 Docker Compose 部署 Halo
在继续操作之前,我们推荐您先阅读《写在前面》,这可以快速帮助你了解 Halo。
创建容器组
在系统任意位置创建一个文件夹,此文档以
~/halo-app
为例。mkdir ~/halo-app && cd ~/halo-app
信息注意:后续操作中,Halo 的所有相关数据都会保存在这个目录,请妥善保存。
创建
docker-compose.yaml
此文档提供三种场景的 Docker Compose 配置文件,请根据你的需要选择一种。
信息需要注意的是,此文档为了更加方便的管理配置,所有与 Halo 相关的配置都使用 Docker 环境变量代替,所以无需创建 application.yaml 文件。
仅创建 Halo 实例(使用默认的 H2 数据库):
version: "3"
services:
halo:
image: halohub/halo:1.6.0
container_name: halo
restart: on-failure:3
volumes:
- ./:/root/.halo
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "8090:8090"
environment:
- SERVER_PORT=8090
- SPRING_DATASOURCE_DRIVER_CLASS_NAME=org.h2.Driver
- SPRING_DATASOURCE_URL=jdbc:h2:file:~/.halo/db/halo
- SPRING_DATASOURCE_USERNAME=admin
- SPRING_DATASOURCE_PASSWORD=o#DwN&JSa56
- HALO_ADMIN_PATH=admin
- HALO_CACHE=memory信息您可以前往 https://hub.docker.com/r/halohub/halo 查看最新版本镜像,我们推荐使用具体版本号的镜像,但也提供了
latest
标签的镜像,它始终是最新的。创建 Halo + MySQL 的实例:
version: "3"
services:
halo_server:
image: halohub/halo:1.6.0
container_name: halo_server
restart: on-failure:3
depends_on:
- halo_mysql
networks:
halo_network:
volumes:
- ./:/root/.halo
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "8090:8090"
environment:
- SERVER_PORT=8090
- SPRING_DATASOURCE_DRIVER_CLASS_NAME=com.mysql.cj.jdbc.Driver
- SPRING_DATASOURCE_URL=jdbc:mysql://halo_mysql:3306/halodb?characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
- SPRING_DATASOURCE_USERNAME=root
- SPRING_DATASOURCE_PASSWORD=o#DwN&JSa56
- HALO_ADMIN_PATH=admin
- HALO_CACHE=memory
halo_mysql:
image: mysql:8.0.27
container_name: halo_mysql
restart: on-failure:3
networks:
halo_network:
command: --default-authentication-plugin=mysql_native_password
--character-set-server=utf8mb4
--collation-server=utf8mb4_general_ci
--explicit_defaults_for_timestamp=true
volumes:
- /etc/localtime:/etc/localtime:ro
- ./mysql:/var/lib/mysql
- ./mysqlBackup:/data/mysqlBackup
ports:
- "3306:3306"
environment:
# 请修改此密码,并对应修改上方 Halo 服务的 SPRING_DATASOURCE_PASSWORD 变量值
- MYSQL_ROOT_PASSWORD=o#DwN&JSa56
- MYSQL_DATABASE=halodb
networks:
halo_network:创建 Halo + MySQL + Redis 的实例:
version: "3"
services:
halo_server:
image: halohub/halo:1.6.0
container_name: halo_server
restart: on-failure:3
depends_on:
- halo_mysql
- halo_redis
networks:
halo_network:
volumes:
- ./:/root/.halo
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "8090:8090"
environment:
- SERVER_PORT=8090
- SPRING_DATASOURCE_DRIVER_CLASS_NAME=com.mysql.cj.jdbc.Driver
- SPRING_DATASOURCE_URL=jdbc:mysql://halo_mysql:3306/halodb?characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
- SPRING_DATASOURCE_USERNAME=root
- SPRING_DATASOURCE_PASSWORD=o#DwN&JSa56
- HALO_ADMIN_PATH=admin
- HALO_CACHE=redis
- SPRING_REDIS_PORT=6379
- SPRING_REDIS_DATABASE=0
- SPRING_REDIS_HOST=halo_redis
- SPRING_REDIS_PASSWORD=dm5fD%rvPtq
halo_mysql:
image: mysql:8.0.27
container_name: halo_mysql
restart: on-failure:3
networks:
halo_network:
command: --default-authentication-plugin=mysql_native_password
--character-set-server=utf8mb4
--collation-server=utf8mb4_general_ci
--explicit_defaults_for_timestamp=true
volumes:
- /etc/localtime:/etc/localtime:ro
- ./mysql:/var/lib/mysql
- ./mysqlBackup:/data/mysqlBackup
ports:
- "3306:3306"
environment:
# 请修改此密码,并对应修改上方 Halo 服务的 SPRING_DATASOURCE_PASSWORD 变量值
- MYSQL_ROOT_PASSWORD=o#DwN&JSa56
- MYSQL_DATABASE=halodb
halo_redis:
image: redis
container_name: halo_redis
restart: on-failure:3
networks:
halo_network:
volumes:
- ./redis/data:/data
- ./redis/logs:/logs
# 请修改此密码,并对应修改上方 Halo 服务的 SPRING_REDIS_PASSWORD 变量值
command: redis-server --requirepass dm5fD%rvPtq
ports:
- "6379:6379"
networks:
halo_network:
启动 Halo 服务
docker-compose up -d
打开
http://ip:端口号
即可看到安装引导界面。提示如果需要配置域名访问,建议先配置好反向代理以及域名解析再进行初始化。如果通过
http://ip:端口号
的形式无法访问,请到服务器厂商后台将运行的端口号添加到安全组,如果服务器使用了 Linux 面板,请检查此 Linux 面板是否有还有安全组配置,需要同样将端口号添加到安全组。
反向代理
你可以在下面的反向代理软件中任选一项,我们假设你已经安装好了其中一项,并对其的基本操作有一定了解。
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 1.x
https://www.yourdomain.com {
gzip
tls [email protected]
proxy / localhost:8090 {
transparent
}
}
Caddy 2.x
www.yourdomain.com
encode gzip
reverse_proxy 127.0.0.1:8090
以上配置都可以在 https://github.com/halo-dev/halo-common 找到。
更新容器组
我们假设您的 Halo 服务容器是按照 使用 Docker Compose 部署 Halo 中的方式启动的。如有不同,请根据实际情况修改。
停止运行中的容器组
cd ~/halo-app && docker-compose stop
备份数据(重要)
cp -r ~/halo-app ~/halo-app.archive
需要注意的是,
halo-app.archive
文件名不一定要根据此文档命名,这里仅仅是个示例。清空 leveldb 或 Redis 缓存(如果有使用 leveldb 或 Redis 作为缓存策略)
rm -rf ~/halo-app/.leveldb
rm -rf ~/halo-app/redis更新 Halo 服务
针对使用
latest
标签镜像的更新:docker-compose pull && docker-compose up -d
信息注意,当您的
Docker
镜像源非官方源时,执行docker-compose pull
命令时可能无法获取到最新的latest
标签的镜像。针对使用具体版本标签镜像的更新:
修改
docker-compose.yaml
中配置的镜像版本。services:
halo_server:
image: halohub/halo:1.6.0
container_name: halo_server启动容器组:
docker-compose up -d