官方手册 · 首次连接流程
Shadowrocket 使用教程订阅导入、模式选择与连接验证
以 iPhone / iPad 界面为例,从已有资料开始,按顺序完成添加与连接。先确认每一步的结果,再继续下一步,避免同时调整多项设置。
01添加资料02选择模式03连接04–05验证与排错
把资料准备在便于核对的位置,再打开应用。订阅链接与单台服务器参数属于两种不同输入:前者通常用于获取并更新一组条目,后者描述某台服务器的协议、地址及认证方式。不要把订阅地址直接填进 Host,也不要把普通网页地址当作订阅。下面两种添加路径选择一种即可,不必重复导入。
截图用于辨认页面与字段,实际可见选项可能随协议或系统而变化;截图中的条目不作为可用服务器资料。遇到界面差异时,以当前应用显示的英文项目名为线索查找。
STEP 01 · Add Server / Subscribe
添加服务器或导入已有订阅
打开 Shadowrocket,进入 Home,在 SERVER 分组找到 Add Server。进入添加页面后先看 Type,不要急着填写其余字段:Type 决定当前条目是什么类型,也决定后续需要提供哪些参数。若已有一条完整订阅链接,走 Subscribe 路径;若拿到的是服务器地址、端口与认证信息,走手动添加路径。
已有订阅:选择 Subscribe
在 Add Server 中打开 Type,选择 Subscribe,返回后在 URL 字段粘贴完整订阅链接,并填写便于识别的备注。复制时留意开头与结尾是否完整,尤其不要把聊天中的标点、换行或说明文字一起带入。链接中的查询参数也属于地址的一部分,不应自行删改;如果服务商给出的内容不是订阅,请先确认资料类型。
保存后回到 Home,等待订阅内容载入,检查是否出现对应分组与服务器条目。保存成功只表示添加了记录,仍要确认内容已经取得。若列表为空,先检查原链接,再尝试对该订阅执行更新;不要连续创建多个相同订阅,否则后续难以区分哪组数据需要维护。条目出现后,先保留原有分组,再进行下一步。
已有服务器参数:按 Type 填写
手动添加时,按资料选择 Shadowsocks、VMess、VLESS、Trojan 或其他对应协议。Host 填服务器域名或 IP,Port 填端口;Password、Method 及其他认证或传输字段按原资料填写。以 Shadowsocks 为例,Method 与 Password 必须与服务器设置一致,不能仅凭地址和端口完成连接。不同 Type 的字段并不相同,不要把某种协议的填写方式套用到另一种协议。
如果资料要求 TLS、特定传输方式或服务器名称,也要逐项核对。Host 通常不是带路径的网页 URL,不应额外添加网页路径。二维码资料可通过 Scan QR Code 读取;Import from Cloud JSON 只用于匹配该格式的资料,不是所有链接的通用导入入口。读取后仍应检查 Type 与关键参数,再保存返回 Home。
订阅链接可能包含访问凭据,不要公开完整地址或直接发送带有完整链接的截图。若添加后提示解析失败,可先按问答页中的订阅排查说明核对格式;确认列表有内容后,再选择流量如何处理。
STEP 02 · Global Routing / Config
选择 Global Routing 三种姿态
服务器条目准备好后,回到 Home,点击 Global Routing。这里决定请求如何处理,而不是修改服务器密码,也不是更新订阅。首次使用建议先理解三个选项,再按目的选择:配置(Config)、代理(Proxy)、直连(Direct)。切换后返回 Home,确认 Global Routing 一行显示的是刚才选定的姿态。
配置(Config):按当前配置规则分流
配置(Config)会依据当前启用的配置文件进行匹配。前往 Config,先确认正在使用哪份文件,再查看其中的规则。官方截图展示的是配置文件编辑页面,可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段;普通首次连接并不需要逐段修改,更不需要为了连通而启用所有功能。
规则按顺序判断,先命中的规则决定该请求的处理方式,末尾通常由 FINAL 接住未命中前面规则的请求。下面只是语法示例,不是要求整段替换现有配置。使用自己的配置时,应确认规则目标能在当前配置中正确解析,避免为了照抄示例而覆盖原有设置。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
示例中,匹配 example.com 及其子域的请求使用 PROXY,其他未匹配请求由 FINAL 指向 DIRECT。DIRECT 表示直接连接,PROXY 表示交给代理处理,REJECT 表示拒绝。某个网站打不开时,首先要确认它实际命中了哪种处理,而不是直接认定所有服务器都失效。
代理(Proxy)与直连(Direct):用于明确对照
代理(Proxy)把通常受该模式控制的请求交给所选代理处理,适合暂时对照 Config 下的结果。如果 Proxy 可以访问而 Config 不行,优先检查规则、策略选择或 DNS 相关设置。这个选项不会修复错误的认证信息,也不能保证所有应用请求都会得到同样结果。
直连(Direct)使用直接连接处理请求,适合观察当前基础网络本身是否正常。选择 Direct 后可以打开网页,不代表刚导入的服务器已经可用。完成对照测试后,应恢复预定的日常模式,并记录当前配置文件。需要调整复杂匹配顺序或策略时,转到完整使用手册,本页只保留首次连接必需的判断。
STEP 03 · Home / SERVER
选择服务器并打开连接开关
模式确定后回到 Home,在 SERVER 分组中点选本次要使用的服务器。存在多个订阅时,要看清选中标记对应的具体条目;订阅组名只是管理入口,不等于已经选定其中某台服务器。首次验证选定一台即可,暂时不要连续切换,以便把测试结果与当前设置对应起来。
确认 Global Routing 后,打开 Home 顶部开关。尚未连接时可看到 Not Connected。首次启用时,系统可能请求添加 VPN 配置;核对请求来自当前打开的 Shadowrocket 后,按系统提示确认,并在需要时通过设备验证。若拒绝了配置请求,应用无法仅靠重复导入订阅建立系统连接,应先处理这项权限。
返回 Home,观察顶部连接状态是否发生变化、开关是否保持开启。系统中的 VPN 标识可以帮助判断隧道状态,但不同设备的状态栏呈现方式并不完全一致,应以应用显示与系统 VPN 设置一起确认。若开关立即关闭,先不要修改规则文件,下一步应检查系统授权、已有 VPN 配置以及应用报告的错误。
设备上如果已有其他 VPN 连接或系统管理配置,可能影响本次建立连接。先确认当前激活的是哪一项;受单位或学校管理的设备,应遵守管理要求,不要删除不明用途的配置。基础网络还需先可用,例如需要网页登录确认的 Wi-Fi,应先完成网络接入页面上的操作。
第一次建立连接后先停留片刻,再执行测试。不要同时更新订阅、更换配置和切换网络,否则出现差异时难以知道是哪项改动造成。若要断开,回到 Home 关闭顶部开关即可;以后再次使用时,仍应确认服务器选择与 Global Routing 没有被之前的排查操作改变。
STEP 04 · Connectivity Test / Data
分开验证连接状态与实际访问
连接开关保持开启后,先在 Home 执行 Connectivity Test。测试用于观察当前测试方法下的连通结果,不是所有网站、所有协议或所有应用的统一结论。单次结果还会受测试目标、网络变化与测试方法影响,不宜仅根据一个数值决定配置是否正确,也不必把不同方法得到的读数直接比较。
随后打开浏览器,访问一个平时能够确认内容的目标页面,并实际刷新内容。浏览器缓存可能让旧页面在网络变化后仍然可见,所以“页面还开着”不等于本次请求成功。建议分别验证预期走代理与预期直接连接的目标,同时回看当前 Global Routing,确保测试条件与打算采用的日常模式一致。
用 Data 辅助观察,不把累计值当即时结论
回到 Shadowrocket 查看 Data,观察与本次访问相对应的流量变化。统计通常包含统计范围内的其他请求,后台同步也可能产生流量,因此不能把某个累计数字当作刚才单个页面的精确用量。若当前视图可以按服务器查看,就结合选中的服务器判断;若需要核对具体规则命中,再使用相关记录与诊断信息。
判断时把三个问题拆开:系统连接是否建立、目标请求是否能完成、处理方式是否符合规则。前两项正常,第三项仍可能有偏差。例如 Config 下某个目标正常打开,却可能实际命中了 DIRECT;反过来,Proxy 下可用而 Config 下失败,也应优先查分流路径,而不是反复重新添加同一个服务器。
- Connectivity Test 有结果、实际页面失败:核对具体目标、DNS 与规则,不直接判定整体可用。
- 实际访问正常、测试失败:检查测试方法与测试目标是否适合当前网络,避免为了一个测试改动整份配置。
- 切换 Wi-Fi 与蜂窝网络后结果不同:保留同一服务器与模式做对照,排除同时更换设置带来的干扰。
首次验证完成后,记住可用服务器、当前模式与配置文件名称。后续出现故障时,这组信息就是恢复基线。不要为了追求某个测试读数频繁修改已经验证可用的参数;如果使用仍有问题,再按下面的失败位置逐项排查。
STEP 05 · Settings / Diagnostics
按失败位置排查,不一次重置所有设置
先描述问题出现在哪一层,再决定查看哪个页面。把“订阅无法载入”“顶部开关无法保持”“某个网站打不开”都归为连接失败,会导致检查方向混乱。每轮只改一个变量,修改后重复第四步的验证;没有改善就恢复原值,再检查下一项,避免越改越难回溯。
列表为空或更新失败:回到订阅资料
先确认链接完整、类型为 Subscribe,并检查当前基础网络能否完成更新。订阅能够取得与其中服务器能够连接并不是同一件事;若链接已经失效,修改 Global Routing 没有帮助。连续更新也不会修复服务商侧失效的资料,应向自己的服务商确认链接状态、内容格式与相关使用状态。沟通时不要在公开页面贴出完整凭据。
有条目但连接失败:核对参数与系统状态
手动条目优先核对 Type、Host、Port、认证信息以及资料要求的 TLS 和传输设置。订阅条目先更新一次,再选定一台已知用于当前用途的服务器测试。开关立即关闭则检查系统 VPN 授权与其他已激活配置;开关保持但访问失败,才继续区分服务器连通、规则和目标访问,不要直接删除所有数据。
测试与访问不一致:查看 Test Method
进入 Settings,查看 Test Method,确认当前使用哪种测试方式。不同方式检查的层面不同,能返回测试结果不代表已验证目标网站的完整请求。保留原设置后再做单项对照,并结合实际访问判断。若只有某个目标异常,记录它的域名、出现时间、当前模式与错误现象,比单独记录“不能用”更便于定位。
自动连接或切网异常:检查 On Demand
Settings 中的 On Demand 与按需连接条件有关。如果手动关闭后又连接,或切换网络后行为不同,先检查是否设置了相应条件。首次使用可先把手动连接流程验证清楚,再配置按需行为。不要把 On Demand 当作修复服务器认证失败的开关;它决定何时尝试连接,不替代可用的服务器资料。
需要进一步定位时查看 Diagnostics,先确认记录对应本轮操作,再提取错误类别。分享记录前遮盖订阅 URL、密码、认证标识和其他敏感信息。Settings 中的 Proxy、TCP、UDP 等项目涉及不同网络行为,不建议凭名称逐个切换;具体含义可查完整使用手册,常见症状与处理路径见问答页。