官方手册 / 快速上手
Shadowrocket 使用教程
导入已有信息,选择 Global Routing,再连接与验证。首次操作按顺序进行;已经完成的步骤可以从目录直接跳过。
操作顺序:信息完整 → SERVER 出现条目 → 确认模式 → 打开连接 → 检查实际访问。截图来自 App Store 官方页面;以设备当前显示的界面为准。
步骤 01 / 添加与导入
Add Server:导入已有连接信息
打开 Shadowrocket,进入 Home。下方 SERVER 区域用于显示已有服务器及订阅分组;首次使用时,先点 Add Server。接下来按手中信息选择一种方式,不必把同一份内容重复导入。订阅链接是一组服务器信息的更新入口,单台服务器信息则是一条连接所需的参数,两者填写方式不同。
已有订阅链接:使用 Subscribe
在 Add Server 中点 Type,选择 Subscribe,再把自己的完整订阅链接填入 URL。需要区分多个来源时,可在界面提供的名称或备注字段中写一个便于辨认的名称,然后保存。返回 Home,等待内容获取完成,检查相应分组中是否出现服务器条目。仅保存了链接却没有条目时,应先处理订阅获取问题,不要直接进入连接步骤。
复制链接时要保留完整参数,避免把说明文字、首尾空格或换行一起粘贴进去。也不要把服务商的网页地址当成订阅地址。链接可能包含账号识别信息,应只从自己的可信来源复制;排错时不要在公开截图中展示完整链接。首次获取成功后,服务器清单以实际返回的内容为准,后续更新也可能增删条目。
已有单台服务器:按 Type 填写参数
回到 Add Server,先根据已有资料选择 Type,再填写 Host、Port 与该协议要求的认证参数。截图展示了 Password、Method 等字段,但不是所有协议都使用同一组字段。Host 填服务器地址,Port 填对应端口;认证信息、加密方式以及传输相关参数必须与服务器端一致,不能根据字段外观随意猜选。
若已有资料以二维码提供,可使用 Scan QR Code 读取,读取后仍需检查 Type 和关键字段。Import from Cloud JSON 只适合已有相应格式资料的情况,不是所有链接的通用入口。保存后回到 Home,确认 SERVER 中出现该条目。此时只代表信息已录入,能否建立连接还要经过后续测试。字段不清楚时先查术语手册,不要用反复修改参数代替核对原始信息。
步骤 02 / 选择模式
Global Routing:确认连接采用的策略
SERVER 中已有条目后,先不要急着打开开关。在 Home 点 Global Routing,检查当前模式。这里决定请求按什么方式处理;选择服务器与选择路由模式是两个独立动作。即使已经选中服务器,直连策略也不会因为这个选择自动变成代理策略。
配置(Config):按当前规则处理
配置(Config) 使用当前配置文件的规则决定请求走向。进入 Config,确认已选中需要使用的配置,再查看 Rule 中的策略。Config 页面用于管理配置文件;Global Routing 中的 Config 则表示采用配置规则,两处名称相同,但操作目的不同。只导入 Subscribe 并不能替代对当前规则的确认。
例如,规则可以让某个域名使用 PROXY,让某个地址范围使用 DIRECT。实际结果取决于规则内容、顺序与策略引用。首次上手不必在截图中的 General、Hosts、URL Rewrite 或 HTTPS Decryption 分段逐项修改,也不需要为了连通而开启额外功能。已有可用配置时保留它,先确认基本连接,再学习具体规则。
代理(Proxy) 与直连(Direct):区分验证目的
代理(Proxy) 按该模式的行为将请求交给所选代理服务器处理,适合在初次验证时减少规则差异带来的干扰;它不代表所有系统流量都必然被处理。直连(Direct) 则按直连模式处理请求,不经过所选代理服务器。若希望验证刚导入的服务器,停留在 Direct 不能完成这一验证。
初次操作可以记下原模式,临时改为 Proxy,完成连接与访问检查后,再切回需要的 Config。切换回来后必须重新测试,因为服务器可用与规则正确是两件事。如果尚未准备规则,先理解当前配置,不要为了让模式名称显示 Config 而导入来源不明的内容。规则关键字的含义可查术语手册;配置文件管理见Config 设置说明。
步骤 03 / 打开连接
Home:选中服务器并开启连接
返回 Home,在 SERVER 中点选一条已有服务器。若同一订阅下有多条记录,先选其中一条进行验证,不要连续切换多个条目。随后再次看一眼 Global Routing,确认它仍是上一步决定的模式。条目名称只是辨认标签,不能用名称推断其连接质量、协议参数或当前可用性。
点 Home 顶部的连接开关。首次建立连接时,系统可能提示允许添加 VPN 配置。这个提示用于让 Shadowrocket 建立系统网络连接配置,不是再次购买应用,也不是订阅内容已经通过验证的证明。核对提示中的应用身份,确认这是本次主动操作后,再按系统要求完成设备验证。
完成授权后返回 Home,观察顶部开关和连接状态是否发生变化。截图中的 Not Connected 是尚未连接时的状态,并不是需要手动填写的文字。如果拒绝过授权,开关可能无法保持开启;应重新发起连接并处理系统提示,而不是重新导入同一份订阅。设备存在管理限制时,系统也可能不允许建立所需配置,应先确认设备权限。
若系统已有其他 VPN 连接正在使用,先在系统设置中确认当前活动连接,再返回 Shadowrocket 重试,避免因连接相互切换而误判。第一次验证期间,也先不要配置 On Demand;自动触发条件会增加判断步骤。等手动连接与断开都可重复成功后,再根据需要了解按需连接。
开关已开启只表明连接过程进入了相应状态,不能证明服务器端认证、目标访问或所有规则都正确。不要到这里就结束操作。保持当前服务器与模式不变,进入下一步执行 Connectivity Test,并用实际访问确认结果。若开关立即回落,记录系统提示或错误文字,再跳到失败点排查。
步骤 04 / 验证生效
Connectivity Test:从测试到实际访问
保持连接开启,在 Home 点 Connectivity Test。等待本次测试完成,再看结果。测试是否成功与采用的测试方法有关:它可能只反映某个探测目标或某种握手过程,不等于所有网页都可访问。结果显示耗时也不是实际下载速度,不能仅凭一个数值判断整条连接的使用体验。
接下来打开浏览器,访问一个平时正常使用的网页。确认内容能够重新加载,而不是仅看到浏览器缓存。再打开另一个正常使用的目标进行交叉检查,区分单个网站的问题与整体访问问题。需要对照时,可以记录连接开启前后的现象,但不应以某个页面外观变化作为唯一依据。
Config 模式下,再验证一次规则
如果前一步为排除干扰使用了 Proxy,现在切回计划长期使用的 Config,再重复同样的访问操作。Proxy 下可用、Config 下部分目标失败,通常应优先检查规则匹配、策略引用及域名解析,而不是立即删除服务器。反过来,Direct 下页面能打开,也不能证明代理服务器可用,因为该请求可能根本没有使用它。
需要核对具体走向时,查看应用内与本次访问对应的连接记录或诊断信息,结合目标域名、时间和命中的策略判断。记录中的 DIRECT 与 PROXY 表达的是不同处理方式;仅有系统 VPN 标识,无法说明某个请求命中了哪条规则。规则顺序等细节可转到术语手册继续阅读,本页先完成最小验证闭环。
最后手动断开一次,再重新连接,重复相同测试。两次结果一致且实际访问正常,才适合继续调整更细的设置。若测试失败但网页正常,先确认测试方法及目标;若测试成功但网页打不开,则保留当前设置并记录失败域名、时间及提示,按下一步逐层定位。每次只改一项,才能把变化与结果对应起来。
步骤 05 / 失败点排查
Settings:按失败环节逐项检查
先确定失败发生在哪一层:订阅没有获取到、服务器不能连接、开关无法开启,还是只有部分网页失败。它们需要不同的处理方法。保留现有条目和配置,记录原始状态,不要一开始就删除全部内容。进入 Settings 后,可以看到 Test Method、On Demand、Diagnostics 以及 Proxy、TCP、UDP 等设置入口;本轮只检查与现象相关的项目。
订阅更新失败:先确认链接与获取网络
Home 中没有获取到条目时,重新核对 Subscribe 的完整链接,检查是否过期、被替换,或复制时漏掉参数。确认当前网络能访问该链接所对应的服务,并从自己的服务商处核实订阅是否仍有效。获取失败与某台服务器连接失败不是同一问题;此时改服务器的 Port 或 Method 通常没有帮助。更多情况见订阅失败问答。
条目存在但连接失败:回查服务器参数
打开对应条目,逐项对照原始资料中的 Type、Host、Port 和认证信息。TLS、传输方式、服务器名称等参数若由资料明确给出,也应保持一致。不要因为字段看起来可选就删除已有值。可以换用自己已有的另一条服务器作对照,但一次只测试一条,并记录切换后的结果,避免混淆不同条目的现象。
开关或访问异常:区分系统、规则与网络
开关无法保持开启时,先检查 VPN 配置授权、系统提示和设备限制。开关正常但所有目标都失败时,再检查所选服务器及本地网络;在自己的 Wi-Fi 与蜂窝网络间切换一次,可帮助判断是否与当前接入网络有关。切换可能产生流量费用,先确认自己的网络使用条件。
只有部分目标失败时,优先回查 Global Routing 与 Config 中的规则。若只是 Connectivity Test 失败,进入 Settings 查看 Test Method,确认所选方法及其局限。不要为追求某次测试通过而同时更改 DNS、TCP、UDP 等多组设置,也不要直接关闭认证相关检查。每次修改前记下原值,测试不改善就恢复。
需要进一步定位时,可在 Diagnostics 中查看当前界面提供的诊断项目。分享错误信息前,遮盖订阅链接、密码、认证标识和不需要公开的地址,只保留必要的错误文字与操作顺序。连接相关现象可继续查阅无法连接问答;如果问题发生在安装、商店地区或已购恢复环节,则转到App Store 安装指南,不必通过修改连接参数处理。
完成基础排查后,回到 Home,使用同一服务器、同一模式和同一目标重新验证。能够复现的操作记录,比一次改动很多设置更有帮助。日常使用中,先保持已经验证成功的配置;需要学习 On Demand 或更细的规则时,再阅读功能与设置,逐项增加,而不是一次启用所有功能。