Shadowrocket 使用教程
已有资料导入 → Global Routing → 连接授权 → 生效验证。先完成一次可复现的连接,再调整规则与设置。
阅读时可直接跳到当前卡住的步骤。第一次操作建议按顺序完成,并暂时保留原有设置,避免同时修改服务器、规则与 DNS 后难以判断问题来源。
01 / IMPORT
添加服务器与 Subscribe
先判断手中的资料属于哪一种:订阅链接通常用于一次导入并更新一组条目;单个服务器资料则包含协议、地址、端口与认证参数。两种方式任选其一即可,不需要把同一组服务器反复添加。打开 Shadowrocket,进入 Home,找到 Add Server 进入添加页。页面上的字段会随 Type 改变,截图中的字段只对应所展示的类型,不代表所有协议都使用同一套参数。
已有订阅链接
在 Add Server 中点开 Type,选择 Subscribe,将自己的完整订阅链接填入 URL,再填写便于辨认的备注并保存。复制时尤其检查链接开头、末尾和查询参数,避免把聊天消息里的说明文字、空格或换行一同带入。订阅链接可能包含访问凭据,不要把完整内容放进公开截图,也不要发送到不相关的页面。
保存并完成读取后,返回 Home 查看订阅分组及其中的服务器条目。若只出现分组而没有可选条目,先检查订阅是否读取成功,再使用该分组提供的更新操作重试;不要立刻改成手动填写。更新失败与服务器无法连接属于不同环节:前者可能是链接内容或当前网络无法读取,后者才需要继续检查服务器参数。具体更新入口以当前应用界面为准。
已有单个服务器信息
手动添加时,先按资料选择正确的 Type,再逐项填写 Host、Port 及该协议要求的认证字段。Host 填域名或地址,不能把完整网页链接当作主机名;Port 按原资料填写,不根据协议名称猜测。若页面出现 Password、Method,也应与已有资料一致。使用 VLESS、VMess、Trojan 等类型时,继续核对对应的认证、传输与 TLS 设置,不能直接照抄截图中的字段组合。
如果手中的资料是二维码,可使用 Scan QR Code,允许必要的相机访问后扫描;Import from Cloud JSON 用于相应格式的资料,不是任意订阅链接的通用入口。无论使用哪种方式,保存后都应回到 Home,在 SERVER 分组中点选目标条目,并确认选中标记。看到条目只说明导入完成,还没有证明连接可用。下一步先选择请求如何处理,再打开连接开关。
02 / ROUTING
选择 Global Routing
回到 Home,点开 Global Routing。这里决定请求使用规则、统一使用代理,还是直连;它与 SERVER 中选中了哪台服务器不是同一个设置。先理解三种姿态,再选择适合当前目的的一种,能够避免“已经选了服务器,为什么部分请求仍然直连”的误判。
配置(Config) 按当前启用配置中的规则处理请求。规则可以把不同目标交给 PROXY、DIRECT 或其他已配置策略,因此并不是每个页面都应使用代理。代理(Proxy) 用于让一般请求走当前代理路径,适合临时缩小规则分流带来的变量;但本地网络、系统行为等仍有各自边界,不应把它理解成所有系统流量的绝对保证。直连(Direct) 用于直接访问,不能用来验证所选服务器是否可用。
Config 与规则的关系
日常准备按规则使用时,选择配置(Config),再进入底部 Config,检查当前启用的是哪份配置文件。打开对应文件可看到 General、Rule、Hosts 等分段;截图展示的是配置编辑内容,不是要求第一次使用就逐项修改。Add Rule 用于新增规则,先确认文件选择正确,再决定是否需要编辑。只有文件存在但没有启用,不能说明其中规则正在工作。
规则通常按自上而下的顺序匹配,先命中的规则决定请求的处理方式。例如下面的片段把示例域名交给 PROXY,未命中的请求按 FINAL 执行。它用于解释顺序,不是要求覆盖现有配置;真实配置还可能引用命名策略,修改前应先保留原文件。暂时不理解某条规则时,不要为完成首次连接而删除整段内容。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
如果现在只是确认服务器资料能否建立连接,可以暂时选择代理(Proxy),记下原先模式,并在验证结束后恢复配置(Config)。若 Proxy 可以访问而 Config 不能访问,下一步应检查规则命中与配置选择,而不是重新购买应用或重复导入订阅。规则关键字和模式差异的扩展说明见常见问题。确定模式后,返回 Home 开始连接。
03 / CONNECT
打开开关与连接授权
现在回到 Home,按顺序确认两处:SERVER 中目标条目处于选中状态,Global Routing 显示刚才决定的模式。服务器名称只是备注,不能仅凭名称判断协议和参数是否正确;若存在多个相似条目,先点开详情核对,再回到 Home 选择。保持这两处不变,打开页面顶部的连接开关。
首次建立连接时,系统可能提示允许添加 VPN 配置。确认这是刚刚主动打开 Shadowrocket 开关所触发的提示后,按系统流程允许,并完成设备要求的认证。这个步骤是在设备上创建连接所需的系统配置,不是订阅账号登录,也不需要填写服务器密码。若取消了提示,回到应用重新打开开关即可再次检查授权流程,不必先删除已有服务器资料。
完成授权后返回应用,观察顶部状态是否仍为 Not Connected,以及开关是否保持开启。如果开关刚打开就回落,先处理系统配置或其他 VPN 连接冲突;如果开关保持开启但网页无法访问,则进入下一步验证服务器和分流。两类现象的检查方向不同,反复快速切换开关会打断观察,也不利于在诊断记录中找出第一次失败的位置。
首次连接先减少变量
首次验证时,建议先停用设备上其他正在运行的 VPN 连接,并固定使用一种网络,例如先在当前 Wi-Fi 下完成一次测试。需要比较蜂窝网络时,先记录当前结果,再切换网络重新测试。不要在同一次尝试里同时更换网络、服务器和模式,否则即使后来能够访问,也难以知道是哪项变化起作用。
系统显示连接或开关保持开启,只能说明连接机制已启动,不能证明订阅内每台服务器都可用,也不能证明每个域名都命中了预期规则。此时先不要改 On Demand;让手动连接正常工作,再考虑自动触发条件。接下来保留当前服务器与模式,分别检查测试结果、实际访问和请求路径。
04 / VERIFY
验证连接是否生效
验证应分成“测试能否完成”和“实际请求是否符合预期”两层。首先在 Home 点击 Connectivity Test,等本轮测试结束,查看目标条目的结果。测试方式、测试目标和当前网络都会影响结果;测试成功是继续检查的依据,不等于所有应用已经正常工作,测试失败也不应直接解释为所有服务器都失效。
接着打开浏览器,访问一个自己熟悉、并且知道应由当前模式处理的页面。建议重新加载或打开新页面,不要仅查看先前已经缓存的内容。若使用配置(Config),再选一个按现有规则应走不同策略的目标进行对照;若使用代理(Proxy),重点确认所选服务器下的实际访问。不要把只需本地网络即可打开的页面,作为代理已经生效的唯一证据。
把结果与策略对应起来
实际访问与预期不同时,查看应用提供的请求记录或诊断内容,围绕刚才测试的目标域名查找对应请求,并确认它使用了哪种策略。命中 DIRECT 时应回看规则,而不是先修改服务器认证;命中 PROXY 后失败,才继续检查服务器、传输或解析环节。某些应用会复用已建立连接,修改配置后应重新发起请求,避免把旧连接结果当作新配置的结果。
建议只记下四项简短信息:当前网络、所选服务器、Global Routing 模式、实际访问结果。完成一次可重复的访问后,再恢复日常使用的 Config,重新验证同一个目标。如果切换回 Config 后出现差异,说明应继续核对配置和规则顺序。到这里,首次连接的主流程已经完成;保留这些信息,后续出现问题时就有可比较的基线。
不要为了验证连接而随意开启 HTTPS Decryption、安装额外证书或批量改写 DNS。普通的导入与连接流程不需要把配置页每一项都开启。只处理与当前症状直接相关的设置,复杂的解析和规则路径问题交给故障排查手册继续分析。
05 / CHECK
常见失败点检查顺序
遇到失败时先定位停在哪一层:导入前、条目已出现但连接失败、系统开关无法保持,还是连接后仅部分请求异常。以下顺序覆盖首次使用最常见的断点。每完成一项检查,就重复上一步的同一项访问;确认没有改善再继续,不要把所有设置一次改完。
导入失败或 SERVER 没有条目
回到 Add Server 检查 Type 与资料格式是否匹配,订阅应使用 Subscribe,单个服务器资料则按具体协议填写。确认订阅链接完整且仍有效,当前网络能够读取它;如果服务返回的是登录页面、说明页面或错误内容,保存链接也不会得到可用条目。联系自己的服务提供方核对资料时,只提供必要信息,避免公开包含凭据的完整链接。
开关正常,但服务器测试失败
先核对选中的是否为刚导入的条目,再检查 Host、Port、认证资料、Method 以及 TLS 和传输参数。协议类型相同不代表参数可以通用,尤其不要把一个类型的密码或加密方式机械填入另一个类型。资料确认后,可在保持其他设置不变的情况下换一种网络复测;如果订阅内只有某个条目失败,先把问题范围限定到该条目。
开关回落或自动重连
开关回落先检查系统是否完成 VPN 配置授权,以及是否有其他连接正在争用。若已经关闭却又自动连接,进入 Settings 检查 On Demand 及其条件,必要时暂时关闭该功能再手动复测。On Demand 影响何时连接,不负责修复错误的服务器参数。先让手动开关结果稳定,再逐项恢复自动连接条件。
测试与网页结果不一致
在 Settings 查看 Test Method,确认测试采用的方式;不要把不同测试方式的结果直接作同类比较。若测试可以完成,但只有特定域名无法访问,检查当前 Config 的规则命中、域名解析与目标服务本身。临时用 Proxy 对照后恢复原模式,能帮助区分规则问题与服务器问题,但不是长期绕过配置检查的替代办法。
需要进一步查看时,使用 Diagnostics 并保留发生问题附近的必要记录。分享记录前移除订阅凭据、密码与个人网络信息。若仍未解决,按症状进入故障排查,或在常见问题查阅订阅更新、配置选择与系统权限说明。教程到此只建立最小可用流程,不要求继续调整所有 Proxy、TCP、UDP 设置。