官方手册 / 初次设置
Shadowrocket 快速上手
从添加服务器到验证分流。按顺序操作,每一步确认结果后再继续。
步骤 01 / 准备服务器
添加服务器或导入订阅
打开 Shadowrocket,进入底部的 Home。先看清手头的资料是哪一类:一条订阅链接通常用来获取一组服务器;单台服务器的资料则会分别给出协议、地址、端口和认证参数。两种方式任选一种,不用先手动添加,再用订阅重复导入同一组条目。
手动添加:先选 Type,再填字段
在 Home 点右上角的加号,进入 Add Server。先在 Type 选择资料中明确标注的协议,因为协议不同,接下来显示的字段也不同。以 Shadowsocks 为例,在 Host 填服务器域名或 IP 地址,在 Port 填端口;再填 Password,在 Method 选择服务商指定的方法。地址和端口分开填,不把网址前缀、路径或端口一并粘进 Host。复制参数后,检查首尾是否多了空格或换行。
确认各字段与原始资料一致后保存,返回 Home 查看 SERVER 下是否出现该条目。如果只拿到了地址和端口,却不清楚 Type 或认证参数,先向你的服务商核对;不要用其他协议的示例值补齐缺项。右侧截图中的 Scan QR Code 和 Import from Cloud JSON 是其他导入入口,手动填写时不必经过它们。
用订阅导入:保存后检查 SERVER
如果拿到的是订阅链接,从 Home 点加号,在 Add Server 的 Type 中选择 Subscribe,把完整链接粘贴到 URL 字段后保存。保留链接原有的路径和查询参数,不要改用服务商的登录页地址。返回 Home,等订阅加载,再在 SERVER 下找到对应分组并查看其中是否有条目。订阅链接可能包含访问凭据,不要连同截图或日志公开发送。
看到可以选中的服务器,就可以继续设置 Global Routing。只看到分组名、里面却没有服务器时,先处理导入问题;反复切换连接开关不会让空分组自动补齐。
步骤 02 / 指定流量处理方式
选择 Global Routing 模式
在 Home 点 Global Routing。这里决定客户端接管连接后怎样处理流量,不负责添加服务器,也不会替换 SERVER 中选中的条目。若希望访问不同目标时分别走代理或直连,日常使用应选配置(Config),并确认所用配置文件符合预期。
- 配置(Config):按当前配置文件中的规则选择策略。两个目标可以分别走代理和直连,不要求所有请求走同一路径。
- 代理(Proxy):让客户端处理的流量走代理。初次排查时可短暂切到此模式,确认所选服务器能否处理测试目标,再切回原模式。
- 直连(Direct):让客户端处理的流量直接连接,不经所选代理服务器。适合做对照,但不等于关闭 Home 的连接开关。
使用配置(Config)前确认当前文件
Global Routing 中的 Config 是一种模式,底部的 Config 则是管理配置文件的页面。选了配置模式以后,再去底部 Config 核对当前启用的文件。编辑页可看到 General、Rule 和 Hosts 等分段;初次连接只需确认自己查看的是当前文件,进入 Rule 了解要测试的目标应走哪种策略,不必点 Add Rule 临时改规则。
尽量不要在初次验证时一边改规则、一边换服务器。两处同时变动,即使目标恢复访问,也难以判断是哪项调整起了作用。模式选定后回到 Home,确认 Global Routing 显示刚选择的值,再打开连接。
步骤 03 / 建立连接
打开 Home 的连接开关
回到 Home,在 SERVER 下点选刚添加的服务器。如果导入的是订阅,先进入对应分组,再选其中一个具体条目。列表里有服务器不代表已经选中打算测试的那一条;操作前记一下条目名称,后面测出异常时,才能回到同一个条目复测。
点 Home 顶部 Not Connected 旁的开关。首次连接时,系统可能请求允许 Shadowrocket 添加 VPN 配置。确认请求是在刚才点开关后、由 Shadowrocket 发起,再允许;如果系统要求验证设备身份,按系统提示在设备上完成。这一步是让系统允许客户端建立连接,不需要在系统弹窗里填写订阅链接或服务器密码。
验证完成后回到 Home,等状态更新。看到顶部从 Not Connected 变为 Connected,再检查 Global Routing 是否仍是第二步选定的模式。若已经有其他 VPN 在工作,先在对应应用中断开它,再回到 Shadowrocket 试一次,避免把另一个连接的状态误认为本次结果。不要为了测试随意删除设备上已有的 VPN 配置。
如果先前点了不允许,回到 Home 重新打开开关,看看系统是否再次提示。如果开关点开后立即回落,不必连续点击:记下有没有弹窗、是否已允许,以及回落发生在选中服务器前还是之后,按第五步查找原因。即使看到 Connected,也只能确认客户端已建立连接;服务器是否可用、特定目标是否按预期分流,要到下一步分别验证。
步骤 04 / 检查实际访问
用 Connectivity Test 与实际请求交叉验证
保持和第三步相同的网络、服务器及 Global Routing 模式。在 Home 点 Connectivity Test,等本次结果返回,再看它对应的条目是不是刚才选中的服务器。出现结果说明该条目在当前测试方法下有响应,不代表每个网站都能正常访问;反过来,单次超时也不一定说明连接已断开,测试目标本身也可能没有响应。
按当前模式选择测试目标
如果选择的是配置(Config),用浏览器分别打开两个你熟悉的目标:一个按当前规则应走代理,另一个应直连。对照时以规则实际匹配的域名为准;一个页面可能还向其他域名请求内容,因此页面能打开,不等于它的所有请求都走同一策略。可以重新载入页面,避免把已缓存的内容当成新连接的结果。若只想确认代理能不能访问某个目标,可保持同一服务器,短暂切到代理(Proxy)重试,再恢复配置(Config)。
如果选择的是直连(Direct),当前结果只用于确认目标在直连条件下是否可达,不作为代理成功的依据。测试结束后回到 Home,核对开关和模式是否符合日常使用需求。若 Connectivity Test 有响应、实际目标也能访问,但还不能确定规则匹配到了哪一项,请查看使用手册中的规则与连接验证章节,不必为此重建订阅。
步骤 05 / 定位失败环节
按现象排查常见连接问题
SERVER 没有条目:先查导入
订阅分组为空时,先核对粘贴的链接是否完整、Type 是否选了 Subscribe,再确认设备当前能够联网。如果链接能确认是最新的,但刷新后仍无条目,向你的服务商确认链接是否有效以及返回的内容是否适用于客户端。手动添加后找不到条目,则回到 Add Server 检查必填字段是否完整、是否完成保存。只有看到具体服务器后,才需要检查连接模式。
开关回落或自动重连:区分权限与按需行为
如果没能完成系统的 VPN 配置确认,先从 Home 重新发起一次连接。若 VPN 权限已允许,但手动断开后又自动连接,进入 Settings 检查 On Demand 是否启用。需要做一次纯手动对照时,可先记下原设置,再临时停用 On Demand,回到 Home 重试;排查结束后按需要恢复原设置。
已连接但测试失败:先分清失败范围
先确认普通网络访问是否正常,再核对 Home 选中的服务器与当前模式。若只有 Connectivity Test 超时,而实际访问正常,在 Settings 查看 Test Method,避免把不同测试方法得到的结果直接比较。若测试和实际访问都失败,可在条件允许时选另一个你已有的服务器,以同一模式和目标复测。每次只改一项,观察是某个条目失败,还是换条目后仍出现同一现象。
若仅一个目标不通,且同一服务器在代理(Proxy)下可以访问、切回配置(Config)后却不行,优先核对当前配置文件和 Rule 的匹配顺序。问题持续时,可到 Settings 中查看 Diagnostics,对照刚记录的复现时间和现象。更细的权限、导入和路由排查见疑难解答。