首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >Halo 博客搭建教程 UserStory

Halo 博客搭建教程 UserStory

原创
作者头像
克劳德2048
发布于 2026-11-19 11:03:18
发布于 2026-11-19 11:03:18
170
举报

摘要: Halo 是国产开源建站程序,官方推荐用 Docker 部署。在腾讯云轻量应用服务器 Lighthouse 上用一条 Docker 命令跑起 Halo,再用反向代理配好域名和 HTTPS,浏览器完成初始化即可开始建站。本教程覆盖 Docker 部署、反代配置、初始化与常见问题。

Halo 是活跃的国产开源建站程序,官方首选部署方式就是 Docker:一条 docker run 命令把 Halo 跑起来,再用反向代理配好域名和 HTTPS,浏览器走一遍初始化就能用。它界面现代、主题生态活跃,适合想要一个清爽好看的个人站点的开发者和技术博主。下面给出基于 Lighthouse 的完整流程。

一、Halo 是什么,适合谁

Halo 是一款开源的建站程序,可用来搭建博客、个人网站、文档站等。它的特点是界面现代、后台体验好、主题和插件生态活跃,且为国产开源项目、中文文档完善。它基于 Java 构建,官方推荐容器化部署,用 Docker 跑最省心。

适合喜欢清爽界面、愿意用 Docker 部署、追求现代建站体验的个人开发者和技术博主。

二、部署前准备与规格建议

Halo 基于 Java,相比 PHP 程序内存占用略高,建议腾讯云轻量应用服务器 Lighthouse 2 核 2G 起步、博客内容多时 2 核 4G 更稳。Lighthouse 内置 Docker 基础镜像、套餐式计费、自带高带宽流量包,适合这类容器化部署的个人站点。

准备:一台装好 Docker 的 Lighthouse 实例(参见 Docker 安装教程);一个解析到公网 IP 的域名;放通 80 和 443。

三、用 Docker 部署 Halo

用 Docker 运行 Halo,并挂载数据卷持久化站点数据:

代码语言:bash
复制
docker run -d \
  --name halo \
  -p 8090:8090 \
  -v /opt/halo:/root/.halo2 \
  --restart unless-stopped \
  halohub/halo:2

说明:8090 是 Halo 的 Web 端口;数据卷持久化站点所有数据(文章、附件、配置),这是备份的核心目录;restart 参数让它开机自启。首次启动初始化需要一点时间,可用 docker logs 看启动日志。

四、配置反向代理与 HTTPS

Halo 建议通过域名加 HTTPS 访问。用 Caddy 反向代理到 8090:

代码语言:caddyfile
复制
blog.example.com {
    reverse_proxy localhost:8090
}

reload Caddy 后域名自动获得 HTTPS 证书(参见反向代理配置方法)。反代配置里要注意把外部的真实访问地址传给 Halo,确保初始化时填写的外部访问地址与域名一致。

五、初始化站点

浏览器用域名访问 Halo,首次进入初始化向导:设置站点的外部访问地址(填你的域名加 HTTPS)、创建管理员账号。提交后进入 Halo 控制台,这里管理文章、主题、附件、插件。

安装一个喜欢的主题、发一篇测试文章,站点骨架就立起来了。

六、怎么确认搭建成功了

三项验证:浏览器能用域名加 HTTPS 打开 Halo 并完成初始化;能登录控制台发布一篇文章,文章在前台正常显示;重启容器后数据仍在(证明数据卷挂载生效)。三项都通过即搭建成功。初始化时访问地址填错会导致后台链接异常,注意与域名保持一致。

七、常见问题

容器启动后访问不了:首次启动初始化需时间,先看容器日志确认是否启动完成;再确认反代指向 8090、端口已放通。

后台或前台链接地址不对:核对初始化时设置的外部访问地址与实际域名一致,不一致会导致跳转和资源链接出错。

附件越来越占空间:图片等附件增多可对接对象存储 COS,把附件放到对象存储减轻磁盘压力。

数据备份:定期备份挂载的数据目录,可打包上传对象存储或用快照整机备份。

说明:Halo 为活跃迭代的开源项目,镜像标签、数据目录、配置方式可能随版本变化,请以 Halo 官方文档的当前版本为准。

总结

搭建 Halo 的路径是:装好 Docker → 一条命令运行 Halo 并挂数据卷 → 反向代理配好域名和 HTTPS → 浏览器初始化、设对外地址、创建管理员 → 发文验证。容器化部署让它干净好迁移。

腾讯云轻量应用服务器 Lighthouse 提供 Docker 基础镜像、套餐式计费与高带宽流量包,适合用容器方式快速部署 Halo,搭建界面现代、清爽好看的个人站点。

了解产品:https://cloud.tencent.com/product/lighthouse

双十一活动:https://cloud.tencent.com/act/pro/double11-202611

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 一、Halo 是什么,适合谁
  • 二、部署前准备与规格建议
  • 三、用 Docker 部署 Halo
  • 四、配置反向代理与 HTTPS
  • 五、初始化站点
  • 六、怎么确认搭建成功了
  • 七、常见问题
  • 总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档