官方手册 · 首次配置

Shadowrocket
导入、连接与使用验证

按顺序完成五步:把已有资料放进客户端,确定请求如何处理,再开启连接并检查结果。先跑通一次完整流程,再调整规则和自动连接条件。

截图来自 App Store 官方界面。按字段名称查找对应入口;界面位置可能随应用更新略有调整。

步骤 01 · 准备可选的服务器条目

Add Server 与订阅导入

订阅链接、单条分享链接和手动填写是不同的资料形式。先认清手里有什么,再选择相应入口。

从 Home 进入 Add Server

打开 Shadowrocket 后停留在 Home。首次使用时,SERVER 分组可能还没有可用条目,这并不表示安装失败。点击 Add Server 进入添加页,先看 Type,再决定要填写什么。不要看到截图中的字段就逐项照抄:Type 改变后,下面显示的字段也会变化,应该以你已有资料中的协议类型为准。

如果持有的是单台服务器资料,在 Type 中选择对应协议,例如 Shadowsocks、VMess、VLESS 或 Trojan,再填写地址、端口与认证信息。官方截图展示的表单包含 Type、Host、Port、Password、Method;其中 Method 适用于对应协议,其他协议可能使用不同的认证字段。Host 只填资料要求的主机名或地址,Port 填端口数字,不要自行给地址增加网页路径,也不要把多项内容挤在同一个输入框里。

已有订阅链接时选择 Subscribe

如果拿到的是用于更新服务器列表的订阅链接,在 Add Server 的 Type 中选择 Subscribe,把完整链接填入 URL,并为它填写便于辨认的备注,再保存。订阅地址经常带有较长的查询参数,复制时应从开头一直保留到结尾,避免带入聊天文本、前后空格或换行。订阅链接本身可能包含访问凭据,应当像密码一样保存,不要贴到公开评论或截图中。

保存后返回 Home,等待订阅内容载入,再检查 SERVER 中是否出现了可选择的服务器。保存一个订阅来源与成功取回其中的条目是两件事;如果只看到了来源名称,却没有可用条目,先检查链接能否正常更新、资料是否仍有效。这里导入的是服务器资料,不等于已经选定了一份规则配置文件;Config 页中的配置订阅与服务器订阅也不要混用。

二维码和剪贴板资料如何处理

已有服务器二维码时,可在添加页使用 Scan QR Code,允许相机访问后扫描,再核对识别出的协议和地址。已有单条分享链接时,可使用应用提供的剪贴板导入入口;若弹出系统粘贴授权,确认内容来源后继续。Import from Cloud JSON 面向相应的 JSON 资料,不是所有订阅链接的通用入口。导入完成后先检查字段,而不是立即开启连接。

本步的完成标志是:Home 中已经有一个来源清楚、能够选中的服务器条目。不要为了尝试不同入口而重复导入同一份资料,否则后面容易选中旧条目。需要分清 Subscribe、配置文件和分享链接时,可查阅概念速查,再继续下一步选择路由方式。

Shadowrocket Add Server 添加页,显示 Type、Host、Port、Password、Method,以及 Scan QR Code 和 Import from Cloud JSON
Add Server:先确认 Type,再填写该协议所需字段;截图中的表单不是所有协议的统一字段清单。
步骤 02 · 确定请求处理方式

Global Routing 三种模式

服务器决定可连接的目标,Global Routing 决定请求按什么方式处理。两者需要分别核对。

回到 Home,点击 Global Routing 查看当前选项。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。Config 按当前配置中的规则处理请求;Proxy 将进入客户端处理范围的请求按代理方式处理;Direct 按直连方式处理。模式名称不是连接质量等级,也不是越靠前越适合所有网络,应按这次要验证的用途选择。

日常需要规则分流时,选择配置(Config),并继续到 Config 页确认正在使用的配置文件。服务器导入成功,不代表规则已经符合你的需求。打开准备使用的文件查看内容,编辑页会按 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段组织。第一次使用先确认 Rule 和最终策略,不需要为了完成连接而开启或修改每一个分段。

先理解规则,再改动配置

规则通常按顺序匹配,较早命中的规则会影响后续处理。下面是用于理解语法的手册示例,不是建议直接覆盖现有配置的完整文件:DOMAIN-SUFFIX 匹配域名后缀,DIRECT 表示直连策略,PROXY 表示示例中的代理策略,FINAL 用于处理没有被前面规则匹配的请求。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

在编辑页使用 Add Rule 前,先保存配置副本,并确认规则中的策略名称能够在当前配置里对应到实际策略。不要只因为示例出现 PROXY,就认定所有配置都采用相同的策略组织方式。改动后保存,并回到 Config 列表确认目标文件处于使用状态;只是打开编辑器查看文件,不应当被当作已经切换了当前配置。

如果暂时无法判断是服务器问题还是规则问题,可以在后面的验证阶段短暂用代理(Proxy)做对照,记录结果后恢复原来的配置(Config)。直连(Direct)可以用于比较本地网络访问,但不能用来证明服务器连接成功。详细的规则关键字解释在Global Routing 速查;协议参数与取舍请看协议详解。本步只要确定当前模式和当前配置,不必一次调整所有规则。

Shadowrocket Config 配置文件编辑页,包含 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config:查看配置内容时重点核对 Rule。Global Routing 的模式选择位于 Home,不在此编辑页中。
步骤 03 · 建立客户端连接

选择 SERVER,打开连接开关

先明确选中哪个条目,再开启顶部开关。系统授权和服务器认证是不同的环节。

回到 Home,在 SERVER 分组选择刚才核对过的服务器。如果列表里有多个相似名称,打开详情确认地址或备注,不要仅凭排列顺序判断。接着再看一眼 Global Routing:使用规则时应是 Config,临时对照测试时才按计划改为 Proxy 或 Direct。这样后面出现不同结果时,才能知道当时使用的是哪一组条件。

确认后打开 Home 顶部连接开关。首次连接可能出现系统添加 VPN 配置的授权提示;确认提示由 Shadowrocket 发起后允许,并按系统要求完成设备验证。这个授权是让应用建立系统网络连接配置,不是在购买服务器,也不是把资料提交给本站。若取消了授权,应重新触发连接并完成系统提示,而不是重复导入订阅。

等待页面连接状态变化。截图中的 Not Connected 表示截图拍摄时尚未连接,并不是需要输入的设置值。开关开启后,还要留意是否保持开启、是否很快退回原状。系统显示 VPN 状态只能说明相关连接配置处于活动状态,不能单独证明服务器认证、目标网页访问和规则匹配都已成功,下一步仍然需要实际验证。

如果开关立即关闭,先记下屏幕上的错误提示,并检查是否存在其他正在运行的 VPN 连接配置。不要在多个网络配置之间反复切换而不记录结果;必要时先停止另一条连接,再重试 Shadowrocket。若开关保持开启但网页打不开,也先保留现场,直接进入下一步的检查,不要同时更换服务器、配置文件和测试方式。

Shadowrocket Home 页,顶部显示 Not Connected 开关,下方为 Global Routing、Connectivity Test 和 SERVER 分组中的 Add Server
Home:连接前确认 SERVER 选择与 Global Routing;连接后继续使用 Connectivity Test 和实际访问验证。
步骤 04 · 区分状态与实际访问

Connectivity Test 与生效验证

按“测试结果 → 实际访问 → 规则路径”的顺序检查,避免把单次测试当作全部结论。

保持连接开启,在 Home 点击 Connectivity Test,等待结果完成。测试可以帮助发现当前测试方式下的连通情况,但它只覆盖对应的测试目标与条件。测试有响应,不代表所有网页都可访问;显示超时,也不必立即认定所有应用都无法工作。先记录结果,再到实际要使用的浏览器或应用中验证。

选择一个用途明确、当前可正常提供服务的页面,重新发起一次访问,而不是只看已经加载好的旧页面。必要时刷新页面或打开新的标签页,避免缓存内容造成误判。然后检查你真正要使用的应用能否完成一次完整操作,例如加载新内容;仅看到应用首页并不足以判断新请求的处理结果。

使用 Config 时,要分别检查两类请求

如果配置中同时存在代理和直连策略,应各选择一个预期用途明确的目标进行验证。能打开某个直连页面,不能说明代理服务器可用;代理页面可访问,也不代表局域网等直连需求已经配置妥当。结合当前规则检查目标是否被预期规则匹配,必要时查看应用中可用的连接记录或诊断信息。不要只根据网页打开快慢推断路由路径。

出现差异时,先固定服务器与测试目标,仅切换一次 Global Routing 做对照。例如 Config 下失败、Proxy 下成功,优先检查规则、策略选择以及相关解析设置;两种模式均失败,则继续核对服务器字段、资料状态与当前网络。测试结束后恢复计划使用的模式,并再次验证,避免临时排查设置被误当成日常配置。

本步完成后,应能说清三件事:连接开关是否保持开启、指定目标是否能完成新请求、Config 中的预期分流是否成立。若只满足其中一项,继续按下一步定位问题。测试方式与常见状态的含义可在疑难解答中继续查找,不需要为了得到一个更好看的测试数字反复修改设置。

步骤 05 · 一次只改一个条件

常见失败点与 Settings 检查

先找到失败发生在哪一层,再查看相关设置。不要把所有开关同时切换。

导入失败:先检查资料类型与完整性

订阅取回失败时,首先核对链接是否复制完整、是否仍在有效期内,以及服务商是否要求更新地址。网页地址、单条分享链接、服务器订阅和配置文件地址不一定能互换。手动添加后无法使用,则回到 Add Server 核对 Type、Host、Port 和认证字段,尤其注意密码中的大小写、不可见空格及协议要求的附加参数。字段不明时,向原资料提供方核实,避免凭名称猜填。

连接失败:区分本地网络与远端资料

先暂停连接,确认设备的基础网络能正常访问;如果当前 Wi-Fi 需要网页认证,应先完成认证。再恢复 Shadowrocket,使用同一个条目测试。如果只有某个网络环境失败,可在具备条件时切换 Wi-Fi 与移动网络做一次对照,并记录差异。如果所有环境都失败,重点确认服务器资料及服务状态,不要反复删除应用,因为重装并不能修正错误的端口或失效的认证信息。

测试和自动连接:查看 Test Method、On Demand

打开 Settings,找到 Test Method,核对当前测试方式是否适合要检查的问题。不同方式的目标与条件不同,结果不能简单横向比较。Settings 中的 On Demand 用于按条件触发连接,不是补齐缺失服务器资料的功能;如果手动关闭后又自动连接,检查已有 On Demand 条件。首次配置建议先完成手动连接验证,再单独设置自动连接条件,详细含义见On Demand 速查。

Diagnostics 可作为进一步定位问题的入口。收集信息时保留错误类型、发生步骤、当前模式和网络环境即可;向他人展示截图或记录前,先检查是否含有订阅地址、密码或认证信息。Settings 中还能看到 Proxy、TCP、UDP 等项目,它们不是出现问题就必须全部修改的选项。遇到特定协议参数问题,应转到协议详解查对应字段,而不是把其他协议的设置照搬过来。

如果仍未解决,按“导入是否成功、开关能否保持、Connectivity Test 结果、实际访问现象、Config 与 Proxy 对照结果”的顺序整理记录,再到疑难解答查相近情形。保留原配置副本,每次仅改一个条件,并在验证后决定保留还是恢复。这样的排查过程能避免问题越改越多,也方便以后更新资料时复用同一套检查顺序。

Shadowrocket Settings 页,列出 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:测试方式、自动连接与诊断分别处理不同问题;先确定失败环节,再进入对应设置。