写在前面

这本手册记录的是一台家用 NAS 被我折腾了几个月之后的真实结论。没有实验室环境，没有干净的重装系统，只有一台每天在跑服务、偶尔被我搞坏、又要我自己修回来的机器。

所以这里的内容有一个特点：每条都带着现场。报错原文、日志片段、我一开始的错误判断、最后真正的原因，都在。因为我自己吃过太多"教程写得很对但就是跑不起来"的亏——多数时候不是教程错，是它省略了失败的样子。

这里会写什么

隧道与反向代理：把家里服务安全地暴露到公网，以及 Tunnel 这类方案的隐性陷阱
备份与灾备：本地备份、异地备份、加密、恢复演练，还有云挂载那些反直觉的限制
媒体与下载：镜像加速、下载链路的稳定性、媒体库整理
自托管应用：WordPress、笔记、Git、面板之类能真正每天用的东西
AI Agent 实战：让 agent 帮你运维一台机器，边界该划在哪

这里不会写什么

大而全的"XX 从入门到精通"
抄来的命令列表，没验证过的参数
任何真实域名、IP、密钥。本手册所有配置示例均已脱敏，example.com、192.168.1.10、cfsd_xxxxxxxx 这类占位符请替换成你自己的

怎么读

如果你只遇到具体问题，直接从左边目录跳过去。如果你想系统搭一套，按章节顺序读——后面几章会反复用到前面的前提（比如"先有可靠的备份，再谈对外暴露服务"）。

一个前提

本手册默认你：

有一台能 SSH 进去的 NAS 或小主机（群晖、fnOS、Unraid、普通 Linux 都行）
会用命令行，能看懂 docker ps 的输出
愿意为"自己掌控数据"多花一点时间

如果你只想点几下鼠标就完事，云盘更适合你，这本手册会让你觉得累。

准备好了就从第二章隧道与反向代理开始，那是所有问题的起点——毕竟，先能安全地从外面连回来，剩下的才有意义。