官方手册 · 上手操作
Shadowrocket
订阅导入与连接教程
按添加、模式、连接、验证、排错的顺序操作。先完成一次可重复的连接,再调整规则与自动连接设置。
开始前:准备已有连接资料
先判断手中的资料属于哪一种:一条用于更新服务器列表的订阅链接,还是单个服务器的分享链接、二维码或参数表。两者入口相近,但用途不同;不要把订阅地址当成 Host 填入,也不要仅凭链接以 HTTPS 开头就判断它一定是订阅。无法确认时,先核对资料说明,再继续添加。
STEP 01 / ADD
Add Server:添加服务器或导入订阅
本步只完成资料录入。返回 Home 后能看到服务器记录,才继续选择连接模式。
已有单个服务器参数
打开 Shadowrocket 的 Home,找到 Add Server 并进入。先点 Type,按已有资料选择协议,再填写 Host、Port 以及该协议要求的认证字段。截图中的 Password、Method 属于特定 Type 下显示的项目;选择其他 Type 后字段可能变化,应以当前页面与原始资料对应,不能把截图中的字段当作所有协议的固定要求。
Host 填写服务器域名或 IP,不附加网页路径;Port 填写资料给出的端口。复制时检查首尾空格与换行,尤其是 Password 等认证内容。若资料还列出 TLS、SNI 或传输设置,应在同一条记录中逐项核对,不要凭协议名称自行猜测这些值。填写后保存,回到 Home 的 SERVER 分组查看新增记录。
已有订阅链接
再次进入 Add Server,在 Type 中选择 Subscribe,把完整订阅链接粘贴到对应的地址输入位置,并填写便于辨认的备注后保存。这里需要的是用于获取列表的完整地址,而不是某个服务器的 Host。订阅地址可能包含身份信息,不要把它放进公开截图、聊天记录或诊断示例中。
保存后让订阅完成首次获取,再返回 Home 查看列表。若已经出现该订阅分组但分组内没有服务器,先检查更新结果与链接完整性,不要立刻再建一份相同订阅。重复添加会让后续选择与更新更难核对;修正原有记录后重新更新,更容易判断问题是否解决。
已有二维码或分享链接
二维码可使用 Scan QR Code 读取,并按系统提示授权相机。导入后仍要打开记录检查 Type、Host、Port 与认证字段。Import from Cloud JSON 对应特定格式的远端 JSON 资料,不是任意网页或任意订阅的通用入口。分享链接与订阅的结构差异可继续阅读分享链接与订阅链接说明。
最后,在 Home 点选一条实际要使用的服务器,确认选中标记落在预期记录上。列表存在只说明资料已保存,不等于远端服务器已经可用;下一步先把 Global Routing 设为可理解的状态,再进行连接测试。
STEP 02 / ROUTE
Global Routing:选择三种姿态
服务器决定连接到哪里,Global Routing 决定请求如何选择路径。两项需要分别核对。
回到 Home,点开 Global Routing。三种姿态分别是配置(Config)/代理(Proxy)/直连(Direct)。第一次操作不要频繁轮换模式;先明确当前要验证的是服务器本身,还是配置文件中的规则,再选择相应模式。模式改变后,应重新打开目标页面发起请求,不能仅根据之前已加载的页面判断结果。
配置(Config):按当前文件分流
日常按规则使用时选择配置(Config)。随后进入 Config,确认当前实际使用的配置文件,而不是只查看列表里某个文件的名字。配置编辑页包含 General、Rule、Hosts 等分段;本教程只关注 Rule 中的匹配条件与策略,不需要为了首次连接修改所有分段。
规则按顺序检查,具体规则通常应放在覆盖范围更广的规则之前。下面是说明策略含义的语法片段,不是可直接替换现有文件的完整配置;其中 PROXY 还需要与实际配置中的策略对应。先阅读现有文件,确认理解后再编辑,并在修改前保留原文件。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
DOMAIN-SUFFIX,ad.example.com,REJECT
FINAL,PROXY
PROXY 表示使用对应代理策略;DIRECT 表示使用直连路径;REJECT 表示拒绝该请求。FINAL 是前面没有命中时使用的最终策略。界面中的姿态名称 Proxy 与规则策略 PROXY 不是同一个操作入口,不要把选择模式当成已经修改了 Rule。
代理(Proxy)与直连(Direct):用于对照
代理(Proxy)可用于检查所选服务器的代理路径,减少普通规则分流对本次排查的影响,但不应理解为设备所有系统流量都必然经过同一路径。直连(Direct)则用于对照本地网络,不会因为连接开关打开就自动改用所选服务器。
若 Proxy 下目标页面可用,而 Config 下失败,后续应检查当前配置与命中规则;若 Direct 下本地网络也无法正常访问,先恢复 Wi-Fi 或蜂窝网络。暂时不理解某条规则时,保留原值即可,完整的配置维护方法见新手到进阶官方手册。
STEP 03 / CONNECT
Home:打开连接开关
先确认选中记录与模式,再授权连接。系统授权与服务器可用性是两件事。
返回 Home,检查 SERVER 分组中的选中记录是否正确,再看 Global Routing 是否保持为上一步选择的姿态。若刚更新过订阅,原记录可能发生变化,不能仅凭之前的选择继续测试。确认后,打开顶部 Not Connected 旁的连接开关。
首次连接时,系统会请求允许添加 VPN 配置。核对提示来自本次 Shadowrocket 操作后允许,并根据设备提示完成密码或生物识别验证。这个步骤是在设备上建立网络接管权限,不会替你创建服务器资料,也不代表远端认证已经通过。若取消了授权,返回 Home 再次打开开关并按系统提示处理。
授权完成后回到 Home,观察顶部状态是否由 Not Connected 变为已连接状态。如果开关立即回落,先检查系统授权是否完成,再确认当前服务器记录是否完整。此时不要连续快速开关,也不要同时重建订阅、修改 DNS 和更换模式;保留一个稳定状态,才能对应到具体失败环节。
状态稳定后使用 Home 中的 Connectivity Test。它用于检查应用按当前测试设置进行的连通性,不是对每一个网页、每一种协议和每条分流路径的统一保证。出现测试结果后,仍需进行下一步的实际访问验证;单看顶部连接状态,不能确定目标请求已经按预期经过代理。
STEP 04 / VERIFY
验证生效:实际访问与 Data 对照
以新发起的请求为准,同时核对目标页面与规则结果,不把一个测试值当作全部结论。
先选择一个平时能够正常访问的页面检查基础网络,再打开本次需要验证的目标页面。必要时重新加载或新开页面,避免浏览器缓存让旧内容看起来像一次成功请求。如果基础网络可用但目标页面失败,记录当时的服务器、Global Routing 与现象,再进入 Data 查看本次新产生的请求。
在 Data 中按请求时间与目标域名定位记录;如当前详情显示命中规则、策略或连接信息,就把这些内容与预期路径对照。Config 下某个请求走 DIRECT,可能正是规则要求,并不意味着连接开关失效;同样,出现 REJECT 应先检查匹配到的规则,而不是立即更换服务器。
若目标请求应走 PROXY,重点确认它匹配的策略是否正确,以及该策略实际使用的服务器是否符合预期。若走 DIRECT,则对照目标是否本来就应由本地网络处理。网页常包含多个域名,一个主页面打开失败可能来自其中某个资源请求,检查时应看相关记录,而非只寻找地址栏中的域名。
- 保持服务器不变,只对照 Proxy 与 Config 两种姿态,重新发起同一类访问。
- 保持模式不变,如有自己已有的其他可用记录,再切换服务器进行对照。
- 每次记录目标、模式、结果与命中策略,避免把不同时间的结果混在一起。
如果 Proxy 可访问而 Config 不可访问,优先回到 Config 检查规则与最终策略。如果两者都失败,但 Direct 下基础访问正常,优先核对服务器参数与远端状态。完成一次正确的规则命中后,再恢复适合日常使用的 Config,并用同样方法验证第二个需要不同路径的目标。
本步的完成标准不是某个固定延迟数字,而是:连接状态稳定,实际目标能够访问,并且可查到的请求路径符合你的配置预期。需要进一步理解 Home、Config、Data 的职责,可查看界面英文词对照。
STEP 05 / CHECK
Settings:按失败环节逐项检查
保留原配置,每次只改一项。先查基础连接,再查参数、模式与规则。
导入失败或列表为空
先确认订阅链接没有缺失字符,且没有把单个服务器分享链接填成 Subscribe。检查当前网络能否完成订阅获取,并查看应用给出的更新结果。服务器列表为空不等于客户端尚未购买,也不能通过反复添加相同记录解决。涉及订阅有效性或服务器资料变更时,应回到自己已有资料的来源核对。
开关已开,但访问失败
先确认不经过代理时基础网络是否正常;遇到需要网页认证的 Wi-Fi,应先完成网络自身的认证。再检查所选服务器的 Host、Port、认证字段与传输设置,尤其注意复制产生的空格。若问题只出现在某一条服务器记录,先修正该记录,不要立即改动全部配置。
随后按第二步对照 Global Routing。Config 失败而 Proxy 可用时,检查当前启用文件、规则顺序与 FINAL;两种姿态都失败时,再核对远端连接和认证。若表现为域名无法解析,查看现有 DNS 设置与相关诊断信息,不要一次粘贴多组陌生 DNS 设置,以免掩盖原始问题。
测试失败,但网页能够打开
进入 Settings 核对 Test Method。测试方式与实际网页访问的路径可能不同,因此 Connectivity Test 失败并不能单独证明所有访问都失败。反过来,测试通过也不保证某个目标必然可用。把测试结果、实际页面结果和 Data 中的记录放在一起判断,必要时保留测试方式不变,只对照一次服务器或模式。
关闭后又连接,或只有部分请求异常
在 Settings 检查 On Demand 是否启用了符合当前网络的自动连接条件。为了完成手动对照,可以先记录原设置,再暂时停用相关条件;验证完成后按实际需要恢复。只有部分请求异常时,优先查看相应规则与传输需求,不要先修改 Settings 中所有 Proxy、TCP、UDP 项目。
需要更多线索时使用 Diagnostics,按应用提供的结果继续定位。分享截图或日志之前,移除订阅完整地址、Password、认证内容与个人访问记录,只保留必要的错误现象。更多分支见疑难解答;开关已开但无法访问的详细顺序见连接后无法上网检查清单。
完成后:保留可用状态
确认选中服务器、当前配置与规则结果一致后,再进行日常维护。
保留一份已经验证可用的配置,订阅更新后留意原服务器是否仍然存在。以后遇到异常,先用同一个目标与相同模式复现,再决定是检查资料、切换网络还是调整规则。不要把自动更新订阅与替换整份配置当成同一个动作;后者可能同时改变 DNS、Rule 与其他设置,需要重新验证。
本教程到此完成首次上手。需要了解权限、Data、Settings 与长期维护的完整关系,可继续阅读新手到进阶,不必在首次连接时一次设置全部功能。