首页软件使用教程Halo建站工具安装指南（通过Docker Compose）

Halo建站工具安装指南（通过Docker Compose）

软件使用教程
2025-07-14 1,102

Halo是一款强大的开源建站工具，提供丰富的模板和插件，支持根据不同需求定制外观和功能，最大亮点就是建站速度飞快。Halo建站工具目前支持使用Docker、1Panel、Helm和Podman等方式部署。关于Halo建站工具的安装流程，下文将由站长百科详细介绍。

一、Halo建站工具价格

安装Halo建站工具之前首先需要确定所需版本，如果仅用于内容管理、邮箱验证、备份等用途，选择其免费版基本够用；但是如果需要移动端、AI建站以及更多自定义支持外，则需要升级至Halo专业版。Halo建站工具专业版目前推出按月、按年和买断版。要对比价格的话肯定是买断划算，如果只是想先体验推荐先试试短期专业版。

通过本链接购买Halo专业版按年/买断可享8.8折优惠，买断3个及以上8折！

Halo建站工具专属优惠链接：点击直达

Halo建站工具安装指南（通过Docker Compose）

二、创建容器组

目前Halo官方维护的Docker镜像仓库，可以根据自己的需求选择合适的镜像源：

  • registry.fit2cloud.com/halo/halo
  • halohub/halo
  • ghcr.io/halo-dev/halo

注意：目前Halo 2并未更新Docker的latest 标签镜像，主要因为Halo 2不兼容1.x版本，防止使用者误操作。我们推荐使用固定版本的标签，比如2.21或者2.21.0。

  • registry.fit2cloud.com/halo/halo:2：表示最新的2.x版本，即每次发布新版本都会更新此镜像；
  • registry.fit2cloud.com/halo/halo:2.21：表示最新的2.21.x版本，即每次发布patch版本都会同时更新此镜像；
  • registry.fit2cloud.com/halo/halo:2.21.0：表示一个具体的版本。

以下安装指引以egistry.fit2cloud.com/halo/halo:2.21为例：

1、在系统任意位置创建一个文件夹，此文档以~/halo为例。

mkdir ~/halo && cd ~/halo

注意：后续操作中，Halo产生的所有数据都会保存在这个目录，请妥善保存。

2、创建docker-compose.yaml

此文档提供几种场景的Docker Compose配置文件，请根据需要选择一种。

注意：为了更加方便的管理配置，所有与Halo相关的配置都使用Docker容器启动参数代替，所以无需创建application.yaml文件。

（1）Halo + PostgreSQL：

~/halo/docker-compose.yaml
version: “3”

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: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。

（2）Halo + MySQL：

~/halo/docker-compose.yaml
version: “3”

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=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: 3s
retries: 5
start_period: 30s
environment:
# 请修改此密码，并对应修改上方 Halo 服务的 SPRING_R2DBC_PASSWORD 变量值
– MYSQL_ROOT_PASSWORD=o#DwN&JSa56
– MYSQL_DATABASE=halo

networks:
halo_network:

此示例的MySQL数据库容器默认没有设置端口映射，如果需要在容器外部访问数据库，可以自行在 halodb 服务中添加端口映射，MySQL的端口为3306。

（3）Halo + H2：

注意：不推荐在生产环境使用默认的H2数据库，这可能因为操作不当导致数据文件损坏。如果因为某些原因（如内存不足以运行独立数据库）必须要使用，建议按时备份数据。

~/halo/docker-compose.yaml
version: “3”

services:
halo:
image: registry.fit2cloud.com/halo/halo:2.21
restart: on-failure:3
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:
# 外部访问地址，请根据实际需要修改
– –halo.external-url=http://localhost:8090/

（4）使用外部数据库：

~/halo/docker-compose.yaml
version: “3”

services:
halo:
image: registry.fit2cloud.com/halo/halo:2.21
restart: on-failure:3
network_mode: “host”
volumes:
– ./halo2:/root/.halo2
environment:
# JVM 参数，默认为 -Xmx256m -Xms256m，可以根据实际情况做调整，置空表示不添加 JVM 参数
– JVM_OPTS=-Xmx256m -Xms256m
command:
# 修改为自己已有的 MySQL 配置
– –spring.r2dbc.url=r2dbc:pool:mysql://localhost:3306/halo
– –spring.r2dbc.username=root
– –spring.r2dbc.password=
– –spring.sql.init.platform=mysql
# 外部访问地址，请根据实际需要修改
– –halo.external-url=http://localhost:8090/
# 端口号 默认8090
– –server.port=8090

使用外部数据库时，需要提前手动创建好数据库，以MySQL为例：

create database halo character set utf8mb4 collate utf8mb4_bin;

运行参数详解：

  • 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

用浏览器访问/console即可进入Halo管理页面，首次启动会进入初始化页面。

注意：如果需要配置域名访问，建议先配置好反向代理以及域名解析再进行初始化。如果通过 http://ip:端口号 的形式无法访问，请到服务器厂商后台将运行的端口号添加到安全组，如果服务器使用了Linux面板，请检查此Linux面板是否有还有安全组配置，需要同样将端口号添加到安全组。

四、更新容器组

1、备份数据。

2、更新Halo服务

修改docker-compose.yaml中配置的镜像版本。

services:
halo:
image: registry.fit2cloud.com/halo/halo:2.21

docker-compose up -d

五、反向代理

可以在下面的反向代理软件中任选一项，我们假设你已经安装好了其中一项，并对其的基本操作有一定了解。

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

2、Caddy 2

www.yourdomain.com

encode gzip

reverse_proxy 127.0.0.1:8090

3、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.21
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

  • 广告合作

  • QQ群号：4114653

点赞 (0)
温馨提示：
1、本网站发布的内容(图片、视频和文字)以原创、转载和分享网络内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。邮箱：2942802716#qq.com（#改为@）。 2、本站原创内容未经允许不得转裁，转载请注明出处“站长百科”和原文地址。
Portainer可视化工具安装及汉化
上一篇： Portainer可视化工具安装及汉化教程
Wappalyzer
下一篇： Wappalyzer功能及安装使用详解

相关文章

Halo许可证激活图文教程
Halo许可证激活图文教程
4天前 18
阿里云创建对象存储OSS图文教程
阿里云创建对象存储OSS图文教程
1周前 20
CrossOver Mac下载、安装激活图文教程
CrossOver Mac下载、安装激活图文教程
2周前 28
Google Analytics入门使用指南
Google Analytics入门使用指南
1个月前 84
猜你喜欢
热门文章
3个月免费VPS

亚马逊云科技活动

科灯跨境

科灯跨境

热门教程
  • Z-Blog教程

    Z-Blog教程

    ZBlog教程分享ZBlog安装教程、ZBlog建站教程...
  • WordPress教程

    WordPress教程

    WordPress教程提供了关于WordPress的基础...
  • 宝塔面板教程

    宝塔面板教程

    宝塔面板教程是一个致力于向用户传授宝塔面板的使用技巧和知...
  • Shopify教程

    Shopify教程

    Shopify教程提供了关于Shopify平台的基本知识...
  • PHP教程

    PHP教程

    PHP教程提供了关于PHP语法、变量、函数、流程控制等概...
阿里云

阿里云

热门标签
360 Facebook Godaddy Google Kubernetes Linux php SEO SEO Shopline TeamViewer WordPress 业界 宝塔面板 微信 微软 技术 搜索引擎 杂谈 淘宝 百度 网站 网站优化 网站建设 美国主机 腾讯 虚拟主机 观点评论 谷歌 阿里巴巴
首页 建站程序 菜单 办公软件 数字化百科