Shadowrocket 官网 · 官方手册

Shadowrocket 使用教程

添加服务器、选择 Global Routing、连接与验证。以一次可复查的操作顺序,完成首次使用。

本页只讲首次使用所需的路径。截图用于对照界面位置;设备上的项目排列可能随系统及应用界面调整,以实际显示为准。设置项的详细含义可继续查阅Settings 设置详解。

01 / ADD SERVER · SUBSCRIBE

添加服务器或导入已有订阅

先打开 Shadowrocket 的 Home,找到 SERVER 分组中的 Add Server。接下来走哪条路径,取决于手中资料的形式:一组地址、端口和认证字段用于手动添加;能够返回服务器列表的完整订阅链接用于 Subscribe。两种方式不必同时操作,也不要把订阅链接直接填进单台服务器的 Host 字段。

用 Add Server 手动填写

进入 Add Server 后,先打开 Type,按自己的服务器资料选择协议,再填写该协议所需字段。Type 会决定后续出现的输入项,因此不要先照着截图填完再改协议。图中的 Host、Port、Password、Method 是对照位置,不代表所有协议都使用同一套字段;若资料写的是其他认证或传输参数,应以相应 Type 下的实际字段为准。

Host 填服务器地址,不要附带浏览器网址的路径;Port 按资料填写端口。Password、Method 等项目应逐项核对,尤其注意复制时带入的空格、换行和字符大小写。如果资料另有 TLS、Server Name 或传输设置,也要展开相应选项核对,不能仅凭地址和端口相同就认为配置完整。不要自行猜测加密方式或省略认证内容。

填写后使用页面上的保存操作,回到 Home 查看 SERVER 分组。能够看到一条记录,只说明资料已经保存,还不代表服务器能够连接。先检查它是否与预期名称、地址相符,再选中这条记录,为后面的测试确定明确对象。

用 Subscribe 导入链接

如果已有订阅链接,在 Add Server 的 Type 中选择 Subscribe,按界面提示填写完整链接,再保存并等待列表获取完成。这里需要的是自己的订阅地址,而不是服务账户的登录页面。粘贴后检查链接首尾,确保没有把说明文字、引号或聊天消息中的换行一起带入。订阅地址可能带有访问凭据,不要把完整内容贴进公开讨论或截图。

返回 Home 后,查看订阅分组是否出现预期的服务器条目。只出现分组名却没有条目时,先确认刷新是否完成,再检查链接有效性与当前网络能否访问订阅地址;重复新建同一分组通常不能解决获取失败。Subscribe 更新的是服务器资料,不应直接理解为规则文件也已导入。

已有二维码时,可使用 Scan QR Code,并在保存前核对识别出的类型和字段;Import from Cloud JSON 则面向相应格式的数据,不是任意网页链接的通用导入入口。完成其中一种添加方式后,继续下一步选择流量处理姿态,不必把其他导入入口逐个尝试。

Shadowrocket 的 Add Server 页面,显示 Type、Host、Port、Password、Method,以及 Scan QR Code 和 Import from Cloud JSON 入口
对照 Add Server:先确定 Type,再填写对应字段。截图中的字段组合不适用于所有协议。
02 / GLOBAL ROUTING · CONFIG

选择 Global Routing 姿态

服务器已经出现在 Home 后,打开 Global Routing,明确本次准备怎样处理流量。这里的三个姿态是配置(Config)、代理(Proxy)、直连(Direct)。选中服务器与选中姿态是两项不同操作:前者确定代理目标,后者影响请求如何决定去向。排查问题前要先记住当前选择,否则一次模式切换就可能改变测试条件。

配置(Config):按当前规则处理

日常按规则分流时使用配置(Config)。进入 Config,确认当前使用的配置文件,再查看其中的 Rule。规则决定匹配条件及相应处理方式;例如某个域名应走 PROXY,还是交给 DIRECT。订阅列表里有服务器,并不能证明已有适合自己用途的规则,也不能证明刚导入的文件已成为当前配置。

右侧官方截图展示的是配置编辑页面:General、Rule、Hosts、URL Rewrite、HTTPS Decryption 分别组织不同内容,Add Rule 用于增加规则。首次使用不需要逐段修改,更不需要为了连接而开启所有功能。先辨认配置文件及 Rule 的位置;若准备编辑,先保存一份原配置,避免把原本可用的内容覆盖。

下面这行仅用于认识规则结构,不是一份可直接替换现有文件的完整配置。它表示对 example.com 及其子域名进行后缀匹配,并交给 PROXY 处理。PROXY 是否可用,仍取决于已选服务器和相应配置。

DOMAIN-SUFFIX,example.com,PROXY

代理(Proxy)与直连(Direct):用于明确对照

代理(Proxy)把整体处理方向切到所选代理路径,适合在首次连接时检查“选中服务器是否能承担实际请求”。它不表示任何请求都能成功,也不能修复服务器资料错误。若准备暂时用它做对照,先记下原来的姿态,完成测试后再恢复;不要为了让单个网站打开就长期保留自己没有理解的选择。

直连(Direct)则用于按直连方向处理请求,可帮助比较设备本地网络与代理路径。直连能访问某个页面,只能证明该页面在当前本地网络下可达,并不能证明代理可用。反过来,代理测试正常也不说明所有规则均正确。关于规则优先级、兜底行为和 DNS 配合,见设置详解;本轮操作只需确定一个姿态,再返回 Home 连接。

Shadowrocket 的 Config 配置编辑页面,包含 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 分段与 Add Rule
Config 编辑页用于查看配置内容;Global Routing 的姿态选择入口位于 Home。
03 / HOME · CONNECTION

回到 Home 打开连接开关

回到 Home,先完成一次连接前核对:SERVER 中选中了准备测试的服务器;Global Routing 与上一步的选择一致;当前 Wi-Fi 或蜂窝网络本身能够使用。若设备正运行其他 VPN 连接,先在系统设置中查看其状态,避免把两个连接之间的切换误判为 Shadowrocket 的服务器故障。

确认后打开 Home 顶部开关。首次建立连接时,iPhone / iPad 可能弹出添加 VPN 配置的系统授权提示。核对这是刚刚主动操作 Shadowrocket 产生的请求,再按系统提示确认,并在需要时完成设备身份验证。此步骤是在设备上建立网络扩展所需的配置,不是在填写服务器 Password;两类凭据不要混淆。

完成授权后返回应用,观察顶部状态是否离开 Not Connected,连接开关是否保持开启。不同系统显示的 VPN 状态位置可能不同,应结合 Home 的状态与后续实际访问判断,不要只寻找某个固定位置的图标。若只是授权完成而连接尚未启动,再确认开关状态后操作一次即可。

如果开关开启后立即退回,先停在当前页面查看是否有错误提示,再核对系统 VPN 授权与所选配置。连续快速开关会让日志里混入多次连接过程,不利于判断最初的失败原因。此时不要急着改 DNS 或重新添加全部服务器;先记下“开启后立即退出”这一现象,再到最后一步沿对应路径检查。

连接开关稳定开启后,也不要立即把设置视为完成。它主要说明本机连接过程处于运行状态,服务器是否可以使用、域名是否能解析、规则是否命中,还需要下一步分别验证。先保持服务器、网络和姿态不变,让接下来的 Connectivity Test 与实际访问处在同一组条件下。

Shadowrocket 的 Home 页面,顶部显示 Not Connected 开关,下方有 Global Routing、Connectivity Test、SERVER 分组与 Add Server
Home 是连接前核对的位置:服务器、Global Routing 与顶部开关应一起检查。
04 / CONNECTIVITY TEST · DATA

分别验证测试结果与实际请求

连接后,先在 Home 使用 Connectivity Test,等待当前测试结束。它的结果应结合所用测试方式理解:测得响应说明相应测试目标和路径有回应,但不等于所有网站、协议和应用都已可用。出现 timeout 也不宜立刻删除服务器,因为测试目标、网络对特定流量的处理以及测试方式本身都可能影响结果。

接着打开浏览器,重新访问一个自己熟悉且允许访问的页面。尽量新开页面或重新加载,避免把缓存内容误当成刚刚完成的网络访问。如果网页有图片、文字和后续加载内容,可以观察它们是否都正常完成;只看到页面标题并不足以确认整个请求链路正常。验证时不要同时刷新订阅、切换服务器和修改配置,否则结果很难对应到某一个变化。

需要确认路由时,可查看 Data 或当前界面提供的连接记录,关注这次请求的目标及处理方向。计数增加只能说明有流量经过,不能单独证明它走了预期的 PROXY。记录中若能查看相应规则与策略,应把目标域名、命中条件和最终处理方式连起来看;没有相关记录时,先确认浏览器确实发起了新请求。

观察到的现象下一项检查
开关保持开启,页面正常加载确认 Global Routing 与实际需要一致,再测试日常使用的应用。
Connectivity Test 有响应,页面打不开查看域名解析、规则去向与浏览器报错,不急着重复导入。
只有 Config 下失败对照当前配置文件及 Rule,确认不是规则将请求送往其他路径。
切换本地网络后结果改变记录 Wi-Fi 与蜂窝网络的差别,再检查协议所需传输是否可达。

对照测试应当一次只改变一个条件。例如先固定服务器,对比配置(Config)与代理(Proxy);如果只有 Config 失败,优先看规则,而不是重新填写 Password。再如固定姿态,比较 Wi-Fi 与蜂窝网络;只有其中一种网络失败时,先记录网络差异。测试结束后恢复准备日常使用的姿态,并再次访问确认,避免把临时排查状态留作长期设置。

05 / SETTINGS · DIAGNOSTICS

按失败现象检查设置

如果验证没有通过,先给问题归类:资料没有导入成功、服务器测试超时、开关开启但网页失败,还是运行一段时间后断开。四种现象对应的检查起点不同。保留当前可见错误和刚做过的操作,比一次重置所有选项更有助于定位;也不要把任何失败都归因于 DNS。

没有导入成功:先回查原始资料

手动添加后没有预期记录,回到 Add Server 检查是否已保存、Type 是否正确,以及必填字段是否完整。Subscribe 没有返回服务器时,确认粘贴的是完整订阅地址,且当前网络能访问它;已有订阅是否有效,应从自己的服务资料或服务商说明核对。不要在公开页面提交链接来请求代测,它可能包含能够访问服务的认证信息。

测试超时:先核对参数和时间

服务器一直 timeout 时,按 Host、Port、Type、认证字段、传输参数的顺序逐项核对。若使用 TLS,还要留意 Server Name 等字段与原资料是否一致,并检查设备系统时间是否准确。时间偏差可能影响证书相关验证,但修正时间并不保证其他错误同时消失。某些传输依赖 UDP,网络环境差异也可能导致测试结果改变;不要通过随意关闭验证来掩盖参数问题。

Settings 中的 Test Method 关系到测试方式。先辨认当前方式,再解释测试结果;不要为了让列表出现数值而不断切换它。若服务器本身与测试目标的可达性不同,可能出现测试结果与网页体验不一致的情况,这时应以实际请求和错误记录继续判断。

开关开启但网页失败:分开看 DNS 与规则

先回 Home 确认 Global Routing,再核对 Config 当前文件。若代理(Proxy)能访问、配置(Config)不能,优先查看规则去向;若两个姿态都失败而测试仍有响应,再检查 DNS 解析相关记录和浏览器报错。调整 DNS 前记录原值,每次只改一个项目,复测后决定是否保留。不要把网络上看到的一组地址同时填进所有 DNS 选项。

自动连接或断开:检查 On Demand 与系统状态

遇到手动关闭后又连接、切换网络后状态改变等现象,打开 Settings 查看 On Demand,确认是否存在按网络条件触发的连接行为。先理解当前条件,再决定是否暂时停用作对照,不需要为完成首次连接就主动开启。也应查看系统 VPN 状态,确认没有其他连接管理设置参与切换。

需要进一步定位时使用 Settings 中的 Diagnostics,围绕一次失败操作收集必要信息。分享记录前移除订阅地址、服务器认证字段及其他个人信息,只保留错误类型和可复现步骤。Today Widget、Proxy、TCP、UDP 等设置各有用途,不应作为统一修复开关全部调整;详细含义见Settings 设置详解,具体问题可到疑难解答继续查找。

Shadowrocket 的 Settings 页面,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP 设置入口
Settings 用于按现象检查设置。首次使用不需要逐项修改,更不要同时改动多个网络选项。

完成本页后,应能说清三个结果:Home 当前选中了哪台服务器,Global Routing 使用哪个姿态,以及实际页面是否通过预期路径加载。后续增加规则或调整设置时,保留这组可用状态作为对照。