boxmoe_header_banner_img

欢迎来到Liyang Blog!

加载中

文章导读

使用Halo部署自己的个人博客


avatar
Liyang 2025-12-30 51
摘要生成中
AI生成,仅供参考

前言

最近使用了Halo重新搭建了博客(其实在上月就换了)和之前的Typecho相比,功能和使用体验不在那么简陋。不过Halo对内存的使用会高一些

Halo项目介绍

Halo是一款基于Java开发的博客系统,强大易用的开源建站工具。

博客部署开始

部署所需资源

搭建博客需要一台具有公网的云服务器和域名一枚

服务器配置推荐:

逻辑核心:2核心

运行内存:2GB

服务器选购

服务器可以选择纯净水互联阿里云等厂商

这里使用的是阿里云的服务器,阿里云有每年99元限购一台的服务器,资源配置不是很高2核心2GB,但对于个人博客已经足够,而且后续续费依是这个价格。

小提示:服务器构建的时候使用阿里云的Linux镜像构建,镜像自带了docker,后续也是使用docker进行构建,会更加方便。

正式部署博客

服务器购买完成,我们就可以开始部署博客了

在系统任意位置创建一个文件夹,本教程以 ~/halo 为例

mkdir ~/halo && cd ~/halo

提示:后续操作中,Halo 产生的所有数据都会保存在这个目录,请妥善保存!

创建 docker-compose.yaml

vim docker-compose.yaml

输入i,进入文件编辑模式

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=Liyang_Blog
      - --spring.sql.init.platform=mysql
      # 外部访问地址,请根据实际需要修改
      - --halo.external-url=http://0.0.0.0: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=Liyang_Blog
      - MYSQL_DATABASE=halo

networks:
  halo_network:

完成编辑后,输入:wq,进行保存并退出

启动 Halo 服务

docker-compose up -d

实时查看日志

docker-compose logs -f

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

反向代理

你可以在下面的反向代理软件中任选一,假设你已经安装好了其中一项,并对其的基本操作有一定了解。如果你对它们没有任何了解,可以参考我们更为详细的反向代理文档:

使用 Nginx Proxy Manager —官方文档

使用 Traefik —官方文档

Nginx

upstream halo {
  server 127.0.0.1:8090;
}
server {
  listen 80;
  listen [::]:80;
  server_name 你的域名;
  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 2

你的域名

encode gzip

reverse_proxy 127.0.0.1:8090

Traefik

更新 halo 容器组的配置

  1. networks 中引入已存在的网络 traefik(此网络需要 提前创建) —官方文档
  2. services.halo.networks 中添加网络 traefik
  3. 修改外部地址为你的域名
  4. 声明路由规则、开启 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


评论(0)

查看评论列表

暂无评论


发表评论

表情 颜文字
插入代码