官方手册 / 首次设置
Shadowrocket 入门指南
先添加已有服务器,再选择 Global Routing,最后连接并验证。首次设置建议预留约十分钟,按顺序操作,不同时修改多个设置。
步骤 01 / 让 Home 出现可选择的服务器
Add Server:添加服务器或导入订阅
先判断手里的资料属于哪一种。包含一组服务器、可定期更新的链接,通常按订阅导入;只有地址、端口、协议和凭据的资料,则按单个服务器填写。两种方式选一种即可,不必把同一份资料重复添加。订阅链接从你的服务商处获取,导入前确认它属于你自己的账户,复制时不要带入说明文字或行尾空格。
已有订阅链接:使用 Subscribe
打开 Home,点击添加入口进入 Add Server,再点击 Type,在类型列表中选择 Subscribe。回到表单后,将完整订阅链接填入 URL 对应的位置,按需写一个便于辨认的备注,然后使用页面上的保存按钮完成添加。订阅的作用是取回并维护一组服务器条目,不是直接替代连接开关。
保存后返回 Home,等待订阅读取完成,再查看 SERVER 中是否出现对应分组与服务器。如果只出现了订阅名称,却没有可选择的服务器,先检查更新是否成功,不要直接进入连接步骤。链接可能已过期,也可能返回了登录提示或其他不适用的内容。具体排查见疑难解答中的订阅与节点导入说明。
已有单个服务器信息:按 Type 填写
在 Add Server 中将 Type 选为资料注明的协议,然后逐项填写 Host、Port、Password 等内容。Host 填服务器主机名或地址,Port 填对应端口;若表单出现 Method,必须与已有资料一致。不同 Type 的字段并不完全相同,不要仅凭字段看起来相似就照填,也不要把订阅链接整段放进 Host。
示例主机名可写作 example.com,它只是说明字段含义,不是可用服务器。需要额外认证、TLS 或其他参数时,应逐项核对自己的原始资料。保存后回到 Home,检查条目名称和协议是否符合预期。密码等敏感内容不要写进备注,备注只用于区分用途或来源。
二维码与剪贴板:导入后仍需检查
若资料是二维码,可使用 Scan QR Code,按系统提示允许相机访问,再扫描你已有资料中的二维码;若拿到的是服务器分享链接,可使用应用提供的剪贴板导入入口。读取成功后,检查 Type、Host 和 Port,再保存。二维码和分享链接只是携带参数的方式,扫描成功不代表服务器已经能够连接。
本步骤结束时,Home 中应至少有一个可选择的服务器。多份订阅、重复条目、更新策略和备份不必在首次设置时一起处理,后续可按订阅与服务器管理手册整理。接下来先确定流量如何处理,再打开连接开关。
步骤 02 / 确定流量处理方式
Global Routing:配置、代理与直连
回到 Home,点击 Global Routing。首次使用先分清三种姿态:配置(Config)、代理(Proxy)、直连(Direct)。它们决定连接开启后如何处理流量,并不是三个服务器,也不会自动补齐服务器信息。切换前记下原来的选择,便于完成测试后恢复。
配置(Config):按当前配置中的规则处理
选择 Config 时,流量依据当前选中的配置文件匹配规则,再交给相应策略处理。进入 Config 页面,先确认当前选择的是你打算使用的配置文件;需要查看内容时,再打开文件编辑页。官方截图中的 General、Rule、Hosts 等分段属于配置内容,不是首次连接必须逐项填写的表单。
如果已有可信配置,应先阅读其说明,再核对规则引用的策略是否存在。规则通常按顺序匹配,例如 DOMAIN-SUFFIX,example.com,PROXY 表达对相应域名后缀使用指定策略。示例中的 PROXY 必须在实际配置上下文中有正确含义,不能把一行示例孤立粘贴后就认为分流已经完成。
代理(Proxy):用于检查所选服务器的连接
Proxy 会让受该模式处理的流量使用代理路径。首次排查时,可以临时选择它,减少规则选择造成的干扰,帮助判断所选服务器是否具备基本连通性。这只是检查步骤,不意味着所有场景都应长期使用 Proxy,也不代表任意目标都必然可访问。测试完成后,应按自己的配置目标决定是否切回 Config。
直连(Direct):不使用所选代理服务器
Direct 用于直接连接。若当前选了 Direct,即使 VPN 配置处于启用状态,也不能据此判断流量正在经过所选服务器。发现访问结果与预期不同,先回到 Global Routing 查看实际选择,比重复导入订阅更有针对性。
首次设置不要顺便修改 URL Rewrite 或 HTTPS Decryption。它们不是让服务器连接成功的前提,涉及的配置影响也不同。此时只需要记住当前姿态,并确认 Config 的文件选择或 Proxy 的服务器选择。规则顺序与策略名称的深入问题可继续查看规则分流与故障排查,本教程接着完成一次实际连接。
步骤 03 / 选择条目并允许 VPN 配置
Home:打开连接开关
返回 Home,在 SERVER 中点选一个你已有的服务器。应选择具体条目,而不只是查看订阅分组名称。若有多个条目,首次测试先固定其中一个,避免每次换服务器又换模式,最后无法判断哪项变化起了作用。确认 Global Routing 仍是上一步选定的姿态。
找到 Home 顶部 Not Connected 旁的开关,将它打开。首次连接时,iPhone 或 iPad 可能显示添加 VPN 配置的系统提示。确认当前操作来自正在使用的 Shadowrocket 后,按提示允许添加,并完成系统要求的设备验证。该授权用于建立设备的 VPN 配置,不是购买应用或订阅的确认步骤。
完成授权后返回应用,观察顶部状态是否从 Not Connected 变为连接状态。若刚才取消了系统提示,先重新发起连接并完成授权,不必立即删除应用。系统状态栏中的 VPN 标识可以辅助确认配置是否启用,但不同设备与显示位置可能不同,仍应结合 Home 的状态判断。
连接状态成立,只说明连接流程已启动,不等于所有访问都已验证成功。服务器不可达、参数不匹配或规则选择错误,都可能让应用显示的连接状态与实际访问体验不一致。因此打开开关后,不要立刻批量改设置,先进入下一步做小范围验证。
需要停止使用时,回到 Home 关闭开关,再确认状态恢复。若设备上还有其他正在工作的 VPN 配置,测试前先明确当前由哪一个配置接管连接,避免同时切换造成误判。首次设置先保持手动连接,On Demand 可在基础连接验证成功后另行配置。
步骤 04 / 分开检查状态、连通性与访问结果
Connectivity Test:验证是否生效
验证分三层进行:先看连接状态,再看服务器测试,最后看实际访问。三层各回答一个问题,不应互相替代。Home 顶部说明连接是否启用,Connectivity Test 提供特定测试方法下的结果,真实页面访问则说明当前网络、服务器与模式组合能否完成你的实际请求。
在 Home 点击 Connectivity Test,对已有服务器执行测试。先关注是否有结果,再比较结果是否稳定;不要把一次较低的延迟当成速度或可靠性的保证。测试方法不同,测量对象也会不同,数字只适合在相同测试方法和相近网络条件下作参考。一个条目出现超时,应先重测一次,并检查基础网络,而不是立即删除整份订阅。
随后打开平时使用、已知可正常访问的页面,刷新并尝试进入另一个页面,避免只看到先前缓存的内容。先验证简单页面,再测试你实际需要的应用。若简单页面可访问而某个应用失败,问题范围已缩小,不应直接认定全部连接都失效。
使用 Config 时,还要检查结果是否符合自己的分流目标。某些目标本来应走 DIRECT,另一些才走代理;直接访问成功并不能证明代理路径有效。可以结合应用提供的连接记录查看目标命中的规则和策略,再对照当前配置。记录可能包含域名或其他访问细节,分享前应先遮盖敏感信息。
到这里,若状态正常、测试有响应、实际访问也符合预期,首次连接就已完成。可以记下使用的服务器备注、Global Routing 和网络类型,作为以后排错的基线。若任一层失败,按下一步从基础网络向应用设置逐层检查,不必反复执行整套导入流程。
步骤 05 / 保留现有资料,逐层缩小范围
Settings 与首次连接失败点
先判断失败发生在哪一步:订阅没有读出条目、开关无法保持启用、Connectivity Test 没有响应,还是只有部分访问异常。不同现象对应不同检查路径。先记下准确的界面提示,再处理对应环节;不要把删除应用作为第一步,以免同时丢失本地配置与排查线索。
先检查基础网络与订阅读取
暂时停止连接,确认当前 Wi-Fi 或蜂窝网络本身能正常使用;遇到需要登录的网络,先完成网络认证。随后检查订阅是否更新成功。如果更新失败,核对完整链接、有效状态和复制内容,必要时向你自己的服务商确认原链接是否仍有效。订阅地址可能携带账户凭据,不要将完整链接贴入公开截图或求助文本。
再核对服务器字段与模式
手动添加的条目应逐项对照原始资料,重点检查 Type、Host、Port、Password,以及对应协议要求的其他参数。字段存在不代表值正确;相似字符、遗漏内容或误选 Method 都会影响连接。订阅导入的条目若由订阅维护,先确认更新状态,再决定是否编辑,避免本地改动在下次更新时被覆盖。
如果服务器测试有响应但实际访问失败,返回 Home 核对 Global Routing。Config 下检查选中的文件与规则策略;必要时临时改为 Proxy 做单条件比较。若只有 Config 出现异常,优先查规则与策略,不要重新录入已经验证可用的服务器。若当前是 Direct,则应先明确这是否符合本次测试目标。
最后检查测试设置与系统权限
进入 Settings,找到 Test Method,确认当前测试方法,再返回 Home 以同一方法重测。Settings 中的 Diagnostics 可作为进一步检查的入口;诊断信息的用途是提供线索,不是自动修复所有连接问题。整理记录时,只保留错误提示、测试方法与发生步骤,并遮盖密码、订阅链接和其他凭据。
若顶部始终停留在 Not Connected,回想首次系统授权是否被取消,并重新发起连接检查提示。若开关已启用而实际访问失败,应回到服务器与模式检查,而不是只反复操作系统权限。记录中出现的错误不熟悉时,可按现象查阅疑难解答,避免凭单个词就改动多个高级选项。
On Demand:基础连接完成后再设置
On Demand 用于按设定条件发起连接,不是修复服务器参数的开关。先完成手动连接与停止的验证,再按自己的网络使用习惯配置。如果测试过程中出现自动重新连接,检查是否启用了 On Demand,并在理解当前条件后临时调整。首次操作不需要同时修改 Settings 中的 Proxy、TCP 或 UDP 等高级项目。
本教程的完成标准是:已有服务器能够被选择,Global Routing 符合目标,开关可以正常启停,实际访问已验证。后续再处理订阅整理、更新与备份,阅读节点管理手册即可;遇到具体失败现象时,保留当前配置并按问题分类继续查找,比从头重做更容易定位原因。