官方手册 / Routing & Settings

Shadowrocket 代理模式与设置

需要按目的地址分流时,选 Config。临时确认服务器或对比当前网络时,再分别用 Proxy 和 Direct。

以下操作以 iPhone / iPad 界面为例。Global Routing 决定怎样处理请求;On Demand 决定何时建立连接。两项设置需要分别核对。

01模式

Global Routing:Config、Proxy 与 Direct

在 Home 打开 Global Routing,按这次要验证的目标选择模式,再返回 Home 确认连接状态。选 Config 前先到 Config 确认正在使用的配置文件;选 Proxy 前先确认 Home 中当前选中的服务器。切换模式不会替你更换配置文件,也不会修正服务器参数。

界面选项处理方式适用场景先核对什么
Config(配置)按当前配置文件里的规则决定策略。日常使用,需要部分请求代理、部分请求直连。配置是否生效、规则顺序及兜底策略。
Proxy(代理)将由客户端处理的请求交给代理路径。临时判断同一目标经代理是否可达。当前选中的服务器,以及服务器参数是否正确。
Direct(直连)请求不经代理服务器转发。对照基础网络是否可达,或临时验证本地服务。系统网络是否正常;Direct 不等同于关闭连接开关。

排查时保持同一网络和同一测试地址,每切一次模式就重新发起一次请求。Proxy 能访问而 Config 不能访问时,先检查是否命中了意外规则,或 Config 使用了不同的策略及服务器。若 Direct 也失败,先确认当前网络是否需要登录门户,再检查目标服务是否可达。测试完成后切回日常使用的模式,避免把临时排查结果留成长期设置。

02规则

规则分流:先匹配条件,再执行策略

规则把请求特征和处理策略写在一起。在 Config 打开当前使用的配置文件,查看规则段并核对先后顺序;再回 Home,把 Global Routing 设为 Config。若较宽的条件排在前面,请求可能已经匹配,后面更具体的例外就不会生效。添加例外时,先找出会覆盖它的规则,再将例外放到那条规则之前。

按请求特征选择规则类型

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD
分别按完整域名、域名后缀和域名中包含的关键词匹配。只处理一个主机时优先用 DOMAIN;要覆盖主域及其子域时用 DOMAIN-SUFFIX;关键词可能匹配到无关域名,修改后应检验命中范围。
IP-CIDR / IP-CIDR6 / GEOIP
前两项按 IPv4、IPv6 地址段匹配,GEOIP 按目标 IP 的归属信息匹配。域名解析到多个地址时,命中结果可能随实际地址变化。GEOIP 判断的是 IP 归属,不是域名后缀,也不是网站运营方所在地区。
USER-AGENT / FINAL
USER-AGENT 只有在客户端能取得相应请求字段时才适用,不能当作通用的应用识别条件。FINAL 为此前没有命中规则的请求指定兜底策略,应放在规则列表末尾。

逐条验证 PROXY、DIRECT 与 REJECT

PROXY 经代理转发,DIRECT 直接访问,REJECT 拒绝匹配的请求。例如:

DOMAIN,local.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

第一条为单个主机保留直连,第二条处理其余匹配后缀的请求,第三条处理未命中的请求。这里的域名是示例;照搬不会替实际服务建立规则。验证时分别选择一个例外目标和一个应命中后缀的目标,发起新请求后查看可用的连接记录。若前者意外走代理,先核对域名是否完全一致,再核对规则顺序和实际启用的配置。

03服务器

订阅导入与服务器管理

已有服务商的订阅地址时,在 Home 打开 Add Server,选择 Subscribe 并填入已有地址。保存后,在 Home 核对导入的条目,并明确选中本次要测试的服务器。添加成功表示列表已经建立,不代表其中每个服务器都可连接。更新后如果条目的名称或数量发生变化,重新确认当前选择,尤其要检查原先使用的条目是否已被移除。

只掌握单个服务器参数时,在 Add Server 先选与服务商资料一致的协议,再按界面填写地址、端口以及该协议需要的身份验证字段。已有二维码时,可用 Scan QR Code 导入;保存前也要核对导入后的协议与地址。即使两份资料给出相同的地址和端口,不同协议的字段也不能互换。字段区别可参阅协议技术参考。

订阅未能载入时,先确认复制的是完整地址,并向原服务商确认是否仍有效;列表已载入但连不上时,则检查当前选中的条目和协议字段。不要把两种问题混在一起反复删除和导入。提交排查信息时,移除订阅地址中的访问参数,并遮盖密码及密钥。本站不提供、不销售、不推荐节点或订阅。

04连接

On Demand:按条件建立连接

On Demand 用于让系统在符合配置条件时尝试建立连接,适合在不同网络之间切换时减少手动操作。先在 Home 手动验证连接正常,再到 Settings 打开 On Demand,按界面提供的条件选择需要触发连接的网络。配置后,切换一次 Wi-Fi 与蜂窝网络,分别确认应连接时能否建立连接、不应触发时是否保持预期状态。

它不决定请求走哪条路径:连接建立后,仍由 Global Routing 和适用的配置规则处理流量。如果手动断开后一换网络就又连上,检查 On Demand 是否仍启用及条件是否覆盖该网络。排查频繁重连时,可暂时关闭 On Demand,在固定网络下验证手动连接,再恢复所需条件。这样能区分问题来自服务器连接,还是来自网络切换时的触发条件。

05统计

Data:查看流量与统计范围

在 Data 查看客户端记录的流量。判断某次操作是否产生流量时,先明确当前显示的统计区间以及上传、下载的数值;记下起点,执行一次明确操作,再回来比较变化。进一步排查时,可让设备保持同一网络,减少同时进行的同步、下载或连通性测试,以免把其他活动的流量计入这次观察。

Data 反映客户端记录,不是系统移动数据账单,也不是服务商最终使用量。统计起点、计入的连接范围和传输开销均可能不同,不宜用两处累计数字直接相减来判断遗漏。若要判断某个域名是否走代理,应结合当前模式、规则和诊断记录;上传或下载总量本身不能说明具体请求采用了哪条策略。

06设置

Settings:解析、测试、同步与诊断

DNS:确认有效的解析设置

DNS 将域名解析为地址。在 Settings 查看 DNS 相关选项;使用 Config 时,还要核对正在使用的配置文件是否指定了解析设置。出现域名无法解析时,先保留原值,再按你的网络或服务商资料修改一项,重新测试同一域名。若局域网的内部名称失效,检查当前解析来源是否认识该名称。解析得到地址不等于目标端口可达,后者需要另行测试。

Test Method:统一测试条件

在 Settings 的 Test Method 查看和选择测试方式,再回 Home 运行 Connectivity Test。比较同一服务器前后的结果时,保持测试方式、网络和测试目标一致;若界面允许编辑测试地址,使用你能正常访问且适于测试的目标。一次测试成功只说明当时对应的探测成功,不能代表实际业务请求全部可达,也不能把测试耗时当成下载速度。

Today Widget:从系统小组件访问

在 Settings 查看 Today Widget 相关选项,按系统当前提供的小组件入口检查是否能添加。添加后,可用它查看组件提供的状态或快捷操作;需要核对 Global Routing、当前服务器或配置文件时,仍返回 Home 或 Config。若小组件未显示,先打开应用确认连接是否正常,再核对系统是否提供该组件入口,不必因组件缺失而重设服务器。

iCloud:核对同步内容

准备在自己的设备间同步时,在 Settings 查看 iCloud 选项,确认设备登录的是同一个 Apple 账号,且系统允许应用使用 iCloud。按界面说明启用所需项目,再到另一台设备核对条目是否出现。同步前保留重要配置的备份,避免在两端同时修改同一份内容。即使配置或服务器信息已同步,也应逐台验证连接和 On Demand 条件。

Diagnostics:按故障现象取证

在 Settings 打开 Diagnostics,先记录故障时间、网络类型和 Global Routing 模式,再复现一次具体问题。若记录显示解析失败,先查 DNS;若已解析但连接超时,核对当前服务器与目标地址;若连接建立却访问结果异常,再核对规则命中与策略。每次只改一处设置并重新验证,分享记录前遮盖账号、订阅地址和其他敏感信息。

按设备获取 Shadowrocket

iPhone / iPad 版在 App Store $2.99 一次性付费,系统要求以 App Store 页面标注为准。Mac(Apple 芯片与 Intel)、Windows、安卓和 Linux 版免费,安装包通过本站 /dl/ 提供。

客户端一次性买断 ≠ 线路套餐。已经获取应用的用户可查看首次连接教程。

获取应用