官方手册 / 首次连接
Shadowrocket 使用说明
先导入已有服务器,再选分流模式、打开连接。最后用测试结果和实际访问确认设置是否生效。
01 / SERVER
添加服务器或导入订阅
先判断手里的资料是订阅链接还是单台服务器信息。两者都从 Home 开始,但填写方式不同:订阅链接用于获取一组服务器,单台服务器信息则用来建立一个条目。先完成其中一种,不必为同一台服务器同时做两次导入。
订阅链接:选择 Subscribe
复制从你的服务商处获取的完整订阅链接。在 Home 的 SERVER 分组点 Add Server,打开 Type 并选择 Subscribe,把链接粘贴到地址栏,再保存。粘贴后检查开头、结尾和查询参数有没有丢失,尤其不要把链接旁边的说明文字一起复制进去。返回 Home,待订阅载入后展开对应分组,确认展开后能看到服务器条目。分组名称已经出现但内容为空时,还不能算导入完成。
单台服务器:按 Type 填写字段
在 Add Server 中先按服务商给出的协议选择 Type,再填写 Host 和 Port。Host 是主机名或 IP 地址,Port 单独填写,不要把订阅链接或连同端口一起复制的地址填进 Host。截图中的 Password 和 Method 是当前 Type 的字段示例;切换协议后字段可能不同。界面要求密码、加密方式或其他参数时,按服务商给出的原值填写,不确定的项目不要用另一个协议的字段代替。
如果已有服务商给出的服务器二维码,可以在 Add Server 使用 Scan QR Code。识别后先核对 Type 和地址,再保存。完整订阅链接、服务器密码和二维码都可能包含凭据,不要把它们贴进公开帖子,也不要用它们制作求助截图。
回到 Home,在 SERVER 分组选择本次要验证的条目。若导入了多组资料,先对照分组名和服务器名,避免接下来测试了另一个同名条目。需要整理多个订阅、处理分享链接或设置更新时,参阅订阅与服务器管理手册;本次先保留一个明确的测试对象,再进入分流设置。
02 / GLOBAL ROUTING
选择分流模式
服务器决定代理连接发往哪里,Global Routing 决定什么连接交给代理处理。在 Home 点 Global Routing 进入选择列表。本次首次设置只需认识三种姿态,按你希望验证的行为选择:
- 配置(Config):按当前配置中的规则决定连接策略。需要让不同目标分别走
PROXY或DIRECT时,选择这一档。 - 代理(Proxy):让交由客户端处理的连接走代理。适合临时检查所选服务器的代理路径,不用先判断测试目标命中了哪条规则。
- 直连(Direct):让交由客户端处理的连接直接发送,不使用所选代理服务器。可以用来对照当前网络能否直接访问同一个目标。
使用 Config 时,先核对当前配置
选了配置(Config),再到 Config 页核对正在使用的文件。Global Routing 中的 Config 是一种运行模式,底部的 Config 则是查看和管理配置的入口;选中模式不等于已经切换配置文件。打开当前文件后,可以进入 Rule 检查测试目标可能匹配的规则及其策略。本教程不要求新增规则,先看懂已有设置即可。
检查某个域名时,除了找直接写着该域名的条目,也要看前面有没有涵盖它的域名后缀规则;没有命中前面的条件时,再看末尾的 FINAL。若预期行为与已有配置不同,先记下目标、可能命中的规则和策略,不必改动截图中的其他配置分段。
返回 Home 后,再读一遍 Global Routing 显示的档位。如果只是临时用代理(Proxy)做对照,记下原来的档位,等验证完成后切回。测试时尽量保持服务器不变,这样切换档位前后的差异才容易解释。
03 / HOME
在 Home 打开连接
打开开关前,先确认设备本身能通过当前 Wi-Fi 或蜂窝网络联网。如果是需要先完成网页认证的 Wi-Fi,先保持 Shadowrocket 关闭,完成该网络的登录再继续。这样可以把基础网络故障和代理连接故障分开,不必在没有联网时反复更换服务器。
确认系统提示,再回到 Home
在 Home 核对 SERVER 中选中的条目以及 Global Routing 的档位,然后打开顶部开关。关闭时,截图中的状态显示为 Not Connected。首次打开时,系统可能询问是否允许 Shadowrocket 添加 VPN 配置;确认提示由本次操作触发、应用名称正确后,再按系统要求确认。完成后回到 Home,等待状态更新,不要连续拨动开关。
如果曾取消系统提示,返回 Home 再打开开关,留意提示是否重新出现。如果设备已由组织管理,或者另一个 VPN 正在使用,不要直接删除已有配置。先确认该连接的用途;工作或学校设备上的限制由设备管理员处理。只要开关仍回到 Not Connected,就先解决连接没有建立的问题,不必先去改 Rule。
区分连接状态与访问结果
开关保持开启,只表示客户端进入连接状态,不代表某个网页一定能访问,也不代表所有请求都走代理。比如,使用直连(Direct)时,开关可以保持开启,但这不构成对代理服务器的验证。打开后先记下当前服务器、分流档位和所用网络,然后到下一步做实际测试。
如果设备在测试过程中切换了 Wi-Fi 和蜂窝网络,等网络稳定后再测一次。两次结果对应不同网络时,先按网络分别记录,不能把差异直接归因于配置。首次验证尽量在同一网络下完成,等连接与访问结果都确认后再检查网络切换时的行为。
04 / CONNECTIVITY TEST
验证连接与分流结果
先在 Home 运行 Connectivity Test,再用平时使用的浏览器或应用发起一次新请求。两项都需要做:Connectivity Test 的结果取决于当前 Test Method 和测试条件,不能替代对实际目标的验证。测试前记下选中条目和 Global Routing 档位;如果界面列出多条测试结果,只把正在使用的那一条作为本轮记录。
用实际访问对照配置预期
使用配置(Config)时,从自己的配置中挑两个熟悉的目标,一个按规则应走 PROXY,另一个应走 DIRECT。分别重新加载或发起新的请求,避免把先前已经打开的页面当作本次结果。自选目标时优先用能稳定复测的地址,不要只用一个本身经常超时或有登录限制的页面来判断连接。
如果两个目标都能打开,只能说明访问发生了,不能据此断定策略命中正确,因为有的目标经两种路径都能访问。需要进一步确认时,可在 Settings 的 Diagnostics 中查看客户端提供的记录;如果有对应请求,就用目标和时间找到同一次访问,再核对记录中可见的匹配规则或策略。不要把测试完成前就已存在的记录当作本次结果。
如果只有一个目标失败,保持同一服务器和网络,把同一个目标分别在代理(Proxy)与直连(Direct)下复测。某个档位能打开而配置(Config)下不能打开时,优先查看该目标在配置里实际匹配的规则;若两个档位下都失败,再检查目标本身和基础网络。对照结束后恢复原档位,再做一次实际访问,确认日常使用的设置也能工作。
05 / SETTINGS
常见连接失败排查
优先检查最早出现异常的环节。SERVER 没有条目时不必修改分流规则;能打开连接而只有部分目标失败时,也不必先重新导入整个订阅。每次只改一项,用上一步的同一个目标复测,确认这次变动是否真的影响结果。
导入后没有可选服务器
确认订阅使用了 Subscribe,链接未经截断,当前网络也可以请求服务商给出的地址;若分组存在但没有条目,先查看订阅更新是否返回错误。手填条目则检查 Type 是否与原资料一致、Host 和 Port 是否被填反、协议要求的字段是否齐全。若服务商提示订阅链接已更换,从你的服务商处获取后再更新原订阅,避免重复保存同一个失效地址。
已连接,但测试或访问失败
先核对 Home 选中的服务器是否就是本轮要测的条目,再到 Settings 查看 Test Method。两次选用不同测试方式时,结果不宜直接比较。若 Connectivity Test 失败但实际访问成功,先判断差异是否只出现在测试目标,不要据此删除服务器。若只有少数域名打不开,回到 Config 查看匹配规则是否指向 REJECT 或当前不可用的策略,再在 Diagnostics 中查找同一时间的请求记录。看到域名解析错误时,再核对当前配置里的 DNS 设置。
开关在换网后自行变化
如果问题只在 Wi-Fi 与蜂窝网络切换后出现,到 Settings 查看 On Demand,核对当前网络是否符合已有连接条件。先记录设置,再选择在稳定网络下手动连接并复测;手动连接成功时,再单独检查按需条件。若系统持续不允许连接,回到前一步检查 VPN 配置确认流程以及设备管理限制,不要以关闭系统保护作为排查手段。
仍未定位时,可在常见问题按下载安装、订阅导入或分流排查查找对应说明。若要向服务商描述问题,只需说明失败发生在导入、连接还是访问阶段,并附上脱敏后的错误文字、触发条件和复测结果。