关于这本手册

为什么写

因为我在中文互联网上找不到"家用 NAS 折腾实录"这种内容 —— 要么是厂商软文，要么是抄来抄去的命令列表，要么是假设你有一整套企业级环境。

真机上踩的坑不长那样：它是"配置明明对但就是不生效"、"退出码 0 但文件是空的"、"重启之后好了但不知道为什么"。

写作原则

1. 只写验证过的。没在真机上跑通的结论不写，或者明确标注"未验证"
2. 保留失败的样子。报错原文、错误日志、我一开始的错误判断都留着 —— 那才是排查时真正要对照的东西
3. 配置全部脱敏。域名用 example.com，内网 IP 用 192.168.1.x，密钥用 xxx，路径里的用户名去掉
4. 给验证方法。结论后面跟上"你怎么自己确认这件事"，而不是让你信我

技术栈

本站用 VitePress 构建，纯静态，Markdown 写作。

代码放在 GitHub 私有仓库，push 到 main 后由 GitHub Actions 自动 npm ci → 构建 → wrangler deploy，发布到 Cloudflare Workers 的边缘节点（静态资源托管）。所以你在页面上看到的每一次更新，都是从一次 commit 自动出去的。

联系

发现错误或者有更好的做法，欢迎指出 —— 这类内容最大的风险就是"当时对、后来变了"，所以勘误比内容本身更值钱。