SSID 暂停

Chute iOS、Chute Mac 与 Chute Android 可用，Apple TV 不可用。

你可以配置 Chute 在设备处于指定 Wi-Fi 网络时暂停。

[SSID Setting]
"Corp-VPN" suspend=true

各平台的执行方式：

• iOS：带精确网络名的条目（裸名、引号名或 SSID:<名称>）以及 TYPE:WIFI / TYPE:CELLULAR 条目会变成 VPN 配置的按需断开规则；TYPE:WIFI 覆盖所有 Wi-Fi 网络。设备加入这类网络时系统会断开隧道，并在停留期间保持断开；下一次网络变化后恢复原有的按需规则，因此「始终保持开启」会自动重连。BSSID:、ROUTER: 条目、TYPE:WIRED 以及含 *、? 的名称无法表达成按需规则：引擎自己的判定命中时，隧道会自行停止，离开该网络后需要手动重连——但若启用了「始终保持开启」，其连接规则会立刻把隧道拉起来，所以这类条目在 iOS 上不会暂停，Chute 只会通知你原因。每次开始暂停时，Chute iOS 会弹出「已在当前网络暂停」通知（受应用的通知设置约束）。
• Mac：当前网络命中 suspend=true 条目时，Chute 关闭系统代理与 TUN，网络不再命中时自动恢复。所有选择器类型都生效。配置里点名了 Wi-Fi 网络时，Chute 会请求一次定位权限（macOS 10.15 及以上）；从 macOS 14 起，没有它就读不到 Wi-Fi 名称，只有 TYPE: 与 ROUTER: 条目能命中。
• Apple TV：基于网络的设置会保留在配置中供其他平台使用，但在 Apple TV 上不生效；保存时应用会给出提示。
• Android：Chute 会读取接入方式、SSID、BSSID 和网关，在每次网络变化时以及每分钟一次匹配这些条目，并把命中条目的 dns-server / encrypted-dns-server 推给解析器。在 VPN 模式下，命中 suspend=true 条目时会撤下 VPN 接口，引擎继续运行，流量因此绕过 Chute；Chute 会弹出「已在当前网络暂停」通知，主界面会显示命中的条目，设备离开该网络后接口会自动恢复。所有选择器类型都生效。本地代理模式不会暂停。为了读取网络名称，配置里存在 [SSID Setting] 段时，应用会请求定位权限（Android 12 及更早）或附近 Wi-Fi 设备权限（Android 13 及更新）；启动时若无法显示这个权限请求，则改为发一条通知——见 Android 快速上手。

后面命中的 suspend=false 条目会取消暂停，在 Mac 和 Android 上如此，在 iOS 上同样如此：按需规则也和引擎自己的判定一样按「后命中者胜」扫描，所以那条断开规则根本不会被写出来。有两种取消是按需规则表达不了的：跨选择器类型时，TYPE:WIFI suspend=true 后面再写 SSID:Home suspend=false，在那个网络上隧道仍会被断开，因为规则是按「所有 Wi-Fi」生成的；通配条目也取消不掉具体条目，所以 SSID:Home suspend=true 之后再写 Home* suspend=false，规则照样留在那里。引擎自己的判定这两种都认。

按网络设置 DNS

条目还可以在其网络为当前网络时修改 DNS：

[SSID Setting]
SSID:Home dns-server=192.168.1.1, 192.168.1.2:5353, encrypted-dns-server=off
BSSID:AA:BB:CC:DD:EE:FF encrypted-dns-server=https://doh.example/dns-query, tls://dot.example
TYPE:CELLULAR dns-server=1.1.1.1

• dns-server= 替换主池中的普通解析器。它只接受普通条目——IP 地址，可带端口（IPv6 写作 [v6]:port）、system 或 syslib，写法与全局 dns-server 相同。加密解析器的 URL 虽然全局键接受，在这里却会被丢弃并记一条提示；请改写进 encrypted-dns-server=。tcp://IP[:port] 条目（DNS over TCP）同样接受。
• encrypted-dns-server=off 关闭所有加密解析器；写成 URL 列表则改为用这些 URL 替换它们，并按 scheme 归入 DoH、DoT、DoQ 和 DoH3。
• 选择器与暂停所用的相同：带引号的网络名称、SSID:<名称>、BSSID:<地址>、TYPE:WIFI、TYPE:CELLULAR、TYPE:WIRED 以及 ROUTER:<网关地址>；名称中可以使用 * 和 ? 通配符。MCCMNC: 可以写，但永远不会命中。
• 网络切换时和配置载入时都会应用覆盖。多个条目同时命中时，后面的条目生效；离开该网络后恢复为配置中的服务器。
• 同一个条目可以同时包含 suspend= 和 DNS 参数。

Shadowrocket 在 [Host] 中的写法 ssid:<名称> = server:<dns> 会变成这类条目，参见本地 DNS 映射。在 Apple TV 上，这些条目会被保留，但永远不会生效。