如何在Linux云服务器上通过Docker Compose部署安装Halo，搭建个人博客网站？

张飞的猪2024-07-31 13:06

目录

前置步骤

首先你需要一套linux服务器，这里默认你已经有了。如果没有可以在**云服务器优惠合集**选择，如果你是个人博客选择性价比最高，最低配置就够用了。

环境搭建

按照Docker官方文档安装Docker和Docker Compose，部分Linux发行版软件仓库中的 Docker版本可能过旧。

创建容器组

下面是Halo官方维护的Docker镜像仓库，根据自己的需求选择合适的镜像源：

Halo 2有时候没有及时的更新Docker的latest标签镜像，因为Halo 2不兼容1.x版本，防止使用者误操作。推荐使用固定版本的标签，比如2.17或者2.17.0。

在系统任意位置创建一个文件夹

此文档以 ~/halo为例，后续操作中，Halo 产生的所有数据都会保存在这个目录。

bash 复制代码 
mkdir ~/halo && cd ~/halo

创建docker-compose.yaml

halo 2默认使用H2数据库，这个主要用于方便开发测试，不推荐在生产使用。因为操作不当可能导致数据文件损坏。如果因为某些原因（如内存不足以运行独立数据库）必须要使用，建议按时备份数据。

docker-compose.yaml文件路径一般放在下面这个路径。

bash 复制代码 
~/halo/docker-compose.yaml

下面给出几种docker-compose.yaml实例的配置。

  1. 创建 Halo + PostgreSQL 的实例：
    这里的PostgreSQL使用默认端口5432，如果需要改端口，要显性标注出来。
yaml 复制代码 
version: "3"

services:
  halo:
    image: registry.fit2cloud.com/halo/halo:2.17
    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          
    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:
  1. 创建 Halo + MySQL 的实例：
    这里的PostgreSQL使用默认端口3306，如果需要改端口，要显性标注出来。
yaml 复制代码 
version: "3"

services:
  halo:
    image: registry.fit2cloud.com/halo/halo:2.17
    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
    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:
  1. 使用默认的 H2 数据库
yaml 复制代码 
version: "3"

services:
  halo:
    image: registry.fit2cloud.com/halo/halo:2.17
    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          
    command:
      # 外部访问地址，请根据实际需要修改
      - --halo.external-url=http://localhost:8090/
  1. 仅创建 Halo 实例（使用已有外部数据库，MySQL 为例）
yaml 复制代码 
version: "3"

services:
  halo:
    image: registry.fit2cloud.com/halo/halo:2.17
    restart: on-failure:3
    network_mode: "host"
    volumes:
      - ./halo2:/root/.halo2
    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

参数配置

参数名 描述
spring.r2dbc.url 数据库连接地址，详细可查阅下方的 数据库配置
spring.r2dbc.username 数据库用户名
spring.r2dbc.password 数据库密码
spring.sql.init.platform 数据库平台名称，支持 postgresql、mysql、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 服务

启动命令

bash 复制代码 
docker-compose up -d

实时查看日志命令

bash 复制代码 
docker-compose logs -f

配置反向代理以及域名解析

这里以Nginx为例子，halo2还支持Caddy 2、Traefik等。

  • 通过nginx.conf文配置
bash 复制代码 
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;
  }
}
  • 通过Nginx Proxy Manager配置

参考使用Nginx Proxy Manager配置Halo的反向代理和申请 SSL 证书

Halo初始化页面。

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

更新新版本的halo

从 Halo 2.8 开始，Halo 内置了备份和恢复的功能，可以在 Console 中一键备份和恢复完整的数据。

  1. 备份
    在 Console 中，点击左侧菜单的 备份，进入备份页面。点击右上角的 创建备份 按钮，即可创建一个新的备份请求，需要注意的是，创建备份请求并不会立即开始备份，而是会在后台异步执行，因此需要等待一段时间才能看到备份的结果。
  2. 更新Halo服务
    修改 docker-compose.yaml 中配置的镜像版本。
yaml 复制代码 
services:
  halo:
    image: registry.fit2cloud.com/halo/halo:2.17
bash 复制代码 
docker-compose up -d
  1. 恢复备份
    • 在 Console 中，点击左侧菜单的 备份，进入备份页面，然后点击 恢复 选项卡即可进入恢复界面，阅读完注意事项之后点击 开始恢复 按钮即可显示备份文件上传界面。
    • 选择备份文件后，点击 上传 按钮即可开始上传备份文件，上传完成后会自动开始恢复。
    • 恢复完成，会提示重启 Halo，点击 确定 按钮即可重启 Halo。
    • 最后，建议去服务器检查 Halo 的运行状态，如果没有设置自动重启，需要手动重启。

原文链接：如何在Linux云服务器上通过Docker Compose部署安装Halo，搭建个人博客网站？

相关推荐
独立站建站C_2Cshop23 天前
不做推销做共情：一个小众独立站靠宠物殡葬用品，年营收超3600万元
网站搭建·宠物·跨境电商·独立站·独立站建站
kaika11 个月前
在 Halo 中导入 Markdown 和 Word 文档
建站·网站管理·halo·文档导入
kaika11 个月前
通过 1Panel MCP 自动部署静态网站
1panel·halo·mcp·ai建站
kaika11 个月前
告别复杂配置！使用 1Panel 运行环境功能轻松搭建 Java 应用
java·1panel·建站·halo
梦吉网络1 个月前
在线进销存系统高效管理网站源码搭建可二开
php·网站搭建
PatrickYao04226 个月前
雨云云应用测评！内测持续进行中！
mysql·部署·网站搭建·openresty·rca
lally.8 个月前
从0开始学习搭网站第三天
网站搭建·crypto动态环境复现
lally.8 个月前
从0开始学习搭网站第二天
github·网站搭建
我叫czc9 个月前
【数字花园】个人知识库网站搭建：⑤本地构建+云服务器部署数字花园plus
笔记·博客·教程·网站搭建·数字花园·第二大脑·网站搭建教程
程序猿看视界1 年前
Halo 开发者指南——项目运行、构建
git·docker·node.js·pnpm·idea·openjdk·halo
热门推荐
01Multisim使用教程详尽版--(2025最新版)02UV 工具安装与国内镜像源配置指南03GitHub 镜像站点0446个Nano-banana 精选提示词，持续更新中05UV安装并设置国内源06Spec-Kit 使用指南07VsCode远程Copilot无法使用Claude Agent问题08保姆级教程：手把手教你用Dify实现完美多轮对话（附Chatflow和提示词）09KGG转MP3工具|非KGM文件|解密音频10Linux下V2Ray安装配置指南