领域	特性
DNS	`evaluate` / `match_response` / `race` 响应匹配，乐观缓存与 `store_dns`，统一 `dns.timeout`
规则集	`initial_path`、多 tag、`http_clients` 下载客户端
连接	TUN `dns_mode` / `dns_address`，UDP NAT 参数（`udp_mapping` / `udp_filtering` / `udp_nat_max`）
证书	`tls.acme` → `certificate_provider`（`key_type` / `profile` / `account_key`）
工程化	生成配置内置 `$schema`；运行要求 sing-box ≥ 1.14

已修复：国内域名走代理问题（r4 / r6 / r7）

背景

bypass_mainland_china 的数据路由原本只用 geoip-cn（按 IP 匹配国内目标）。sing-box 不会把「域名连接」的域名解析成 IP 再去匹配 IP 规则集，因此按域名访问的国内站（如字节、百度等）落到 main-out 走了代理，只有「裸 IP 访问国内 IP」才直连。

修复方式

数据路由改用 action: resolve (prefer_ipv4) + geoip-cn → direct-out——先解析域名再做 IP 匹配，由真实 IP 决定国内 / 国外（国内 IP → 直连，其余 → 代理）；数据判定不再依赖 geosite-cn / geosite-noncn 域名规则（geosite-cn 仍用于 DNS 路由）。

对字节、百度等国内域名，以及苹果等全球跨国企业站点更稳更友好；默认使用公共 DNS（223.5.5.5）作为国内 DNS 以降低污染概率。

可选增强 cn_ip_fallback

启用后使用 1.14 原生 evaluate / match_response：对非 geosite-cn 域名，若 main-dns 返回国内 IP，再回退到 china-dns 解析。

这版块确实很难两全，改来改去也都存在缺憾，就这样不改了，照顾大多数为准。

新增：规则集自动更新（r5）

为 bypass_mainland_china 的三个远程规则集（geoip-cn / geosite-cn / geosite-noncn）增加 update_interval: '24h'，sing-box 每 24 小时自动重新拉取 .srs：

热替换，不中断既有连接；
下载失败时保留旧规则集，不影响分流。

新增：Snell 协议与 Hysteria2 增强（r9）

面向 sing-box 1.14 的一轮收敛：补齐新协议、暴露传输层新参数，并修复 1.14 DNS 迁移的一个行为缺陷。

领域	变更
Snell（1.14 新协议）	客户端出站 + 自建服务端 inbound 全支持（v4 / v6、psk、多用户 `userkey`、HTTP 混淆、v6 流量整形）；订阅导入 `snell://`
Hysteria2	新增 `disable_chrome_parrot`（Ed25519 证书服务器兼容开关）、`bbr_profile`、`hop_interval_max`（跳变间隔随机化）、`gecko` 混淆与 min/max 包长；服务端同步支持 gecko
Hysteria v1	移除上游已废弃的 QUIC 流控调参（上游 1.16 将删除），回归 sing-box 默认
DNS	修正 1.14 自动迁移：legacy `ip_cidr` / `ip_is_private` 包装 `evaluate` 时继承原规则查询条件，不再对全部查询预解析
连接与交互	TLS `handshake_timeout`；TUN `dns_mode` 缺省（hijack）与平台 DNS 劫持叠加的界面指引；规则集 merged / OR 匹配语义与 `query_type` 兼容性提示

设计取舍：Chrome QUIC 指纹（1.14 默认开启）仅在服务器证书为 Ed25519 等握手失败时才需关闭；Snell 采用 sing-box 官方实现（v5 无线协议视同 v4，不支持 v5 QUIC 代理模式）。

新增：规则分流与 TLS 能力补全（r10）

补齐 sing-box 1.14 在路由规则与规则集加载侧的剩余能力，并加固一处规则集配置的校验提示。

领域	变更
route `resolve`	新增 `disable_optimistic_cache`、`timeout`两个控件,乐观缓存增至四个选项
route / route-options	新增 `tls_spoof` / `tls_spoof_method`（注入伪造 ClientHello 干扰按 SNI 过滤的中间盒，需特权），LuCI 提供 SNI 与方式选择（默认 wrong-sequence）
规则集加载	多 tag 时若 `path`/`url`/`initial_path` 缺少 `{tag}` 占位，生成器给出 `warn` 提示，配合 LuCI 表单校验与 sing-box 的硬拒绝（`missing {tag} placeholder`），三层防护避免误配
i18n	补齐新增文案的 zh_Hans 译文

工程化加固（r11）

一轮以可维护性与可验证性为目标的加固：重构不改变行为，测试锁住结果，经实机验证。

轮次	做了什么	结果
重构和修复错误	重构：前端 TLS/传输表单收敛、generator 共享 TLS/transport 构建、`parse_uri` 拆为 13 个协议函数测试：协议单测 153 条、generator 回归、LuCI 表单快照修复：`executeCommand` 清理、dnsmasq 路径告警、fw4 清单单源、启动日志、PEM 校验、`wGET` 失败原因工程：提高中文翻译率 CI、架构核实	parse_uri 对比零差异、generator JSON 逐字节一致、表单快照逐字段一致顺带修复 3 个既有缺陷：证书上传、fw4 清理回滚、dnsmasq 路径

稳定性修复（r12）

修掉两个会让功能整体不可用的缺陷，均由 issue 复现确认。

领域	变更
订阅抓取（#5）	抓取前先探测 wget 实现：GNU wget 用 `-nv`（静音进度条但保留失败原因），uclient-fetch / busybox wget 用 `-q`；`--user-agent` / `--timeout` 一并换成三家通用的 `-U` / `-T`。r11 引入的 `-nv` 是 GNU 专有选项，而 OpenWrt / ImmortalWrt 的 `/usr/bin/wget` 默认由 uclient-fetch 提供，参数解析阶段即失败，导致所有订阅更新以 `no valid node found` 结束
自定义路由（#3 #4）	修复 `routing_mode='custom'` 完全无法生成配置：`direct_overrides` 的使用早于声明（ucode 不做变量提升，strict 模式下直接抛未声明变量）；本地规则集残留 legacy `download_detour` 字段，被 sing-box 判为 `unknown field` 而拒绝整个配置
预设规则集	`geoip-cn` / `geosite-cn` / `geosite-noncn` 改用 SagerNet 上游 raw URL，并经 `main-out` 下载：直连受 DNS 污染时会超时并静默沿用缓存；每天约 250 KB 的代理开销可忽略，节点引导不受影响
依赖	Makefile 补上 `+ip-full`、`+kmod-tun`

回归保障：订阅抓取用 stub wget 覆盖 GNU / 非 GNU 两条分支，并在装有 /bin/uclient-fetch 的目标上直接执行生成的命令行；自定义路由新增 custom.uci fixture（本地规则集 + 直连节点覆盖 + 路由规则）。

运行要求

ImmortalWrt / OpenWrt ≥ 24.10+（apk 或 opkg 均可安装）
sing-box ≥ 1.14.0（ImmortalWrt 25.12 源对应 sing-box 1.14.0-r1）
低于 1.14 时服务会拒绝启动并记录明确日志

版权归 ImmortalWrt.org 与各贡献者

README.md Unescape Escape

新增本仓库“架构重构”试验性产品luci-app-homeproxy-pro

luci-app-homeproxy

项目定位

已融入的 sing-box 1.14 特性