官方手册 · 首次设置

Shadowrocket 使用说明

按“导入 → 选择姿态 → 连接 → 验证 → 排查”的顺序操作。先完成一次可重复的连接检查,再调整规则与日常设置。

本页适合跟着完成首次设置。界面中的 Home、Add Server、Subscribe 等名称保留英文,便于对照查找;不同系统语言下的位置和排列可能略有差异。需要了解完整设置项与维护方法时,转到新手到进阶,不必在首次连接前逐项调整。

步骤 01

添加服务器或导入订阅

先判断手中的是订阅地址、单条分享链接,还是需要手动填写的服务器信息,再选择对应入口。

已有订阅链接:使用 Subscribe

打开 Shadowrocket,进入 Home,点击右上角加号进入 Add Server。在类型选项中选择 Subscribe,再将从你的服务商处获取的完整订阅链接填入 URL。若需要填写备注,使用便于自己辨认的名称即可;备注只用于整理列表,不决定连接是否成功。

粘贴后先检查地址开头、结尾以及参数部分,避免混入空格、换行或中文标点。订阅地址一般是返回一组服务器条目的地址,并不是服务商网站的登录页。保存后等待订阅内容载入,再返回 Home 查看 SERVER 区域。已有订阅需要重新获取内容时,使用对应条目的更新操作;不要连续重复添加同一地址,否则后续难以辨认正在使用哪一组条目。

如果保存后只有订阅名称,尚未出现可选服务器,先检查更新是否成功,再进行下一步。订阅链接里可能包含身份凭据,不要把完整地址发到公开页面,也不要为了说明错误而公开二维码。需要记录问题时,仅保留报错文字与已遮盖敏感内容的字段说明。

已有服务器字段:在 Add Server 手动填写

仍从 Home 的加号进入 Add Server,按已有资料选择对应协议,例如 Shadowsocks、VMess、VLESS 或 Trojan。随后逐项填写地址、端口与该协议要求的认证信息。不同协议需要的字段并不相同,不要把某个协议的密码填入另一个协议的标识字段,也不要凭名称相似就更换协议类型。

如果资料还包含 TLS、SNI、传输方式或路径等内容,应保持与原始信息一致;留空与填写任意值不是同一种设置。无法确认的字段从你的服务商处获取,先核对再保存。已有单条分享链接时,可使用应用提供的链接导入或剪贴板识别入口;若出现读取剪贴板提示,只在确实需要导入时允许,并检查导入后的字段。

完成后返回 Home,在 SERVER 中选中准备使用的实际服务器条目。列表里出现名称只说明信息已保存,不代表服务器已经可用。此时先不要反复打开开关,下一步还需确定 Global Routing 使用哪种姿态。

步骤 02

选择 Global Routing 姿态

服务器条目决定“连接到哪里”,Global Routing 决定“连接按什么方式处理”。两者需要分别确认。

在 Home 点击 Global Routing,查看当前选项。本教程将三种姿态写作配置(Config)/代理(Proxy)/直连(Direct),实际界面请认准 Config、Proxy、Direct。选择后返回 Home,确认显示的姿态已经改变,不要仅凭刚才点过某个选项推断当前状态。

Global Routing 三种姿态的用途与检查位置
姿态如何处理连接首次设置时如何使用
配置(Config)根据当前配置中的规则决定连接使用的策略。用于日常规则分流;同时检查 Config 中当前选中的配置。
代理(Proxy)将可代理的连接交给当前选中的服务器处理。适合先检查所选服务器的基本可用性,再排查规则差异。
直连(Direct)直接访问目标,不经所选代理服务器转发。用于辨别基础网络与代理路径的差异,不作为代理已生效的判断。

首次设置时,如果尚不清楚配置内容,可以先用 Proxy 完成一次基本连接验证。验证成功后再切换到 Config,观察日常访问是否符合预期。Proxy 不应被理解为所有系统流量都会按完全相同的方式处理;系统行为、连接类型和应用本身的网络实现仍可能影响结果。

需要使用 Config 时,进入 Config 页面,确认选中的是准备使用的配置,而不是只下载了文件却没有选用。服务器订阅与规则配置不是同一份内容:更新订阅会更新服务器条目,并不等于已经换成某套规则。不要为了排查一个页面而同时替换订阅、配置和 DNS,否则很难判断是哪项改动起作用。

如果 Proxy 下可以访问,而 Config 下某个目标失败,优先检查规则匹配与策略去向。DOMAIN-SUFFIX、IP-CIDR 等关键字的含义见术语表;首次操作不必立即编辑它们。确定姿态并保留当前选择后,继续进行连接与系统授权。

步骤 03

打开连接开关与 VPN 授权

先选中服务器,再打开开关。首次出现的添加 VPN 配置提示属于系统授权流程。

从 Home 发起连接

返回 Home,核对 SERVER 中选中的服务器,以及 Global Routing 当前显示的姿态,然后打开顶部连接开关。未连接时可能看到 Not Connected。首次连接时,系统会询问是否允许添加 VPN 配置;确认是刚刚由 Shadowrocket 操作触发的提示后,选择允许,并根据系统要求完成设备密码或生物识别验证。

完成授权后返回 Shadowrocket,观察开关是否保持打开,以及连接状态是否发生变化。系统设置里出现对应 VPN 条目是正常结果,它表示应用建立系统网络连接所需的配置已保存,不等于服务器信息由系统自动补齐,也不代表远端服务器已经可用。

拒绝过授权或开关立即关闭

如果之前点过拒绝,返回 Home 再次尝试连接,按实际出现的系统提示重新授权;同时到系统设置中搜索 VPN,核对是否已有 Shadowrocket 对应条目。不要在尚未确认用途时批量删除其他 VPN 配置,尤其是设备管理或工作环境需要的条目。

若授权后开关仍立即关闭,先记下弹出的错误文字,再检查服务器是否已选中、必要字段是否完整,以及设备上是否有另一个正在使用的 VPN 连接。受管理设备可能限制添加或启用 VPN 配置,这种情况下应先确认设备策略,而不是不断重复导入相同订阅。

首次验证期间,可先保持 On Demand 原有设置,通过手动开关观察完整连接过程。如果关闭连接后又自动建立,检查 On Demand 是否启用以及是否存在触发条件。先理解自动连接来源,再决定是否调整,避免把自动重连误认为开关失效。

步骤 04

验证连接是否生效

分开看本机连接状态、Connectivity Test 与实际网页访问,避免用一个结果代替全部判断。

先在 Home 找到 Connectivity Test,对已导入的条目执行测试。测试结果反映所选测试方式和当时网络环境下的可达情况,并不是对所有网站的保证。某条目显示失败时,记录当前网络、所选服务器与测试方式;不要仅根据一次结果就删除整组订阅。

接着打开浏览器,访问一个自己有权访问、且平时能够辨认内容的 HTTPS 页面。必要时新开页面并刷新,避免将浏览器缓存误认为新请求成功。再检查实际需要使用的目标页面。普通页面可访问而特定目标失败,与所有页面都无法打开是两种情况,后续排查方向应不同。

如果当前是 Proxy,先确认基础访问能够重复成功,再切到 Config 对同一个目标复测。Config 下部分目标直连属于可能的正常规则结果,不是所有请求都必须使用代理。需要判断某个目标的实际去向时,结合应用提供的连接记录或日志,核对对应域名与策略;分享记录前遮盖服务器地址、账号和订阅参数等敏感信息。

也可以在网络条件不变时,短暂关闭连接,对同一页面进行对照,然后恢复连接再次测试。对照的目的在于缩小问题范围,并非依靠单个页面证明全部流量的去向。应用里已经建立的长连接可能继续沿用原来的路径,切换姿态后应重新发起请求,必要时重新打开目标应用。

当“选定服务器 → 打开连接 → 实际访问 → 关闭后再连接”可以重复完成,首次设置即可结束。记录可用服务器的备注与当前姿态,后续每次更新订阅或修改配置后,沿用这一组检查动作。Data 中的流量变化可以辅助确认有连接活动,但不能单独证明目标页面已成功加载。

步骤 05

常见失败点与检查顺序

先确定失败发生在哪一步。每次只改一项,并用同一目标复测,保留能够恢复的设置。

订阅保存了,但没有服务器条目

先关闭连接,确认设备当前可以正常访问基础网络,再检查订阅 URL 是否完整、有无多余空格,以及是否粘贴成了服务商的网页地址。订阅更新依赖地址本身可达、内容格式可识别以及访问权限仍有效。若提示认证失败或返回内容异常,从你的服务商处获取当前有效的信息,不要靠反复改写链接参数尝试恢复。

条目存在,但 Connectivity Test 失败

先检查选中的是否为实际服务器条目,再核对协议、地址、端口和认证字段。手动填写时尤其要检查 TLS、SNI、路径与传输方式是否与原始资料一致。已有多个条目时,可以在同一网络下选另一个已有条目复测;只有某一条失败与全部失败,分别指向条目信息和基础网络等不同方向。

开关打开了,但网页仍无法访问

确认当前不是 Direct,并检查所选服务器是否与刚才测试的条目一致。先用 Proxy 对同一个 HTTPS 目标进行检查:如果此时可用而 Config 不可用,再检查当前配置及规则;如果两种姿态都失败,回到服务器字段与网络环境检查。不要一开始就重置全部 Settings,重置会丢失有助于判断的上下文。

只有部分域名或切换网络后异常

部分页面失败时,记录具体域名、发生时间段、当前姿态及可复现动作,再检查规则去向与 DNS 相关设置。不要随意填入不清楚用途的 DNS 地址。Wi-Fi 与蜂窝网络切换后出现异常,可手动断开再连接并复测,同时检查当前网络是否需要先完成网页认证。若系统连接状态正常而目标应用异常,也应排除该应用自身的会话与缓存影响。

准备继续排查时保留哪些信息

保留报错原文、所用网络类型、选中的协议类型、Global Routing 姿态,以及问题出现在哪个操作之后。配置修改前先保留可恢复的副本;公开讨论时不要附完整订阅、密码或二维码。常见现象可继续查阅常见问题,涉及 DNS、规则匹配和配置维护的完整检查方法见新手到进阶。

首次使用到这里即可:确认信息已导入、姿态符合用途、授权完成且实际访问可重复验证。后续需要调整 On Demand、规则或配置时,一次处理一个主题,并在改动后重新执行验证步骤。