官方手册 · 首次连接
Shadowrocket 使用教程
用已有的订阅或服务器信息完成第一次连接,再分别检查分流选择、服务器响应和实际访问。
1. 在 Home 添加服务器或导入订阅
打开 Shadowrocket,点底部的 Home,再点右上角的加号进入 Add Server。先判断手里的资料是哪一种:订阅链接用于获取一组条目;单个服务器资料则对应一个条目,通常按协议分列地址、端口和认证信息。首次设置只选一种方式即可,不必同时导入订阅并手填同一台服务器。添加资料时可以先保持顶部连接开关关闭。
已有订阅链接:选择 Subscribe
在 Add Server 打开类型选择,选 Subscribe,把完整订阅链接粘贴到 URL 栏。核对开头与结尾,尤其注意复制时有没有带入空格、换行或旁边的说明文字。不要删掉链接问号后面的参数,也不要把整个链接拆成服务器地址和端口。保存后回到 Home,查看 SERVER 列表是否出现订阅及其下的服务器条目。若只看到订阅名称,没有可选条目,先检查该订阅能否更新,再决定是否继续。
已有单个服务器:按协议填写
在 Add Server 选择资料指定的协议,例如 Shadowsocks 或 VLESS,然后逐项填写地址、端口及该协议要求的认证字段。地址栏只填资料指定的主机名或 IP 地址,端口填在独立字段中。协议相关的传输与安全选项也应与资料一致;缺少必要字段时,先向资料提供方确认,不要拿其他条目的值补齐。保存后返回列表,看新条目是否出现。若多个条目的名称相近,可用自己能辨认的备注区分,不要把密码写进备注。
无论用哪种方式,下一步都是在 SERVER 中点选一个具体服务器,并确认当前选中的是刚才要测试的条目。订阅导入成功只表示列表已经载入,不表示服务器可达;保存手填条目同样不代表认证已经通过。先记住当前选中的名称,接下来选择分流方式时保留这个条目,避免同时改变两个条件。
2. 在 Global Routing 选择配置、代理或直连
在 Home 点 Global Routing,按当前任务选择配置(Config)、代理(Proxy)或直连(Direct)。这里选择的是连接建立后如何处理流量,不是在选择服务器。切换分流方式不会修改已保存的服务器地址或订阅链接。选好后回到 Home,先核对显示的模式,再去打开连接。
| 姿态 | 如何处理流量 | 何时使用 |
|---|---|---|
| 配置(Config) | 按当前配置文件的规则和策略处理。 | 确认日常分流是否符合配置。 |
| 代理(Proxy) | 让客户端接管的流量通过代理。 | 暂时排除分流规则的影响,检查代理路径。 |
| 直连(Direct) | 让客户端接管的流量直接连接,不通过代理服务器。 | 与代理路径做对照。 |
使用 Config 前确认当前配置
底部的 Config 是查看和管理配置文件的位置;Global Routing 中的 Config 是让连接按当前配置执行的选项。两处同名,作用不同。若已有准备使用的配置,先到下方 Config 确认当前选中的是那份文件,再回 Home 选择 Global Routing 中的 Config。不要把刚导入的订阅当成分流配置:订阅提供可选服务器,配置决定访问请求如何处理。
如果此时只想验证服务器能否工作,可以先用 Proxy 做一次短测试,验证后再切回原来打算使用的模式。用 Direct 能打开网页,只能说明该请求在直连路径上可完成,不能证明代理服务器可用。反过来,选了 Config 也不代表每个网站都经过代理;不同域名可能匹配不同规则。首次测试先不改写规则,记录选择即可。
3. 打开 Home 开关并允许 VPN 配置
回到 Home,看一遍 SERVER 的选中项和 Global Routing 的当前模式。两项正确后,点页面顶部 Not Connected 一侧的连接开关。首次建立连接时,iPhone 或 iPad 可能弹出添加 VPN 配置的系统提示。核对请求来自 Shadowrocket 后允许,并按设备提示完成验证。验证成功后返回应用,等待顶部状态变化,不要在系统提示还没处理完时反复点开关。
如果先前取消了系统提示,可回到 Home 再尝试开启一次。若没有再次出现提示,开关也无法保持开启,先到系统设置确认 VPN 配置状态;如果设备由单位或学校管理,还要确认管理策略是否允许添加 VPN。若设备已有其他活动的 VPN 连接,在可以自行管理该连接的情况下,先断开再测试。不要为了完成这一步删除用途不明的配置,也不要关闭设备的管理限制。
顶部出现已连接状态,只表示客户端的 VPN 连接已启动;它不等于订阅刷新成功,也不等于选中的服务器已经通过实际请求验证。此时先保持当前网络不变。例如,刚才使用 Wi-Fi 开启连接,就先在同一个 Wi-Fi 环境中完成下一步,不要一边测服务器一边切到蜂窝网络。这样失败时能判断变化来自网络、服务器,还是分流方式。
4. 用 Connectivity Test 和实际访问验证
在 Home 点 Connectivity Test,等待测试结束,然后查看当前选中服务器对应的结果。列表里有其他服务器返回读数,并不能证明当前使用的服务器也有响应。若当前条目显示超时,记下使用的网络、服务器名称和测试结果,不要仅凭一次超时就删除条目。测试结果只反映当时针对测试目标的响应,不是所有网站访问情况的汇总,也不能用响应时间推断下载速度。
接着打开浏览器,用新标签访问一个你知道正常、适合用于对照的网页。等页面加载出实际内容,再刷新一次,避免把先前已经打开的页面当成新请求。如果用的是 Config,最好分别验证一个预期走代理的目标和一个预期直连的目标。验证前先确认目标域名与配置规则相符;一个站点的首页、登录页和资源文件可能使用不同域名,因此只看首页能否打开,不足以判断整个站点的访问情况。
当结果和预期不一致时,保留服务器与网络,只换一种分流方式,再访问同一个目标。比如当前 Config 下访问失败,而 Proxy 下可以打开,应先看当前配置及该域名命中的策略;如果 Proxy 与 Direct 都失败,先确认目标或当前网络是否正常。对照完成后,切回打算长期使用的姿态并再访问一次。记录「开关状态、测试结果、实际访问」三项,比只记一个延迟数值更便于后续排查。
5. 按失败发生的位置排查
先定位第一个没达到预期的步骤:列表没有条目、开关打不开、服务器测试超时,还是测试有响应但网页打不开。按顺序检查,先解决前一层,再复测下一层。如果已经能正常打开页面,只是某个目标不符合分流预期,不必先重装应用或重做订阅。
订阅保存了,但列表没有服务器
回到添加资料,确认保存时类型为 Subscribe,链接填的是完整原文。检查手中是否有比当前保存内容更新的链接,并在能正常上网的网络上尝试更新。若仍取不到条目,向资料提供方确认链接是否有效、响应内容是否适用于客户端。反馈时可以说明错误提示与发生时间,但不要在公开讨论中粘贴完整链接、认证字段或含这些信息的截图。
开关打开后立刻关闭
回到连接步骤,确认系统的 VPN 配置提示是否已经允许,以及设备上是否存在其他活动的 VPN。先处理权限或冲突,再回 Home 复试。若配置受设备管理,记录系统提示并联系设备管理员核对。这个症状发生在连接启动阶段,修改服务器端口或分流规则不是首要检查项。
服务器超时,或有响应但网页打不开
先断开 Shadowrocket,确认当前网络本身可以访问一个通常可直连的网页。如果连基础访问都失败,先处理网络登录、Wi-Fi 或蜂窝连接问题。基础网络正常时,重新开启 Shadowrocket,核对服务器地址、端口与协议;如果自己的列表还有另一条已知可用的服务器,可在同一网络、同一模式下做一次对照。只有一个条目超时时,优先查该条目的资料与可用性;多个条目都失败时,再考虑网络或设置的共同影响。
若 Connectivity Test 有响应而实际访问失败,重做访问对照,看问题是否仅在 Config 下出现。若浏览器提示域名解析失败,记录具体域名和提示,再按排查手册检查 DNS 与规则;若只有某个站点的图片或登录页异常,先记下失败的具体页面。每次只改一项;没有改善就恢复原值,再检查下一个因素。