Docker部署Halo(Ubuntu)

官方教程

使用 Docker Compose 部署 | Halo 文档

安装 Docker

标准安装(下载速度慢可更换源)

 # 安装基础依赖
 apt update
 apt install -y apt-transport-https ca-certificates curl software-properties-common
 ​
 # 下载并处理 GPG 密钥(使用中科大源)
 curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
 ​
 # 添加 Docker APT 软件源(使用 Ubuntu 24.04 noble 版本,兼容性最好)
 echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu noble stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null
 ​
 # 更新软件包列表
 apt update
 ​
 # 安装 Docker
 apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
 ​
 # 启动 Docker
 systemctl start docker
 systemctl enable docker
 ​
 # 配置镜像加速器
 cat > /etc/docker/daemon.json <<EOF
 {
   "registry-mirrors": [
     "https://docker.m.daocloud.io",
     "https://docker.1ms.run",
     "https://docker.xuanyuan.me"
   ]
 }
 EOF
 ​
 # 重启 Docker 服务使配置生效
 systemctl daemon-reload
 systemctl restart docker
 ​
 # 验证 Docker 及加速器是否生效
 docker --version
 docker info | grep -A 5 "Registry Mirrors"

使用 Docker Compose 部署 Halo

配置文件(Halo + MySQL)

 # 创建工作目录
 mkdir -p /root/halo && cd /root/halo
 ​
 # 编写 docker-compose.yaml
 vim /root/halo/docker-compose.yaml
 ​
 # 添加以下内容
 services:
   halo:
     image: registry.fit2cloud.com/halo/halo-pro:2.25
     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=o#DwN&JSa56
       - --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: 5s
       retries: 10
       start_period: 60s
     environment:
       # 请修改此密码,并对应修改上方 Halo 服务的 SPRING_R2DBC_PASSWORD 变量值
       - MYSQL_ROOT_PASSWORD=o#DwN&JSa56
       - MYSQL_DATABASE=halo
 ​
 networks:
   halo_network:

文件说明

运行参数详解:

参数名

描述

spring.r2dbc.url

数据库连接地址,详细可查阅下方的 数据库配置

spring.r2dbc.username

数据库用户名

spring.r2dbc.password

数据库密码

spring.sql.init.platform

数据库平台名称,支持 postgresql、mysql、mariadb、h2

halo.external-url

外部访问链接,如果需要在公网访问,需要配置为实际访问地址

数据库配置:

链接方式

链接地址格式

spring.sql.init.platform

PostgreSQL(推荐)

r2dbc:pool:postgresql://{HOST}:{PORT}/{DATABASE}

postgresql

MySQL

r2dbc:pool:mysql://{HOST}:{PORT}/{DATABASE}

mysql

MariaDB

r2dbc:pool:mariadb://{HOST}:{PORT}/{DATABASE}

mariadb

H2 Database

r2dbc:h2:file:///${halo.work-dir}/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE

h2

启动 Halo

 # 启动
 docker compose up -d
 ​
 # 实时日志查看
 docker compose logs -f
 ​
 # 访问
 http://你的IP:8090/

反向代理

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;
   }
 }