JianHong
发布于 2026-01-05 / 9 阅读
1

🌟 小白零代码搭建 Halo 博客

✅ 无需写代码,只需按步骤操作即可拥有一个属于自己的个人博客网站!

✅ 准备工作(提前准备好)

项目

要求

服务器

推荐使用 Linux 系统(如 Ubuntu/CentOS)的云服务器(阿里云、腾讯云、华为云等均可)

域名

已购买且解析到服务器 IP(例如:jellulc.cn

数据库

MySQL,已安装并运行中

宝塔面板

已安装并登录(安装教程

Nginx

已安装并运行中(安装教程

🚀 操作步骤详解(图文+说明)

🔹 第一步:进入宝塔 → 选择 Docker

  1. 登录宝塔面板

  2. 在左侧菜单栏点击 【Docker】

    • 如图所示,这是第一步操作位置 👉 1、选择Docker菜单


🔹 第二步:在应用商店搜索 “halo”

  1. 进入 Docker 页面后,顶部有「应用商店」标签页

  2. 在搜索框输入:halo

  3. 找到名为 Halo 的应用(开源建站工具)

    • 如图所示 👉 2、在应用商城搜索halo


🔹 第三步:点击“安装”按钮

  1. 找到 Halo 应用后,点击右侧绿色的 【安装】 按钮

    • 如图所示 👉 3、点击安装


🔹 第四步:填写安装配置(关键!)

弹出配置窗口,请按以下要求填写:

⚠️ 配置项说明(务必准确)

字段

填写内容

说明

名称

halo_r1BT 或自定义

只是标识名,随意命名

版本

2.20 或更高版本

推荐最新稳定版

域名

jellulc.cn

❗必须是你已备案并解析好的域名

允许外部访问

✅ 打勾

否则无法从外网访问

端口

8080

默认端口,也可以改其他(但需对应 Nginx)

外部访问地址

http://127.0.0.1:8080https://jellulc.cn

建议填完整 HTTPS 地址

CPU / 内存限制

0(不限制)

初期建议不限制

编辑模板

选择 【自定义】

关键!我们自己写 compose 文件

👉 点击「自定义」后,会弹出编辑器,粘贴下方的 docker-compose.yml 配置。


🔹 第五步:粘贴自定义 Docker Compose 配置

services:
  halo:
    image: registry.fit2cloud.com/halo/halo:2.22
    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=root
      - --spring.sql.init.platform=mysql
      # 外部访问地址,请根据实际需要修改
      - --halo.external-url=https://jellulc.cn/
      # 端口号 默认8090
      - --server.port=8090

💡 注意:

  • halo 是数据库名,请确保已在 MySQL 中创建该数据库。

  • root 是用户名和密码,如果你修改过请替换为真实值。

  • https://jellulc.cn/ 是你的域名,必须正确填写,否则后台无法正常访问。

🔹 第六步:确认安装

  1. 点击「确定」按钮

  2. 宝塔将自动拉取镜像并启动容器

  3. 等待几分钟,直到状态显示为“已停止”,不要慌,可以多等几分钟尝试一下自己的域名能不能访问

✅ 最终效果

你现在拥有了:

  • ✅ 自己的域名博客网站

  • ✅ 使用 Docker 容器部署,稳定易维护

  • ✅ 支持文章发布、主题更换、评论等功能

  • ✅ 开源免费,无广告,完全自主掌控

✅ 总结一句话

只要有一台服务器 + 一个域名 + 宝塔面板,哪怕不会写代码,也能一键部署 Halo 博客,打造专属个人网站!