Shadowrocket桌面小组件可实现一键切换代理节点与查看实时延迟,本文详解iOS小组件添加流程、代理组类型选择策略及常见配置错误排查，助你提升国际网络加速效率。
前置条件与版本要求
小火箭桌面小组件配置需满足iOS 14及以上系统版本，Shadowrocket应用版本建议2.2.0+，确保已导入有效的YAML格式订阅链接，且"设置-延迟测试方法"中配置了可访问的测试URL（推荐http://www.gstatic.com/generate_204）。
桌面小组件添加与配置流程
- 进入编辑模式：长按iOS主屏幕空白处，点击左上角"+"号进入小组件库
- 选择组件尺寸：搜索"Shadowrocket"，提供小（1x1）、中（2x1）、大（2x2）三种规格，中号组件推荐，可同时显示节点名称与延迟数值
- 配置显示内容：添加后长按小组件选择"编辑Shadowrocket"，勾选"显示代理组"和"显示延迟"，若需跨境办公需求场景，建议开启"显示今日流量"
- 绑定代理组：在"选择代理组"选项中，指定需要快捷控制的策略组（如"自动选择"或"手动切换"）
代理组类型与Widget联动逻辑
小火箭桌面小组件配置的核心在于理解代理组（Proxy Group）类型对Widget交互的影响：
Select（手动选择） Widget显示当前选中节点名称，点击可直接展开节点列表进行切换，适合需要精确控制出口IP的学术资源访问场景。
URL-Test（自动测速） Widget实时显示延迟最低的节点，点击可强制刷新测速，配置示例：
Proxy Group:
- name: "自动选择"
type: url-test
url: http://www.gstatic.com/generate_204
interval: 300
proxies:
- 节点A
- 节点B
Fallback（故障转移） Widget显示当前可用节点，当主节点失效时自动切换，适合对稳定性要求高的视频会议场景。
TUN模式与系统代理的区别
完成小火箭桌面小组件配置后,需根据使用场景选择代理模式：
TUN模式：通过虚拟网卡接管设备所有流量（含UDP、ICMP），适用于游戏加速或部分不遵循系统代理的应用，开启后Widget显示"VPN"标识，电池消耗增加约15%。
系统代理：仅代理HTTP/HTTPS流量，iOS系统级应用（如Safari、邮件）默认遵循，适合纯网页浏览场景，功耗较低但无法处理UDP流量。
分流规则优先级说明
当Widget显示"规则模式"时，流量匹配遵循以下优先级：
- DOMAIN：精确匹配域名（如
DOMAIN,www.example.com） - DOMAIN-SUFFIX：后缀匹配（如
DOMAIN-SUFFIX,google.com匹配所有子域名） - IP-CIDR：IP段匹配（如
IP-CIDR,142.250.0.0/16） - GEOIP：地理位置匹配（如
GEOIP,CN,DIRECT）
规则文件建议采用DOMAIN > DOMAIN-SUFFIX > IP-CIDR > GEOIP的排列顺序，避免过早匹配导致分流失效。
常见问题排查（FAQ）
现象：Widget添加后显示"配置加载失败"
原因：Shadowrocket未获得本地网络权限，或订阅链接格式错误
解决：设置-Shadowrocket-开启"本地网络"；检查订阅是否为Clash YAML格式，必要时使用SubConverter转换
现象：点击Widget节点切换无响应
原因：代理组类型为URL-Test或Load-Balance（负载均衡），不支持手动切换
解决：修改配置文件中该策略组type: select，重新导入订阅
现象：延迟测试始终显示"timeout"
原因：测试URL被墙或节点真连接失败
解决：更换延迟测试URL为http://cp.cloudflare.com/generate_204；检查节点连通性
对于需要长期稳定国际网络加速的用户,建议配合支持自动切换的节点订阅服务使用，选择提供Clash YAML格式、具备故障转移机制的订阅商，可最大化发挥小火箭桌面小组件配置的便捷性。
完成上述小火箭桌面小组件配置后,你可在锁屏界面或主屏幕实时掌握代理状态，实现无需打开App即可切换节点的高效操作，定期更新订阅链接并优化代理组策略，能显著提升跨境办公与学术资源访问的流畅度。
