太长不看：这篇是本站所有家庭服务器实操文章的总入口：一张服务矩阵总览表（博客/监控/音乐/智能家居/图床五条线），按「我想搭什么」的场景导航到对应教程，最后是一份跨服务的通用踩坑清单。新读者从这里进，老读者用它查漏。

为什么要有这篇

自托管最大的问题不是搭不起来，而是三个月后自己都想不起来「当时那个服务是怎么配的」。本站的实操文章分散在各篇教程里，这篇 hub 页把它们按场景聚合起来，并补一张全景表——既是给读者的导航，也是给自己的架构存档。

服务矩阵总览

服务线 跑着什么 关键组件 对应文章
博客系统 本站 Halo + 主题定制 + 自动发布流水线 Halo、theme-hao、Obsidian、对象存储 把发博客压成一条命令、修改 halo 主题配置
监控告警 服务存活监控 + 飞书中文美化告警 Uptime-Kuma、飞书 webhook 优化 Uptime-Kuma 的告警内容
音乐服务 站内音乐播放 + 自建 API Meting API、Docker 多种方式安装 Meting API
智能家居 Home Assistant 反代接入 HA、反向代理 反向代理 home-assistant
大模型应用 RAG 检索问答 GLM-4.6、chromadb 使用智谱 GLM-4.6 构建 RAG
学习存档 Python 入门一年完整路径 Jupyter、Hexo 我的 Python 入门一年、配置 Hexo 自动同步
系统网络 Windows 挂载网络驱动器 SMB、mount.cifs win10 添加网络驱动器报凭据错误

按场景导航

「我想写博客但怕麻烦」 → 先看自动发布流水线：AI 写文 + 脚本传图 + 一条命令上线；图片自动转 WebP（实测 1.4MB PNG 压到 167KB）。

「我想知道我关注的服务挂没挂」 → Uptime-Kuma 飞书告警美化：状态分色、中文文案、@指定人，容器挂载改模板的思路可以复用到钉钉/企微。

「我想给自己的站加音乐」 → Meting API 三种安装方式，本质都是 Docker，重点是 HTTPS 反代的 location /meting/ 写法。

「我想把 Home Assistant 暴露到域名访问」 → 反向代理 home-assistant：use_x_forwarded_for + trusted_proxies 两行配置是关键。

「我想搭一个自己的知识库问答」 → GLM-4.6 构建 RAG 从零到能跑，完整 main.py 可抄。

通用踩坑清单（跨服务）

这些坑在多个服务里重复出现过，值得单独列出来：

  1. 反代后的信任链：服务放到反向代理后面，几乎都要单独配置「信任代理头」（HA 的 trusted_proxies 是典型），否则拿到的是代理 IP 而非真实客户端。
  2. 容器内文件要改？先挂载再改：Uptime-Kuma 改通知模板的套路——把容器内目录拷出来挂载进去重建容器——适用于一切「想改官方镜像里文件」的场景。
  3. 校验存活用 GET 不用 HEAD：不少自托管程序对 HEAD 返回 404，别当成服务挂了（自动发布流水线里踩过）。
  4. 国产环境镜像拉取：Docker Hub 直连不稳，1Panel 第三方应用商店与镜像加速是现实解。
  5. 安全策略对不上比配错更隐蔽：SMB 的 sec= 策略、Win10 的 LAN Manager 认证级别，两边策略不匹配时报的是「凭据错误」，极具误导性。

这张图后面会长出什么

  • 图床与对象存储线（MinIO/WebP 管线）会单独成文
  • 内网穿透与域名/证书管理（含 EdgeOne 边缘缓存）在整理中
  • 每新增一条服务线，会更新上面的总览表并回链到对应教程

本页是「家庭服务器」话题的枢纽页（hub）。各服务的深度教程都在上表与场景导航里；如果你只想问「这个东西值不值得自托管」——我的答案是：先从一条你最想要的线开始，其余的会自然长出来。