把个人主页托管在云服务器固然省事,但如果你家里本来就有一台 24 小时开机的群晖 NAS,那么把 Halo 2.x 跑在群晖的 Docker(Container Manager)里,再配合独立域名与 HTTPS 反向代理,几乎是性价比最高、掌控感最强的个人建站方案。
这篇文章梳理一套从 容器编排 → 反向代理 → HTTPS 证书 → 避坑与备份 的完整实战路径,也是本站正在稳定运行的真实架构总结。
整体架构一览
整个访问链路非常清晰,核心原则是 容器内只暴露内网端口,统一由群晖反向代理终结 HTTPS:
访客浏览器
│ HTTPS (如 https://blog.sugenwang.top:8443)
▼
家庭路由器端口转发 (外网 8443 → 群晖 8443)
│
▼
群晖 DSM 反向代理 (Nginx + TLS 证书)
│ HTTP (http://127.0.0.1:8090)
▼
Docker 容器:Halo 2.x + PostgreSQL (持久化到 NAS 共享目录)
这样做有三个明显好处:
- 证书集中管理:直接在群晖「控制面板 → 安全性 → 证书」里申请或自动续期 Let's Encrypt / 泛域名证书,不用在容器内折腾 Nginx 配置。
- 数据完全落盘:Halo 工作目录与数据库目录映射在 NAS 宿主机卷上,升级镜像只需拉取新版本重启,数据零丢失。
- 公网暴露面极小:只转发反代后的 HTTPS 端口,不把数据库端口暴露到公网。
第一步:使用 Docker Compose 部署 Halo 2.x
建议直接用 PostgreSQL 作为生产数据库,避免轻量嵌入式数据库在文章和插件增多后出现性能瓶颈。在群晖 Container Manager 中创建项目,使用如下 docker-compose.yml 模板:
services:
halo:
image: registry.fit2cloud.com/halo/halo:2.26
container_name: halo
restart: unless-stopped
depends_on:
halodb:
condition: service_healthy
networks:
halo_network:
volumes:
- /volume1/docker/halo/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
- --spring.r2dbc.password=请替换为强密码
- --spring.sql.init.platform=postgresql
# 极其关键:务必填最终对外访问的 HTTPS 完整域名(含非标准端口)
- --halo.external-url=https://blog.sugenwang.top:8443/
halodb:
image: postgres:15.4
container_name: halodb
restart: unless-stopped
networks:
halo_network:
volumes:
- /volume1/docker/halo/db:/var/lib/postgresql/data
healthcheck:
test: ["CMD", "pg_isready"]
interval: 10s
timeout: 5s
retries: 5
environment:
- POSTGRES_PASSWORD=请替换为强密码
- POSTGRES_USER=halo
- POSTGRES_DB=halo
- PGUSER=halo
networks:
halo_network:
第二步:配置群晖反向代理与 HTTPS
在群晖 DSM 中打开 控制面板 → 登录门户 → 高级 → 反向代理服务器 → 新增:
| 配置项 | 推荐值 | 说明 |
|---|---|---|
| 来源协议 | HTTPS | 对外强制加密传输 |
| 来源主机名 | blog.sugenwang.top | 你的专属博客二级域名 |
| 来源端口 | 8443 | 家庭宽带通常封禁 80/443,可选用高位端口 |
| 目的地协议 | HTTP | 本机回环通信即可 |
| 目的地主机名 | localhost | 同宿主机直接转发 |
| 目的地端口 | 8090 | Halo 容器映射端口 |
别忘了切换到 自定义标题 标签页,点击「新增 → WebSocket」,让群晖自动补齐 Upgrade 与 Connection 请求头,保证 Halo 后台通知和部分插件实时能力顺畅运行。
随后到 控制面板 → 安全性 → 证书 → 设置 中,把新创建的反向代理规则绑定到对应域名的 SSL 证书。
第三步:最容易踩的 4 个高频坑
1. 页面能 HTTPS 打开,但 RSS / Sitemap 里还是内网 IP
这是群晖建站最常见的问题:容器初次部署时把 --halo.external-url 设成了 http://192.168.x.x:8090,后来配好公网 HTTPS 域名后忘了同步更新。
症状:前台相对路径一切正常,但打开 /rss.xml 会看到 <link>http://192.168.x.x:8090/...</link>,Halo 后台「系统概览」也会提示外部访问地址不一致。
解决:修改容器启动参数 --halo.external-url=https://你的域名:端口 并重建容器即可立刻恢复正常。
2. 图片加载慢或 Favicon 404
- 尽量在后台「基本设置」里配齐 Logo 与 Favicon,避免浏览器每次请求
/favicon.ico都触发 404。 - 家庭宽带上行带宽有限,文章封面图建议控制在 200KB–600KB 以内(WebP 或合理压缩的 PNG/JPG),观感几乎无损但首屏加载会快很多。
3. 评论区开了但游客看不到输入框
Halo 的评论策略分散在两处:
- 系统设置 → 评论设置:如果勾了「仅允许注册用户评论」,同时又关闭了「开放注册」,就会导致所有访客都无法留言。推荐 关闭开放注册 + 允许游客评论 + 开启新评论审核。
- 评论组件插件设置:建议勾选「匿名评论需要验证码」,防机器人刷屏同时不影响正常访客交流。
4. 安全与备份千万别偷懒
- 强密码 + 关闭注册:管理员账号使用高强度独立密码,不对外开放注册入口。
- 定期备份两个目录:群晖 Hyper Backup 定时备份
/volume1/docker/halo/halo2(附件、主题、插件配置)和数据库定期pg_dump导出,哪怕换机器也能十分钟无损迁移。
小结
把个人主页安放在群晖 NAS 上,前期只需要花半小时把 Docker、反向代理、external-url 和备份理顺,后面几乎就是“零维护成本”的长期陪伴。如果你也在用群晖跑 Halo,欢迎在评论区交流你的部署方案!