Halo Docker镜像文档

镜像概述

Halo Docker镜像为下一代开源博客/CMS系统提供容器化部署方案，旨在简化Halo的安装与运维流程。Halo是一款基于Java开发的现代化内容管理系统，具备轻量、高效、可扩展等特性，适用于个人博客、企业官网、内容平台等场景的快速搭建。

核心功能与特性

• 现代化界面：采用响应式设计，支持多终端访问，提供简洁直观的管理后台
• 插件生态：丰富的插件系统，支持功能扩展（如评论、统计、社交分享等）
• 主题机制：支持自定义主题，满足多样化的页面展示需求
• Markdown编辑：内置高效Markdown编辑器，支持实时预览与代码高亮
• 多数据库支持：兼容H2（默认）、MySQL等数据库，适应不同部署环境
• 数据安全：支持自动备份与手动备份，保障内容数据安全
• SEO优化：内置SEO设置功能，支持自定义元标签、sitemap生成

使用场景

• 个人博客搭建：适合开发者、创作者快速部署个人技术博客或自媒体平台
• 企业官网：小型企业可基于Halo构建简洁的产品展示或企业介绍网站
• 内容平台：用于构建垂直领域内容站点（如教程站、资讯站）
• 开发测试：开发者可通过容器化快速搭建Halo测试环境，进行功能验证或二次开发

使用方法

基本要求

• Docker 19.03+ 环境
• 至少 512MB 可用内存
• 持久化存储需求（推荐挂载数据卷）

Docker Run 部署

快速启动（默认配置）

bash
docker run -d \
  --name halo \
  -p 8090:8090 \
  -v ~/.halo:/root/.halo \
  halohub/halo:latest

说明：

• -p 8090:8090：映射容器8090端口到主机8090端口（默认服务端口）
• -v ~/.halo:/root/.halo：挂载主机目录到容器，实现数据持久化（包含配置、主题、插件、数据库文件等）

自定义数据库配置（以MySQL为例）

bash
docker run -d \
  --name halo \
  -p 8090:8090 \
  -v ~/.halo:/root/.halo \
  -e HALO_DATABASE_DRIVER_CLASS_NAME=com.mysql.cj.jdbc.Driver \
  -e HALO_DATABASE_URL=jdbc:mysql://mysql-host:3306/halo?characterEncoding=utf8&useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true \
  -e HALO_DATABASE_USERNAME=halo \
  -e HALO_DATABASE_PASSWORD=yourpassword \
  halohub/halo:latest

Docker Compose 部署

创建docker-compose.yml文件：

yaml
version: "3"

services:
  halo:
    image: halohub/halo:latest
    container_name: halo
    restart: unless-stopped
    ports:
      - "8090:8090"
    volumes:
      - ~/.halo:/root/.halo
    environment:
      # 可选：配置数据库连接（默认使用H2嵌入式数据库）
      # - HALO_DATABASE_DRIVER_CLASS_NAME=com.mysql.cj.jdbc.Driver
      # - HALO_DATABASE_URL=jdbc:mysql://mysql-host:3306/halo?characterEncoding=utf8&useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
      # - HALO_DATABASE_USERNAME=halo
      # - HALO_DATABASE_PASSWORD=yourpassword
      # 可选：修改服务端口
      # - HALO_SERVER_PORT=8090

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量

数据持久化

容器内Halo数据默认存储路径为/root/.halo，包含：

• 数据库文件（H2默认）
• 配置文件（application.yaml）
• 主题文件（themes/）
• 插件文件（plugins/）
• 上传文件（uploads/）

必须通过数据卷挂载该目录，避免容器重启后数据丢失。

访问与初始化

服务启动后，通过 http://<主机IP>:8090 访问Halo。首次访问将进入初始化页面，需完成管理员账号创建、站点基本信息配置等步骤，配置完成后即可进入管理后台开始使用。