
摘要: Halo 是国产开源建站程序,官方推荐用 Docker 部署。在腾讯云轻量应用服务器 Lighthouse 上用一条 Docker 命令跑起 Halo,再用反向代理配好域名和 HTTPS,浏览器完成初始化即可开始建站。本教程覆盖 Docker 部署、反代配置、初始化与常见问题。
Halo 是活跃的国产开源建站程序,官方首选部署方式就是 Docker:一条 docker run 命令把 Halo 跑起来,再用反向代理配好域名和 HTTPS,浏览器走一遍初始化就能用。它界面现代、主题生态活跃,适合想要一个清爽好看的个人站点的开发者和技术博主。下面给出基于 Lighthouse 的完整流程。
Halo 是一款开源的建站程序,可用来搭建博客、个人网站、文档站等。它的特点是界面现代、后台体验好、主题和插件生态活跃,且为国产开源项目、中文文档完善。它基于 Java 构建,官方推荐容器化部署,用 Docker 跑最省心。
适合喜欢清爽界面、愿意用 Docker 部署、追求现代建站体验的个人开发者和技术博主。
Halo 基于 Java,相比 PHP 程序内存占用略高,建议腾讯云轻量应用服务器 Lighthouse 2 核 2G 起步、博客内容多时 2 核 4G 更稳。Lighthouse 内置 Docker 基础镜像、套餐式计费、自带高带宽流量包,适合这类容器化部署的个人站点。
准备:一台装好 Docker 的 Lighthouse 实例(参见 Docker 安装教程);一个解析到公网 IP 的域名;放通 80 和 443。
用 Docker 运行 Halo,并挂载数据卷持久化站点数据:
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 看启动日志。
Halo 建议通过域名加 HTTPS 访问。用 Caddy 反向代理到 8090:
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,搭建界面现代、清爽好看的个人站点。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。