官方手册 / 快速上手

Shadowrocket 导入与连接

按添加、模式、连接、验证、排错的顺序操作。先建立一条可验证的连接,再调整规则与自动连接条件。

本文以 iPhone / iPad 上的操作为主。界面词保留英文原文,截图用于定位入口;实际布局与可用选项请以当前应用界面为准。

01 · Add Server 与 Subscribe

按手中资料的类型选择一种添加方式,不必重复导入。

打开 Shadowrocket,进入底部的 Home。在 SERVER 分组找到 Add Server,也可使用界面上的添加入口进入编辑页。先判断手中的是单个服务器字段、完整订阅链接,还是兼容的二维码:三者对应不同的导入方式。订阅链接不是服务器的 Host,不能把整条链接拆进 Host 与 Port。

已有服务器信息:先选 Type,再填字段

在 Add Server 页点开 Type,选择与你已有信息一致的协议类型。以 Shadowsocks 为例,按原始资料填写 Host、Port、Password 和 Method。Host 填服务器域名或地址,Port 填端口;Method 必须与服务器端一致,不要根据名称相似程度猜选。不同 Type 会显示不同字段,截图中的字段并不适用于所有协议。

填写时特别检查复制内容两端是否带空格、端口是否误用全角数字、密码是否被输入法替换标点。若资料还有 TLS、传输方式或其他附加参数,应按原始说明逐项核对,不能只填四个基础字段就认为配置完整。完成后使用页面的保存或完成按钮,返回 Home,确认 SERVER 中已经出现对应条目。

已有订阅链接:使用 Subscribe

如果已有完整订阅链接,在 Type 中选择 Subscribe,把链接完整粘贴到 URL 字段,再填写便于辨认的备注并保存。链接中的查询参数可能承载访问凭据,不能随意删减或分享。保存后等待内容载入;若当前界面提供更新操作,可对该订阅执行一次更新,再检查是否展开或列出了服务器条目。

订阅条目用于管理一组服务器,并不意味着列表中的每个条目都已经通过连接验证。请在 Home 选择其中一个实际服务器作为本轮测试对象,记住它的名称,后续不要一边测试一边更换。若列表为空,先核对链接是否仍有效、复制是否完整以及当前网络能否取得订阅内容,避免连续重复添加相同链接。

已有二维码:Scan QR Code

在 Add Server 页使用 Scan QR Code,按系统提示授予所需的相机权限,将你已有的兼容二维码完整放入取景范围。识别后先检查导入的是单个服务器还是订阅,再核对 Type、Host 或 URL 等关键信息。扫码只是录入方式,不会替你验证资料是否有效;识别失败时可改用原始链接或字段录入,不要靠修改二维码内容尝试修复。

页面底部的 Import from Cloud JSON 是另一种资料导入入口,不是任意订阅链接的通用替代方式。只有已有资料明确采用相应格式时才使用。完成任意一种添加后,下一步先决定 Global Routing 如何处理流量,而不是立即修改多项高级设置。

Shadowrocket 官方 Add Server 页面,显示 Type、Host、Port、Password、Method 与 Scan QR Code 入口
Add Server:先选择 Type,再按已有资料填写;显示的字段随类型变化。

02 · 选择 Global Routing

服务器决定连接目标,Global Routing 决定流量处理方式。

回到 Home,点开 Global Routing。这里的三个姿态是配置(Config)、代理(Proxy)、直连(Direct)。它们不是三种服务器协议,也不是连接开关的替代品。选择姿态后仍需完成下一步的连接操作,才能验证实际路径。

配置(Config)按照当前启用配置中的规则处理流量,可能让不同目标分别走 PROXY、DIRECT 或其他已定义策略。日常需要规则分流时,先确认配置来源与内容,再使用这一姿态。仅仅在 SERVER 选择了服务器,不代表所有请求都会经过它;若某个目标匹配 DIRECT,走直连是规则的结果。

代理(Proxy)在通常的流量处理层面使用所选代理路径,适合短暂核对服务器是否可用、隔离规则带来的影响。它不等于所有应用请求都一定通过同一条可观察路径,仍需结合实际目标与连接记录判断。直连(Direct)用于直接连接目标,可作为基础网络对照;Direct 下目标能打开,并不能证明代理服务器本身可用。

使用 Config 前检查当前配置

进入底部 Config,确认准备使用的是哪份配置,再打开其内容查看。官方截图展示的是配置文件编辑页,包含 General、Rule、Hosts、URL Rewrite 与 HTTPS Decryption 等分段;它不是 Global Routing 的选择菜单。先认清两处入口,避免把编辑配置误当成切换姿态。

首次使用只需重点核对 Rule:域名规则、网段规则与最终规则各自指向什么策略,引用的策略是否存在。通过 Add Rule 添加规则前,应先保存原配置副本。规则通常按顺序匹配,较早命中的规则会影响后续处理;例如 DOMAIN-SUFFIX 用于域名后缀匹配,FINAL 则负责前面未匹配流量的最终处理。

此时不需要为了建立首次连接而调整 URL Rewrite 或 HTTPS Decryption。保持变更范围小,才容易判断是服务器、规则还是网络出现问题。若没有经过核对的规则配置,可先用 Proxy 做短暂连通性验证,再回到 Config 逐项检查。规则概念与协议字段的深入说明见协议详解,具体使用疑问可查阅问答。

Shadowrocket 官方 Config 配置编辑页面,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config 编辑页:检查 Rule 与配置内容;Global Routing 在 Home 中另行选择。

03 · Home 连接与系统授权

确认所选服务器与姿态,再打开顶部开关。

回到 Home,先确认 SERVER 中选择的是刚才录入或导入的实际服务器,再检查 Global Routing 显示的姿态是否符合本次测试目的。若使用 Config,还要确认启用的是刚刚检查过的配置。三项对应关系核对完成后,打开顶部位于 Not Connected 状态附近的连接开关。

首次建立连接时,系统可能提示允许添加 VPN 配置。该提示表示 Shadowrocket 需要通过系统网络扩展接管相应流量;此步骤仅用于授予网络权限。阅读应用名称与权限说明后,按你的意愿允许,并根据系统要求完成设备验证。若取消了授权,本次连接不会完成;应返回应用重新发起,而不是反复重新导入服务器。

授权流程结束后回到 Home,观察连接开关与状态文字是否更新。若界面仍停留在 Not Connected,先等当前请求结束,再核对是否还有待处理的系统提示。不要只根据状态栏某个图标判断,因为系统显示方式可能随设备与当前界面变化;应用内状态和后续实际请求应一起检查。

连接状态不等于目标可访问

开关保持开启,只能说明系统连接流程已经建立或正在工作,不能单独证明所选服务器、DNS 与目标服务均正常。下一步还需要执行 Connectivity Test,并打开实际要使用的页面。若有其他正在管理设备网络连接的配置,先确认当前生效的是哪一项,避免测试过程中被其他连接状态改变干扰。

首次验证期间先保持 On Demand 条件不变,也不要一边切换网络一边更换服务器。需要结束测试时,回到 Home 关闭连接开关,再确认状态恢复。连接资料会继续保留,关闭开关并不等于删除订阅或服务器。

Shadowrocket 官方 Home 页面,显示 Not Connected 开关、Global Routing、Connectivity Test、SERVER 与 Add Server
Home:依次核对服务器、Global Routing 与顶部连接状态。

04 · Connectivity Test 与实际验证

测试结果、目标访问与规则记录需要相互印证。

在 Home 点开或执行 Connectivity Test,等待结果出现。测试用于观察当前条件下的连通表现,不是对所有目标服务的保证。结果受测试方式、测试目标、当前网络与服务器状态共同影响,因此单次超时不应直接等同于全部请求失败,单次成功也不能证明每条规则都正确。

接着打开你实际需要使用的目标页面,重新发起一次请求,观察是否能加载预期内容。尽量使用新打开的页面,避免缓存内容让你误以为当前路径已经生效。若目标本来就能直接访问,仅看到页面打开仍不足以区分代理与直连;需要继续结合 Global Routing 和记录判断。

检查 Data 中的策略与连接信息

返回应用进入 Data,查看当前界面提供的连接或请求记录。若能看到目标、匹配规则或策略,重点核对是否与预期一致:Config 下命中 DIRECT 的请求不应被误判为“代理没连接”,而命中 PROXY 后失败的请求则需要继续检查服务器与目标。记录名称与详细程度随当前功能和界面而异,以实际显示为准。

如果仍不能确定问题位置,可在记下原姿态后短暂切换 Proxy,再对同一个目标重试;然后切换 Direct 做基础网络对照。每次只改变姿态,保持服务器、网络与目标一致,才能使结果具有比较意义。Proxy 可用而 Config 不可用时,优先检查配置规则及引用策略;两者均失败时,再检查服务器字段与基础网络。

测试结束后恢复你准备日常使用的姿态。如果改回 Config,重新确认启用配置,不要把临时排错姿态长期保留而忘记原因。建议记录本轮使用的服务器名称、姿态、网络类型与失败现象,不需要保存或公开订阅链接、密码等凭据。完成这一步后,再考虑是否设置 On Demand 等自动连接功能。

05 · Settings 与常见失败点

按网络、资料、授权、规则的顺序检查,每轮只改一项。

订阅没有条目:先检查取得内容的过程

如果保存 Subscribe 后 SERVER 仍没有实际服务器,先暂停连接,确认设备当前网络可正常访问。再核对订阅 URL 是否完整,是否误复制了说明页面地址,链接是否已经失效,以及订阅内容是否适用于当前导入方式。通过已有资料的提供方核实状态即可,本站不提供替代订阅。保留原条目,先做一次有明确结果的更新,不要重复建立许多相同订阅。

有条目但连接失败:回到原始字段

依次检查 Type、Host、Port、Password 与对应协议的附加字段。Shadowsocks 尤其需要核对 Method;其他协议也可能依赖额外的标识、传输或 TLS 设置。不要为了让测试数字出现而随意更换参数。刚更新过订阅时,还应确认当前选中的服务器没有因内容变更而失效或被移除。

测试超时:核对 Test Method 与实际访问

进入 Settings 查看 Test Method,确认当前测试方式,再与实际目标访问结果对照。某种测试方式不成功,不一定意味着所有应用请求都失败;反过来,测试有结果但页面无法加载,也可能涉及目标、DNS 或规则。先明确“哪一个测试、哪一个目标失败”,再缩小检查范围,不要一次同时修改 DNS、TCP 与 UDP。

状态反复变化:检查 On Demand

On Demand控制符合条件时的连接触发,与 Global Routing 的流量分配不是同一件事。如果手动关闭后又出现连接,或切换网络后状态改变,先检查是否已有 On Demand 条件。为了完成可重复的手动测试,可以记下原设置后暂时关闭相关自动触发,待连接验证通过,再按真实需求恢复。

仅部分目标失败:检查规则与诊断信息

若大多数目标正常而某一个失败,先在 Config 核对对应 Rule 与最终策略,再查看 Data 的相关记录。Settings 中的 Diagnostics 可作为进一步排查入口,但诊断信息需要与出错时刻、所选服务器和姿态对应才有意义。对外提供截图或记录前,应删除订阅 URL、密码、访问凭据以及不必要的个人网络信息。

如果切换姿态可以稳定复现差异,就保留这组对照结果,不必先重装应用。重装会增加资料恢复工作,并不能自动修正错误字段或失效订阅。更多购买、订阅与设置问题请查阅问答;需要理解协议参数与选型时,继续阅读Shadowsocks 与协议参考。

Shadowrocket 官方 Settings 页面,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 与 UDP
Settings:先核对 Test Method、On Demand 与 Diagnostics,不必一次改动所有设置。