官方手册 · 首次配置
Shadowrocket 使用说明 从导入到连接验证
按添加信息、选择模式、连接、验证的顺序操作。首次配置先让一条已知可用的连接通过验证,再调整规则与自动连接设置。
STEP 01 / 准备连接信息
添加服务器或导入订阅
完成标志:Home 的 SERVER 分组出现可选择的服务器,而不只是保存了一条链接。
打开 Shadowrocket 后,先确认手里拿到的是什么:一条能返回多个服务器条目的订阅链接,还是一个服务器的完整参数。两者入口和用途不同。订阅用于成组获取并更新条目;手动添加则把指定服务器保存到本机。第一次操作只选其中一种即可,不必把同一份信息用所有入口重复导入。
有订阅链接:使用 Subscribe
从你的服务商处复制完整订阅链接,打开 Config,找到 Subscribe 入口,按提示粘贴链接、填写便于识别的名称并保存,再执行更新。入口位置可能随应用界面调整,以当前显示的 Subscribe 为准。链接中的查询参数同样属于地址的一部分,不要删掉问号后面的内容,也不要把说明页地址当成订阅地址。
等待导入结束后回到 Home,检查 SERVER 分组。如果只保存成功却没有出现服务器,先查看订阅更新结果,确认服务器确实返回了可识别的数据。订阅与配置文件不是同一种内容:订阅主要提供服务器条目,配置文件还可能带有规则和其他设置。不要为了导入订阅而直接替换现有配置。
https://example.com/sub?token=xxxx
以上仅为格式示例,不是可用订阅。真实链接通常包含个人凭据,不要贴到公开评论、截图或共享文档中。
有服务器参数:使用 Add Server
回到 Home,在 SERVER 分组点 Add Server。先选择与服务端一致的 Type,再填写 Host 和 Port;然后按该类型需要填写 Password、Method 或其他认证字段。截图展示的是一种字段组合,选择 VLESS、Trojan 等其他 Type 后,字段会不同,不能把截图中的字段机械套用到所有协议。
Host 一般填写服务端给出的域名或 IP,不要擅自加上网页地址的路径;Port 要与服务器监听端口一致。涉及 TLS、传输方式、路径或服务器名称的类型,还应逐项核对服务商提供的参数,不能只填地址和密码就判断配置完成。保存后返回 Home,选择刚添加的条目,留意当前选中标记。
如果已有个人二维码,可使用 Scan QR Code;Import from Cloud JSON 则用于对应格式的导入,不是任意网页链接的通用入口。导入后仍需检查 Type、Host 和 Port。保存服务器只表示信息已写入客户端,是否能连接还要经过后续验证。需要比较几种入口时,可继续阅读订阅与服务器导入的四种方式。
STEP 02 / 决定请求走向
选择 Global Routing 姿态
完成标志:能够区分当前服务器与当前路由模式,并确认正在使用的配置文件。
服务器添加完成后,返回 Home,点 Global Routing。这里决定请求如何被处理,和 SERVER 中“选哪一台服务器”是两项独立设置。只切换服务器而没有核对模式,可能让实际请求继续按原来的方式处理。首次使用重点理解配置(Config)/代理(Proxy)/直连(Direct)三种姿态;若界面还显示 Scene,先保留现状,等基本连接验证完成后再研究场景配置。
配置(Config):按当前文件分流
日常需要规则分流时选择 Config。客户端会根据当前启用配置中的规则判断请求该使用 PROXY、DIRECT 还是 REJECT。打开 Config,确认当前使用的文件,再进入 Rule 查看内容。截图中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是不同设置分段,首次连接不需要逐个修改,更不必为了完成本教程启用 HTTPS Decryption。
Rule 内的规则通常按从上到下的顺序检查,首条命中后执行对应策略,末尾的 FINAL 负责此前未命中的请求。下面片段只用于理解顺序,不要求直接替换你的配置。修改前先保留原文件,避免无法还原原有规则。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
代理(Proxy)与直连(Direct):用于对照
Proxy 将需要代理处理的请求交给所选服务器,可用于对照“服务器是否可用”和“规则是否导致请求走错方向”。它不等于所有应用、所有网络条件都一定可用,也不能替代正确的服务器参数。Direct 则不经代理服务器,用于直连访问或排除代理链路影响;选择 Direct 后,即使连接开关开启,也不能据此认为请求正在经过代理服务器。
如果已有可信配置,先用 Config 完成连接。若后续发现只有部分目标异常,再短暂切换 Proxy 进行同目标对照;测试结束恢复原模式。关于 DOMAIN-SUFFIX、FINAL 与策略的详细含义,查阅术语手册;关于规则顺序导致的异常,转到疑难手册继续检查。
STEP 03 / 建立系统连接
打开 Home 顶部连接开关
完成标志:系统授权已完成,返回 Home 后开关保持开启,连接状态不再停在 Not Connected。
现在回到 Home,再检查一次 SERVER 中选中的服务器与 Global Routing。确认这两项后,打开顶部 Not Connected 附近的连接开关。首次连接时,系统可能请求添加 VPN 配置;阅读提示并允许,按系统要求使用设备密码或生物识别完成确认。该授权用于建立系统网络通道,与订阅是否有效是两件不同的事。
授权结束后返回 Shadowrocket,观察开关和状态是否保持。若刚打开便自动关闭,先读清系统提示,不要立即重复导入订阅或连续新建多个服务器。设备上的其他 VPN 连接、受管理设备的限制、未完成的系统确认,都可能影响这一步。可先断开其他 VPN,再回到本应用重试;受组织管理的设备应按管理员要求处理,不要删除不明管理配置。
iPad 的布局可能因屏幕尺寸、分屏状态而与截图略有不同,但操作顺序相同:先选服务器、再核对 Global Routing、最后打开连接开关。找不到某个入口时,先回到 Home,必要时退出分屏再核对,不要把系统网络设置里的其他开关当作应用内的连接按钮。
连接状态出现后,先不要更改 On Demand 或同时调整多个选项。顶部开关开启只说明系统通道已建立,服务器仍可能认证失败,规则也可能把目标送往 Direct。保留当前状态,继续下一步的实际访问验证,才能确认完整链路是否可用。
STEP 04 / 检查实际结果
验证连接与规则是否生效
完成标志:实际目标访问正常,且请求采用的策略与你的预期一致。
保持连接开关开启,先运行 Home 中的 Connectivity Test,作为当前测试方式下的连通性参考。出现测试结果,不代表任意网站或任意协议都正常;显示超时,也应结合测试目标、测试方式和实际访问一起判断。不要只凭一次测试的数值决定大幅修改配置。
- 先确认基础网络。用浏览器访问一个平时可正常打开、自己有权访问的页面。若关闭连接后仍完全无法访问,先处理 Wi-Fi、蜂窝网络或网络登录页,而不是继续改服务器参数。
- 再测试实际目标。打开你预期由代理处理的目标,刷新一次,避免把浏览器缓存误认为新连接结果。若只是某个应用失败,再用浏览器访问同一服务的可访问页面做对照。
- 最后核对请求策略。在应用可用的请求记录或 Data 信息中定位刚才的目标,检查命中的规则及 PROXY、DIRECT、REJECT 结果。不同界面的记录字段可能不同,重点是“同一个目标是否走了预期路径”。
Config 下一个目标正常、另一个失败,通常需要进一步区分规则匹配、DNS 解析和目标服务本身的限制。可以暂时切到 Proxy,保持服务器与目标不变再测一次:若 Proxy 正常而 Config 失败,优先看规则;若两者都失败,优先检查服务器与目标链路。这只是定位方法,不是让 Proxy 成为所有故障的固定解决办法。
不要把网页显示的出口地址当作唯一证据。Config 模式下,不同目标可能采用不同策略,某个查询页面直连并不代表所有请求都直连。验证时记录目标、模式、所选服务器与结果即可;每轮只改变一个条件,结束后恢复计划使用的 Config 模式。
STEP 05 / 按失败位置回查
常见失败点与 Settings 检查
先确定故障发生在哪一步,再改对应设置;不要把所有选项同时重置。
订阅保存了,但没有服务器
回到订阅入口检查更新结果。确认粘贴的是完整订阅链接,没有多余空格、换行或遗漏参数,再检查当前基础网络能否访问该地址。链接失效、返回登录页面、返回格式不受支持,都可能导致列表未生成。此时可向自己的服务商确认链接状态;不要把整条含凭据的地址交给公开检测页面。详细操作见订阅更新说明。
开关能打开,但服务器超时
先核对选中的是否为刚添加的条目,再逐项检查 Type、Host、Port、认证字段与 TLS、传输参数,确认设备系统时间使用自动设置。打开 Settings 查看 Test Method:不同测试方式衡量的环节不同,改变方法后不能直接把数值与之前混为一谈。服务端不响应时,反复修改本地规则通常没有帮助。
部分网页失败,或连接自行恢复
部分目标异常时,沿用上一步的 Config 与 Proxy 对照,检查是否命中了更靠前的规则。若手动断开后连接又自动出现,查看 Settings 中的 On Demand,并检查是否设置了相应触发条件。首次上手宜先完成手动连接验证,再配置自动连接;需要改变自动连接行为时先记下原设置,避免测试后忘记恢复。
Settings 还包含 Proxy、TCP、UDP 等分组,它们并不是看到故障就必须修改的项目。某个应用只有实时语音或特定功能失败时,再根据实际使用的传输类型检查对应项目。不要为了让一个测试通过而随意改变所有设置,否则会失去可以比较的基准。
需要进一步排查时,保留哪些信息
在 Settings 的 Diagnostics 中查看可用诊断信息,结合实际失败时间和操作步骤定位。记录“导入是否成功、开关是否保持、Connectivity Test 结果、哪些目标失败、Config 与 Proxy 是否有差别”,通常比只说“无法使用”更有帮助。分享记录前遮住订阅地址、密码、个人服务器地址和其他认证内容。
本页到此完成首次配置流程。持续出现超时、DNS 异常、耗电变化或更新后问题时,继续阅读按症状组织的疑难手册;只是不清楚某个设置名时,先查术语手册,不必重新导入整份配置。