官方手册 · 首次连接流程

Shadowrocket 使用教程

按「添加 → 模式 → 连接 → 验证 → 排错」操作。先让一条已有服务器信息完成实际访问,再处理规则细节。

以下以应用内英文界面词定位。官方截图用于辨认页面,实际显示会随设备与应用界面调整;请以当前应用中的项目为准。完整设置参考见完整手册。

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

先辨认拿到的是订阅链接,还是一条服务器的参数。订阅链接通常用来取得一组服务器条目;单条参数则需要逐项填写连接字段。两条路径任选其一,不必把同一份信息重复导入。操作前保留原始信息,复制时注意不要把说明文字、前后空格或换行一起带入。

已有订阅链接:选择 Subscribe

在 Home 找到 Add Server,也可通过添加入口进入。打开后点选 Type,选择 Subscribe,再将完整订阅链接粘贴到该类型对应的 URL 字段。名称或备注只用于辨认,填写一个自己能区分的名称即可;它不能替代订阅链接,也不影响链接本身的有效性。

确认链接没有截断后保存,返回 Home 等待内容获取完成。成功时应看到订阅分组及其服务器条目,而不仅是一个分组名称。如果分组为空或提示获取失败,先核对链接、当前网络和服务状态,不要立即修改 Global Routing。订阅内容尚未取得时,切换连接模式并不能补齐服务器信息。

已有单条参数:按 Type 填写

同样进入 Add Server,在 Type 中选择服务商明确给出的协议类型,再逐项输入 Host、Port 与对应认证参数。官方截图展示的是一种类型下的字段,其中包括 Password 与 Method;不同类型会显示不同字段,不能照着截图把所有协议都填成同一套参数。

Host 是服务器地址,Port 是端口,密码、加密方式以及其他协议参数均应与原始信息一致。不要把订阅 URL 填进 Host,也不要因为某个选项看起来更常见就自行替换。若拿到的是可识别的二维码,可使用 Scan QR Code,识别后仍需检查类型与地址再保存。

保存并回到 Home 后,在 SERVER 列表确认刚添加的条目确实出现。此时只完成了信息录入,还没有证明服务器能连接。先挑出一条准备测试的条目,接着设置路由姿态;订阅与配置文件的区别可在术语表查看。

Shadowrocket 官方 Add Server 页面,显示 Type、Host、Port、Password、Method 与扫码导入入口
App Store 官方截图:Add Server。先选择 Type,再核对该类型所需的字段;Subscribe 的字段以实际选中后的页面为准。

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

Global Routing 决定流量按什么方式处理,不负责补全服务器参数。回到 Home,打开 Global Routing。本教程先使用配置(Config)、代理(Proxy)、直连(Direct)这三种姿态建立判断方法;选择前先明确本次是要验证服务器,还是要验证规则分流。

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

选择配置(Config)后,流量依据当前配置中的规则决定策略。需要进入 Config 核对实际启用的配置文件,而不是仅确认列表中存在某个文件。导入订阅不等于已经配置好分流规则:订阅主要提供服务器信息,配置文件则规定匹配方式与处理策略,两者作用不同。

官方截图中的配置编辑页包含 General、Rule、Hosts、URL Rewrite 与 HTTPS Decryption 等分段。初次使用只需先理解 Rule 中的目标与策略,不必逐项改动其他分段。规则通常按顺序匹配,较前位置的匹配可能先决定结果;更完整的语法与配置维护方法见完整手册。

代理(Proxy):用于检查所选服务器

选择代理(Proxy)时,可先围绕当前选中的服务器检查连接与访问,不把分流规则同时作为主要变量。这适合首次排查,但并不保证所有目标都一定成功,也不能代替正确的服务器参数。若 Proxy 可以访问而 Config 不符合预期,下一步应重点核对配置和规则命中,而不是反复重新导入同一条服务器。

直连(Direct):不以代理出口作为验证目标

选择直连(Direct)时,访问采用直连方式处理。因此,看到网页打开不能据此认定所选代理服务器已生效。完成基础连接测试后,如果目的是日常规则分流,应返回配置(Config),确认当前文件,再对具体目标验证。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

以上仅用保留示例域名说明规则结构:PROXY、DIRECT 是策略名,FINAL 处理此前未匹配的流量。这不是要求直接覆盖现有配置。当前目标是先确认模式与使用目的相符,然后继续选中服务器并连接。

Shadowrocket 官方 Config 配置编辑页面,包含 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
App Store 官方截图:Config 配置编辑页。Global Routing 在 Home 选择,Config 中的规则用于决定配置(Config)姿态下的处理策略。

Home:选中服务器并打开连接

先选服务器,再打开顶部开关。在 Home 的 SERVER 分组中,点选本次准备使用的服务器条目,确认左侧出现选中圆点。点开条目的编辑入口与选中条目不是同一件事;如果进入了参数页面,保存或返回后仍要确认列表里的选中标记。

核对页面上的 Global Routing 与上一步选择一致,然后打开顶部连接开关。首次连接时,系统可能请求允许添加 VPN 配置;这是应用建立系统网络通道所需的授权步骤。阅读弹窗内容,确认正在操作的是 Shadowrocket,再按系统要求完成允许与设备身份验证。

如果取消了系统授权,本次连接不会完整建立。应回到应用再次发起连接并处理系统提示,而不是继续调整服务器密码。设备受管理、系统设置受限制或已有其他 VPN 配置处于连接状态时,也可能影响授权或连接;遇到限制应先确认设备允许的配置范围。

授权后返回 Home,观察顶部状态是否从 Not Connected 切换为已连接状态,开关是否保持打开。如果开关马上退回关闭,先记录是否有错误提示,以及问题发生在系统授权前还是之后。这两种情况的检查方向不同,后面的排错步骤会分别处理。

应用显示连接建立,只能说明系统通道已启动,不能直接推导服务器认证、远端访问和规则选择都正确。切换服务器或调整模式后,也应重新执行下一步的验证。首次操作尽量一次只改一个项目,保留能正常工作的状态,避免把选中服务器、模式和配置同时换掉后无法定位原因。

Shadowrocket 官方 Home 页面,顶部为 Not Connected 开关、Global Routing 和 Connectivity Test,下方为 SERVER 与 Add Server
App Store 官方截图:Home。截图呈现未连接状态;实际操作时先在 SERVER 选中条目,再打开顶部开关。

Connectivity Test:验证连接与实际访问

测试结果与实际访问要一起看。保持连接开启,在 Home 点选 Connectivity Test,等待本次结果。它用于判断测试目标在当前条件下是否可达;成功结果不等于所有网站、所有协议或所有规则都已经验证,失败也不能单凭一个结果断定整条服务器完全不可用。

随后打开浏览器,访问一个自己明确需要验证、且已知应该能够访问的目标。不要只看已经载入的页面,应重新加载并观察新请求。记录这个目标、当前选中服务器和 Global Routing,后续比较时保持目标一致,结果才有参考价值。

若使用配置(Config),还要核对目标是否按预期匹配规则:预期走 PROXY 的目标,应结合连接记录中的目标与策略检查;预期走 DIRECT 的目标则不能用来证明代理出口可用。页面能够打开是访问结果,具体由哪条路径处理则需要规则和记录支持。

若需要做对照,可先保持同一条服务器,在代理(Proxy)与配置(Config)之间分别访问同一目标。Proxy 正常、Config 异常时,优先检查规则顺序、策略引用和当前配置;两种姿态都失败时,则优先回查服务器参数、服务状态或当前网络。这是缩小范围的方法,不是只凭一次测试下结论。

Data 中的流量变化可作为辅助观察,但应用或系统的其他请求也可能产生流量,数字增加不能单独证明目标走了预期策略。同样,测试显示的耗时也不等于实际下载速度。完成验证后保留最终使用的模式与配置;若仍不能解释结果,再进入最后一步逐项排查。

Settings 与常见失败点:一次检查一个变量

按问题出现的位置检查,先不重置全部设置。记录是「没有导入内容」「开关无法保持」「测试失败」还是「只有特定目标失败」。每次修改一个项目后,回到同一目标重复测试;这样才能知道哪项调整产生了变化。

导入后没有服务器条目

回到添加信息,核对订阅是否使用 Subscribe 类型、链接是否完整、是否仍有效,以及设备当前网络能否取得订阅内容。链接包含的认证参数不要自行删改;若服务商已更换链接,应从你的服务商处获取当前信息。更新前保留必要的自定义内容,避免在尚未确认原因时删除唯一可用条目。

开关退回关闭,或系统授权未完成

先确认系统 VPN 配置授权已被允许,再看是否有其他 VPN 连接或设备管理限制影响当前连接。若首次弹窗被取消,重新发起连接并完成验证。此类问题发生在系统通道建立阶段,优先检查授权与设备状态,比反复更换规则更合适。

连接保持打开,但测试或访问失败

先看选中圆点是否在预期服务器上,再核对 Type、Host、Port 与认证参数。字段正确后,确认已有服务仍可用;必要时在设备允许的另一种网络下复测,用来判断是否与当前网络有关。记录变化,不要把偶然一次成功当成问题已完全解决。

进入 Settings 可找到 Test Method,它会影响连通性测试的判断方式。某种测试失败、实际访问正常时,应先理解测试条件,再决定是否调整。On Demand 与自动连接条件有关;如果出现手动断开后又连接的现象,应核对这些条件,而不是把它误认为开关失灵。

只有 Config 或某个目标异常

回到 Config 确认启用的是预期文件,检查目标前面是否已有更早命中的规则,以及规则引用的策略是否符合当前配置。若怀疑 DNS,只记录相关现象并逐项核对,不要同时改动 DNS、规则和协议参数。需要处理 Proxy、TCP、UDP 等更细设置时,转到完整手册按对应章节操作。

Settings 中的 Diagnostics 可用于进一步定位。整理诊断信息时,保留错误现象、所用模式、复现步骤和测试结果;分享前移除订阅链接、认证参数、密码及其他可识别信息。常见问题的后续处理见FAQ,不必为了提交问题公开整份配置。

Shadowrocket 官方 Settings 页面,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
App Store 官方截图:Settings。排查时围绕已观察到的现象检查对应项目,不需要把所有设置都修改一遍。

首次连接后的阅读路径

能够稳定复现一次成功访问后,再逐步学习配置维护。保留当前有效设置,比同时尝试多个新选项更便于判断。