官方手册 / 首次设置
Shadowrocket 订阅导入与首次连接
按“添加 → 选路由 → 连接 → 验证 → 排错”的顺序操作。先完成一次可复查的连接,再调整规则和自动连接设置。
先准备好完整链接或完整字段,暂时保持连接开关关闭。不要同时修改 DNS、规则和协议参数,否则失败后难以判断是哪一处造成变化。下方截图用于辨认页面与字段,图中条目不作为实际连接信息;界面细节以设备上当前显示为准。
01 · Add Server 添加服务器与 Subscribe 订阅导入
打开 Home 首页,在 SERVER 服务器分组附近找到 Add Server 添加服务器入口。进入后先判断手里的内容:一条用于更新服务器列表的链接,属于订阅;包含协议、地址、端口及认证信息的一组参数,适合手动填写。两种方式任选与已有信息相符的一种即可,不必把同一份内容重复添加。
已有订阅链接:先确认完整,再保存
在 Add Server 添加服务器页点 Type 类型,选择 Subscribe 订阅类型,再把链接粘贴到 URL 地址栏。粘贴后从开头检查到结尾,确认没有把说明文字、引号、换行或空格一起带入。链接中的查询参数往往与访问权限有关,不要因为看不懂就删去问号后的内容,也不要手动拼接缺失部分。
填写便于自己辨认的名称后,点页面上的保存按钮,回到 Home 首页等待导入结果。检查是否出现对应的服务器分组,以及分组内是否有可选条目。如果列表为空,先停在这一步检查链接与更新结果;不要用切换 Global Routing 全局路由来解决列表为空的问题,因为列表尚未成功取得。
已有服务器参数:Type 决定后续字段
手动添加时,先在 Type 类型里选与服务商提供信息一致的协议。官方截图展示的是包含 Host、Port、Password、Method 的填写页:Host 主机地址填写域名或 IP,Port 端口填写指定端口,Password 密码与 Method 加密方法必须逐项一致。不要照抄截图中的值,也不要把另一种协议的字段套进来。
选择不同协议后,页面字段会变化。例如 VLESS 需要核对 UUID 身份标识,以及服务商给出的传输和 TLS 参数;这些内容不能由地址和端口推算。缺少字段时应先核对已有资料,而不是反复尝试随机组合。保存后返回 Home 首页,确认新增条目可见,再继续下一步。
如果拿到的是二维码,可使用 Scan QR Code 扫描二维码入口,并在需要时允许相机访问。导入后仍要核对协议、地址与端口。Import from Cloud JSON 从云端 JSON 导入是另一种导入入口,不等同于普通订阅地址栏。分享链接、剪贴板导入与多订阅整理请继续阅读订阅与服务器管理手册。
02 · Global Routing 选择路由姿态
已有可选服务器后,回到 Home 首页,点 Global Routing 全局路由。这里决定请求按什么方式处理,不负责获取订阅,也不会修正服务器密码。首次使用先认清三种姿态:配置(Config)、代理(Proxy)、直连(Direct)。选定后返回首页,核对 Global Routing 全局路由旁显示的当前值。
配置(Config):按当前配置中的规则处理
配置(Config)依据当前启用的配置文件进行规则匹配,适合已经准备好规则、希望区分不同请求去向的情况。底部 Config 配置页与 Global Routing 全局路由中的 Config 选项有关联,但不是同一个操作:前者管理和编辑配置,后者决定是否按配置处理请求。只导入服务器列表,不代表已经同时导入并选用了适合的规则。
进入 Config 配置页,确认当前使用的是哪份配置,再查看其中的 Rule 规则部分。官方截图是配置编辑页,可看到 General 通用设置、Rule 规则、Hosts 主机映射等分段,以及 Add Rule 添加规则入口。入门阶段先核对已有内容,不必为了连接成功而修改 URL Rewrite 链接重写或 HTTPS Decryption HTTPS 解密等进阶设置。
代理(Proxy)与直连(Direct):先理解用途
代理(Proxy)让通常受该路由姿态控制的请求使用当前代理服务器,适合在基础排查时减少规则选择带来的变量,但不能理解为对每一种系统流量的绝对保证。直连(Direct)则让请求采用直连方式;如果目标是检查代理服务器是否能承载访问,停在直连(Direct)并不能完成这项验证。
已有可信且适用的配置时,选择配置(Config);只想先检查所选服务器的基本连接,可临时使用代理(Proxy),验证后再回到配置(Config)。记下切换前的值,避免测试结束后遗忘当前姿态。规则顺序、策略与配置备份属于后续内容,可在订阅手册继续阅读相关管理说明。
03 · Home 选中服务器并打开连接
回到 Home 首页,在 SERVER 服务器分组中点选这次准备测试的条目,确认它处于选中状态,再核对 Global Routing 全局路由。列表里有服务器不等于已经选中服务器,选中了服务器也不等于连接开关已经打开。这三个状态要分开检查,尤其是刚导入多个分组时。
点顶部 Not Connected 未连接状态旁的开关。首次建立连接时,系统可能提示允许 Shadowrocket 添加 VPN 配置。这是让系统建立相应网络配置的授权步骤,不是填写订阅信息的窗口。确认提示对应 Shadowrocket 后,按系统引导允许,并在系统要求时完成设备验证;不要将设备解锁信息填写到服务器认证字段中。
完成授权后返回应用,观察顶部连接状态是否改变。若开关随即退回,或者系统授权没有完成,先不要快速连续点击。确认刚才是否取消了系统提示、是否仍有待完成的验证,再尝试一次。仅看到系统 VPN 标识或连接计时,也只能说明连接配置已经启动,不能单凭这一项断言网页访问一定正常。
如果之前已允许添加 VPN 配置,本次可能不会再次出现同样的提示,这是正常的授权流程差异。使用 iPad 时同样按“选条目、核对路由、打开开关”的顺序操作;页面排布可能随设备显示方式不同,但要检查的状态不变。接下来保持当前服务器和姿态不变,进入验证步骤。
04 · Connectivity Test 与实际访问验证
先检查顶部连接状态,再点 Home 首页的 Connectivity Test 连通性测试入口,查看当前测试的反馈。测试结果反映的是特定测试方式下的响应,不是服务质量承诺,也不是所有网页都能打开的证明。即使出现延迟数值,认证、DNS 解析、规则选择或目标站点仍可能存在单独的问题。
接着打开浏览器,访问自己平时使用、并且允许访问的网页。先检查页面是否能完整加载,再打开第二个不同的页面,避免仅凭某个页面的缓存做判断。如果连接前页面已经打开,可重新加载后再观察;只看到旧页面内容,不足以证明这次请求通过了当前连接。
验证时同时记住当前姿态。使用直连(Direct)时网页能打开,证明的是该环境下的直连访问;使用配置(Config)时,某个网页能打开,也不代表它一定命中了代理策略。需要进一步确认请求去向时,应结合当前规则和可用的请求记录核对,而不是仅依据连接标识或网页速度猜测。
如果结果符合预期,首次连接流程就已完成。现在可以停止测试,保留当前可用设置;不必立即调整所有选项。若希望比较不同服务器,每次只换一个条目,并在相同路由姿态与相近网络条件下重复测试。测试方式不同或目标不同,得到的数值也不能直接放在一起判断。
05 · Settings 设置与常见失败点
失败时先回想最后一个已确认成功的步骤:列表是否取得、服务器是否选中、连接状态是否建立、实际访问是否成功。按这个顺序定位,比同时重填字段、换配置和修改 DNS 更容易复现问题。下面每项检查结束后,都回到同一个网页重新验证,只改变一个条件。
订阅没有条目:先检查导入过程
若 SERVER 服务器分组没有预期条目,检查链接是否完整、是否填在 Subscribe 订阅对应的 URL 地址栏,以及更新时设备能否访问该地址。网页形式的账户入口不一定是订阅链接;出现登录页面或说明页面,也不等于客户端已经拿到可解析的服务器内容。链接有效性与服务状态需要从你的服务商处核对,不要公开完整链接请求他人代查。
开关打开后失败:先检查选中项与认证
确认有一个实际服务器被选中,再逐项对照 Type 类型、Host 主机地址、Port 端口和认证字段。手填信息尤其要注意相似字符、尾部空格、TLS 与传输参数。系统授权未完成时先完成授权,字段不完整时先补齐字段;重复开关无法替代这些条件。也要留意设备上是否有其他正在使用的 VPN 连接,避免把连接切换误认为本次连接稳定建立。
测试有响应但网页失败:分开检查解析与路由
先换一个日常网页,区分单一站点失败与普遍失败,再核对 Global Routing 全局路由是否符合预期。进入 Settings 设置页可查看 Test Method 测试方式;不同方式检验的范围不同,因此不能用一个延迟结果排除全部问题。需要使用 Diagnostics 诊断时,只查看与当前现象有关的信息,分享记录前检查其中是否包含地址或认证内容。
不要把 DNS 设置改成随机地址,也不要通过跳过证书检查来掩盖认证问题。更细的“延迟正常但网页打不开”、DNS 与规则匹配排查,见常见问题;若问题来自订阅更新或多分组管理,转到订阅手册继续检查,不必在首次设置中一次处理全部进阶选项。
关闭后又连接:核对 On Demand 按需连接
如果手动关闭后又触发连接,进入 Settings 设置页检查 On Demand 按需连接是否启用,以及当前条件是否会触发它。首次测试建议先明确手动连接的结果,再配置自动触发行为。调整前记录原状态,避免为解决自动连接而误删服务器或配置文件。排错结束后恢复需要的设置,再重复“选服务器、开连接、验证网页”的闭环。
最后,客户端的连接设置与服务商提供的访问条件各有边界。已确认字段一致、配置明确而问题仍持续时,整理失败发生的步骤、设备网络环境和错误提示,再从你的服务商处核对服务状态。不要用反复删除全部资料代替定位;修改或删除之前,先备份自己需要保留的配置与连接信息。