官方手册 · 首次连接流程
Shadowrocket 快速上手
订阅导入、连接与验证
本页以 iPhone / iPad 界面为例。先把已有信息准确导入,再选择 Global Routing,最后用实际访问确认结果。第一次操作时,按五步顺序完成即可,不必同时调整所有设置。
- 01 导入信息
- 02 选择模式
- 03 连接授权
- 04 验证结果
- 05 定位失败点
先确认订阅链接可以完整复制,或服务器资料中包含协议类型、地址、端口和所需认证字段。订阅链接可能带有个人访问凭据,不要贴到公开留言、截图或聊天群中。已有配置的用户,建议先保存原配置,再进行本页操作;遇到问题时能够恢复到原状态,比连续尝试多个未知设置更容易判断原因。
下方配图来自 App Store 官方截图,用于定位 Home、Add Server、Config 与 Settings。界面排列可能随应用调整,操作时以设备上显示的英文界面词和实际字段为准。长篇配置管理请转到订阅管理手册,本页只完成首次连接所需的最短流程。
STEP 01 / IMPORT
Add Server:添加服务器或导入订阅
打开 Shadowrocket,进入 Home。首次打开时,SERVER 分组可能还没有可用条目,这是尚未添加连接资料的状态。找到 Add Server 进入添加页;先看手中资料属于订阅链接、单个服务器分享链接,还是需要手填的字段,再选择相应方式。不要把几种资料都当作 Host 地址输入。
已有订阅:选择 Subscribe
在 Add Server 的 Type 中选择 Subscribe,将完整订阅链接粘贴到 URL 字段。粘贴后检查开头、结尾以及中间的查询参数,避免把说明文字、换行或空格一并带入。备注可使用便于自己辨认的名称,例如“个人订阅”;名称只用于管理,不能替代实际链接。确认后保存,等待应用读取订阅,再返回 Home 查看对应分组与服务器条目。
保存订阅信息不等于一定已成功取回服务器列表。如果分组为空或出现读取失败,先核对链接是否完整、当前网络是否能够访问该地址,以及链接本身是否仍然有效。不要通过反复新增同一订阅解决读取问题,否则列表恢复后容易出现重复条目。订阅更新与分组整理的完整说明见Subscribe 管理章节。
已有服务器资料:逐项核对字段
手动添加时,先选择 Type,再填写该类型要求的字段。Host 填服务器地址,Port 填端口;Password、Method 等字段按用户已有资料原样对应。不同协议要求不同,截图里的字段不是所有协议通用的必填表。不要因为协议名相近就替换类型,也不要把完整分享链接粘进 Host。带路径、传输方式或其他参数的资料,同样需要逐项一致。
如果已有二维码,可使用 Scan QR Code 读取;扫描后仍要检查解析出的 Type 与服务器地址。剪贴板中已有受支持的分享链接时,可使用应用提供的导入提示,并在保存前核对结果。Import from Cloud JSON 是另一种导入入口,不应把普通订阅链接或任意文本直接当成对应文件使用。字段含义不清楚时,先查术语表,不要猜测认证参数。
完成任一导入方式后,回到 Home,在 SERVER 列表中选择准备使用的服务器,确认选中标记确实落在该条目上。此时只完成了连接资料准备,还没有决定流量如何处理,也没有建立连接。下一步先检查 Global Routing,避免连接后才发现模式与目标不一致。
STEP 02 / ROUTING
Global Routing:选择流量处理模式
服务器已经出现在列表后,回到 Home,打开 Global Routing。这里选择的是流量处理方式,不是服务器协议,也不是系统连接权限。三种姿态分别为配置(Config)、代理(Proxy)、直连(Direct)。先根据当前要做的事选一种,再进行连接;不要把模式切换当成修复所有故障的通用操作。
配置(Config):依据当前配置匹配规则
日常需要规则分流时,使用配置(Config)。应用按照当前生效配置中的规则处理目标请求,命中的策略可能是 DIRECT、PROXY 或 REJECT。因此,即使连接已经打开,也不是每一个请求都会经过所选服务器。进入 Config,确认当前选用的是自己了解的配置;仅仅在列表里看见某个文件,并不能代替确认它是否生效。
官方截图展示了 Config 编辑页中的 General、Rule、Hosts、URL Rewrite 与 HTTPS Decryption 分段。首次连接不需要逐段修改,更不需要为了导入订阅就启用所有功能。订阅主要解决服务器列表的取得与更新,Config 则决定规则等配置内容,两者不是同一项设置。若已有配置能满足使用需求,先保留其内容,用正常访问验证后再做细调。
代理(Proxy)与直连(Direct):用于明确路径
代理(Proxy)用于让流量按该模式通过所选代理处理,适合在排查时对照服务器路径。它不能保证服务器端一定正常,也不能绕过协议参数错误。直连(Direct)则用于直接连接,不通过所选代理服务器。若目标是测试已有代理服务器是否可用,保持 Direct 进行网页访问,并不能证明该服务器工作正常。
建议记住本次选用的模式:有已确认配置时先用 Config;需要区分“服务器问题”与“规则问题”时,可以临时用 Proxy 对照,测试后恢复原模式。不要一边改规则、一边换服务器、同时切换模式,否则结果难以归因。规则匹配顺序与各策略含义在官方订阅管理手册和规则术语表中继续说明。确认模式后,再返回 Home 执行连接。
STEP 03 / CONNECT
Home:打开开关并确认系统授权
回到 Home,先检查两处:SERVER 中选中的服务器是否正确,Global Routing 是否为上一步确定的模式。确认后,再打开页面顶部的连接开关。官方截图中的 Not Connected 表示尚未连接;不要把“列表有服务器”或“测试有结果”当成连接已经启动的标志。
首次连接时,系统可能弹出添加 VPN 配置的确认窗口。这是应用建立系统网络连接所需的授权流程。先核对发起应用为 Shadowrocket,阅读提示,再按系统要求确认;设备可能要求输入锁屏密码或进行身份验证。完成后返回应用,观察连接状态是否改变。系统授权与服务器账号认证不同,不要把服务器 Password 输入到设备锁屏密码提示中。
如果先前取消了授权,开关可能无法保持开启。此时重新发起连接,并处理系统提示,而不是重复导入订阅。设备已有其他 VPN 连接或受设备管理策略限制时,也可能影响启动;先在系统设置中查看当前 VPN 状态,结束不需要同时运行的连接。单位或学校管理的设备,应遵循设备管理要求,不要随意删除管理描述文件。
开关开启后,先停留片刻,观察是否马上回到断开状态。若能保持连接,可以进入下一步验证;若立刻断开,记录弹出的错误提示或当时状态,直接查看本页失败点排查,不要连续快速开关。系统显示 VPN 状态只能说明相关连接状态,并不等于每个目标请求都成功,也不能证明 Config 中所有规则都符合预期。
首次建立连接期间,不要同时更换网络、修改 Type 或编辑规则。保留这一组明确的条件,后续才容易判断结果来自哪里。需要结束使用时,可以回到 Home 关闭开关,再确认连接状态已经停止。若曾启用 On Demand,还应注意它可能根据条件再次发起连接;首次排查阶段先了解当前设置,避免把自动重连误认为开关失效。
STEP 04 / VERIFY
Connectivity Test:验证连接与实际访问
连接状态保持开启后,在 Home 使用 Connectivity Test。它用于检查对应测试目标的连通表现,结果与测试方法、当前网络和目标响应有关。测试成功是一项参考,不代表所有网站、所有应用或所有协议均可用;测试失败也需要结合目标是否能够响应来判断,不能只凭单次结果认定订阅整体失效。
- 先保留当前条件。记下所选服务器与 Global Routing 模式,运行一次 Connectivity Test,观察是否返回结果或提示超时。不要在测试过程中同时更新订阅或切换服务器。
- 再打开实际页面。切到浏览器访问一个自己熟悉且正常提供服务的页面,尝试打开新页面或刷新,而不是只查看已经缓存的内容。能显示旧页面,不一定说明刚发起的连接成功。
- 最后对照预期路径。Config 模式下,部分目标按规则直连是正常情况。若需要判断某个目标是否经过代理,应结合应用可见的连接记录与命中策略核对,不能只看页面能否打开。
若测试返回结果,实际页面却无法加载,先确认问题是否仅发生于一个目标,再检查目标请求的规则和 DNS 情况。若页面能够正常访问,而测试持续失败,先查看所用 Test Method 与测试目标,不要立即删除全部配置。延迟数值只描述相应测试条件下的响应,不等同于文件下载速度,也不能用它单独判断长时间连接的稳定性。
初次验证以“开关能保持、实际请求能完成、路由与预期一致”为结束条件。不必为了得到某个数值不断排序或切换。验证通过后,保留当前可用设置,再逐项调整个人需要的功能。如果需要加入 On Demand 或更复杂的规则,先阅读订阅管理手册,每次只修改一个设置,并重新执行本步对照。
STEP 05 / DIAGNOSE
Settings:按失败阶段逐项排查
遇到问题时,先描述“在哪一步失败”,比笼统地说“连不上”更有用。请保留当前配置,按以下顺序检查。每完成一项,只重新执行与它有关的步骤;如果同时重装、清空列表和更换网络,就会丢失原本可用于定位的线索。
导入后没有条目:先查输入与更新
先检查自己导入的是订阅链接还是单个服务器分享链接,再核对 Type 与输入位置。订阅为空时,确认 URL 完整、没有多余空白,并检查更新是否返回错误。服务器信息由用户已有订阅决定,客户端无法凭空补齐缺失字段。订阅地址包含凭据时,不要公开链接;如需核实资料有效性,通过用户原有的资料管理渠道确认即可。
开关无法保持:先查授权与系统状态
确认首次 VPN 授权已经完成,再查看系统当前 VPN 状态及是否存在设备管理限制。若开关一开即关,记录应用显示的错误,而不是先修改 Method 或添加规则。只有在客户端确实能够启动连接之后,测试服务器网络路径才有意义。重启应用或设备可以作为恢复尝试,但不能替代对具体错误的核对。
已连接但访问失败:先查服务器,再查规则
手填服务器先对照 Type、Host、Port 和认证字段;导入服务器则确认当前选择的条目仍有效。可以在同一网络中暂时使用 Proxy 做对照,再恢复原模式;若 Proxy 正常而 Config 异常,重点检查当前配置、目标命中策略与 DNS。若两者都失败,再在条件允许时切换一次 Wi-Fi 与蜂窝网络,区分本地网络影响。切换网络可能产生流量费用,操作前留意设备设置。
只在部分场景失败:检查测试方法与记录
进入 Settings,可看到 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 等设置。先查看 Test Method 是否适合当前测试,不要因为一次失败就同时修改 TCP 与 UDP 相关选项。仅某个应用或目标异常时,重点记录发生条件、所用模式和目标范围;On Demand 引发的自动连接行为也应单独核对,避免与手动连接问题混在一起。
需要进一步定位时,再使用 Diagnostics 查看或收集相关记录。分享记录前检查其中是否含有订阅 URL、服务器地址、密码或其他个人信息,只保留复现问题所需的部分。更多问题按分类查看问答与故障排查;涉及多订阅更新、重复条目、备份与恢复时,继续阅读订阅管理手册。完成排查后,恢复临时改动,并重新执行连接与验证两步,形成闭环。