Shadowrocket 使用教程:
导入、分流与连接验证
按一次完整连接的顺序操作:先准备可用的服务器条目,再选 Global Routing,最后用实际访问结果验证。首次操作先完成一条连接,不同时调整多套配置。
STEP 01 / INPUT
Add Server:添加服务器或导入订阅
先确认手里的资料属于哪一种:一组服务器地址、端口和认证参数,还是一条用于获取多个条目的订阅链接。两者的导入方式不同,不能把订阅地址当成 Host,也不能把普通网页地址当成订阅。资料不完整时,应先向原服务商核对,而不是靠反复更换 Type 尝试。
手动填写一条服务器
- 打开 Shadowrocket,在 Home 的 SERVER 区域找到 Add Server,进入添加页面。先点 Type,选择资料标明的协议,例如 Shadowsocks 或 Trojan;选择后,页面会显示对应的字段。
- 按资料填写 Host 和 Port,再填写 Password 以及该协议要求的其他参数。Host 一般是域名或 IP 地址,端口填写数字,不把整条网页链接连同路径一起填入 Host。
- 如果所选协议显示 Method,必须与服务器端一致。涉及 TLS、SNI 或其他传输参数时,同样逐项对照原始资料;不要为了让测试通过而随意关闭证书校验。
- 核对后使用页面的保存操作,返回 Home。确认 SERVER 下出现刚添加的条目,并点选它作为接下来连接时使用的服务器。
右侧官方截图展示的是包含 Type、Host、Port、Password、Method 的 Add Server 页面,并不意味着所有协议都填写同样的字段。判断依据是当前选中的 Type 和你的服务器资料。名称备注可帮助辨认用途,但备注写什么不会修正地址、端口或认证错误。
用 Subscribe 导入已有订阅
如果已有完整订阅链接,在 Add Server 的 Type 中选择 Subscribe,粘贴到对应的 URL 字段,再保存并返回 Home。复制时保留整个地址,包括问号后的参数;检查首尾是否多出空格、换行或中文标点。订阅地址可能带有个人访问凭据,不应粘贴到公开讨论区,也不应作为截图内容发布。
保存后等待内容获取完成,再查看 Home 中对应的分组和条目。只有分组名称、没有服务器条目时,先检查订阅更新是否成功;只保存了地址不等于已经获得可连接的服务器。已有订阅需要更新时,使用对应分组的更新操作即可,避免为同一地址反复新增分组。多订阅的整理方法见FAQ 的订阅与节点导入说明。
Add Server 底部还可见 Scan QR Code 与 Import from Cloud JSON。只有在你已有相应二维码或符合要求的资料时才使用它们;扫描前确认来源,导入后仍要检查协议与地址。完成本步的标准是:Home 中存在一条参数完整、能够被选中的服务器,而不仅仅是出现了一个名称。
STEP 02 / ROUTING
Global Routing:选择配置、代理或直连
服务器条目准备好后,回到 Home,打开 Global Routing。这里决定连接建立后采用哪一种路由姿态。选中服务器只回答“需要代理时使用哪个条目”,Global Routing 则回答“哪些连接按什么方式发送”;两项需要分别确认。
- 配置(Config):按当前配置文件中的规则决定路径,可以将不同请求分别交给 PROXY、DIRECT 或其他已定义策略。日常需要规则分流时使用这一姿态,但前提是已经确认配置内容。
- 代理(Proxy):让受客户端处理的连接采用代理路径,适合在排错时对照服务器是否可用。它不能保证每个应用、每种协议或每个目标都必然可达。
- 直连(Direct):让受客户端处理的连接采用直连路径,可用于对照本地网络访问情况。看到开关开启,并不表示当前请求一定经过所选服务器。
使用配置(Config)前检查 Config
如果选择配置(Config),再进入底部 Config,确认当前实际使用的是哪份配置。打开对应文件检查 Rule 部分;官方截图中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是配置编辑分段,Add Rule 是规则添加入口。快速上手阶段先理解现有规则,不需要逐个修改所有分段,更不需要为普通连接额外启用 HTTPS Decryption。
下面两行是阅读规则语法的示例,不是要求直接覆盖现有配置。第一行让指定域名后缀匹配代理路径,第二行在前面规则都未命中时使用代理路径。规则从上向下匹配,顺序会影响结果;单独一行的含义需要放回完整配置中判断。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY
没有可信配置或暂时不理解现有规则时,可先用代理(Proxy)对一条已有服务器做连接验证,再回到配置(Config)检查分流。不要把“切到代理后能访问”直接当成全部修复完成:这更可能说明服务器可用,而原来的规则、策略选择或 DNS 设置仍需检查。配置字段的深入问题请转到规则分流与故障排查 FAQ,本页先完成一次可重复的连接流程。
STEP 03 / CONNECT
Home:打开开关并确认连接状态
完成路由选择后返回 Home,再核对一次 SERVER 中选中的条目。订阅更新、删除条目或切换分组后,实际选中项可能与之前不同;不要只凭列表最上方的名称判断。如果准备切换到另一条服务器,先记下原来的条目,方便后续进行相同条件下的对照。
- 找到 Home 顶部连接开关。尚未连接时可见 Not Connected;点开开关,开始建立连接。
- 首次使用时,系统可能要求允许添加 VPN 配置。阅读系统说明,确认操作来自刚打开的 Shadowrocket,再允许添加,并按提示使用设备密码或设备验证完成授权。
- 回到 Home 等待状态变化。确认开关保持开启,而不是刚打开就自动关闭。若仍显示 Not Connected,先停止访问测试,转到本页的失败点排查定位原因。
允许添加 VPN 配置,是授权客户端通过系统提供的网络能力处理连接,不代表订阅内的服务器已经通过可用性验证。开关能够保持开启,也不代表所有目标都可访问。因此,本步只确认系统连接状态正常;是否真正按预期工作,还要继续做下一步的网页访问与路径检查。
如果设备上已有其他 VPN 连接或由单位管理的网络配置,先确认当前使用的连接及设备管理要求。不要同时启动多个相互竞争的连接来测试,也不要删除不清楚用途的管理配置。出现系统授权提示被取消的情况,可返回 Home 再试一次,观察提示是否重新出现;持续失败时再检查系统中的 VPN 配置状态。
初次验证期间,先保持 On Demand 的状态不变,并记录它原先是否启用。尚未理解自动连接条件就修改 On Demand,可能让开关在切换网络后重新启动,给排错增加干扰。测试完成、确认手动连接行为稳定以后,再决定是否需要按需连接。
STEP 04 / CHECK
Connectivity Test:区分测试结果与实际访问
开关保持开启后,先在 Home 使用 Connectivity Test 检查已有条目,再打开浏览器访问一个平时确认可用的页面。前者提供测试条件下的连通性线索,后者检查实际请求是否能完成。两种结果需要一起看:延迟数字较低,不代表网页解析、TLS 协商、数据传输或其他应用访问一定正常。
- 记录基线。记下当前本地网络、所选服务器和 Global Routing 姿态,使用同一页面完成一次访问。不要一边切换 Wi-Fi 与蜂窝网络,一边更换服务器,否则无法确定哪项变化影响了结果。
- 检查实际路径。如果需要确认分流,在客户端可用的连接记录或 Data 相关视图中查找对应请求,检查命中规则及实际路径。只看到流量累计增加,不能证明某个指定请求走了代理。
- 只改变一个条件。若配置(Config)下失败,可保持同一服务器,临时换成代理(Proxy)再访问一次;若需要了解本地网络本身的表现,再用直连(Direct)对照。每次都记下结果,测试完恢复计划使用的姿态。
若代理(Proxy)能够完成访问、配置(Config)却失败,优先检查当前配置中的匹配规则、实际策略和 DNS 相关设置;若两者都失败,再检查服务器参数与本地网络。若只有一个应用失败、浏览器正常,问题可能与该应用的连接方式、缓存或协议需求有关,先重新打开应用并重复同一操作,不要立即清空整个配置。
验证完成的标准不是某个图标出现,也不是所有测试条目都有延迟,而是目标任务能够稳定重复完成,并且所用路径符合预期。可以再切回平时使用的网络做一次同样检查;如果结果变化,记录“哪个网络下、哪种姿态、哪个条目失败”,后续排错会比单纯描述“连不上”更准确。
STEP 05 / DIAGNOSE
Settings:按失败阶段检查,而不是全部重置
排错从最早失败的环节开始:没有成功获取条目,就先解决导入;有条目但无法建立连接,再核对服务器;连接稳定但访问不符合预期,才检查规则。把问题拆成这些阶段,可以避免在订阅尚未获取成功时反复调整 DNS,或者在系统授权被取消时反复更换密码。
导入后没有条目,或订阅更新失败
先重新核对完整订阅地址,确认它仍然有效、没有遗漏参数,并检查当前网络是否可以访问订阅地址所在的服务器。订阅获取与节点连接是两个过程:已有条目可能仍能连接,但订阅服务器暂时不可访问;反过来,能更新出条目也不表示每条服务器都可用。不要连续新增相同订阅,保留原分组,按更新时的实际错误继续检查。
有条目,但测试失败或开关不能保持
手动条目重点核对 Type、Host、Port、Password,以及协议特有的 Method、TLS 或传输设置。复制参数时注意大小写和首尾空格。系统时间明显不正确时,也可能影响证书相关连接。若开关不能保持,先检查系统 VPN 授权及其他活动连接;若开关稳定而服务器测试失败,才重点检查服务器资料和可达性。
测试有结果,但网页或应用仍打不开
进入 Settings 查看 Test Method,确认当前测试方式再解释 Connectivity Test 的结果;不同测试方式对应的检查范围并不相同。然后按上一步的方法对照配置(Config)和代理(Proxy)。如果只有规则姿态失败,检查命中规则;如果只有特定应用失败,记录该应用的具体操作与失败表现,不把单个应用的问题直接归因于整条连接。
切换网络后自动连接,或需要进一步诊断
在 Settings 中检查 On Demand 的既有设置,确认是否有符合当前网络条件的自动连接行为。需要手动对照时,可以记录原设置后临时停用,测试完再恢复。Settings 中还可见 Diagnostics、Proxy、TCP、UDP 等项目;不要因为名称与网络有关就全部修改,只有在错误信息或资料要求明确指向某一项时才调整。
需要借助 Diagnostics 或连接记录进一步定位时,先复现一次问题,再保留与该次操作有关的内容。分享前隐藏完整订阅地址、认证参数、服务器密码以及可识别个人的信息。有效的问题描述应包含失败阶段、Global Routing 姿态、网络类型与已做过的单项对照;参数本身不必公开。
仍然无法定位时,前往FAQ查对应类别。若问题发生在 App Store 获取、商店地区、换机或已购恢复阶段,请阅读安装指南;这些属于获取环节,不需要通过修改 Add Server 或 Config 处理。排错结束后,删除临时测试条目、恢复预期的 Global Routing,并确认正常网络下仍能重复完成一次访问。