社交媒体

群晖 NAS 搭建个人主页实战:Docker + Halo 2.x + HTTPS 反向代理完全指南

群晖 NAS 搭建个人主页实战:Docker + Halo 2.x + HTTPS 反向代理完全指南

把个人主页托管在云服务器固然省事,但如果你家里本来就有一台 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同宿主机直接转发
目的地端口8090Halo 容器映射端口

别忘了切换到 自定义标题 标签页,点击「新增 → 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 的评论策略分散在两处:

  1. 系统设置 → 评论设置:如果勾了「仅允许注册用户评论」,同时又关闭了「开放注册」,就会导致所有访客都无法留言。推荐 关闭开放注册 + 允许游客评论 + 开启新评论审核。
  2. 评论组件插件设置:建议勾选「匿名评论需要验证码」,防机器人刷屏同时不影响正常访客交流。

4. 安全与备份千万别偷懒

  • 强密码 + 关闭注册:管理员账号使用高强度独立密码,不对外开放注册入口。
  • 定期备份两个目录:群晖 Hyper Backup 定时备份 /volume1/docker/halo/halo2(附件、主题、插件配置)和数据库定期 pg_dump 导出,哪怕换机器也能十分钟无损迁移。

小结

把个人主页安放在群晖 NAS 上,前期只需要花半小时把 Docker、反向代理、external-url 和备份理顺,后面几乎就是“零维护成本”的长期陪伴。如果你也在用群晖跑 Halo,欢迎在评论区交流你的部署方案!