作为一名公司律师，我每天打交道最多的就是各种法规条文，以及来咨询各种法律条文的亲戚朋友。其中一个最常被问到的问题，就是各种劳动法规。尤其是各地假期政策，比如婚假怎么请，产假有多长……这些是每个人都会遇到的问题。

前段时间，我有个朋友跳槽到一家深圳的公司，问我：“深圳的陪产假到底是几天？网上查的乱七八糟的。“我翻了一圈，发现确实如此。国家层面有一套规定，各省又有各自补充的地方规定，信息散落在各级人社厅的官网、政府公报、地方性法规里，没有一个能一站式对比查看的地方。

我当时就想：要是有一个网站，选一个省份，所有假期政策一目了然，中央规定和地方特别规定并列展示，每条规则还附上法律出处，那该多好。

然后我脑子里蹦出另一个念头——我为什么不自己做一个呢？

放在以前，这个念头冒出来三秒钟就会被我自己摁回去。我不会写前端，不会画地图，不知道怎么部署网站。但最近这一年，情况变了。

当法学撞上 Vibe Coding

先聊聊什么是 Vibe Coding。这个词是 Andrej Karpathy 在 2025 年初提出来的，大意是：你不再需要逐行手写代码，而是用自然语言描述你想要什么，AI 帮你写。你要做的不是"编程”，而是"指挥”。你负责想法和品位，AI 负责执行。

我刚接触 Vibe Coding 的时候，也经历过一段迷茫期。看别人用 Cursor、用 Claude Code 三下五除二搞出一个项目，自己上去一试，发现根本不是那么回事。AI 确实能写代码，但写出来的东西经常有这样那样的问题：组件渲染不出来、类型报错、样式错乱、路由不对……

后来我慢慢悟出来一个道理：Vibe Coding 不是"不用动脑子"，而是"换一种方式动脑子"。 你不能真的完全放手，你得学会审阅代码、提出精准的修改指令、在 AI 卡壳的时候指出方向。某种意义上，这和 review 一篇法学论文没什么区别——你不是从头到尾自己写每一个字，但你必须判断哪里有问题、该怎么改。

而我的法律背景，在这个项目里扮演了一个意想不到的角色。

法律思维如何重塑我的开发流程

法学的核心训练是什么？如果只让我说一点，那就是体系化的分类与归入。面对一个案件，你要做的第一件事不是拍脑袋下结论，而是把事实拆解成若干个法律要件，逐一检视，最后得出结论。

这套思维方式，在我做这个假期政策查询网站的时候，天然地映射到了数据结构的搭建上。

假期政策说白了，就是一个多层级的规则体系：

• 第一层，国家法定基准。比如产假 98 天、婚假 3 天，这是写在《女职工劳动保护特别规定》和《人口与计划生育法》里的，全国通用。
• 第二层，各省地方补充规定。比如上海在 98 天基础上再加 30 天产假，广东的陪产假是 15 天，少数民族自治地方还有特殊政策。
• 第三层，兜底规则。如果地方没有特别规定，就自动沿用中央标准。

这个三层结构，我用法学里"一般法与特别法"的关系来理解：特别法优先于一般法，特别法没有规定的，适用一般法。这恰恰就是代码里 mergePolicy() 函数的核心逻辑——先加载中央基准数据，再用各省的覆盖字段去 merge，本地有的覆盖中央，本地没有的 fallback 到中央。

所以当 AI 问我要怎么设计数据结构的时候，我几乎没有犹豫就画出了这个 YAML schema：

婚姻假:
  天数: 3
  适用条件: 依法办理结婚登记的夫妻
  工资待遇: 正常发放
  法律依据:
    - 名称: 国家劳动总局、财政部关于国营企业职工请婚丧假和路程假问题的通知
      条款: 第一条

然后在各省的文件里，只写和中央不同的部分。比如江苏：

婚姻假:
  天数: 13
  法律依据:
    - 名称: 江苏省人口与计划生育条例
      条款: 第二十七条

这个设计思路，法学圈的人一眼就能看出来是"特别法优于一般法"的逻辑，但你要让我从头手写代码实现这个 merge 逻辑，放一年前的我绝对写不出来。现在呢？我把思路描述给 AI，半分钟代码就出来了，而且类型检查全过。

Zod 数据校验也是同样的道理。法律讲究"形式要件"，合同缺了某个必要条款就无效。映射到项目里，就是数据文件必须有严格的 schema 验证——central.yaml 必须包含全部 7 类假期，省份文件里每个假期必须包含"天数"字段，法律依据不能为空。我把这些约束用自然语言描述给 AI，它生成了一套 Zod schema，build 之前自动跑一遍验证脚本，任何一个省份的 YAML 格式不对，整个 CI 直接报错。

说起来有点好笑，我的导师要是知道我拿法律方法论去"调教" AI 写代码，不知道会怎么想。但说实话，这种跨学科的思维迁移，恰恰是 Vibe Coding 时代最有意思的部分——你不需要是一个科班出身的软件工程师，但你需要有一套成体系的思考框架，不管这套框架是来自法律、医学、建筑还是音乐。

从想法到产品：一个周末的构建记录

想法有了，方法论也理顺了，接下来就是动手。

整个项目的技术栈选择，我基本遵循一个原则：选最主流、AI 最熟悉的方案。这不是炫技的时候，我是拿来主义的信徒——Next.js + Tailwind CSS + shadcn/ui，这套组合是 AI 训练数据里最充分的技术栈，意味着 AI 出错的概率最低。

数据层：31 个省的假期政策汇编

这其实是最耗时的部分。代码可以靠 AI 生成，但内容不行。

我花了差不多两个完整的周末，逐一翻查了 31 个省级行政区的卫健委、人社厅官网，以及各地方人大发布的计划生育条例修正案。每一条规则我都在旁边标注了原文件的名称、条款号和官方链接。有些省份的规定藏得特别深——比如某个自治区的陪产假规定，写在一份 2016 年的《关于修改〈XX 自治区人口与计划生育条例〉的决定》里，要顺着修正案的指示往前翻原文才能拼出完整的规则。

这件事 AI 帮不了忙，至少现在帮不了。它可能会"编造"一些看起来很像真的法条，但在这种事上，一个法律人的底线还是有的——数据必须可溯源。

所有整理好的数据，我按照 XX-pinyin.yaml 的命名规范放在 data/provinces/ 目录里，一共 31 个文件，加上一个 central.yaml 做基准。

前端：SVG 中国地图的三天折磨

整个项目里最让我头疼的部分，是中国地图。

一开始我想得很简单：找个现成的 ECharts 图表库，把中国地图渲染出来就完了。结果发现 ECharts 的中国地图用的是 GeoJSON 格式，数据量巨大不说，暗黑模式下的颜色适配也很麻烦。AI 建议我用原生 SVG，但网上找到的中国地图 SVG 大多质量堪忧——边界线粗糙，有些省份的路径数据甚至不完整。

最后我采取了一个折中方案：让 AI 帮我生成一个精确的 SVG 路径数据，存储为 JSON 文件，每个省份一条 path，包含 viewBox、路径坐标和省份中心的经纬度。然后自己写了一个 React 组件来做交互。

这里有个细节值得一提：小省份的点击区域。北京、天津、上海这些直辖市在地图上实在太小了，鼠标根本点不到。我当时跟 AI 反复来回了好几轮，最后想到一个办法——在路径外面套一层不可见的圆形点击热区，半径放大 3 倍，覆盖周围的空白区域。这个方案 AI 没有主动提出来，但当我描述给它之后，它很快就实现了。

地图的热力图配色也调了很久。我定义了一个"假期热度值"，把婚假天数、产假天数和陪产假天数相加，然后分成四档：

• 绿色（≥200）：假期福利比较到位的省份
• 黄色（190-199）：中上水平
• 红色（180-189）：中等偏下
• 深红色（<180）：假期天数较少的地方

说实话，这个"热度值"的算法相当粗糙，但我就是想给用户一个直观的视觉感受——一眼扫过去，大致知道哪个"颜色区域"假期多一些。未来如果有时间，我打算引入更多权重因素，比如育儿假、探亲假也纳入计算。

每个省的详情页：七类假期的卡片式展示

省份详情页的设计灵感来自我手机上的健康 App 仪表盘——每一类假期是一张独立的信息卡片，顶部显示天数，中间是适用条件和工资待遇，底部折叠了资格认定和注意事项的详细说明。

最有价值的设计是 “来源标签"系统。每条规则右侧都会有一个小标签：

• “中央规定”（灰色标签）：表示这条来自国家层面的法律法规
• “本地特别规定”（蓝色标签）：表示这是该省在中央基础上额外制定的政策

两者并列展示，用户一眼就能分辨出哪些是国家给的、哪些是本省额外补充的。

部署：GitHub Actions + GitHub Pages，零成本上线

部署部分反而是整个项目最简单的一环。

Next.js 有个特性叫 Static Export，简单说就是把整个网站预渲染成纯静态的 HTML + CSS + JS 文件，不需要服务器。我只需要在 next.config.mjs 里加一行 output: "export"，然后配置 GitHub Actions 在每次 push 代码到 main 分支的时候自动 npm run build，把产物推到 GitHub Pages 上。

CI 流水线也很干净：

1. Checkout 代码
2. npm ci 装依赖
3. npm run validate-data 校验所有 YAML 数据文件的格式
4. npm run typecheck TypeScript 类型检查
5. npm run build 构建静态产物
6. 部署到 GitHub Pages

从 push 代码到网站更新，全自动，整个过程不到两分钟。

最终线上地址：masonblog.github.io/HolidayGO-CN

写在最后：AI 时代，创意才是真正的稀缺资源

这个项目做完，我最大的感触不是"AI 好厉害”，而是——在 AI 时代，有想法的人太少了，能把想法落地的人更少。

你不信的话，想想看：全中国每年有多少法学生、律师、HR 从业者，每天都在查假期政策，查完之后该干嘛干嘛。有多少人会冒出"我为什么不做一个查询工具"这个念头？又有多少人冒出了这个念头之后，真的打开电脑，开始做了？

AI 拉平了技术实现的鸿沟，但没有拉平"想不想做"和"能不能坚持做完"的鸿沟。

我不是什么编程大神。在开始这个项目之前，我连 Next.js 的路由是怎么写的都不知道。但现在呢？一个可用的产品摆在这里，31 个省的数据覆盖齐全，有暗黑模式、有交互地图、有来源溯源，CI/CD 全自动部署。这些东西，放在两年前，是我一个文科生想都不敢想的事情。而在 2026 年，我用业余时间，借助 AI，做到了。

所以我想说的是：如果你的脑子里一直有一个"要是能有个什么东西就好了"的想法，别犹豫，现在就动手。不需要等到你"学会了编程"才开始——那个时代已经过去了。你只需要：

• 一个清晰的想法（这是你最独特的资产，AI 抢不走）
• 一套成体系的思维框架（不管来自哪个学科）
• 愿意花时间去打磨细节的耐心（AI 能帮你写代码，但打磨产品只能靠你自己）

剩下的，交给 AI 和时间。

这个项目的所有代码开源在 GitHub：masonblog/HolidayGO-CN。如果你对假期政策数据有补充或纠错，欢迎提 PR。

如果你也是一个非技术背景、但用 AI 做出了自己作品的"野生开发者"，欢迎在评论区聊聊你的故事——我很想听听。

这不是黑客攻击，不是内鬼泄密，而是有人忘记在 .npmignore 里加了一行 *.map。

就这样，51 万行 TypeScript 代码、44 个隐藏功能开关、以及一个叫做 KAIROS 的神秘"后台自主代理"，在几小时内暴露在所有人面前。

事件经过：一个 .map 文件引发的雪崩

泄露是如何发生的？

2026 年 3 月 31 日，Anthropic 在 npm 上发布了 @anthropic-ai/claude-code 的 2.1.88 版本。这次更新本是例行维护，但却附带了一个巨大的"彩蛋"——一个 59.8 MB 的 JavaScript Source Map 文件（.map 后缀）。

Source Map 是开发者用于调试压缩/混淆代码的工具，它能将编译后的代码映射回原始的 TypeScript 源码。正是这个本应只存在于内部的调试文件，被意外打入了公开发布的 npm 包里。

更关键的是，这个 .map 文件还指向了一个 Anthropic 自家云存储上的 ZIP 压缩包，里面存放着完整的源代码仓库。所有人只需要顺着这条线索，就能下载到全部代码。

根本原因：有人忘记在 .npmignore 文件中添加 *.map 规则，导致 Source Map 文件随包一起发布。

传播有多快？

代码在公开后数小时内便被开发者社区察觉，随即被备份到 GitHub 上。根据 Layer5 的统计，相关仓库的 Fork 数量迅速突破 41,500 次，一度成为 GitHub 历史上增长最快的仓库。

Anthropic 很快确认了这一事件，但表示这只是一次"发布打包失误"，没有泄露用户数据或凭证信息。

泄露的内容：512,000 行代码里藏着什么？

源代码共包含 1,906 个 TypeScript 文件，整个 AI 圈的开发者和研究者们开始像考古学家一样，在代码里挖掘 Anthropic 从未公开过的秘密。

秘密一：KAIROS —— 始终在线的自主 AI 代理

这是泄露内容中最受关注的发现之一。代码中一个名为 KAIROS 的功能标志被提及超过 150 次。

KAIROS 来自古希腊语，意为"恰当的时机"。从代码逻辑来看，它代表着 Claude Code 的一次重大范式转变：从被动响应变为主动的后台自主守护进程（Daemon）。

具体来说，KAIROS 模式包含一个叫做 autoDream 的子机制：当用户处于空闲状态时，Claude 会在后台自动进行"记忆整合"，将分散的观察合并、消除逻辑矛盾，并将模糊的认知转化为具体的知识。

这本质上是让 AI 拥有了一种持续学习和自我优化的能力——不仅是在你主动使用时，而是随时随地都在运转。

秘密二：BUDDY —— 一只赛博电子宠物

是的，你没看错。代码里藏着一个完整的电子宠物系统，叫做 BUDDY。

它有：

• 18 个物种可供选择
• 稀有度分级：普通（60%）→ 稀有 → 史诗 → 传说（1%）
• 闪光变体（类似宝可梦的色违）
• 专属属性值，包括 DEBUGGING（调试力）、PATIENCE（耐心）、CHAOS（混乱值）、WISDOM（智慧）和 SNARK（毒舌度）

根据代码注释，BUDDY 原本计划作为愚人节彩蛋于 4 月 1 日悄悄上线预告，并在 5 月正式发布。结果，在 3 月 31 日就被这次意外泄露提前"剧透"了——时机不可谓不讽刺。

秘密三：隐身模式 —— Anthropic 员工的"马甲"

代码中还发现了一个被称为"隐身模式"（Stealth Mode）的功能，其设计目的是隐藏 Anthropic 员工对开源项目的贡献。

简单来说，当 Anthropic 工程师使用 Claude Code 向开源社区提交代码时，该模式会对外屏蔽其 Anthropic 员工的身份。这一发现在开源社区引发了一定的讨论和争议。

秘密四：反蒸馏机制 —— 给竞争对手的"毒药"

代码中的 ANTI_DISTILLATION_CC 功能标志揭示了一个更具攻击性的策略：向 API 请求中注入虚假的工具定义。

其目的在于污染那些监听 API 流量、试图通过"知识蒸馏"来学习和复制 Claude 能力的竞争对手的训练数据。此外，代码还会对 AI 的推理过程进行摘要并附上加密签名，使得窃听者只能获取摘要，而非完整的思维链输出。

安全警告：趁火打劫的黑客

意外泄露事件本身危害有限，但随之而来的安全风险不可小觑。

Axios npm 遭投毒：北朝鲜黑客的精准狙击

就在同一天（3 月 31 日），黑客攻陷了流行 HTTP 库 Axios 的 npm 账号，发布了两个恶意版本（1.14.1 和 0.30.4）。这些版本通过一个名为 plain-crypto-js 的隐藏依赖，植入了一个跨平台远程访问木马（RAT）。

恶意版本在被 npm 下架前存活了约 2-3 小时。

Google 威胁情报团队将此次攻击归因于 UNC1069——一个具有朝鲜背景的、以经济利益为驱动的威胁行为者，所使用的恶意软件为 WAVESHAPER.V2。

高危时间窗口：如果你在 3 月 31 日 00:21 UTC 至 03:29 UTC 之间通过 npm 安装或更新了 Claude Code，你的机器可能已被植入恶意代码。

GitHub 上的假冒仓库

除了 npm 投毒，威胁行为者还在 GitHub 上散布了伪装成"Claude Code 源代码镜像"的恶意仓库。这些仓库诱骗用户运行一个 Rust 编写的投放程序，最终部署 Vidar Stealer（信息窃取木马）和 GhostSocks（代理恶意软件）。

应急自查步骤

如果你是开发者，请立即执行以下检查：

1. 检查你的项目 lockfile（package-lock.json 或 yarn.lock），查找 axios 版本 1.14.1 或 0.30.4。
2. 检查是否存在 plain-crypto-js 依赖项。
3. 如果发现上述任一情况，立即将该主机视为已完全沦陷：轮换所有密钥和凭证，并考虑重装操作系统。

影响与反思

对 Anthropic 的影响

这次事件对 Anthropic 的直接损失是竞争情报的泄露。KAIROS、反蒸馏机制等未发布的战略功能，已被竞争对手和研究者提前看到。

但从另一个角度看，Anthropic 的处理方式——快速承认、如实说明原因——在一定程度上维护了公众信任。

对供应链安全的警示

这次事件是一个关于 软件供应链安全 的经典案例：

• 开发侧：一个被遗忘的打包规则（.npmignore）可以造成灾难性的信息泄露。
• 攻击侧：黑客能够以惊人的速度（同日）利用高关注度事件实施供应链攻击。
• 用户侧：在重大事件发酵期间，来自"官方渠道"之外的任何下载都极度危险。

这提醒每一个维护开源项目的团队：发布流程的审计和自动化检查，与代码本身的质量同等重要。

结语

Claude Code 源代码泄露事件，是 2026 年 AI 领域最戏剧性的事故之一。它以一种意想不到的方式，让公众得以一窥顶尖 AI 工具背后的工程逻辑与产品野心——从重塑人机交互范式的 KAIROS，到充满极客趣味的电子宠物 BUDDY。

然而，伴随着这场意外透明化而来的，是供应链攻击的真实威胁。它再次提醒我们：在这个软件高度依赖开源生态的时代，安全从来不只是代码里的事，更是发布流程、依赖管理和应急响应能力的综合体现。

延伸阅读：

• Claude Code 源代码泄露事件详情 - VentureBeat
• Anthropic 确认 npm 打包失误 - The Hacker News
• Axios npm 投毒与 RAT 事件 - Decode the Future
• 伪造 Claude Code 下载传播恶意软件 - The Register
• KAIROS 与隐藏功能完整分析 - WaveSpeed AI
• 供应链安全的启示 - Coder Blog

但是，对于很多需要申请美国银行账户（如 Capital One, Chase 等）或注册美国券商账号的朋友来说，ATMB 最大的痛点在于：绝大多数地址都是“商业地址” (Commercial / CMRA)，而银行往往要求提供“住宅地址” (Residential / RDI)。

要在 ATMB 浩如烟海的地址列表中，手动一个个去查哪个是住宅地址，简直是大海捞针，费时费力。

为了解决这个问题，我写了一个开源的小程序：ATMB-Addresses。

这个工具能做什么？

简单来说，它就像一个自动化的“探针”，可以帮我们：

1. 自动爬取 ATMB 上指定州（或全美）的所有地址信息。
2. 自动识别 每个地址的属性，帮我们判断它究竟是 住宅 (Residential) 还是 商业 (Commercial) 地址。
3. 整理成表，将结果保存为 Excel/CSV 文件，方便我们筛选。

如何使用（无需编程基础！）

虽然这是一个 Python 程序，但我知道很多朋友可能对代码并不熟悉。没关系！为了方便大家，我已经把爬取并验证好的现成数据直接上传到了仓库里。

如果你懒得自己跑程序，只需要直接下载我跑好的数据即可。

步骤如下：

1. 访问我的 GitHub 仓库：https://github.com/masonblog/ATMB-Addresses
2. 点击页面上的 “Public” 文件夹。
3. 在里面找到你感兴趣的州（比如 new-york.csv 或 california.csv）。
4. 下载这个 CSV 文件，用 Excel 打开。
5. 在表格中寻找 rdi 这一列：
   • 如果显示 Residential，恭喜你！这很可能就是一个银行认可的住宅地址。
   • 如果显示 Commercial，那就是普通的商业地址。

就是这么简单！

进阶玩家：如何自己运行代码

如果你是技术党，或者你想获取最新的实时数据（毕竟地址库会更新），你也可以把代码下载到本地自己运行。

1. 准备工作

首先，你需要确保电脑上安装了 Python 3.x 环境，并安装必要的依赖库。在终端中运行以下命令：

pip install requests beautifulsoup4

其次，这个工具最核心的“验证”功能依赖于 Smarty API。你需要去 Smarty.com 注册一个账号（它提供免费1000条地址验证的试用额度，够我们跑很多数据了）。注册好后，获取你的 Auth ID 和 Auth Token，把它们保存好，后面会用到。

然后，访问我的 GitHub 仓库：https://github.com/masonblog/ATMB-Addresses，点击Code按钮，再点击Download ZIP打包下载代码。

在代码**根目录（解压后的文件夹）**下创建一个名为 smarty_api_key.txt 的文件，将刚刚保存的 Smarty API 的 Auth ID 和 Auth Token 填入这个文件并保存：

auth_id=你的AUTH_ID
auth_token=你的AUTH_TOKEN

2. 开始运行

整个流程分为三步：爬取 -> 补充详情（可选） -> 验证。

第一步：爬取基本地址信息

在代码文件夹右键单击，选择“在终端中打开”，然后输入以下命令运行 ATMB_scrape.py。你可以指定爬取某个州，或者直接爬取全美所有地址。

# 爬取纽约州
python ATMB_scrape.py --input new-york

# 爬取全美（耗时较长）
python ATMB_scrape.py --input us

程序运行后，会在 Public 文件夹下生成一个 CSV 文件，比如 Public/new-york.csv，里面包含了 ATMB 上最新爬取的地址信息，包括街道地址、城市、州、邮编等。

第二步：补充单元号信息（可选）

ATMB 的列表页通常只显示街道地址，但很多时候我们需要知道具体的单元号信息，比如 Suite # 或 Unit #。这一步就要在终端中输入以下命令，程序会访问每个地址的详情页，把这些信息抓取下来：

python ATMB_detail.py --input Public/new-york.csv

运行完成后，会生成一个新的文件 Public/new-york_detailed.csv。

第三步：验证地址性质（关键步骤）

最后，我们使用 Smarty API 来验证这些地址是住宅还是商业。在终端中运行以下命令：

python ATMB_verify.py --input Public/new-york_detailed.csv

程序会逐行验证，并生成最终的文件 Public/new-york_detailed_verified.csv。

打开这个最终文件，查看 rdi 列：

• Residential: 住宅地址（银行喜欢这个！✅）
• Commercial: 商业地址（⚠️）

详细的技术文档和使用参数，我都写在仓库的 README.md 里了，欢迎大家去 Star 和 Fork！

结语

寻找一个靠谱的美国住宅地址是很多“云居民”迈向全球化的第一步。希望这个小工具能帮你节省宝贵的时间，少走弯路。

如果你觉得好用，别忘了分享给身边有需要的朋友！

虽然很多教程都推荐在 Mac Mini 或 Linux 服务器上运行它，但其实 在 Windows 上运行它也完全没问题。

在这篇文章中，我将手把手教你在 Windows 上安装 ClawdBot，将其配置为使用 Google 的 Gemini API（目前最好的 AI 模型，并且赠送有免费额度），并连接到 Telegram，让你随时随地都能与你的 AI 助手聊天。

🛠️ 准备工作

在开始之前，请确保你准备好了以下几样东西：

1. 一台运行 Windows 11 的电脑。
2. 一个 Google Gemini API Key（密钥）： 你可以在 Google AI Studio 免费获取。
3. 一个 Telegram 账号： 用于创建你的机器人。

第一步：安装 WSL2 (Windows Subsystem for Linux)

关键点： ClawdBot 无法直接在 Windows 的 PowerShell 或 CMD 中原生运行。它需要一个 Linux 环境。幸运的是，Windows 自带了一个完美的工具——WSL2。

1. 点击 Windows 开始菜单，找到 PowerShell，右键选择 “以管理员身份运行”。

2. 输入以下命令并回车：

   wsl --install
   

3. 重启你的电脑。

4. 重启后，打开 应用商店（Microsoft Store），搜索“Ubuntu”，下载并安装 “Ubuntu 24.04.1 LTS” 。

5. 打开 Ubuntu ，它会要求你创建一个 用户名和密码。 提示：输入密码时屏幕上不会显示任何字符，这是正常的，输完回车即可。

一旦你进入了这个 Ubuntu 终端窗口，我们就可以继续了。

第二步：安装 Node.js (正确姿势)

ClawdBot 需要较新版本的 Node.js (v22+)。Ubuntu 默认自带的版本通常太旧了，所以我们要使用 NVM (Node Version Manager) 来安装最新版。

请在刚才打开的 Ubuntu 终端中运行以下命令：

1. 下载并安装 NVM：

   wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
   

2. 刷新环境变量 (让系统识别 NVM)：

   source ~/.bashrc
   

3. 安装 Node.js 最新版：

   nvm install --lts
   

4. 验证安装是否成功：

   node -v
   npm -v
   

只要这两个命令能打印出版本号，就说明安装成功了！

第三步：安装并配置 ClawdBot

最简单的部分来了。ClawdBot 提供了一键安装脚本。在你的 Ubuntu 终端中运行：

curl -fsSL https://clawd.bot/install.sh | bash

脚本会自动下载必要的文件，并将 ClawdBot 全局安装到你的虚拟 Linux 系统中。

安装完成后，看到如下界面，说明已经安装成功了：

安装完成后，我们需要进行简单的快速配置

1. 启动设置向导的命令如下：

   clawdbot onboard
   

2. 按照提示操作：

   • Understand this is risky（同意风险）: 选 Yes.
   • Onboarding mode（启动模式）: 选 QuickStart.
   • Model provider: 按需选择，这里选择 Google Gemini.
   • API key: 粘贴你之前申请的 Google AI 密钥。
   • Defualt model: 按需选择，推荐选择 gemini-2.0-flash (速度快/成本低) 或 gemini-2.0-pro (更聪明)。
   • Select channel: 按需选择，推荐选择 Telegram.

第四步：配置 Telegram 机器人

选择 Telegram ，它会要求你输入 Bot Token。打开手机或电脑上的 Telegram，搜索 @BotFather。

发送消息 /newbot 给它，它会让你给你的机器人起个名字（例如 “My Jarvis”）和用户名（例如 my_private_clawd_bot）。BotFather 会给你一串 API Token（看起来像 123456:ABC-DEF...）。将这个 Token 粘贴回 Ubuntu 终端窗口中。

继续配置 Clawdbot ，Skills 和 Hooks 这些都可以先暂时跳过，监看方式 (how to hatch your bot) 可以按需选择，这里推荐直接在 命令行 (TUI) 上监看。

上面这些都配置完成后，你的 Clawbot 就正式开始运行了。

第五步：设备配对 (Pairing)

为了安全起见，你的机器人不会随便理睬陌生人。你需要将它与 你 的 Telegram 账号进行配对。

1. 确保 ClawdBot 正在终端中运行。打开 Telegram 中你刚才创建的机器人，点击 Start (或发送 /start)。
2. 机器人会回复一个 配对码 (Pairing Code)。
3. 回到你的 Ubuntu 终端。你应该会看到一个请求批准的提示。
4. 根据屏幕提示输入刚才的配对码批准命令。

🎉 成功！你的机器人上线，随时待命。

第六步：如何使用

现在，你可以直接在 Telegram 上与你的机器人聊天了。试试这些指令：

• “帮我总结这篇文章：” (粘贴一个文章链接)
• “提醒我 20 分钟后关烤箱。” (它到时候会主动给你发消息！)
• “东京现在的天气怎么样？”

如何保持后台运行

因为这个程序运行在你的电脑上，如果你关闭了 Ubuntu 窗口或关机，机器人就会下线。 为了让它在你使用 Windows 时保持后台运行，你可以：

1. 简单地将 Ubuntu 终端窗口 最小化（不要关闭）。
2. 或者在 Ubuntu 中学习使用 tmux 或 screen 等工具来保持会话。

常见问题排查

• 错误：“Command not found”： 确保你是在 Ubuntu (WSL) 终端中输入命令，而不是在 Windows 的 PowerShell 中。
• 机器人不回复： 检查终端里的日志。如果你看到 Gemini API 报错，可能是你的 Key 无效，或者因为请求过多触发了限制（如果用量大，可能需要在 Google Cloud 开启按量付费）。

享受你的新 AI 伙伴吧！ 与 ChatGPT 不同，它住在你的硬盘里，了解你的上下文，并且会在 它 觉得你需要知道某些事情时，主动联系你。

RedteaGo 的全球套餐有以下几点优势：

1. 有效期内（最长365天，可续费）可免费接收短信，注册各类 APP【仅全球套餐】

2. 支持全球130+地区（包括中国大陆）的漫游上网，且 IP 地址在欧洲，可以轻松登录 ChatGPT【仅全球套餐】

3. 价格低廉，100MB 保号套餐仅需 3.2 美元/年，若叠加邀请码赠金，则最低 2 美元（约合人民币15元）即可保号一年

4. 支持 eSIM，无需实体卡即可轻松激活

5. 无需实名登记

RedteaGo 的套餐可以在官方网站或者官方APP上直接购买，如果你的手机支持 eSIM，那么可以通过官方APP直接购买；如果你的手机不支持 eSIM，需要借助第三方实体 eSIM 卡，那么最好在官方网站上下单，因为只有官方网站下单的套餐才会提供 eSIM 二维码。

先用邮箱注册一个 RedteaGo 账号，注册时可以使用我的邀请码MASO0042，这样你和我都可以获得 3 美元的赠金，后续购买套餐时可以直接抵用。叠加邀请码赠金后，最低只要 2 美元就能保号一整年。

注册完成后，就可以选购套餐了。如果想要在购买套餐时使用上面的 3 美元赠金，一定要先往账户里充值，再购买套餐，因为如果购买套餐时账户余额低于套餐金额的话，就只能选择直接支付套餐金额，无法抵扣邀请码赠金，这点一定切记。

账户充值的最小金额是 2 美元，支付方式可以选择Apple Pay、国际信用卡或支付宝等，下图为 RedteaGo APP 内的充值演示。注意充值前先看好你想购买套餐的价格，确保充值金额+3美元赠金要大于套餐价格，才能在购买套餐时抵扣。

以最便宜的 3.2 美元套餐为例，用邀请码注册账号的初始余额为 3 美元（赠送），那么我们只要充值最低的 2 美元，即可拥有 3+2=5 美元的余额。购买套餐时选择用余额支付，则购买完成后，账户中还剩下 5-3.2=1.8 美元，可用于下次购买其他套餐使用。

充值完成后，就可以开始购买套餐了。这里我推荐以下三个套餐：

1. 全球（130+地区）100MB/365天 免费接收短信 3.2 美元（欧洲 IP）

2. 全球（130+地区）1GB/365天 免费接收短信 19.9 美元（欧洲 IP）

3. 中国大陆 50GB/365天 不支持短信 26.19 美元（香港 IP）

以上 3 个套餐均可在中国大陆漫游上网，其中全球套餐为欧洲 IP、中国大陆套餐为香港 IP。全球套餐带一个 +43 电话号码，可以免费收短信，中国大陆套餐没有号码，无法收短信，各位可以按需选择。可以看到，同样是 365 天有效的香港 IP 漫游，第 3 个套餐的价格仅为 190 元，远低于 268 元的 3HK 45G 的套餐（但比 3HK 少了电话号码和短信功能）。如果考虑邀请码赠送的 3 美元，那么最低 170 元即可拿下 50GB/365 天的漫游，岂不美哉~

套餐的激活方式也很简单，以支持 eSIM 的 iPhone 为例，直接点击激活按钮，按步骤操作即可。

激活成功后，可以看到手机左上角的运营上是 RedteaMobile，且套餐页面有套餐剩余的流量和有效期。

套餐自激活成功后开始计算有效期，不管是什么套餐，遇到以下条件之一即告失效，失效后必须重新购买套餐才能继续使用，且无法找回之前的电话号码：

1. 激活后连续 30 天未使用

2. 套餐内流量用尽

3. 套餐有效期结束

如果想在套餐失效前保留自己的电话号码，那么请务必记得在以上三个条件达成前续费套餐，否则一旦套餐失效，原先的号码也就离你而去了。

综上，RedteaGo 是一款能够以较低成本获得原生欧洲 IP 的海外手机卡产品，适合有特殊需求的用户，可以完美平替 3HK，且无需实名登记。最后，再次贴出我的邀请码：MASO0042，使用我的邀请码注册，你和我都能获得 3 美金的赠金，可以直接抵扣套餐费用。

然而，受自身承载能力和大规模黑客攻击的限制，Deepseek 的官方服务器在最近一段时间经常会出现连接不稳定的问题，这给用户带来了不便。所幸，Deepseek 大模型的开源属性使其能够被部署在任何第三方服务器上。硅基流动便是众多第三方 AI 大模型供应商之一，它与华为云合作，以低廉的价格，向用户提供Deepseek r1大模型的API接口应用。用户可以通过这一接口顺利使用 Deepseek 的模型功能。

获取第三方 Deepseek API

首先，我们需要在硅基流动的官网注册一个账号。你可以使用我的邀请码1MwHUt0X注册，这样，你和我都会得到 14 CNY 的免费额度，可以用来免费体验各个大模型的功能。如果免费额度用完，想要付费充值的话，就必须完成实名认证，这也是中国特色的监管要求。

登录硅基流动的后台，我们就能看到它所支持的一系列大模型，其中就包含当下最热门的 Deepseek R1。

想要调用这些大模型为我们服务，首先要生成我们自己的 API Key。点击硅基流动后台左侧的API 密钥，再点击右上角的新建 API 密钥按钮，来新建一个 API Key。

结合 Chatbox 使用 Deepseek R1 大模型

Chatbox 是一款开源的AI聊天机器人客户端，支持包括个人电脑和移动端几乎所有平台（包括网页端），能够调用多种AI模型，以实现文字对话、文生图、程序编写、文案创作等诸多用途。

出于数据安全与隐私保护的考虑，Chatbox 的所有运行数据都只存储在本地。也就是说，Chatbox 本身只是一个向AI大模型传递数据的工具，它本身并不记录用户的数据。因此，即使我们在不同设备上同时使用 Chatbox，也无法做到配置设置和历史记录的多设备共享。

硅基流动的官方文档中提供了将其API接入 Chatbox 的指引。这里简单讲一下配置的重点。软件安装好以后，第一次打开会自动弹出设置界面。选择"添加自定义提供方"，API 域名填写https://api.siliconflow.cn即可。更新版本的 Chatbox 已经原生支持了硅基流动的 API 接口，只要在模型提供方处选择SILICONFLOW API，再填写自己的 API Key，并选择想要调用的模型即可。

值得注意的是，硅基流动同时提供了Pro/deepseek-ai/DeepSeek-R1和deepseek-ai/DeepSeek-R1两个R1模型，只有不带Pro的那个模型支持消耗平台赠送的免费额度，带Pro的必须付费充值后才能使用，选的时候不要选错了。

配置好后点击保存，就可以开始和我们的AI大模型聊天了。Chatbox 软件内预置了很多好用的 Prompt 场景，可以都尝试一下。

结合VS Code的Cline插件使用Deepseek R1大模型

对于开发者，Visual Studio Code 是一个非常流行的代码编辑器，同时也支持丰富的AI插件。我们可以通过这些插件让 VS Code 调用硅基流动的 Deepseek R1 大模型 API，以实现AI辅助编程的应用。

下载和安装好 VS Code 软件后，在它的扩展市场中搜索“AI”相关插件，比如Cline，它是一款能够调用各种AI大模型来辅助用户编写程序的插件，可以提供超越代码完成或技术支持的帮助。Cline 支持 OpenRouter、Deepseek、OpenAI、Google Gemini 和 GCP Vertex 等 API 提供商。你还可以配置任何兼容 OpenAI 的 API，或通过 LM Studio/Ollama 使用本地模型。

打开 VS Code 软件，点击左侧的插件商店按钮，在搜索框中输入Cline，再搜索到的 Cline 页面中点击安装，即可在VS Code软件中安装 Cline 插件。

安装完成后，点击左侧多出来的 Cline 小机器人图标打开插件。点击插件右上角的设置按钮，开始配置我们的 API 接口。在对应位置选择或填写相应的内容即可。

• API Provider：OpenAI Compatible

• Base URL：https://api.siliconflow.cn/

• API Key：你的硅基流动API Key

• Model ID：deepseek-ai/DeepSeek-R1

最后点击保存，就可以开始通过和AI大模型聊天的方式进行代码编写了。Cline 支持一键创建目录和文件，只要使用得当，即使零基础的人也可以编写出对应需求的程序。

结语

由于 Deepseek 官方服务器偶尔出现连接不上的情况，我们仍然可以通过硅基流动的第三方 API 顺利使用 Deepseek R1 大模型。通过结合 Chatbox 和 VS Code 两大工具，我们不仅可以轻松进行 AI 对话，还可以获得专业的代码编写建议。

配置文件语法

Hugo 同时支持3钟配置文件语法，分别为 YAML、TOML和JSON。它们都是常用的数据序列化和配置文件格式，且各有特点和适用场景。

YAML (YAML Ain’t Markup Language)

YAML是一种人类可读的数据序列化格式，常用于配置文件和数据交换，它的语法格式为：

name: John Doe
age: 30
city: New York
hobbies:
- reading
- traveling

它的特点为：

• 语法简洁，易于阅读和编写

• 支持注释、多行字符串和复杂的数据结构

• 使用缩进表示层级关系

TOML (Tom’s Obvious, Minimal Language)

TOML是一种旨在成为最小配置文件格式的语言，设计目标是易于阅读和编写，它的语法格式为：

[person]
name = "John Doe"
age = 30
city = "New York"
[person.hobbies]
favorite = "reading"
others = ["traveling", "photography"]

它的特点为：

• 语法直观，易于理解

• 支持注释

• 支持多种数据类型，包括日期时间

• 允许创建嵌套的数据结构

JSON (JavaScript Object Notation)

JSON是一种轻量级的数据交换格式，最初源于JavaScript，但现在已广泛应用于各种编程语言，它的语法格式为：

{
  "name": "John Doe",
  "age": 30,
  "city": "New York"
}

它的特点为：

• 简洁易读

• 解析速度快

• 与JavaScript高度兼容

• 支持基本数据类型：字符串、数字、布尔值、null、对象和数组

综合考虑易读性及与当前主题的兼容性，我选择的配置文件语法为YAML，以下所有配置命令，都将以YAML格式呈现。值得注意的是，YAML对缩进非常敏感，在利用 Hugo 进行渲染时，哪怕某一行少了一个空格，都会渲染失败，所以要特别注意。

添加文章时间轴页面（Archives）

在/Content/目录下新建archieves.md，写入以下内容：

---

title: "Archive"
layout: "archives"
url: "/archives/"
summary: archives

---

添加搜索页面（Search）

第1步：在配置文件config.yml中添加以下内容：

outputs:
  home:
    - HTML
    - RSS
    - JSON # 搜索页所必需

第2步：在/Content/目录下新建archieves.md，写入以下内容：

---
title: "Search" # 以你想要的任何语言
layout: "search" # 搜索页所必需
# url: "/archive"
# description: "Description for Search"
summary: "search"
placeholder: "在此输入搜索关键词"
---

添加菜单

在配置文件config.yml中添加以下内容：

menu:
  main:
    - name: 文章
      url: archives
      weight: 5
    - name: 搜索
      url: search/
      weight: 10
    - name: 标签
      url: tags/
      weight: 10
    - name: 关于
      url: about/
      weight: 10

启用 Emoji ✅

Hugo 原生支持 Emoji 渲染，只要在配置文件config.yml中添加以下内容：

enableEmoji: true

这样，只要在.md文件中输入符合 Markdown 语法的:emojiname:（两个半角冒号中间写上 Emoji 名称），即可输入一个 Emoji。你可以在这个列表中查询 Markdown 语法中的 Emoji 名称。

添加 Favicon 图标

可以参考我的这篇文章，访问这个网站，将你喜欢的站点图标图片转换成Favicon专用格式，将生成的所有文件放入/static/目录下。

可选：如果想将图标文件放入/static/的子目录下，例如/static/favicon/，则还需在配置文件config.yml中添加以下内容：

params:
  assets:
    favicon: "/favicon/favicon.ico"
    favicon16x16: "/favicon/favicon-16x16.png"
    favicon32x32: "/favicon/favicon-32x32.png"
    apple_touch_icon: "/favicon/apple-touch-icon.png"
    safari_pinned_tab: "/favicon/safari-pinned-tab.svg" 

启用代码复制按钮

在配置文件config.yml中添加以下内容：

params:
  ShowCodeCopyButtons: true

翻页按钮显示页数

在配置文件config.yml中添加以下内容：

params:
  ShowPageNums: true

文章列表页面添加RSS订阅按钮

在配置文件config.yml中添加以下内容：

params:
  ShowRssButtonInSectionTermList: true

RSS Feed 输出全文

在配置文件config.yml中添加以下内容：

params:
  ShowFullTextinRss: true

以新标签页打开站外链接

在/themes/主题名/layouts/_default/_markup/目录下新建render-link.html，写入以下内容：

<a href="{{ .Destination | safeURL }}"{{ with .Title}} title="{{ . }}"{{ end }}{{ if strings.HasPrefix .Destination "http" }} target="_blank" rel="noopener"{{ end }}>{{ .Text | safeHTML }}</a>

自定义超链接样式

PaperMod 主题支持自定义CSS，我们可以通过自定义CSS改变网站默认的超链接样式，如颜色、下划线，以及鼠标悬停时的变化等。

在/themes/主题名/assets/css/extended/目录下新建custom.css，写入以下内容：

.post-content a {
  color: #0969da;
  box-shadow: none;
  text-decoration: none;
}

.post-content a:hover {
  text-decoration: underline;
}

这段代码会将文章内容中的超链接颜色设置为蓝色(#0969da)，并在鼠标悬停时添加下划线。

SEO 优化相关

SEO (Search Engine Optimization) 是一种通过优化网站内容和结构来提高网站在搜索引擎结果页面中自然排名的方法。SEO的目标是增加网站的有机流量，提升网站的可见度，吸引更多目标受众。要为 Hugo 站点做 SEO 优化，我们需要做好以下工作：

配置文件优化

在配置文件config.yml中添加网站描述：

params:
  description: "您的网站描述"

同样，我们也可以为每篇文章设置标题、关键词和描述，在.md文件的头部添加以下内容，来定义文章的基本信息：

---
title: "文章标题"
keywords:
  - 关键词1
  - 关键词2
description: "文章描述"
---

创建 sitemap 站点地图

站点地图是一个重要的网站文件，它为搜索引擎和用户提供了网站结构的概览。要为 Hugo 站点创建站点地图，在配置文件config.yml中添加以下内容：

sitemap:
  changefreq: weekly
  filename: sitemap.xml
  priority: 0.5

其中，changefreq表示更新频率，filename表示生成的站点地图文件名，priority表示页面的默认优先级。这样，Hugo 会在网站根目录下生成一个sitemap.xml文件，以便搜索引擎了解网站结构。

创建 robots.txt 爬虫索引

Robots.txt是一个位于网站根目录的纯文本文件，用于将站点地图提交给搜索引擎，指导搜索引擎如何访问和索引网站内容。要为 Hugo 站点创建robots.txt，在配置文件config.yml中添加以下内容：

enableRobotsTXT: true

这样，Hugo 会自动在网站根目录下生成Robots.txt文件。

参考链接

Introduction | Hugo

Home · adityatelange/hugo-PaperMod Wiki

折腾 Hugo & PaperMod 主题 - Dvel’s Blog

搭建 Hugo 个人网站｜PaperMod 主题 | ed

PaperMod主题配置 | 🚀 田少晗的个人博客

我在2022年4月的一篇文章中介绍了 Home Assistant 的安装与配置方法。彼时，要将小米的众多智能家居接入 HA，我们必须安装一个第三方 HA 集成，即 Hass-Xiaomi-Miot。它由个人开发者 al-one 在 Github 上发布，一直以来都是我们将米家接入 HA 的唯一选择。直到最近，小米在 Github 上发布了官方的 HA 集成：HA_Xiaomi_Home，填补了米家接入 HA 的空白。

虽然这又是一个“官方逼死同人”的故事，但小米的开源精神仍然值得称赞。与第三方集成相比，小米官方的集成对自家产品支持更好， 能够帮助我们更加轻松地将米家接入 HA，进而实现米家与 Homekit 生态的互联互通。今天，我们将跟随 HA_Xiaomi_Home 的官方文档，详细介绍一下这个集成的安装及使用方法。

通过 HASC 安装米家官方集成

米家官方集成有多种安装方式，其中最简单，也是最新手友好的方式，就是通过 HACS 进行安装。HASC 的安装方法详见我的这篇文章，此处不再赘述。由于米家官方集成暂未加入 HASC 的官方库，我们需要通过添加自定义库链接的方式，将米家官方集成的库链接添加到 HASC 目录。登入 HA 后台，点击左侧的HASC，再点右上角的三个点，选择Custom Repositories，新建一个自定义库链接，如下图所示。

库类型（Catagory）选择Integration；库链接填写下面的链接：

https://github.com/XiaoMi/ha_xiaomi_home.git

最后点击ADD按钮，如果网络没有问题的话，米家官方集成的安装链接就会被添加到 HASC 的自定目录中。再依次点击设置—设备与集成—添加集成，在搜索框中输入Xiaomi，在弹出的结果中选择XIaomi Home。接下来，按照提示登录米家账号即可。

注意⚠️：如果你和我一样，使用 Docker 作为 HA 的安装环境，那么大概率会在米家账号验证时遇到无法跳转的问题。无法跳转的核心原因在于，米家官方集成默认使用 homeassistant.local:8123这个本地域名来跳转回 HA 页面，而 Docker 容器中的 HA 无法在本地局域网中广播.local本地域名。因此，在验证米家账号并跳转回 HA 页面时，我们需要手动将浏览器地址栏中的homeassistant.local:8123改为IP:8123。这样就能完成米家账号的验证工作。以上方法参考自米家集成仓库的 Issue#8。

停用多余的米家实体

当我们安装好米家官方集成并完成账号验证后，HA 就会自动搜索并添加米家的各种设备。同时，我们的家庭中会出现一堆乱七八糟的实体。所谓实体（Unit）是 HA 用来定义设备最小子功能单元的概念。通常一个设备会对应多个实体。例如，一台『热水器』设备，可以同时拥有『当前水温』、『目标水温』、『预热开关』、『增压开关』等多个实体。

然而在日常使用过程中，我们并不需要将每一个设备都拆分成诸多零碎的子功能单元，这样不仅使人迷惑，还会让我们的家庭界面变得极其繁琐。因此，在将 HA 链接到 Homekit 之前，我们需要对米家集成添加进来的众多实体进行筛选，仅保留我们日常使用过程中最需要的开关和数值即可。

依次点击设置—设备与集成—实体，在列表中点击我们不需要的实体，在弹出的对话框中关闭该实体，最后点击保存。这样，我们便停用了一个不需要的实体。

将 HA 桥接到 Homekit

筛选掉不需要的米家实体后，我们就可以将 HA 桥接到 Homekit 了。对于大多数人而言，将米家接入 HA 的唯一目的，便是实现米家与 Homekit 的联通。Homekit 是苹果原生的智能家居协议，能够让用户在 iOS、Mac 和 Apple Watch 等苹果设备上直接操控家中的电器，而无需借助第三方 APP。众所周知，Homekit 家居生态远不如米家繁荣，且支持 Homekit 协议的产品价格大多高昂。因此，如果将米家生态接入 Homekit，便能实现便利性与性价比的两全。而 HA 正是联通米家与 Homekit 的最佳桥梁。

将 HA 实体桥接到 Homekit，我们需要安装另一个集成：Homekit Bridge。依次点击设置—设备与集成—添加集成，在搜索框中输入Homekit Bridge，再按提示安装即可。安装完成后，HA 通知栏会弹出一个二维码。打开苹果设备的 Home APP，点击右上角加号——添加配件，扫描通知中的这个二维码，就能将 HA 上现有的实体全部桥接到 Home APP中了。

经常折腾家里网络的你，一定经常遇到这些问题：

1. 为什么明明插上了网线，却打不开路由器的后台？
2. 为什么 NAS 的 IP 地址经常变化？
3. 为什么用上了高价的软路由，打开网页的速度反而变慢？
4. 为什么跟着大佬的视频一通配置，却还是玩不转旁路由？

以上这些问题其实都和 DHCP 有关。

什么是 DHCP？

DHCP 是 Dynamic Host Configuration Protocol 的缩写，意思是动态主机配置协议。它的作用，是为每一个接入局域网的设备自动分配一个 IP 地址，并为这些设备自动配置默认网关和 DNS 服务器。

名词解释

如果你不理解网关和 DNS 是什么意思，也不要紧。你可以把网关理解成一个中转站，局域网内的所有设备都要通过这个中转站来与外界联系，而家用网络的网关通常只有一个，那就是路由器。DNS 则要更加复杂一点，我后面会单独制作一期视频来讲解。这里你只要把它理解成一个“电话簿”就可以了。

DHCP 的工作原理

DHCP 协议由一个服务端，和多个客户端组成。服务端一般就是你的路由器，而客户端就是你用来上网的设备。

Discoer

每当一个新设备初次连入局域网，它就会向整个网络广播自己的 MAC 地址。所谓的 MAC 地址，是每个设备的硬件地址，它被写在设备的网卡上，一般情况下无法更改，相当于设备的“身份证号码”。当新设备初次连入，它会向局域网广播自己的 MAC 地址，相当于新员工的自我介绍。这段自我介绍有一个很洋气的名字，叫做 Discover。

Offer

当路由器接收到新设备的广播，就会在现有的 IP 地址中，挑选一个还没有被其他设备占用的空缺地址，并将这个地址和其他配置信息（比如默认网关和 DNS）打包发给这个设备，相当于领导给新员工安排工位。这段安排也有一个非常洋气的名字，叫做 Offer。

Request

接下来的事情就非常简单了，当设备收到路由器发出的配置信息，并且决定套用这些配置，会再次答复路由器，相当于接受领导的安排。这段答复同样有一个很洋气的名字，叫做 Request。

这里要注意一点，如果局域网内有两个以上路由器，并且这些路由都开启了 DHCP 服务，那么它们在收到新设备的广播后，会同时给这个设备发送配置信息。当设备同时收到多个配置信息，会优先回复最先收到的那个。因此，为了避免网络混乱，即使你家里有多个路由器，也最好只开启一个 DHCP 服务。

ACK

回到正题，当路由器收到设备的肯定答复后，就会再给设备回个话，表示占位成功。这时，设备会根据路由器下发的 IP 地址、默认网关和 DNS 服务器，自动配置自己的网络，实现成功联网。路由器的这个回话，叫做 ACK。

解答问题一

说到这里，我们就解决了视频开头提到的第一个问题：

• 为什么明明插上了网线，却打不开路由器的后台？

这里有两种可能： 1. 你的路由器没有开启 DHCP 服务，你的电脑没有收到路由器下发的 IP 地址。 2. 你的路由器开启了 DHCP 服务，但你的电脑之前设置了静态 IP 地址，而这个静态地址和路由器的地址，不在同一个网段。

要解决”打不开后台“的问题，方法也很简单： 1. 如果是第一种情况，那么我们就要先在电脑上手动配置一个静态 IP 地址，并且这个地址要和路由器在同一个网段。比如路由器的 IP 地址是 192.168.31.1，那么电脑的静态地址就要设置成 192.168.31.x，这里的 x 可以是 2~255中的任何一个数字，但要注意不能和其他设备重合。 2. 如果是第二种情况，那么我们就要清除电脑的静态 IP 地址，并将 IP 地址的获取方式改为”自动获得 IP 地址“。这样，我们的电脑就会重新接受 DHCP 服务的分配。

NAK 报文

再次回到正题，上面提到的这一整个流程，都是新设备初次连入局域网的流程。如果不是初次连入的新设备，而是之前连过的老设备，断开后重新连入，就会跳过前两个步骤，直接从 Request 切入，相当于老员工离职后又重新回归，直接省略客套的过程，让领导给个工位。

这时，路由器会检查之前的 DHCP 租约表。如果设备之前对应的 IP 地址仍然空缺，则照旧返回一个 ACK。租约继续有效，设备继续沿用之前的 IP 地址。如果设备之前对应的 IP 地址已被其他设备占用，则只能拒绝设备的这次请求。那么这个拒绝的动作，叫做 NAK。

解答问题二

说到这里，我们又解决了视频开头提到的第二个问题：

• 为什么 NAS 的 IP 地址经常发生变化？

原因就是，NAS 关机下线期间，原本占用的 IP 地址空缺出来，并被其他设备占用，当 NAS 重新开机上线时，路由器只能为它重新分配一个新的 IP 地址。这时候我们就会找不到 NAS 的后台，而要借用 Synology finder 这类软件才能重新搜索到 NAS 的新地址。

要解决这个问题也很简单，那就是开启路由器的 IP/MAC 绑定，将某个固定的 IP 地址分配给特定的 MAC 地址，做到”一个萝卜一个坑“，这样就不会发生混乱了。

DHCP 的应用

知道了 DHCP 的工作原理，我们就可以解决上网过程中的很多问题。

解答问题三

• 为什么用上了高价的软路由，打开网页的速度反而变慢？

打开网页的速度很慢，或者明明 QQ 可以联网，但网页却死活打不开，多半是因为 DNS 服务器出了问题。我们家用网络的 DNS 服务器，一般是通过光猫从运营商处获得，再经过路由器的 DHCP 服务层层下发。如果我们在路由器的 DHCP 服务里没有指定 DNS 服务器，那么路由器就会默认适用运营商的 DNS，众所周知，运营商的 DNS 经常被劫持，用起来既不安全也不稳定。

所以，要解决”浏览网页慢“的问题，我们可以在路由器的 DHCP 服务里，手动指定一个稳定的 DNS 服务器地址，让局域网里的所有设备，都套用路由器 DHCP 下发的 DNS。至于有哪些好用的公共 DNS 服务器，网上一搜一大堆，比较常见的，国外的有著名的谷歌 8.8.8.8，国内的有阿里 223.5.5.5 等。

随着智能家居的日益普及，各大互联网巨头纷纷进场，导致智能家居的平台和品牌越来越多，且各个平台和品牌间的产品无法互通。例如，你无法用米家的智能开关来控制 homekit 的智能灯，除非你的产品支持双平台，但目前同时支持两个以上平台的智能家居少之又少。

Home Assistant（以下简称 HA）很好地解决了智能家居平台不互通的问题，它是一个开源的智能家居集成平台，可将各个常见平台的产品接入，并通过网页、手机app等多种客户端统一操控，实现真正的「万物互联」。并且最重要的是，这么好用的工具不仅支持 Windows、MacOS、Linux 等多种操作系统，其本身也是开源免费的，并且其极高的扩展性也为爱折腾的数码爱好者提供了全新的研究对象。

通过 Docker 部署 HA 容器

正如前文所述，HA 支持多种操作系统，但如果我们打算将其作为 7x24 小时待机的智能家庭中枢，那么最好的选择就是 Linux 系统，因为它可以运行在诸如树莓派这类低功耗的设备上，随时准备着为我们提供服务。

提到 Linux，我们就不得不提 Docker，它是一种兼容性极高的容器系统，可以适应几乎所有 Linux 环境，做到即装即用。今天，我们将着重介绍通过 Docker 容器部署 HA 的方法。

我的这篇文章详细介绍了 Portainer 这个非常好用的 Docker 管理容器，由于每位读者的系统环境不尽相同，因此本博客往后介绍的所有 Docker 容器安装，不再拘泥于群晖、威联通或者 Unraid，而是统一通过 Portainer 进行。

Portainer 本身的安装可以参考上面提到的文章，本文不再赘述。要安装 HA，我们首先需要登录 Portainer 后台，然后进入本地终端界面，也就是 Local，接着点击左侧的 Containers，进入本地容器管理界面。

点击 Add container，创建一个新容器，Name 随便填，Image 写 HA 官方提供的映像索引 homeassistant/home-assistant:latest，Always pull the image 可以打开，这样以后每次修改容器配置，都会从服务器重新拉取最新的映像。

接着点击下方 Advanced container settings 中的 Volumes，进入目录映射选项卡，点击 map additional volume 按钮新增一个目录映射，右侧的映射方式选 bind，container 里的目录只能写 /config，这是 HA 配置文件的所在目录，host 上的目录可以根据自己需要填写。

继续点击 Advanced container settings 中的 Env，进入环境变量选项卡，点击 add environment variable 按钮新增一条环境变量，左侧的 name 填写 TZ，右侧的 value 填写 Asia/Shanghai，这是将 HA 的默认时区（Time Zone）设置为亚洲/上海。

剩下的高级设置就比较简单了，Network 设置成 host，Restart policy 设置成 Always 即可。最后点击 Deploy the container，等待一段时间，如果网络连接通畅的话，即可完成 HA 容器的部署。

HA 的后台默认端口是 8123，因此只要我们在局域网中访问 HA 运行设备的 ip地址:8123 即可登录 HA 的网页端。初次打开 HA 网页端需要进行一些基本的初始化配置，例如用户名、密码这些，此处不再赘述。需要注意的是，HA 管理员账户的密码无法找回，如果我们忘记此处设置的密码，后面只能通过重装容器的方式解决。

安装 HACS 集成

HACS 的全称是 Home Assistant Community Store，是一个 HA 社区商店，里面提供了各种外观主题，以及第三方集成的下载，使用起来非常方面，建议所有 HA 用户安装。

要安装 HACS，首先需要将它的安装包放入 HA 容器。在 HA 映射的 /config 目录中创建两个新目录，名称分别为 www 和 custom components，点击这里下载 HACS 安装包，将压缩包内的 hacs 目录解压到刚刚创建的 personal components 目录，然后重启 HA 容器。登录 HA 网页端，依次点击左下角配置—设备与服务—集成，进入集成选项卡。

点击右下角的添加集成按钮，搜索 HACS，点击安装 HACS 集成，接着按照提示走流程就能顺利安装。安装过程中需要跳转登录一次 Github，如果没有账号需要注册一个。此外就是安装过程需要科学的网络环境，这个只能靠各位自行解决。安装完成后再次重启 HA 容器。不出意外的话，网页端的左侧会多出一个 HACS 按钮，点击它就能进入 HACS 的商店界面了。

将米家接入 HA

以往，要将小米的众多智能家居接入 HA，我们必须安装一个第三方 HA 集成，即 Hass-Xiaomi-Miot。它由个人开发者 al-one 在 Github 上发布，一直以来都是我们将米家接入 HA 的唯一选择。直到2024年12月，小米在 Github 上发布了官方的 HA 集成：HA_Xiaomi_Home，填补了米家接入 HA 的空白。

虽然这又是一个“官方逼死同人”的故事，但小米的开源精神仍然值得称赞。与第三方集成相比，小米官方的集成对自家产品支持更好， 能够帮助我们更加轻松地将米家接入 HA，进而实现米家与 Homekit 生态的互联互通。小米官方集成的安装与使用方法详见我的最新文章，此处不再更新。

随着版本的不断迭代，Jellyfin 已经逐渐超过 Plex 和自家兄弟 Emby，成为用户数量最所的个人媒体管理方案，这不仅因为它的所有功能均为免费，更是因为它的源代码完全开源，具有极高的维护与拓展空间。

不论用于运行 Jellyfin 的具体是哪款操作系统，只要该系统是基于 Linux，我们就可以通过 Docker 容器来实现极为简单且方式一致的部署。但相比于原生套件，Docker 有一个显而易见的缺点，即无法直接调用各类系统资源，核显驱动就是其中之一。

要让 Jellyfin 的 Docker 容器实时调用核显驱动（也就是人们常说的开启硬解），要满足两个条件：

1. 拥有支持视频解码的核心显卡，且核心显卡的驱动程序运行正常；
2. 将核显驱动直通给 Docker 容器，并赋予 Docker 容器调用该驱动的权限。

对于系统是否满足上述第一个条件，可以通过以下方式进行检验：首先用 ssh 工具连接到服务器，确保登陆 ssh 的账户拥有系统管理权限，再输入以下命令：

ls /dev/dri

如果返回的结果为 card0 renderD128 ，那么恭喜，核显驱动运行正常，硬件系统满足视频解码的基本条件。接下来便是将 renderD128 这个核显驱动直通给 Docker 容器的方法。

为什么必须用 Portainer?

无论是群辉、威联通还是 Unraid，市场上绝大多数 NAS 系统都提供了图形化的 Docker 容器管理工具。但无论上述哪一个，都不支持核显驱动的直通功能。群辉的 Docker 套件无法编辑容器的系统资源参数，威联通的 Container Station 干脆无法编辑已经创建好的容器。

这里所说的“直通”，其实是将 /dev/dri/renderD128 这个驱动文件映射到 Docker 容器的相同位置。这一点利用命令行可以非常轻松地实现，即在 Jellyfin 容器的拉取命令中加入下列参数：

--device=/dev/dri/renderD128 \

因此，要快速拉取并创建一个开启硬件解码的 Jellyfin 容器，只要在 NAS 的命令行界面输入以下命令即可：

sudo docker run -d --name jellyfin \
-v /share/Container/Jellyfin/config:/config \ #冒号左边为存放配置文件的目录
-v /share/Container/Jellyfin/cache:/cache \ #冒号左边为存放媒体缓存的目录
-v /share/Media/:/media \ #冒号左边为存放电影文件的目录
-p 8096:8096 \ #web界面访问端口（http）
-p 8920:8920 \ #web界面访问端口（https）
--device=/dev/dri/renderD128 \ #映射核显驱动
--restart=always \ #重启策略
jellyfin/jellyfin

但对许多轻度用户来说，命令行不仅不便理解，也断绝了后续对容器进行修改和自定义的空间。因此对于绝大多数日常用户来说，我个人强烈推荐使用 Portainer。它本身也是一个运行在 Docker 容器里的程序，但它拥有强大的 Docker 管理功能，是目前市面上功能最完善的网页端 Docker 容器管理界面。

因此，对于那些既不想用命令行，又希望对 Docker 有较为全面管控的用户来说，Portainer 几乎是唯一的选择。通过 Portainer，即使是初学者也能轻松为 Jellyfin 开启硬件解码。

Portainer 的安装与使用

由于 Portainer 需要调用 /var/run/docker.sock 这个文件以实现对 Docker 的直接管理，因此 Portainer 也无法通过群辉或威联通自带的 Docker 管理界面进行安装，因为上述管理界面均不支持针对单个文件的映射。但由于 Portainer 需要配置的参数较少，且容器创建完成后不需要频繁修改，因此普通用户可以直接复制一以下命令进行安装。

sudo docker run -d --name prtainer \
-v /var/run/docker.sock:/var/run/docker.sock \ #关键
-p 9000:9000 \ #web界面访问端口
--restart=always \ #重启策略
portainer/portainer

容器创建完成后，即可通过 IP:端口的方式访问 Portainer 的管理界面，Portainer 的默认访问端口是 9000。初次登陆需要设置管理员账号和密码。

因为是单机使用，所以连接模式选择“local”，然后点击“Connect”即可连接到服务器上的docker。

配置完成后，再次点击 local，选择左侧的 Container 便可使用 Portainer 对系统上现有的所有 Docker 容器进行管理了。

安装 Jellyfin 并直通核显驱动（开启硬解）

后续的安装及配置过程都将在 Portainer 界面上完成。首先点击“Containers”选项卡上的“Add container”按钮添加新容器，进入容器创建界面。

“Name”随便写，“Image”填写 Jellyfin 官方的 Docker Hub 映像路径 jellyfin/jellyfin，“Always pull the image”可以打开，这样当我们配置完成创建容器时，Portainer 会自动从 Docker Hub 拉取最新的官方映像。

“Network ports configuration”处选择“Manual network port publishing”，点击“publish a new network port”创建两个端口映射，分别是 8096 和 8920，作为 Jellyfin 网页界面的访问端口。

接着点击“volumes”选项卡，进行容器内目录的映射。Jellyfin 默认需要映射的目录分别是 /media、/cache 和 /config，点击“bind”按钮选择服务器上对应的目录进行映射。

“Network”选择“host”，“Restart policy”选择“always”。最重要的是，“Runtime & Resources”处一定要点击“add device”，两边分别输入 /dev/dri/renderD128，这是开启硬解的关键步骤。

以上配置完成后，即可点击“Deploy the container”按钮创建容器。如果网络环境较好，等待半分钟左右即可完成容器的创建。至此，我们不仅手动配置完成了 jellyfin 的 Docker 容器，还将核心显卡的驱动文件直通给了该容器。最后，只要进入 Jellyfin 的控制台，在“播放”选项卡中，将“硬件加速”类型选为“Video Acceleration API (VAAPI)”，并在“VA API 设备”处填写 /dev/dri/renderD128，即可调用服务器的核显驱动进行硬件解码了。

经常访问本博客的读者可能会注意到，我所使用的 Hugo 主题是一个支持自动切换明暗模式的第三方主题——AutoFuji. 今天在阅读这个主题的说明文档时，我发现原来它是支持 Favicon 图标代码的。于是经过一通简单的操作，我的博客终于有了自己的图标。

为 Hugo 站点添加 Favicon 代码的方法非常简单。首先访问这个网站上传一张图片作为网站图标的母本。其实类似的 Favicon 生成器还有很多，大家可以根据自己的习惯或喜好自由选择，基本功能都是一样的。

图片上传完成后，会自动跳转到参数配置页面。如无特殊需求，保持默认配置即可。点击页面下方的生成按钮生成我们的图标和代码。

生成完成后，点击如图所示按钮下载各类格式的图标包，再将自动生成的 HTML 代码复制到剪贴板。

之后，来到 Hugo 站点的根目录，将刚刚下载的压缩包里的所有文件解压到 /static/ 文件夹下。

用文本编辑器打开 /layouts/partials/favicon.html 文件，清空原有代码，将刚刚复制到代码粘贴进去，保存并退出。

最后，打开 /themes/正在使用的主题名/layouts/partials/head.html 文件（不同主题需要编辑的文件可能不同，例如我所使用的 Fuji 主题就是直接编辑同一目录下的 favicon.html 文件），找到下列代码：

<link rel="shortcut icon" href="xxx" />

将 xxx 替换成 favicon.ico ，保存并退出即可。

此时，我们的 favicon 图标安装工作就宣告完成了。使用 hugo 命令重新生成站点，不出意外的话，就能看到我们刚才上传的站点图标了。

实现原理其实很简单，只要在现有 DHCP 服务端正常工作的前提下，为软路由的 WAN 口再行分配一个与光猫网段相同的 IP 地址即可，前提是你的软路由支持多 WAN。

以 Openwrt 系统为例，在“网络—接口”界面点击“添加新接口”，进入新接口创建页面。

接口名称随意填写，接口协议选择“静态地址”，包括的接口选择当前 WAN 口绑定的物理接口。注意，接口协议尽量不要选择 DHCP，因为桥接模式下的光猫基本都会关闭自身的 DHCP 功能，不会给新接口自动分配 IP 地址，所以此时需要通过“静态地址”协议来手动指定新接口的 IP 地址。完成上述配置后，点击“提交”按钮进入新接口的详细配置页面。

IPv4 地址一定要设置成与光猫位于相同网段的地址。例如光猫连接软路由的 LAN 口的地址（即光猫后台地址）为 192.168.1.1，那么这里新接口的静态 IP 地址就要设置为 192.168.1.x。子网掩码设为 255.255.255.0，默认网关就是光猫 LAN 口的 IP 地址。有关 IP 网段和子网掩码的相关知识，可以参考这篇文章。完成上述设置后，点击“保存&应用”按钮即可完成配置。

新接口配置完成后，DNS 缓存会有一定延迟，导致无法正常浏览网页，此时重启一下软路由即可解决问题。如果软路由之前配置了端口映射，则新接口创建完成后，所有的端口映射都将失效，此时仍需经过一番针对防火墙的额外设置才能恢复正常。

重新进入新接口的详细设置页面，在“防火墙设置”中，将原先 WAN 口的防火墙区域绑定到新接口。

然后进入“网络—防火墙—端口转发”页面，将原有的端口映射配置重新“保存&应用”一下即可。

至此，如果不出意外的话，我们便可在桥接模式下随时随地访问光猫的后台管理界面了。

因此，我纠结许久，终于决定以后不再购买任何单机游戏。如果某段时间我不是那么忙了（例如辞职在家的现在），就去订阅一个月的 XGP，体验一下最新的单机游戏。事实上，Xbox 账户是可以随时切换区域的。因此我们可以简单地通过将 Win10 的系统区域切换成香港的方式来享受港区 XGP 79 港元每月（首月10港币）的优惠价格。在一个单机游戏动辄就要三百块以上的当下，XGP 确实是一种非常合算方案。毕竟，一个月的时间，完全够我通关一个中型单机游戏，而买断这款游戏的价格远远不止 79 港币。

开通了 XGP 之后，我又开始琢磨如何在出差的时候利用“零碎的时间”玩游戏。例如驻场期间每天下班以后，住在酒店里的我只有一台性能羸弱的 MacBook，如何利用现有设备在酒店里玩上 XGP 上的单机游戏呢？其实解决方案只有一个：远程桌面。只要在家里的 PC 上开启网络唤醒功能，在将某款远程桌面软件设置成开机自动启动，我就可以在任何地方，通过网络唤醒 + 远程操控的方式随时随地游玩家里电脑上的游戏。

思路虽然很简单，但找到合适的远程桌面软件着实费了我一番工夫。经过仔细的搜索，我发现了一款叫做 Parsec 的远程桌面软件。它不仅同时支持 Windows 和 macOS 双平台，还专门针对远程游戏进行了优化。不仅如此，Parsec 还支持 Hevc 编码。只要客户端设备支持 Hevc 解码，就能大大降低串流数据体积，减少网络带宽和流量的消耗，提升远程游戏的体验。

Parsec 的使用方式非常简单，只要去官网注册一个账号并分别在服务端（用于运行游戏的设备）和客户端（用于远程操控的设备）下载安装 Parsec 客户端即可。在两台设备上同时安装并登陆软件后，软件界面应该是这样的：

此时只要点击相应设备上的 Connect 按钮即可建立远程连接了。但为了提升我们的游戏体验，在正式使用前还需要进行一些简单的设置。点击左侧的齿轮图标进入设置界面，将客户端设备的“硬件解码”和“Hevc 编码”功能打开即可。

连接成功后，软件会自动将被操控的设备调至静音，而将所有系统声音转到操控的设备上播放，这一细节非常人性化。经测试，在局域网（千兆带宽）环境下，两台设备基本可以实现零延迟的远程控制，但在广域网环境下，由于带宽和延迟的限制，远程控制略有延迟和卡顿，但仍能满足一些对操作要求不是那么高的游戏。例如，我最近正在补完的《歧路旅人》。这是一款“高清马赛克”游戏，且所有战斗均为回合制，非常适合远程游玩。

由于 macOS 原生支持 Xbox 和 switch pro 手柄，同时 Parsec 也能直接识别上述两款手柄的所有按键，因此在远程游戏时，可以直接通过将手柄连接客户端设备的方式来操控服务端的游戏。网络状况较好的时候，远程游戏的体验和本地几乎没有区别。

昨天心血来潮，想把放在角落吃灰许久的蜗牛星际B双刷成黑群晖，用作重要数据的冷备工具，平常都会处于关机状态，只有冷备的时候才会开机。由于我的B双之前一直都用作软路由，因此从来都没有刷过黑群晖。但鉴于蜗牛星际的配置都差不多，我简单地以为直接用之前C上现成的黑群晖引导U盘即可直接安装黑群晖系统。然而天真的我还是遇到了困难。

问题出在新系统安装的过程中，每当进度走到 56% 的时候，都会跳出编号为 13 的错误，提示“系统安装失败，文件可能已经损毁（13）”。为了解决这一问题，我尝试了很多方法，包括但不限于格式化所有硬盘（包括 SSD）以及更换各个版本的官方或非官方 DSM 安装包，但都不奏效，错误 13 依然存在。

最后，在电报群里高人的指点下，我终于解决了这一问题。其实，新系统安装的过程中之所以会出现错误 13， 是因为机器主板的 BIOS 没设置好。只要给主机插上键盘和显示器，在开机时进入 BIOS 界面（通常是在开机后显示主板厂商 logo 时按键盘上的 DEL 键进入），然后依次进入 Advanced—Miscellaneous Configuration—OS Selection，将 Win 7 改为 Win 8.x 即可。

忙活了半天，最后才知道原来只是这么简单的一个问题。为了不让后来的小白们像我一样浪费时间，特此记录一下。本文也谈不上什么教程了。

简单来说，luci-app-openvpn-server 就是 Openvpn 服务器端的 Luci 界面版本。有了它，你就可以告别难搞的命令行，通过图形化的网页直接配置你的 Openvpn 服务器端。结合各主流平台的 Openvpn 客户端软件，你可以随时随地接入自己家里的局域网，实现内网访问或文件传输等功能。

正常情况下，只要按照 Luci 界面的提示填写相应的配置信息，即可成功运行 Openvpn 的服务器端。此时只要点击“一键下载.Ovpn 文件”按钮，再将下载下来的配置文件直接导入 Openvpn 客户端软件即可开始使用。但 luci-app-openvpn-server 的默认配置支支持同时登陆一个客户端，当有第二个客户端尝试接入时，先前接入的第一个客户端就会被强制断线。然而在日常使用的过程中，多设备同时接入的情况是十分常见的，那么怎样才能使 luci-app-openvpn-server 可以同时接入多个设备呢？

其实，Openvpn 的服务端是支持多设备同时接入的。根据 Github 上这个 Issue 中的介绍，我们能够得知，只要在 Openvpn 的配置文件中加入一行代码，即可开启 Openvpn 的多设备同时接入功能：

具体如何操作呢？首先，用 ssh 工具登陆你的 Openwrt 软路由。具体的工具及方法可自行搜索，我日常使用的是微软官方发布的 Windows Terminal 终端工具。成功登陆 ssh 后，输入以下命令开始编辑 Openvpn 的配置文件：

vim /etc/config/openvpn

如果没能成功打开配置文件的编辑界面，很可能是因为你的 Openwrt 系统没有安装 vim （一款命令行文本编辑器）。至于 vim 的安装方法，还请自行搜索，本文不再赘述。

进入配置文件的编辑界面后，按键盘上的 I 健进入文本编辑模式，将光标移到配置文件末尾，将以下代码复制粘贴到配置文件最后一行。

option duplicate_cn '1'

编辑完成后，按键盘上的 ESC 健，再依次输入以下命令保存并退出编辑器：

:qw

完成上述步骤后，重启路由器。不出意外的话，你就可以同时使用多个客户端接入自己的局域网了。

两年前，我接触到一款叫做 Notion 的跨平台软件，无论是功能还是界面都令我十分满意，但它的价格并不便宜，我毕竟不是靠内容吃饭的职业创作者，无论如何也不愿为一款笔记软件搞月付。另外，Notion 仍然无法实现在牢牢掌控内容数据的同时实现便捷的多端同步，这也是一个不大不小的遗憾。

直到今天，偶然在少数派这篇文章的介绍下了解到一个叫 Trilium 的 Github 开源项目，几乎完美地满足我的所有需求。首先，它是一个开源项目，支持自建笔记服务器，可以让我在牢牢掌控笔记控制权的同时实现多端同步；其次，它界面简洁，非常轻量，甚至可以丢掉客户端，完全实现网页端访问；最后，它完全免费，这点非常重要。

自从买了威联通 NAS 后，我越来越倾向于将自己的各种数据保存在 NAS 上，再通过各类开源软件实现多端同步。这样既能保证数据安全和个人隐私，又能方便地管理自己的文件和数据。用几千元的成本和少许的电费换得对个人数据的完全掌控，我认为是值得的。因此，在意识到 Trilium 提供开源的服务端软件后，我立刻开始本地服务器的搭建工作。

Trilium 的官方文档中提供了通过 Docker 安装 Trilium Server 的具体方式。但由于文档为全英文，且只提供了 SSH 命令安装的方式，一些新手阅读起来可能有些困难，因此本文将以图形化的方式简单陈述 Trilium Server 的安装方式。

首先，在你的 NAS 上安装 Docker 套件（在威联通的 QTS 中叫做 Container Station）并打开它。

进入“创建”，并在搜索框中搜索 Trilium，找到 zadam/trilium，点击右侧的“安装”。

在弹出的创建窗口中，点选“高级设置”，首先在“网络”选项卡中设置 Trilium 的端口转发，trilium 的默认 web 界面默认端口是 8080，因此 Container 的端口必须写 8080，而映射出的主机端口则可以根据自身需求填写。为了记忆方便，我倾向于内外端口一致的设置，即主机端口同样设置成 8080，但如果你的 NAS 的 8080 端口已被其他程序占用，请填写其他端口。

接着，在“共享文件夹”选项卡中，将一个共享文件夹挂在到 Trilium 的容器中。容器中的挂载路径必须写 /trilium-data，而本机共享文件夹则可根据自身需求进行选择，注意挂载共享文件夹的权限必须为读取和写入均有。

上述设置完成后，点击“创建”按钮，系统会自动下载镜像文件并根据你的配置安装容器。容器安装完成后，便可通过在浏览器中输入 NAS IP/端口的方式访问 Trilium 的 web 界面。初次使用 Trilium 时要进行一些简单的初始化设置，例如创建用户名和密码等。虽然界面只有英文，但非常简单，这里不做赘述。

至此，我们便搭建完成了自己的笔记服务器。关于 Trilium 的具体使用方法，可自行摸索或搜索，总体来说，这款工具的使用门槛并不高。我的这篇文章就是全称用 Trilium 撰写的。Trilium 支持 Marddown 语法，因此对我而言几乎没有任何使用门槛。另外，Trilium 的 web 界面支持移动端布局，只要做好 DDNS 和路由器端口映射，便可在任何地方随时随地访问自己的笔记，无论用电脑还是手机。

第二种方法则更为简单直接，即通过动态 DNS 服务将一个域名绑定到局域网服务器的外网 ip，再议端口映射的方式将内网设备暴露在公网中，以供外网设备连接。由于众所周知的原因，我国境内的 VPN 连接并不稳定，因此大多数人都会选择第二种方式进行内网穿透。

在路由器上进行端口映射的操作非常简单。这里以 Openwrt 系统为例，仅需在网络 - 防火墙 - 端口转发中新建转发规则，将相应内网设备的端口映射为外网端口即可。

然而，由于内网设备的内部 ip 地址会随着 DHCP 租约的更新而不断变化，尽管我们可以通过 IP/MAC 绑定的方式人为地固定内网设备的 ip 地址，但实践证明这种方式并不稳定。因此，我们经常需要手动修改端口映射规则，这就使得相关的维护工作变得非常繁琐。如果我们长期在外，无法接入内网环境，上述规则修改的工作就很难进行。这时，我们就需要用到 UPnP（通用即插即用）服务。顾名思义，它是一种自动配置端口映射的工具。只要服务器和内网其他设备同时开启 UPnP 服务并稍加简单的配置，即可一劳永逸地解决端口映射的问题。

以群晖和 Openwrt 系统为例，我们首先需要在 Openwrt 路由器上安装并开启 UPnP 服务。

然后，登陆群晖的管理后台，在控制面板 - 外部访问 - 路由器配置选项卡中，选择“设置路由器”。此时系统会自动检测网络环境以及路由器型号与配置，不出意外的话，整个过程能够由系统自动完成，无须人工配置。之后，点击“新增”按钮，并根据自己的需求选择要转发的应用和端口，再点击“保存”即可。

最后，我们可以回到路由器后台的 UPnP 页面，查看已经被系统自动添加好的端口映射规则。值得注意的是，国内的网络运营商一般会禁用个人和家庭宽带的 443 和 445 端口（前者是 https 的默认端口，后者是 smb 服务的默认端口），因此，即使我们在 UPnP 服务中添加了上述两个端口的自动映射，也无法实现 443 和 445 端口的外网访问。此时，就需要我们在防火墙的端口映射中手动进行端口映射，即将 443 和 445 两个内网端口映射到外网的非 443 或 445 端口（如 444 和 446，全凭个人喜好）。这样，我们才能绕过运营商的封锁，成功进行上述两个端口的外部访问。

长期以来，PC 和 Mac 端的 Calibre 都是一个差强人意的电子书管理解决方案。它不仅支持多平台、功能强大（支持电子书整理、编辑、格式转换、一键推送到 Kindle 等），而且完全免费。那我为什么要将这么厉害的软件说成是“差强人意”呢？因为 Calibre 已经多年没有较大的功能更新，作为一款电子书管理软件，它已经无法适应当下人们已经习以为常的需求。具体而言，Calibre 具有以下缺点：

1. 界面老旧（或曰古朴？），看起来像是十年前的软件；
2. 启动和运行速度较慢，操作繁琐；
3. 不支持多设备同步，不提供云存储服务（这是最重要的一点）。

对于像我这样学习或工作繁忙，几乎没有固定的整段时间使用同一台终端设备的人来说，多端同步和云存储几乎是不可或缺的功能。而且在网页程序和微信小程序等日益普及的今天，有时连下载一个专门的应用程序都显得繁琐（可能是被这几年的技术进步惯坏了把）。因此，最好有一款类似于 Plex 影视库的电子书管理服务器应用，能够让我随时随地打开一个网页就能管理和阅读自己的电子书。幸运的是，这样的软件确实存在，它便是 Calibre 的继任者—— Calibre Web。

下图就是我用 Calibre Web 在自己的 NAS 上搭建的个人电子书管理网站（或曰个人电子图书馆？）。通过这个网站，我可以轻松地在各种终端设备上上传、修改、整理、推送各种格式的电子书。由于是网页端，因此我不用担心海量电子书会占用手机或电脑的硬盘容量，也不用担心多端同步的问题。更加难能可贵的是，由于 Calibre Web 开发得比较晚近，因此它的界面也很符合当下的主流审美标准。

关于 Calibre Web 的搭建方法，网络上有很多前辈们撰写的教程，他们已经说得非常详细了。首先，你必须拥有一台能够稳定运行的服务器或 NAS（其实任意一台普通电脑都是可以的，只要你舍得让它 7*24 小时运行）。然后，你需要在你的设备上搭建一个 docker 环境，因为 Calibre Web 需要 docker 作为运行的载体。最后，经过简单的安装和配置，你就可以拥有一个属于自己的电子书管理网站了。

这里以群辉为例。首先在“控制面板”中创建一个新的共享文件夹，用于存放 Calibre Web 的数据库和电子书资源。我这里将它命名为"Books"。创建完成后切记要开放该文件夹对所有用户的读写权限，否则 Calibre Web 将无法正常运行。

共享文件夹配置完成后，在群辉的套件中心中选择安装 docker 并打开它。再在“注册表”页面中搜索“Calibre-web”，此处途中框选的三个镜像都可以下载，它们的区别并不大，这里主要推荐 linuxserver/Clibre-web，在双击后弹出的对话框中选择“latest”并点“确定”开始下载。

镜像下载成功后（系统右上角会弹出提示），进入 docker 的“镜像”页面选择刚刚下载好的 linuxserver/Clibre-web 镜像，点击启动。在弹出的对话框中，点击“高级设置”，再按下图所示进行设置即可。

之后，启动 Calibre Web，并在浏览器地址栏中输入群辉的内网 IP 地址 + 半角冒号 + 上图中设置的端口号（默认为8083）。例如，我的群辉内网 IP 地址是 10.10.10.34，Calibre Web 的端口号是 3096，那么我输入的地址就是：

http:10.10.10.34:3096

初次进入 Clibre Web 时需要进行一些简单的配置，例如指定数据库目录（一定要和上图中设置的“装载路径”相匹配）、创建用户，以及配置邮件推送等。关于 Calibre Web 的配置和使用方法，这里就不再赘述了，网上教程一搜一大把。顺带一提，如果想在非家庭内网的环境中（例如出门在外的 4G 网络）继续使用 Calibre Web，你还需要进行内网穿透或动态 DDNS 的相关配置。至于这些内容，已经超出今天这篇文章的讨论了范围了，以后我们有机会在说把。

最后，推荐一本我最近正在读的书——理想国译丛的《布达佩斯往事》，希望你们能够喜欢。

在这样的背景下，一众“背单词”软件应运而生。这其中就包括开心词场、扇贝英语和百词斩等较为优秀的产品。但是，这些软件或多或少都存在着以下几点无法弥补的缺陷：

• 词库多为厂商事先制作而成，缺乏根据个人情况进行定制的空间，灵活性不强。
• 支持的语种多为英、日、韩等热门语种，无法满足小语种（如希伯来语）学习者的需求。
• 出于营利目的，集成了许多不常用的花哨功能，洁面不够简洁。
• 同样出于营利目的，部分功能仅对付费用户开放，免费用户的使用体验受限。

凡此种种，都构成了我长期无法找到适合自己的背单词软件的原因。然而，就在将近两年前，也就是我正在准备研究生考试的时候，我遇到了 Anki 这个神一样的记忆软件。之所以称它为“记忆软件”而非“背单词软件”，是因为它几乎支持所有需要记忆的内容格式，而不像上文提到的众多“专业软件”那样只能用来背特定语种的单词。实际上，只要你愿意，Anki 可以被用来记忆唐诗、成语，甚至纳瓦霍语。

简单来说，Anki 是一种利用类似于 Flash Cards 的卡片机制来辅助记忆的，支持高度定制化的工具。到目前为止，我发现它具有以下几个传统背单词软件所不具备的优点：

• 支持几乎所有内容形式，只有你想不到，没有 Anki 不支持的内容。
• 不仅支持传统的翻面单词卡，还支持诸如填空题、选择题等多种答题形式，满足各类需求。
• 根据艾宾浩斯遗忘曲线科学定制学习和温习计划，保证高效利用精力和时间。
• 云端实时备份词库和学习进度，并支持包括 PC、Mac、iOS、Android 等类操作系统，让用户可以轻松跨平台同步学习进度，随时随地进行学习。
• 支持牌组导出导入，结合活跃的社区和各类资源分享渠道，使那些不愿意自己制作牌组的用户也能通过下载并导入前人制作好的卡组来高效进入学习状态。

Anki 的桌面端（包括 Windows 和 Mac）和手机端（包括 iOS 和 Android）的功能几乎完全相同，但前者完全免费而后者必须付费。如果你既不愿意付费也不想使用盗版，那么只使用桌面版即可。这样除了无法获得多平台同步学习的体验外，不会受到任何具体功能上的限制。

Anki 的桌面端界非常简洁，你可以通过点击“新建记忆库”来自定义录入自己的牌组，也可以点击“获取牌组”以进入 Anki 官网浏览和下载其他用户上传的现成牌组。另外，在诸如淘宝或闲鱼等交易网站上也会有卖家有偿销售自己制作的 Anki 牌组，如果你购买了那些牌组，那么只要点击“导入文件”按钮即可将买来的牌组轻松导入。

以手机端为例，在学习牌组的过程中，我们可以根据自己的答题状况点选下方不同颜色的按钮。这样，Anki 就会将相应卡片加入对应的温习序列中，并根据艾宾浩斯遗忘曲线，结合我们后续的回忆状况，动态地安排学习计划。可以说，Anki 的这种根据个人记忆状况动态定制学习计划的特点，是使它从众多“背单词软件”中脱颖而出的最根本原因。

去年的这个时候，我正在准备所报考学校的研究生复试。如果说我的研究生外语考试能够取得理想成绩“多半”是我自己努力的结果的话，那么 Anki 便是那“少半”的原因。

经过几年前的一阵腥风血雨之后，目前国内叫得上号的公共网盘只剩下百度网盘、域通网盘和坚果云等。其中最臭名昭著的非百度莫属，其不仅对非会员用户有着苛刻的功能限制（地容量+下载限速），并且身型极其臃肿、拥有很多大多数用户完全用不到的冗余功能。相比之下，坚果云就要好不少，它对免费用户只做月流量方面的限制，除此之外既不限制速度也无冗余内容，可以说非常良心了。

然而与百度网盘生成链接直接分享的便捷性相比，坚果云在文件分享方面又稍显不足。因此在目前国内的公共网盘生态中，想要免费使用一个功能简洁、分享方便又不限速的网盘产品，几乎是不可能的。在这种情况下，很多用户开始转向私有云（NAS）方案，即建立私人的网络存储服务器，如购买群晖或 QNAP 的 NAS 主机或自行组装一台 DIY 主机。但无论是前者还是后者，都具有一定的技术门槛，并不适合所有用户。

作为苹果产品生态的基础性服务，iCloud 几乎为所有苹果设备用户所使用。无论你是否意识到，只要你用 iPhone 拍过照，你的照片就会自动被存储到你的 iCloud 中。无论你是否付费，只要你注册一个 Apple ID，你就会得到 5GB 的 iCloud 存储空间。虽然这个容量并不算大，但仅用于存储日常拍摄的照片和办公文档，是完全足够的。多年来，icloud 的封闭性一致为人们诟病。可能是出于数据安全的考虑，苹果并不允许用户将自己 iCloud 网盘中的文件分享给其他人。但好消息是，这一状况在最新一次的 MacOS 系统更新中被彻底改变。

今天上午，当我打开电脑准备开始今天的工作时，发现苹果推送了最新版本的 MacOS 10.15.4 系统更新，更新说明里面赫然写着羡慕一段话：

也就是说，iCloud 终于支持对外分享文件了！于是我立刻更新了系统，想尽快体验一下用 icloud 分享文件的感觉。在新版本的系统中，只要在 icloud 文件上右击鼠标，选择“共享”，再点“添加用户”，即可生成该文件的分享链接。

打开“添加用户”对话框后，我们可以对共享链接进行相应的设置。如果我们只想对受邀请的用户共享文件，那么不仅要在下方将“有权访问的用户”设置为“仅限于受邀用户”，还要在上方填写我们所邀请用户的邮箱。注意，目前“受邀用户”功能只对其他 Apple ID 开放，填写的邮箱也必须是 Apple ID 的登陆邮箱。

如果我们想要创建公开共享链接，而不是只针对特定用户开放浏览，那么我们可以选择“任何拥有链接的用户”。这样，只要将我们创建的共享链接发送给其他人，拥有链接的用户就可以随时打开相应链接浏览文件。

另外，我们可以在下方的选项中设置共享文件的访问权限。其中“仅查看”是只读权限；“可更改”是读写权限。

设置完成后，通过点击下方的“共享”按钮，我们就为指定文件创建了一个共享链接。共享链接创建完成后，它会自动地被复制到我们的剪贴板中，并且相应 iCloud 文件的名称后面会出现“由我共享”字样，便于我们事后查找。

现在，我们就可以将复制好的共享链接发给其他用户，让他们通过浏览器打开该共享链接来读取或更改相应文件了。值得一提的是，如果共享文件是 PDF 等格式的文件，打开共享链接即可直接预览其内容，而无需先下载再查看，非常方便。

本站由 Hugo 渲染而成。它的使用方式非常简单，想要自学的朋友可以阅读 Hugo 的官方文档。与其他博客系统一样，Hugo 也拥有着众多简洁美观的主题，本站所使用的主题是 maupassant（2024年更新：播客迁移后最新使用的主题为PaperMod），它最初是由 cho 开发于 Typecho 平台的主题，后被移植到众多其他平台，并被加入了许多新功能。

Hugo 的所有页面都支持 Markdown 语法，借助它，我们可以在任何环境下撰写出格式统一的博文，而不用担心外观问题。Markdown 的学习成本很低，任何人都可以在极短的时间内学会。如果你有兴趣，可以通过这份教程入门 Markdown。Typora 是我目前正在使用的一款支持多平台的轻量级 Markdown 编辑器，界面非常干净简洁，并且免费开源（2024年更新：该软件已于2022年开始收费，目前我使用的编辑器是 MarkText）。

通过 Hugo 生成好完整的 HTML 页面之后，我们便可以将这些页面放到我们的服务器上了。你可以购买一台虚拟主机，或者更加省时省力地，利用 Git 仓库托管自己的网站。Git 是一个应用非常广泛的版本管理工具，而 Git 仓库则是用于托管源代码的小型服务器。最著名的 Git 仓库非 Github 和 Gitlab，它们在提供免费的源代码托管服务的同时，还支持 Pages 托管服务。所谓 Pages，原本是用于介绍和传播开源项目的说明文档，但其本身也是一个小型的 HTML 静态 Web 服务器。利用 Pages，我们可以轻松而免费地部署自己的静态网站。

如果你不希望通过手动的方式创建页面或修改配置，而是习惯于通过类似于 PHP 动态博客后台的可视化界面来编辑自己的网站，那么你可以尝试 Forestry。它是一个支持多种环境的可视化内容管理系统（CMS）。通过 Forestry，你可以像编辑动态博客那样管理自己的静态网站，并实时地将编辑好的网站推送到你的 Git 库中，实现真正的无代码建站。

本站即通过 Hugo + ~~Forestry ~~+ Github 搭建而成，从开始自学到写这篇文章总共花费三天时间。在此感谢所有为开发上述工具或撰写相关教程而无偿付出时间与精力的前人们，若不是站在他们伟岸的肩膀上，本站不会有问世的这天。