Shadowrocket桌面小组件可实时显示代理状态与流量消耗，本文详解iOS小组件添加流程、参数配置技巧及常见显示异常解决方案,助你高效管理跨境网络连接。
小组件功能定位与系统要求
iOS 14+ 系统支持通过桌面小组件快速查看Shadowrocket（俗称小火箭）的运行状态，该功能适用于需要频繁切换国际网络加速节点的跨境办公场景，无需打开应用即可监控流量消耗与连接质量，确保应用版本为2.2.0以上，且已导入有效的Clash YAML格式订阅配置。
三步配置流程
添加Widget到主屏幕
长按主屏幕空白处进入编辑模式，点击左上角"+"号，搜索"Shadowrocket"，提供三种尺寸：小号仅显示当前节点名称，中号增加上传/下载速度，大号额外展示流量统计图表，建议选择中号以平衡信息密度与屏幕占用,拖拽至主屏幕或负一屏即可完成基础部署。
绑定Clash配置与代理组
小组件数据来源于应用内加载的Clash配置，长按已添加的组件选择"编辑小组件"，在"Configuration"中选择对应的订阅配置,关键设置项：
- Proxy Group: 选择需要监控的代理组（如"自动选择"或"手动切换"）
- Show Traffic: 开启实时流量显示，支持显示今日用量或当前速度
此处涉及Clash核心概念：若配置中使用select类型代理组，组件显示当前选中节点名称；若为url-test自动测速组，组件显示"Auto"标识及当前最优节点延迟；fallback故障转移组则在主节点失效时自动变更显示名称并触发颜色提示。
设置刷新频率与隐私权限
进入系统设置 > 通用 > 后台App刷新，确保Shadowrocket权限开启，小组件默认15分钟刷新一次，可在应用内"Widget Settings"中调整为"实时"模式（会增加少量耗电），同时检查"本地网络"权限,确保小组件能读取当前连接状态。
核心参数解析
TUN模式与系统代理的识别
小火箭通过Clash Meta内核支持两种流量转发模式,小组件右上角图标区分：
- Globe图标：系统代理模式（仅HTTP/HTTPS流量,适用于浏览器访问学术资源）
- VPN图标：TUN模式（虚拟网卡接管全部流量含UDP,适合游戏加速与跨境办公视频会议）
分流规则对统计的影响
若Clash配置中包含DOMAIN-SUFFIX或IP-CIDR分流规则，小组件"今日流量"统计仅显示经过代理服务器的流量，直连流量不计入，这是正常现象,不代表功能异常。
进阶布局方案
对于多场景用户,建议添加两个中号小组件分别监控：
- 组件A：绑定"流媒体"代理组（url-test类型），监控YouTube、Netflix等4K视频节点延迟
- 组件B：绑定"办公专线"代理组（select类型），手动控制Zoom、Teams等稳定性要求高的连接
配合iOS快捷指令，可设置自动化：当连接公司Wi-Fi时,自动刷新办公组件并切换至专线节点。
常见问题排查（FAQ）
现象：小组件显示"无配置"或空白
原因：Clash订阅链接未正确导入或YAML格式缺少proxy-groups字段
解决：使用SubConverter工具将订阅转换为标准Clash格式，确保包含proxies和proxy-groups定义后重新导入
现象：流量数据长时间不更新
原因：系统后台刷新权限被限制或应用被完全退出
解决：确保"后台App刷新"开启，避免上滑关闭应用（只需返回主屏幕），iOS会自动管理进程
现象：节点延迟显示与实际测速不符
原因：小组件刷新频率与url-test测速周期不同步
解决：在Clash配置中调整url-test的interval参数至300秒以内，与组件刷新频率匹配
节点订阅优化建议
小火箭桌面小组件的展示效果高度依赖底层节点质量，对于高频跨境办公需求，建议选择支持Clash Premium内核的订阅服务，确保url-test自动切换功能稳定；游戏加速场景需确认节点支持UDP转发并开启TUN模式，定期更新订阅配置，移除失效节点可显著提升小组件"自动选择"的响应速度与准确性。
