跳到主内容

fake-ip-filter-mode:blacklist、whitelist 与 rule 的区别

同一份 fake-ip-filter 列表,在不同模式下意思相反。默认的 blacklist 表示列表里的域名不分配虚拟地址,whitelist 则只给列表里的分配。

01先复习 fake-ip

fake-ip 模式下,内核对域名查询先回一个虚拟地址,真正的解析留到建立连接时再处理。字段 fake-ip-range 决定虚拟地址的范围,文档示例是 198.18.0.1/16。这个机制的整体介绍见 Clash DNS fake-ip 字段。

有些域名不适合拿到虚拟地址,比如局域网服务依赖真实 IP。fake-ip-filter 就是用来挑出这些域名的,而 fake-ip-filter-mode 决定这份列表怎么被使用。

02三种取值

文档给出三个取值,默认是 blacklist:

取值含义
blacklist列表里的域名不返回 fake-ip,其余都返回
whitelist只有匹配成功的域名才返回 fake-ip
rulefake-ip-filter 按路由规则语法书写,自上而下判断

whitelist 的文档原意是“只有匹配成功才返回 fake-ip”,与 blacklist 刚好相反。同一个 '*.lan' 条目,在 blacklist 里表示局域网域名不用虚拟地址,在 whitelist 里表示只有局域网域名用虚拟地址,这几乎一定不是你想要的。所以改模式时要同步检查列表。

03blacklist:默认的用法

dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  fake-ip-filter-mode: blacklist
  fake-ip-filter:
    - '*.lan'

文档说明 fake-ip-filter 里的条目支持域名通配符,也可以导入域名集。列出的地址不会得到虚拟地址的映射。没有特殊需求时保持 blacklist 就是默认行为。文档没有写 fake-ip-filter 的默认内容。

04whitelist:只给列表里的分配

选 whitelist,意味着大部分域名拿到的是真实解析结果,只有你列出来的才走 fake-ip。这样可以把虚拟地址的影响范围控制得很小,代价是列表要自己维护,漏掉的域名不会享受 fake-ip 的行为。

05rule:用规则语法写

rule 模式下,fake-ip-filter 里写的是路由规则,从上往下判断。文档说明支持的类型包括 RULE-SET、GEOSITE、DOMAIN 一类以及 MATCH。条目形式类似:

fake-ip-filter-mode: rule
fake-ip-filter:
  - RULE-SET,reject-domain,fake-ip

示例中 reject-domain 是一个规则集的名字,需要你自己在配置里定义。这种写法的好处是可以复用分流里已有的规则集,也方便用 MATCH 做兜底。顺序影响结果,所以排列时要像写分流规则一样考虑先后,规则顺序的思路见 Clash 分流规则入门。

06什么时候改这个模式

文档没有给出“什么情况必须改”。从用途出发,可以这样判断:

1. 默认的 blacklist 能解决问题,就不要动,只往列表里加例外。
2. 想让虚拟地址只作用于少数域名,再考虑 whitelist。
3. 想复用现有规则集来决定哪些域名排除,再考虑 rule。

改动后观察解析异常是否出现、局域网服务是否仍可访问。解析异常的整体排查可以看 DNS 泄露是什么意思。

07是哪些客户端和版本在用

fake-ip-filter-mode 是 mihomo 内核的 DNS 字段,使用该内核的客户端都能通过配置写入。各客户端是否提供图形界面开关、从哪一版开始,没有查到统一的官方说明,需要看客户端自己的发布页。

常见问题

blacklist 和 whitelist 到底差在哪?

+

blacklist 是默认值,列表里的域名不返回 fake-ip;whitelist 相反,只有匹配列表的域名才返回 fake-ip。同一个条目在两种模式下含义相反,换模式必须重新检查列表。

rule 模式的条目能写哪些类型?

+

文档说明支持 RULE-SET、GEOSITE、DOMAIN 一类以及 MATCH,自上而下判断。条目形式与分流规则相似,所以顺序会影响结果。

fake-ip-filter 可以用通配符吗?

+

可以。文档说明它支持域名通配符,也支持导入域名集,示例里的 '*.lan' 就是通配写法。列出的地址在 blacklist 模式下不会得到虚拟地址的映射。

还没确定从哪一步开始,可把 从安装开始的操作教程 与 设备对应的软件档案 配合阅读。已有配置但访问失败时,转到 连接异常的分类检查 找对应表现。