Shadowrocket 使用说明导入、连接与验证。
以 iPhone / iPad 界面为例,从已有资料开始操作。先确认服务器可以连接,再检查规则是否按预期处理请求;遇到问题时,按相同顺序回查。
添加服务器或导入订阅。先让资料出现在列表中。
打开 Shadowrocket,进入 Home。先判断手中的资料类型:一条用于获取服务器列表的完整链接,通常应按订阅导入;分别列出的服务器地址、端口、协议与认证参数,则适合手动填写。两种方式选择一种即可,不必把同一份资料重复添加。导入成功只代表应用读到了资料,还没有证明服务器可用。
已有订阅链接:在 Add Server 选择 Subscribe
在 Home 点击 Add Server,进入后打开 Type,选择 Subscribe。将自己的完整订阅链接粘贴到 URL 字段,确认开头与结尾没有空格、引号或换行,再填写一个便于辨认的名称并保存。链接可能带有较长的查询参数,不要为了缩短显示而删掉问号后面的内容,也不要把服务商的网页登录地址当作订阅地址。
保存后返回 Home,等待订阅内容载入,查看 SERVER 区域是否出现相应分组及服务器条目。若只看到分组名称、里面没有可选内容,先检查订阅地址和当前网络,不要立即反复新增同一链接。已有分组需要刷新时,应在该分组上执行更新操作;更新失败先保留原条目,以免把仍可对照的信息一并删除。
已有服务器参数:按 Type 对应字段填写
如果资料是单台服务器的参数,仍从 Add Server 进入,但 Type 应选择资料指定的协议。以 Shadowsocks 为例,对照填写 Host、Port、Password 与 Method。Host 是服务器地址,通常不需要添加网页地址的路径;Port 应与资料完全一致,Method 也应照原值选择,不能按名称相似程度猜测。
不同 Type 展示的认证字段并不相同。资料要求的标识、TLS、传输方式或其他选项,应逐项核对;不能把某个协议的密码直接填到另一种协议的字段中。已有二维码时可使用 Scan QR Code,导入后仍需复查 Type 与地址。Import from Cloud JSON 只用于匹配其格式的资料,不是普通订阅链接的通用粘贴入口。
保存后回到 Home,点选准备使用的服务器,确认选中标记已移动到该条目。至此只完成“资料已添加、目标已选中”,下一步还要确定请求采用哪一种处理姿态。订阅管理与重复条目的详细处理可查看常见问题,首次连接前不必同时整理全部分组。
选择 Global Routing 姿态。区分服务器与规则。
服务器决定“代理连接交给哪个目标”,Global Routing 决定“请求按什么方式处理”。两者不是同一项设置。在 Home 点击 Global Routing,查看当前选中的配置(Config)、代理(Proxy)、直连(Direct)。如果出现“开关已打开,但某些请求仍然直接连接”的情况,应先检查这里,而不是立即重新导入订阅。
配置(Config):按当前配置中的规则处理
日常希望按规则分流时,选择配置(Config)。再切换到底部的 Config 页面,确认已有并选中了准备使用的配置文件。这里的 Config 页面与 Global Routing 中名为 Config 的姿态有联系,但职责不同:前者用于管理配置,后者表示连接时采用规则处理。只切换姿态,并不会自动把某份远程规则导入应用。
进入配置编辑页后,可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。首次使用先确认 Rule 的内容,不必为了建立连接同时修改每个分段。Add Rule 用于添加规则;改动前应保留原配置副本,并记下原来的规则顺序。对来源不明、用途不清楚的附加设置,先暂停修改,避免把连接问题和配置问题叠在一起。
规则按顺序匹配,前面的规则已经命中时,后面的规则通常不再决定同一请求的结果。下面两行只是说明规则结构:第一行让局域网地址采用 DIRECT,第二行是最终匹配项。这不是服务器配置,也不是建议直接覆盖现有文件的完整配置。其中 PROXY 应结合实际配置中的策略含义理解。
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
代理(Proxy)与直连(Direct):用于明确路径和对照
代理(Proxy) 让通常可接管的请求采用代理路径,可临时用于判断问题是否与规则选择有关,但不应将其理解为所有应用、所有系统流量都必然经过服务器。直连(Direct) 则用于直接连接的对照;如果停留在 Direct,即使连接开关打开,也不能据此认定请求正在使用所选服务器。
首次排查时,可以先用 Proxy 对照服务器连接,再切回 Config 检查日常规则表现。每次切换都记住当前姿态,不要一边替换服务器、一边改规则、一边切网络。规则关键字与配置管理的延伸问题见常见问题;商店获取与账号问题另见App Store 指南。
打开连接开关。完成系统授权后再观察状态。
回到 Home,先检查 SERVER 中选中的服务器,再看 Global Routing 是否为刚才确定的姿态。截图中的 Not Connected 表示当时尚未建立连接,是用于辨认开关位置的初始状态,不代表你的设备必须显示完全相同的列表内容。
打开 Home 顶部的连接开关。首次操作时,系统可能请求允许添加 VPN 配置;阅读提示,确认请求由 Shadowrocket 发起,再按照系统要求完成设备验证。这个步骤是在设备上授权建立网络连接配置,并不是要求把服务器密码填写到系统账号验证框中。完成授权后返回应用,等待连接状态变化,不要在提示尚未处理完时连续点击开关。
如果刚刚拒绝了授权,先回到应用再次尝试连接,并检查系统是否给出新的提示。仍不能建立时,查看设备是否受到组织管理策略限制,以及是否有其他正在运行的 VPN 连接。不要随意删除不认识的系统配置;受管理设备应先确认使用权限,再按管理要求处理。
开关保持开启、应用状态发生变化后,才进入下一步验证。状态变化说明本地连接流程有所进展,不能单独证明远端服务器认证成功、目标网站可以访问或规则完全符合预期。反过来,若开关立即弹回关闭,也不必重新购买或重新安装,应先记录系统提示并检查授权与配置。
第一次连接期间,建议保持当前 Wi-Fi 或蜂窝网络不变,也暂不启用新的 On Demand 条件。先完成一次手动连接和断开,确认基本流程正常,再考虑自动触发连接。这样出现异常时,能区分是手动连接本身失败,还是自动连接条件造成了重复切换。
验证连接是否生效。把测试结果与实际访问分开看。
验证的第一步不是比较数字,而是确认基础网络。必要时先断开 Shadowrocket,打开一个平时能够直接访问的页面,确认 Wi-Fi 或蜂窝网络本身正常。如果网络还在等待网页登录、信号中断或系统限制了应用联网,服务器测试也可能一起失败,此时应先恢复基础连接。
回到 Home,使用 Connectivity Test 检查候选服务器。测试过程依据当前 Test Method 执行,因此结果反映的是特定测试条件下的可达情况。出现一个响应数值,不等于目标网页、视频或其他业务已经可用;出现超时,也不宜只凭一次测试就断定服务器资料永久失效。先确认测试方法,再用相同条件做一次复测。
随后保持连接开启,打开实际需要使用的页面,观察能否完成一次新的加载。仅看到浏览器里原来已经打开的内容不够,因为它可能来自缓存。可以重新载入页面,或打开同一服务中的另一个页面;如果只有某一个应用异常,应将问题范围收窄到该应用、目标地址或相关规则,而不是直接判定整个连接失效。
接着对照 Global Routing。处于 Config 时,目标可能命中 DIRECT、PROXY 或其他已定义策略;能够打开页面,不一定代表使用了代理。若需要比较路径,可保持服务器与网络不变,临时切换 Proxy 再测试相同目标,然后恢复 Config。若 Proxy 正常而 Config 异常,应优先查规则与配置;若两者都失败,再回查服务器参数、认证和基础网络。
验证通过后,保留这组已经确认可用的设置。后续再调整规则或 On Demand 时,若出现新问题,就可以回到这组基准条件对照。更细的订阅更新、连接超时与规则问题,可按现象进入常见问题继续查找,不必在首次连接时一次性修改所有设置。
常见失败点排查。从资料到网络逐项回查。
导入后列表为空,或服务器突然减少
先核对导入的是完整订阅链接,而不是介绍页或账户页面。再确认当前网络能取得订阅响应,以及自己的服务状态是否允许获取内容。订阅更新可能改变服务器数量和名称,这与客户端连接开关是两件事。保留已有分组,向自己的服务商核对链接有效性后再更新,不要通过反复创建分组来尝试修复同一个地址。
能够看到服务器,但连接持续失败
打开该条目的编辑页,逐项核对 Type、Host、Port 和认证字段,注意复制时带入的空格、大小写和被遗漏的附加参数。再回 Home 确认真正选中的是刚检查的条目,而不是另一组中的同名服务器。若问题只在一种网络发生,可在允许的条件下更换 Wi-Fi 或蜂窝网络对照,但不要同时更改配置,以免失去判断依据。
测试有响应,实际页面仍打不开
进入 Settings,查看 Test Method,弄清刚才进行的测试。测试响应不等于完整协议握手、DNS 解析和目标服务访问都正常。先测试另一个明确目标,判断是单站异常还是普遍失败;再回查 Config 中的规则和当前 Global Routing。若临时使用 Proxy 可恢复,而 Config 不行,优先检查规则顺序与最终匹配项,不要直接修改所有 DNS 或 TLS 设置。
连接反复变化,或只在切换网络后异常
检查是否启用了 On Demand,以及设备上是否存在其他会影响 VPN 连接的设置。为了排除自动触发条件,可以在记下原值后暂时停用 On Demand,回到手动连接流程复测。网络从 Wi-Fi 切到蜂窝后出现的中断,应与切换前的状态分别记录;一次重连恢复,不能直接证明原规则有误。
需要进一步观察时,使用 Diagnostics
Settings 中的 Diagnostics 可用于进一步排查。先保留错误发生时的时间、目标与状态,再查看相关诊断信息;不必为了“全面排查”同时改动 Proxy、TCP、UDP 等多个设置。向外描述问题时,只提供必要的错误文本与操作顺序,遮住订阅 URL、密码、认证标识等敏感内容。诊断信息也应先检查再分享。
如果完成上述检查仍不能连接,整理为一条可复现的过程:使用哪类网络、选择哪个 Type、在哪一步失败、系统或应用给出什么提示,以及 Direct、Proxy、Config 对照结果。服务器认证或订阅内容的问题,应向自己的服务商核对;应用获取与恢复问题可看App Store 指南,其他操作问题可进入常见问题。这些信息比“无法使用”更便于定位。