Shadowrocket 使用教程

STEP 01 / INPUT

Add Server：添加服务器或导入订阅

打开 Shadowrocket，先进入 Home。这一页用于查看服务器条目、选择当前服务器以及控制连接。首次使用时，先完成信息录入，不必立即打开连接开关。判断手上的资料属于哪一种：能够更新一组条目的订阅链接，或只对应一个服务器的地址、端口和认证信息。两种资料的填写入口相近，但字段含义不同。

已有订阅链接：选择 Subscribe

在 Home 点击右上角加号，进入 Add Server，打开 Type 并选择 Subscribe。在 URL 字段粘贴自己的完整订阅链接，再填写便于辨认的备注并保存。复制时留意链接前后的空格、换行和聊天标点；如果地址包含查询参数，应保留完整内容，不能只复制到第一个问号之前。

保存后返回 Home，等待订阅内容读取完成。成功读取时，应能看到订阅分组及其中的服务器条目。点击展开对应分组，再点击准备使用的服务器，确认它处于选中状态。保存了一条订阅记录与成功获取了服务器列表不是同一件事；如果只有分组名称而没有条目，应先检查读取结果，再进入后续步骤。

订阅更新用于重新获取已有链接中的条目，不等于修复服务器本身。如果首次读取失败，先确认这个地址确实返回客户端可识别的订阅内容，而不是账号管理网页。向原信息提供方核对链接状态即可，不要把含凭据的完整地址贴入公开讨论。已有列表时，也应先确认当前选中条目是否仍属于有效分组。

已有单个服务器信息：按 Type 填写

如果资料是单个服务器，仍从 Add Server 开始，在 Type 中选择资料明确标注的协议类型，例如 Shadowsocks、VMess、VLESS 或 Trojan。随后逐项填写服务器地址、端口及对应认证字段。协议类型不是按名称相似程度选择的；密码、UUID、加密方式与传输设置也不能相互替代，应以自己的原始信息为准。

地址字段填写服务器域名或 IP，端口填写资料给定的数字。若信息包含 TLS、服务器名称或传输路径，应一并核对，不能仅凭地址和端口齐全就判断设置完整。有现成的服务器分享链接或二维码时，可按其格式导入；使用 Scan QR Code 后仍要检查导入结果，特别是 Type 和认证字段，避免误扫其他用途的二维码。

保存并回到 Home 后，为条目使用易辨认的备注，再选中这个服务器。此时检查点只有两个：列表中确实存在条目，当前选中的也是计划使用的条目。需要了解协议字段含义时，先看协议技术参考，不必在首次连接前逐项调整高级参数。完成信息录入后，下一步决定请求如何走向这些条目。

STEP 02 / ROUTING

Global Routing：选择配置、代理或直连

在 Home 点击 Global Routing，查看当前姿态。这里的选择决定连接建立后如何处理请求，并不是服务器协议的选择。三种姿态分别是配置(Config)/代理(Proxy)/直连(Direct)。刚导入服务器并不会自动说明当前配置是否适合自己的用途，因此应在打开开关前主动确认一次。

日常按规则使用：先检查 Config

准备按规则分流时，进入 Config 页面，确认当前使用的配置。打开对应配置查看内容，重点留意 [Rule] 中的规则与末尾策略。服务器订阅负责提供服务器条目，配置负责描述处理方式，两者不能视为同一份资料；导入订阅后，仍应确认当前生效的配置是否符合自己的用途。

规则通常按顺序检查，命中后采用对应策略。PROXY、DIRECT、REJECT 表示不同处理结果，FINAL 用于前面的规则未命中时兜底。第一次使用不必立即编写规则，但至少应理解：某个网站直连可能是配置安排，而不一定是连接失效。不要为了让一项访问恢复而直接清空整份配置。

先验证服务器：保留清晰的对照条件

如果目的是确认刚添加的服务器能否工作，可临时选择代理(Proxy)，用同一目标请求观察结果。验证结束后，按自己的使用目的恢复配置(Config)。直连(Direct)则用于对照本地网络：直连正常、代理失败时，排查方向更偏向服务器或其参数；两种姿态都失败时，还需要检查设备基础网络与目标站点。

姿态切换之后返回 Home，再看一眼 Global Routing 的当前值。一次只改变姿态或服务器中的一个因素，不要同时更换服务器、配置与 DNS，否则即使访问恢复，也难以知道是哪一项起了作用。确认姿态后，保持当前设置进入连接步骤。

STEP 03 / CONNECT

Home：打开开关并完成系统授权

回到 Home，确认选中的服务器与刚才检查的一致，再确认 Global Routing 显示预期姿态。这里需要区分三个状态：信息已保存、服务器已选中、连接开关已打开。仅在列表中看到服务器，并不表示设备流量已经按所选姿态处理；完成前两项检查后，再打开 Home 顶部的连接开关。

首次弹出的 VPN 配置提示

首次建立连接时，iOS 或 iPadOS 可能显示添加 VPN 配置的系统提示。阅读提示中的应用名称，确认操作来自刚刚打开的 Shadowrocket，然后按系统提示允许，并完成设备要求的认证。系统配置授权是客户端接管网络流量所需的步骤，不是服务器账号登录，也不应在这个过程中填写订阅密码。

如果先前取消了提示，连接可能无法继续。返回应用后重新发起连接，按实际系统提示完成授权即可。系统界面的具体文字可能随设备语言与系统状态不同而变化；本页不要求寻找某个固定中文按钮，而是要求确认提示用途与应用来源。设备系统要求以 App Store 页面标注为准。

授权后回到应用检查

完成认证后返回 Home，观察连接开关是否保持打开。设备可能显示 VPN 状态标识，但其位置会随系统布局变化，因此不能只凭状态栏有没有图标判断。开关保持打开，说明连接流程已经进入工作状态；这仍不等于远端服务器、域名解析和每一条规则都已通过验证。

如果开关立即关闭，先检查系统授权是否完成，以及是否有其他正在接管连接的 VPN 配置。首次操作时也先核对 On Demand，避免自动连接条件与手动操作交织，造成“刚关闭又连接”的误判。不要反复快速点击开关；先等待当前状态稳定，再决定是否重试。

如果系统返回具体错误，记下错误文字与出现时机，例如“授权之后立即停止”或“开关保持打开但网页失败”。这些信息比一句“不能用”更有助于定位。需要保存记录时，遮去服务器地址、认证字段及订阅链接中的凭据。开关稳定后，继续用实际请求验证，而不是把状态标识作为操作终点。

STEP 04 / VERIFY

Connectivity Test：验证实际访问与规则

连接开关打开后，先在 Home 使用 Connectivity Test 检查服务器的测试结果。测试适合发现明显不可达的条目，也能帮助比较同一网络条件下的响应情况，但结果取决于测试方法和目标。测试有响应，只能说明这次探测得到响应，不能直接推导出所有网页、所有协议传输都正常。

发起一次新的网页请求

打开 Safari，访问自己熟悉、当前需要使用的网站，并刷新或进入一个新的页面。不要只看之前已打开的页面，因为缓存内容可能在连接变化后仍能显示。观察页面是否能完成加载，若只能看到标题或部分图片，也应把它记为部分请求失败，而不是笼统地认定“整个连接成功”。

如果使用配置(Config)，选一个预期由代理处理的目标，再选一个预期直连的目标进行对照。对照的目的不是证明所有流量都走同一路径，而是核对规则是否按预期执行。应用或网页显示的地区信息可能受账号、缓存和定位权限影响，不能把地区文案当作唯一的连接判据。

在 Data 中对应请求记录

返回 Shadowrocket，在 Data 中查看与刚才访问对应的连接记录；如当前未记录所需信息，按界面提供的记录选项启用后重新发起请求。优先按访问时间和目标域名定位，核对实际采用的策略及可见的匹配信息。不同页面提供的信息粒度可能不同，以当前界面实际显示为准。

例如预期走代理的域名却采用 DIRECT，应回到 Config 检查规则顺序，而不是立即重填服务器密码。如果请求采用 PROXY 却持续失败，则继续检查选中服务器、认证字段与解析情况。若看到 REJECT，先确认是否是当前配置主动阻止了该请求。记录用于解释结果，不应为了让记录看起来一致而随意更改策略。

完成一次有效验证后，记住当时选中的服务器、Global Routing 姿态和配置名称。之后出现问题，可以先与这组已验证条件比较。测试结束后按实际需要管理记录功能；准备分享记录时，应移除目标地址中的私人信息和所有访问凭据。到这里，首次连接的操作链已经完成，后续排查只围绕失败位置展开。

STEP 05 / CHECK

常见失败点：按发生位置逐项检查

排查从最早出现异常的步骤开始。没有读到服务器列表，就先停留在导入阶段；开关无法保持打开，就先处理连接与授权；只有某个网站失败，再看目标请求的解析和规则。每轮只修改一个因素，并重新执行同样的验证请求，这样才能保留可比较的结果。

导入失败：检查链接与内容类型

回到 Add Server 的订阅记录，核对 Type 是否为 Subscribe、URL 是否完整，以及是否混入空格或标点。若返回内容实际是登录页、错误提示或空内容，客户端便无法从中生成服务器列表。不要把订阅地址直接当作服务器地址填写，也不要把单个服务器分享链接误当成可更新订阅。无法确认格式时，向原信息提供方核对资料用途。

服务器不可用：先查原始字段

如果 Connectivity Test 持续失败，先确认设备在关闭连接时能够正常联网，再检查选中条目的地址、端口、协议类型及认证信息。对于手动添加的条目，把字段与原资料逐项对照；对于订阅条目，确认订阅更新是否成功、当前条目是否仍有效。频繁修改协议类型通常不能解决认证不匹配，反而会掩盖最初问题。

开关打开但无法访问：检查姿态与 DNS

先看 Global Routing 是否仍为测试时预期的姿态。如果处于直连(Direct)，访问结果不能证明服务器转发正常；如果处于配置(Config)，还要检查目标是否实际命中 PROXY。保持服务器不变，临时采用代理(Proxy)进行一次对照，有助于区分规则问题与服务器问题，测试后再恢复自己的日常姿态。

如果探测有响应而网页提示找不到域名，再检查当前配置中的 DNS 相关设置。先确认使用的是哪份 Config，再检查解析设置是否能够在当前网络条件下工作。不要因为看到 DNS 错误就连续替换多个地址；先保留原值，改动一项后重新发起同一域名请求。解析成功与服务器转发成功属于不同环节，需要分别观察。

部分网站失败：查看匹配结果再改规则

只有部分目标异常时，在 Data 中定位这些目标的请求，对照 Config 的规则顺序与 FINAL 策略。一个网页可能同时请求多个域名，因此主页可打开而图片失败，可能对应不同的匹配结果。先找出失败请求的域名和策略，再决定是否需要调整规则，不要把整份规则改成同一策略来替代定位。

需要继续排查时，前往常见问题按现象查阅；需要理解协议与参数的取舍，转到技术参考。换机后重新安装应用的购买恢复步骤见已购恢复说明。重新下载应用不能代替恢复自己的配置与连接信息，操作前应先确认已有资料是否保存完整。