asuswrt-merlin

asuswrt-merlin 深度剖析：在闭源基座上做可控性手术

项目背景与痛点

华硕 Asuswrt 在消费级路由固件里算开放的一支，但开放有明确边界：Web UI 只暴露厂商愿意给的开关，Broadcom 无线驱动、硬件加速（Runner / Flow Cache）以及相当一部分二进制组件不随 GPL 发布，原厂固件还会随产品生命周期停止更新。而用户真正想做的事——改 DNS 行为、跑 VPN 策略路由、装 Entware、定制 DDNS、按 WAN/挂载事件触发脚本——在原厂固件里基本只能"绕着来"。

另一条路是 OpenWrt：完全开源、包管理成熟，但在 Broadcom 平台上常常只能拿到半残的开源无线驱动，硬件 offload 缺失，性能与稳定性都打折。DD-WRT 功能庞杂、FreshTomato 则跟不上新平台。

RMerl/asuswrt-merlin 的定位正是这条夹缝：它不重造固件，而是在华硕官方 GPL 源码加闭源二进制的基座上做外科手术式增强——保住原厂驱动、加速路径和 Web UI 血统，把可编程性与运维面补齐。仓库描述里的 “legacy code base” 指的是以 380.x 为代表、面向 MIPS/ARMv7 老机型仍在做安全维护的分支，这也解释了它为什么看上去"旧"：旧是刻意的，稳定优先。

核心技术揭秘

从构建形态看，这个仓库本质是"开源胶水层 + 预编译二进制"的混合体。release/src/router/ 一侧是能改的开源代码：rc 服务编排、httpd、nvram 工具、dnsmasq、busybox、OpenVPN 封装等；另一侧是 Broadcom SDK 与厂商提供的 prebuilt 对象。构建时必须使用与华硕原厂严格对齐的 crosstools 工具链，否则闭源库的 ABI 不匹配，链接期或运行期直接崩。这条约束决定了 Merlin 的改动半径：只能动胶水，不能动内核驱动。

系统的配置中枢是 nvram。WLAN 参数、DHCP、防火墙、VPN 全部以 nvram set key=value 落盘，rc 启动时按这些键展开成具体服务（生成 dnsmasq 配置、iptables 规则、wl/hostapd 参数），Web UI（httpd + ASP + 前端 JS）不过是往 nvram 写键值、再触发 restart_* 动作。这个"键值中枢 + 进程重建"的模型很粗糙，胜在简单、可脚本化、跨机型一致——也是 Merlin 所有增强能落地的前提。

真正的难点在生命周期编排。路由器没有 systemd，rc 是唯一启动调度者，WAN 状态与存储挂载靠内核 hotplug 事件加轮询。Merlin 在原厂少量钩子之上补齐了 /jffs/scripts/ 事件矩阵（pre-mount、post-mount、services-start、wan-start、firewall-start、service-event 等），把用户逻辑插进启动链的确定位置，同时还得处理脚本阻塞拖慢启动、JFFS 挂载失败、升级后 JFFS 被格式化这些边界情况。这些没有文档约束，全靠维护者对 Asuswrt 启动链的长期观察。

功能亮点与差异

补丁哲学克制。 Merlin 不重构 Web UI、不改闭源驱动，改动遵循"局部、可回滚"。对比 OpenWrt 频繁的内核跃迁，它的补丁面小、回归风险低，这是它被当作"生产可用增强固件"的根本原因。

事件钩子加 Entware。 外置存储上跑 Entware 等于给固件接了软件源，钩子把服务注册为开机自启，NAND 保持低写入，对 flash 寿命友好。这是它与原厂固件最直观的差距。

网络功能的工程化补齐。 多实例 OpenVPN 客户端与策略路由、DNSMasq 定制与 DoT、NAT loopback 修正、Guest Network 独立策略、无线 Region 与功率可调——这些在原厂固件里大多缺失或半成品。

老机型安全 backport。 硬件停产但仍在收安全补丁，对家庭与小型办公是实打实的价值。

与 OpenWrt、FreshTomato 相比，Merlin 的卖点从来不是"开源纯度"，而是在保留厂商二进制与硬件加速收益的前提下，把可控性推到接近开源固件的水平。

应用场景与落地建议

适合：不愿换硬件、想要可控网络的家庭与小型办公；需要 VPN 网关、流量分流、DNS 定制、脚本化运维的中小团队；喜欢折腾但不接受天天救砖的极客。

不适合：要求全栈可审计的合规场景（闭源 blobs 无法审计）；依赖新内核特性的业务（内核版本跟着华硕基座走）。

落地要点：

1. 升级前后备份 JFFS 与 nvram 配置，部分升级路径会格式化 JFFS。
2. 启动脚本必须幂等并自带超时，services-start 里做阻塞操作会拖慢整机启动。
3. 不要乱写未知 nvram 键，脏值会导致服务起不来；动手前先 nvram show 留档。
4. Entware 装在外置 USB，避免频繁写 NAND；USB 掉盘要有 umount 保护。
5. 认准分支与机型的对应关系：legacy 分支只做安全维护，别指望新功能。
6. 生产环境先小范围灰度，重点验证无线驱动行为差异。

综合评价

优点：稳定性与可编程性的最佳折中；钩子机制实用且生态成熟；老机型续命；功能增强不牺牲硬件加速。

缺点：闭源基座决定了它无法摆脱华硕的发版节奏与二进制黑箱；nvram 键值中枢的设计在 2020 年代已显陈旧；legacy 分支创新停滞；部分高级能力仍要手写配置文件而非 GUI；机型支持矩阵碎片化，是长期运维负担。

一句话总结：要的是"一台能稳定跑三年、并且我能在上面写脚本的路由器"，Merlin 是当下最务实的选择；要的是"每一行代码都在我掌控中"，请右转 OpenWrt。