Shadowrocket桌面小组件可实现节点状态监控与一键切换，无需打开主应用，本文详解iOS系统权限配置、小组件参数映射逻辑及YAML规则联动方法,帮助用户构建高效的跨境网络加速可视化控制面板。
前置条件与系统权限配置
小火箭桌面小组件配置前，需确保Shadowrocket已获取网络扩展权限，进入设置 > 小组件，确认"实时活动"与"后台刷新"已启用，iOS 17+用户需额外检查"本地网络"权限,否则小组件无法读取节点延迟数据。
小组件类型与代理组映射逻辑
Shadowrocket支持四种桌面小组件形态：节点切换器、流量统计、延迟测试、快捷开关,配置时需理解代理组类型映射关系：
Select组（手动选择）：小组件显示当前选中节点名称，点击展开下拉列表切换,适合跨境办公需求中需要固定特定IP场景。
URL-Test组（自动测速）：小组件显示测速优胜节点，但不可手动干预，配置参数建议设置interval: 300（5分钟）,避免频繁测速耗电。
Fallback组（故障转移）：小组件显示当前活跃节点，当主节点延迟超过阈值自动切换，学术资源访问场景下，建议配合health-check启用。
TUN模式与系统代理的组件差异
小火箭桌面小组件配置需明确流量接管模式：
- 系统代理模式：小组件仅显示HTTP/HTTPS流量统计，UDP流量（如游戏、视频通话）不计入统计
- TUN模式（推荐）：小组件显示全流量数据，包括ICMP延迟测试，配置时需在Shadowrocket设置中开启"TUN Interface",并确保YAML配置包含：
tun:
enable: true
stack: system
dns-hijack:
- 8.8.8.8:53
分流规则与组件显示优化
受分流规则直接影响，配置DOMAIN-SUFFIX规则时，建议将常用学术资源域名加入直连组,避免统计污染：
rules: - DOMAIN-SUFFIX,edu.cn,DIRECT - DOMAIN-SUFFIX,ac.uk,DIRECT - IP-CIDR,192.168.0.0/16,DIRECT - GEOIP,CN,DIRECT - MATCH,Proxy
优先级逻辑：DOMAIN精确匹配 > DOMAIN-SUFFIX后缀匹配 > IP-CIDR段匹配 > GEOIP国家码,小组件流量统计遵循此优先级显示归属类别。
常见问题排查（FAQ）
现象：小组件显示"无法加载"或空白
原因：Shadowrocket后台进程被系统终止，或订阅链接未更新节点列表
解决：重新添加小组件；检查配置文件中proxy-providers是否设置health-check-url有效
现象：延迟测试数值与主应用不一致
原因：小组件使用独立测速线程，受iOS后台限制可能延迟执行
解决：在小组件编辑界面关闭"实时延迟"，改用"上次测速结果"模式
现象：切换节点后小组件未同步更新
原因：配置文件中存在缓存策略，或Select组未正确关联
解决：检查YAML中use字段是否引用正确代理组，强制重启Shadowrocket刷新配置
进阶自动化配置
对于高频国际网络加速用户，建议结合快捷指令自动化：创建"到达办公室"地理围栏触发器，自动切换至办公专用节点组，此配置需在小火箭桌面小组件中预设快捷指令URL Scheme：shadowrocket://switch?group=Office&policy=HK-01。
选择稳定节点订阅是小组件准确显示的基础，建议优先选择支持Clash YAML格式、提供自动故障转移的订阅服务，确保桌面组件反映真实网络质量，配置完成后，建议每周验证一次订阅链接有效性,避免因节点失效导致小火箭桌面小组件配置显示异常。
