官方手册 / 首次连接
Shadowrocket 订阅导入与连接教程
从已有连接信息开始,按导入、路由、连接、验证、排查的顺序操作。先完成一次可复现的连接,再调整规则与自动连接设置。
- Home → Add Server
- Global Routing
- Connectivity Test
本页以完成首次连接为目标。界面词保留英文原文;按钮位置可能随设备与应用界面调整,请按名称识别入口。已有连接信息齐全时,可按顺序完成一轮检查,不必先学习全部配置参数。
步骤 01 / 建立服务器列表
Add Server:添加服务器或导入 Subscribe
打开 Shadowrocket,进入 Home。首次使用时,列表中可能还没有服务器;这只是尚未导入连接信息,不是安装失败。先确认手中的内容属于哪一类:能够更新一组服务器的订阅 URL、单个服务器的分享链接,还是包含地址、端口与认证信息的参数说明。三类信息的导入方式不同,不要把订阅 URL 当成服务器地址填写。
已有订阅 URL:使用 Subscribe
在 Home 点右上角的添加按钮,打开 Add Server,进入 Type 并选择 Subscribe。返回填写页面后,将完整订阅地址粘贴到 URL,在 Remarks 中写下便于辨认的名称,然后保存。粘贴前后检查是否带入空格、换行或说明文字;地址中的查询参数也要保留,不能只复制域名部分。
保存后回到 Home,等待订阅读取完成,再检查是否出现订阅分组及其中的服务器条目。如果只保存了一个订阅名称,却没有可选服务器,先检查读取结果,不要反复添加同一地址。订阅地址通常包含访问凭据,应像密码一样保管;向他人描述问题时,不要发送完整 URL 或包含凭据的二维码。
已有单个服务器:按协议填写或导入
如果拿到的是参数,在 Add Server 的 Type 中选择与原始说明一致的协议,再填写服务器地址、端口和认证字段。不要根据名称猜协议,也不要把域名自行替换为解析出的 IP;部分连接依赖原有域名及相关 TLS 设置。涉及传输方式、路径或其他扩展字段时,逐项与服务商给出的信息对照,未提供的字段不要随意补填。
如果已有分享二维码,可使用 Scan QR Code 入口并按系统提示授予相机权限。已有分享链接则可按客户端出现的剪贴板导入提示操作;若没有提示,先确认复制的是完整分享内容,而不是网页标题。扫码或粘贴导入后,仍需检查条目类型与地址,导入成功只说明客户端能够识别信息,不代表服务器已经可用。
最后,在 Home 点选准备使用的服务器,确认它成为当前选择。先选一条完成后面的连接验证,不必立即调整整个列表的排序。关于订阅更新、重复条目和备份,另见订阅与服务器管理手册;本轮操作继续进入 Global Routing。
完成标志:Home 中已有可选的服务器,并且已经明确选中其中一条。
步骤 02 / 确定流量走向
Global Routing:选择 Config / Proxy / Direct
服务器决定“通过哪个连接出口”,Global Routing 决定“哪些连接使用它”。在 Home 打开 Global Routing,先辨认三种姿态:配置(Config)/代理(Proxy)/直连(Direct)。列表中有服务器、甚至连接开关已经开启,都不能单独说明所有请求一定经过所选服务器,最终流量走向还受这里的选择影响。
配置(Config):按当前配置逐条判断
配置(Config)依据当前启用配置中的规则处理请求,匹配到 DIRECT 的流量直接连接,匹配到 PROXY 的流量使用相应代理策略。使用前进入 Config,确认当前启用的是哪份配置,并了解其基本用途。仅仅导入订阅,不等于同时导入了完整规则配置;订阅分组出现在 Home,也不表示 Config 已经切换。
已有可信且符合自身用途的配置时,可以使用配置(Config)进行日常连接。不要为了完成首次操作就随意替换整份配置;配置文件可能还包含 DNS、策略组等设置,替换后出现问题会增加排查变量。规则细节不需要在本页一次学完,先记录当前配置名称,保证后面能够恢复。
代理(Proxy)与直连(Direct):用于明确对照
代理(Proxy)让受客户端处理的流量使用代理路径,适合临时判断所选服务器能否完成实际访问,但并不意味着设备上的每一种通信都一定经过该路径。直连(Direct)让受处理的流量直接连接,可用于对照基础网络;它不是“代理连接更稳定”的另一种模式,也不会通过所选服务器转发这些请求。
首次排查若不确定规则是否干预了测试,可以先记下原来的选择,临时使用代理(Proxy)完成一次访问,再恢复配置(Config)重复相同测试。若两次结果不同,优先检查配置与策略,而不是立刻删除服务器。无论选哪一种,设置后返回 Home,再进行下一步的开关操作。
完成标志:能够说清当前选择及其用途,并知道临时测试后应恢复哪一种姿态。
步骤 03 / 建立系统连接
Home:打开开关与首次 VPN 授权
返回 Home,重新看一眼当前服务器与 Global Routing,确认没有在浏览列表时误选其他条目,然后打开顶部连接开关。首次建立连接时,系统可能提示 Shadowrocket 请求添加 VPN 配置。这是让客户端接管相关网络流量所需的系统授权,不是重新购买应用,也不是订阅已经生效的证明。
在系统提示中确认发起应用为 Shadowrocket,阅读提示后允许添加,并按照设备要求完成身份验证。若取消或拒绝,客户端可能无法建立连接;此时先返回 Home 再次尝试,按系统提示完成授权。设备若受组织管理或存在限制,相关权限可能由管理策略决定,应先确认限制条件,不要反复重置配置。
授权结束后回到客户端,观察开关与连接状态是否保持。系统状态栏或控制中心中的 VPN 标识可以辅助确认系统连接已建立,但不同设备上的显示位置可能不同。VPN 已连接不等于远端服务器、DNS 和目标网站都正常,还需要继续做实际访问验证。
首次测试期间,先不要启用或调整 On Demand。按需连接条件可能在手动断开后再次请求连接,使测试前后状态难以比较。若之前已经设置过自动连接条件,先记录设置,并在理解其作用后暂时停止自动触发。设备上其他正在使用的 VPN 连接也应先断开,避免连接状态相互切换。
如果开关立即回落,记录当时的系统提示及客户端错误信息,直接到失败排查检查授权与配置;不要连续快速开关。若开关保持开启,则保留当前状态进入验证步骤。需要结束本次连接时,返回 Home 关闭开关,并观察系统连接状态;若自动恢复,应回查 On Demand 条件。
完成标志:系统授权已完成,连接状态能够保持;下一步验证实际请求,而不只看开关。
步骤 04 / 用实际请求确认结果
Connectivity Test:延迟与页面访问分别检查
先确认设备当前的 Wi-Fi 或蜂窝网络本身可用。如果基础网络仍停留在登录认证页面,或者暂时无法正常联网,应先完成认证并恢复网络,再测试 Shadowrocket。否则,订阅读取、延迟测试和网页访问可能一起失败,容易误判为服务器参数错误。
在 Home 使用 Connectivity Test 对导入的服务器进行测试,等待本轮结果完成。测试结果可用于初步判断可达性和响应情况,但不同测试方式检查的范围并不完全相同。有延迟数值不代表认证、DNS、规则与目标网站访问都已通过;没有结果也应结合测试方式和网络环境判断,而不是只凭一次结果删除条目。
接着打开 Safari,访问一个你有权访问、且平时能够正常使用的 HTTPS 页面。等待页面实际加载,再打开同一网站的另一页,避免把已经缓存的页面误当作当前连接成功。若目标应用也需要使用该连接,再打开该应用进行对应操作;浏览器能够访问,只能说明这次浏览器请求成功,不能直接替代应用内验证。
使用配置(Config)时,某个页面打开并不能证明它经过代理:该域名可能命中了 DIRECT。需要确认流量走向时,结合客户端中的请求记录或日志,按目标域名寻找相应请求,查看是否符合当前配置的策略。只在自己的设备上检查必要信息;日志可能包含访问域名,不应整段公开。
为了得到可比较的结果,一次只改变一个条件。例如保持网络、服务器和测试页面不变,只临时把配置(Config)改为代理(Proxy),重新加载同一页面后再恢复原选择。如果代理(Proxy)可用而配置(Config)失败,检查重点就转向规则、策略选择和 DNS;如果两者都失败,再继续检查服务器与网络。
验证结束后,保留一条已确认可用的服务器和一份当前配置作为基线。以后更换服务器、更新订阅或修改规则时,都可以用同样的页面重复测试。不要仅以延迟最小作为选择依据,实际访问稳定、目标操作能够完成,才是本次验证需要确认的结果。
完成标志:测试页面可以实际加载,目标操作能够完成,流量走向与当前 Global Routing 的预期一致。
步骤 05 / 按发生阶段缩小范围
Shadowrocket 连不上:先定位失败在哪一步
遇到失败时,先记下“哪一步没有达到完成标志”,再按下面的顺序检查。导入失败、开关无法保持和网页打不开属于不同阶段,处理方法也不同。保留当前配置与原始连接信息,每次只修改一项,修改后重复同一个测试;这样才能判断变化是否真正解决问题。
订阅没有条目,或更新后仍不可用
回到订阅信息,核对 URL 是否完整,尤其是末尾参数、大小写及粘贴时带入的空白。确认当前基础网络能够请求订阅地址,再尝试更新已有订阅,而不是重复创建多个分组。若返回的是账号登录页面、说明页面或其他无法识别的内容,客户端就不能按预期生成服务器列表。
订阅访问权限、有效状态及服务器可用情况,需要向你的服务商确认。描述问题时提供错误文字、发生阶段和必要的脱敏信息即可。不要为了排查把完整订阅 URL 放进公开网页或聊天截图。更完整的更新与整理方法见订阅更新说明。
条目已经存在,但测试失败或连接中断
先核对当前选中的服务器,随后检查协议、地址、端口和认证信息。手动填写的条目尤其要检查 TLS 与传输相关字段;连接参数需要相互匹配,并非只要地址和端口正确就足够。若服务商已经调整信息,按最新有效信息更新,不要仅修改条目名称。
若系统授权未完成或开关立即回落,先处理设备显示的权限提示。连接状态能够保持但实际请求失败时,再测试另一条你已有的服务器,并保持同一个网络与测试页面。一次切换多条服务器、同时改 DNS 和规则,会使结果失去对照意义。
延迟正常,但网页打不开
先排除直连(Direct)选择与预期不符的情况,再按前一步的方法比较配置(Config)和代理(Proxy)。仅配置(Config)失败时,检查当前启用配置及相关规则;两种姿态都无法访问时,继续检查服务器能力、基础网络和 DNS。测试一个其他正常页面,可以帮助区分单个目标网站的问题与普遍访问失败。
DNS 负责把域名解析为地址,延迟测试成功并不能证明每个域名都能解析。检查前先保存配置,了解当前是否修改过 dns-server 等参数;不要随手填入不熟悉的地址。优先恢复到此前已验证可用的设置,再重复请求。具体排查顺序见延迟正常但网页打不开的 DNS 检查说明。
完成排查后,恢复日常设置
当同一网络、同一服务器和同一页面能够稳定复测后,恢复日常使用的 Global Routing,确认临时测试没有遗留在代理(Proxy)或直连(Direct)。需要 On Demand 时,再单独设置触发条件并验证。接下来可以阅读订阅与服务器管理手册整理分组、更新与备份;首次连接阶段不必同时改动所有高级选项。
完成标志:能明确指出失败阶段、已检查的项目与复测结果,而不是只得到“开关已打开”这一项信息。