官方手册首次连接
Shadowrocket 快速上手
添加已有连接信息,选择 Global Routing,再验证实际访问。按五步完成一次可复查的连接流程。
准备一条可用的订阅地址,或一份完整的服务器参数即可,不需要两种方式都操作。以下官方截图用于辨认界面位置;服务器名称与可用条目以自己的配置为准。
01 / ADD
添加服务器 / 导入订阅
先把信息放入 Home 的 SERVER 分组,再决定使用哪一个条目。
打开 Shadowrocket,进入 Home。首次使用时,SERVER 分组可能尚未包含服务器。点击 Add Server 进入添加页面,先查看 Type,再选择与你手中的信息一致的类型。订阅地址、单个服务器的分享链接和普通网页地址不是同一种内容;如果不能确认手中信息的用途,先查看服务商提供的参数说明,不要靠反复切换类型尝试。
已有订阅链接:选择 Subscribe
在 Add Server 中打开 Type,选择 Subscribe,将完整订阅地址填写到相应的 URL 字段,并填写便于辨认的名称。复制时保留地址中的路径与查询参数,去掉前后的空格或换行,不要只复制域名。保存并等待订阅内容获取完成,然后回到 Home,确认订阅分组下已经出现服务器条目。若只看到了订阅名称却没有服务器,先按第五步检查获取结果,而不是直接打开连接。
订阅通常用于批量管理服务器。后续更新应在原订阅条目上进行,不必每次重新添加同一地址。服务器数量或名称发生变化时,先确认更新是否成功,再重新选择可用条目。订阅能获取成功,只代表地址返回了可导入的内容,并不代表其中每个服务器都处于可连接状态。
已有单个服务器:逐项核对参数
若服务商提供的是单个服务器参数,在 Type 选择对应协议,再填写 Host、Port 以及该协议要求的认证信息。以 Shadowsocks 为例,需要准确填写 Password 和 Method;其他协议可能使用不同字段,不要把一种协议的参数套入另一种类型。Host 不要擅自添加网页地址前缀,Port 应与提供的信息一致,Password 注意大小写与复制时多出的空白。
如果已有二维码,可从 Add Server 底部使用 Scan QR Code,按系统提示允许相机访问。Import from Cloud JSON 只用于与该入口相符的配置数据,不是任何订阅链接都适用。无论通过哪种方式导入,保存前都要检查 Type 与关键字段;保存后回到 Home,点选计划使用的服务器,确认选中标记落在正确条目上。
完成这一阶段的标准是“能看到并选中服务器”,不是“已经联网成功”。下一步将决定请求怎样交给这个服务器处理。协议参数的完整解释可继续阅读新手到进阶官方手册,首次操作先保留服务商给出的参数即可。
02 / ROUTING
选择 Global Routing 三姿态
服务器决定连接到哪里;Global Routing 决定请求按什么方式处理。
返回 Home,点击 Global Routing,查看配置(Config)、代理(Proxy)、直连(Direct)三个选项。首次连接时,先明确本次要验证的是服务器本身,还是现有规则的分流结果。不要在不清楚当前姿态时同时修改服务器、规则和 DNS,否则出现问题后很难判断是哪一步造成变化。
配置(Config):按配置文件中的规则处理
选择配置(Config)时,请求由当前配置文件中的规则决定处理策略。进入 Config,确认正在使用的配置文件;打开配置编辑页面,可以看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。首次上手重点查看 Rule,确认已有规则符合自己的访问需求。没有明确需求时,不必为了连接而启用其他分段,也不需要先修改所有设置。
下面的片段只解释顺序:匹配 example.com 及其子域名的请求走 PROXY,其他未命中的请求由 FINAL 交给 DIRECT。example.com 是示例域名,不代表需要连接的服务器,也不是可以直接满足个人需求的完整配置。规则从上到下匹配,FINAL 应放在兜底位置;如果目标请求被前面的规则接走,后面的规则不会替它重新作出选择。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
代理(Proxy)与直连(Direct):用于明确的验证目的
代理(Proxy)将交由客户端处理的请求按代理姿态转发,适合首次检查已选服务器是否能完成目标访问。直连(Direct)则让请求直接连接目标,不经代理服务器;需要比较当前网络本身能否访问时,可以把它作为对照。Global Routing 不应被理解为某个应用专属的开关,它描述的是当前客户端处理请求的方式。
如果还没有确认规则是否正确,可以先用代理(Proxy)完成一次连接与访问验证。确认服务器可用后,再切换到配置(Config),检查预期分流是否成立。只有配置(Config)访问异常而代理(Proxy)正常时,优先检查当前配置、规则顺序和命中策略,而不是立刻删除服务器。更完整的规则解释见系统化使用手册。
03 / CONNECT
打开连接开关
确认服务器、姿态与系统权限,完成首次启动。
回到 Home,先查看 SERVER 分组,确认选中的是本次准备使用的条目;再看 Global Routing 是否保持第二步选择的姿态。截图顶部的 Not Connected 表示尚未连接。打开顶部连接开关,等待状态变化,操作期间先不要切换服务器或重复点击开关,以便观察一次完整的连接结果。
首次启动时,系统可能请求允许添加 VPN 配置。确认这是从 Shadowrocket 发起的操作后,按提示允许,并完成设备密码或生物识别认证。这个权限用于建立系统网络扩展连接,并不是订阅的登录过程,也不会替你补齐服务器信息。如果此前取消了授权,返回客户端重新发起连接,并按系统提示检查 VPN 配置是否已经添加。
如果设备上已有其他正在工作的 VPN 连接,先停止它,再重试当前流程,避免同时争用系统连接。受管理的工作设备还可能存在组织限制;遇到无法添加或启用 VPN 配置的提示,应检查设备管理要求,不要把所有权限问题都归结为服务器故障。
顶部显示已连接后,也不要仅凭状态就结束检查。连接状态说明系统中的连接已经启动,并不能证明每个目标网站、每条规则和所有网络条件都正常。保持当前服务器与姿态不变,进入下一步做一次实际访问测试。如果开关立即回到关闭状态,记下当时的提示文字,再按第五步从系统权限与服务器参数开始排查。
04 / VERIFY
验证连接是否生效
把测试结果、实际访问和规则命中放在一起看。
在 Home 运行 Connectivity Test,观察所选服务器是否有测试结果。测试反映的是当前测试方法和目标下的连通表现,不能直接等同于浏览器、视频或其他应用的实际体验。显示延迟数字不代表认证参数、目标网站访问和所有请求都正常;超时也不一定说明服务器完全不可用,应结合测试方法与网络环境判断。
随后打开浏览器,访问自己明确需要使用的目标网站,确认页面能完成加载,而不只是显示缓存中的标题。尽量选择可以重复操作的页面,并刷新一次。回到 Shadowrocket,结合 Data 中的流量变化或可用的连接记录,检查刚才的访问是否产生了新的请求;流量增长只能作为线索,仍要结合目标请求的策略判断。
使用配置(Config)时,要分别验证预期走 PROXY 的请求与预期走 DIRECT 的请求。若只有其中一类异常,检查相应规则的条件和顺序。域名解析产生的请求、页面中的图片与其他资源可能涉及不同域名,因此“主页面打开了”并不能证明页面内全部资源都用了同一策略。
需要对照网络环境时,先在 Wi-Fi 下记录结果,再切换到蜂窝网络重复相同访问。保持服务器、姿态与目标不变,一次只改变一个条件。测试完成后,把 Global Routing 恢复为日常需要的姿态。若只在代理(Proxy)下正常,就继续核对配置;若两种网络下都失败,则把检查重点转回服务器参数、服务状态和错误提示。
05 / DIAGNOSE
按失败阶段检查设置
停在出错的那一步,先缩小范围,再修改参数。
导入后没有服务器
先确认复制的是完整订阅地址,而不是服务商的账户网页。核对链接是否已过期、查询参数是否缺失,以及当前网络能否获取订阅内容。如果返回的是登录页面或错误信息,客户端就无法从中生成服务器条目。向已有服务商确认订阅状态与格式后,在原订阅上重试更新;不要连续建立多个相同订阅,否则后面难以分辨哪些条目属于哪次导入。
开关无法保持连接
先看系统是否完成 VPN 配置授权,再确认没有其他活动连接冲突。然后回到 Add Server 对照原始信息检查 Type、Host、Port 与认证字段;尤其留意端口遗漏、密码尾部空格和协议选错。需要 TLS 等参数的连接还应核对服务商要求的相关字段,不要通过随意关闭验证来试错。修改后保存,再回到 Home 重新选中该条目测试。
显示连接,但页面打不开
先区分“所有目标都打不开”与“只有某个网站异常”。保持服务器不变,比较代理(Proxy)与配置(Config)的访问结果。只有配置(Config)失败时,检查 Rule 的顺序、FINAL 的兜底策略以及当前实际使用的配置文件;两者都失败时,重新核对服务状态与协议参数,再考虑 DNS 或当前网络条件。不要在没有记录的情况下同时更换多项设置。
用 Settings 收集必要线索
进入 Settings,可以看到 Test Method、On Demand、Diagnostics 等项目。Test Method 会影响连通测试的判断方式,不应为了得到更小的数字而频繁切换。首次排查时可先停止 On Demand 的自动触发,手动完成一次连接与断开,排除自动重连对观察结果的干扰;确认基本流程正常后,再恢复自己的按需连接设置。
需要进一步定位时,在 Diagnostics 中查看可用的诊断信息,保留发生问题的时间、网络类型、Global Routing 姿态和错误文字。分享截图或日志之前,遮盖订阅地址、密码、认证字段与其他账户信息。只向相关支持方提供必要片段,不要公开完整配置。更多问题可查看FAQ 分类说明;参数、规则与日常维护的系统解释见新手到进阶官方手册。
完成排查后,再重复第四步的实际访问测试。恢复日常配置前,确认临时修改过的姿态、测试方式与 On Demand 设置是否仍符合需要。这样下次出现问题时,可以从一个明确、已验证过的状态开始,而不是重新猜测全部设置。
首次连接后的下一步
保留已验证的配置;按实际需要再学习规则、自动连接与维护。