OFFICIAL MANUAL / GETTING STARTED
Shadowrocket 使用说明
按添加、选模式、连接、验证、排错的顺序操作。本教程以 iPhone / iPad 界面为例,先完成一次可复查的连接,再调整规则与 Settings。
截图用于辨认界面与字段,不代表需要逐项照抄。实际字段随所选 Type 和应用界面有所变化,所有连接参数以你已有的服务器资料为依据。
STEP 01 / ADD SERVER
添加服务器或导入已有订阅
先辨认拿到的是订阅链接、单条服务器链接,还是需要逐项填写的服务器参数。
手动填写:Home → Add Server
打开 Shadowrocket,在 Home 页下方的 SERVER 分组找到 Add Server。进入后先点 Type,选择服务商资料中写明的协议,再填写其余字段。Type 决定后续表单的内容,因此不要先填完密码再随意更换协议,也不要仅凭端口号推测协议。
以截图展示的字段为例,Host 填服务器域名或 IP 地址,Port 填服务器端口,Password 填对应密码,Method 按提供的加密方式选择。Host 不是网页地址栏,不要把带路径的订阅链接塞入其中。其他 Type 可能显示不同的认证或传输字段,应逐项核对,不能把一套协议的认证信息搬到另一套协议中使用。
填写结束后保存,返回 Home,确认 SERVER 下出现刚添加的条目。此时条目存在只说明资料已保存,并不说明服务器可用。先检查显示的名称和地址是否与预期一致,稍后再通过 Connectivity Test 和实际访问验证;如果输入时多出空格或换行,应先回到编辑页修正。
批量导入:Subscribe
如果已有的是订阅链接,进入 Config 页查找 Subscribe 入口,按界面提示粘贴完整链接并保存或更新。订阅链接用于获取一组服务器信息,单条服务器链接则只描述一个连接,两者用途不同。导入后回到 Home 查看服务器列表,确认条目已出现,再选择本次准备使用的服务器。
订阅地址常带有身份参数,应完整复制,但不要在公开截图或求助内容中展示。导入失败时,先确认剪贴板里只有链接本身,没有前后说明、引号或换行;再检查服务商是否要求先在其账户页面启用订阅。更新不会自动修复账户状态或改变服务商端的服务器参数。
已有二维码时,可在 Add Server 页使用 Scan QR Code,授权相机后扫描自己已有的资料。Import from Cloud JSON 面向相应的 JSON 数据来源,并不是通用订阅输入框。不要把任意网页地址反复尝试到不同入口;拿不准格式时,先核对资料说明,再参考订阅导入的四个入口。
完成这一段后,Home 应当已有可选择的服务器。下一步先确定流量如何处理,不必立即修改 DNS 或其他高级设置;添加成功与选对 Global Routing 是两件不同的事。
STEP 02 / GLOBAL ROUTING
选择 Global Routing 姿态
服务器决定连接使用哪份资料,Global Routing 决定请求按什么方式处理。
回到 Home,点 Global Routing,按当前目的选择配置(Config)、代理(Proxy)或直连(Direct)。这三种姿态不是连接质量的等级,也不代表不同协议。首次使用时先确认选项,再打开连接;否则即使服务器填写正确,也可能因为当前姿态与预期不同而误判结果。
日常分流:配置(Config)
配置(Config)按当前启用配置中的规则处理请求。需要代理的目标应命中相应策略,需要本地直接访问的目标则可命中 DIRECT。进入 Config,确认实际选中了哪份配置;若打开配置编辑页,会看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。这里展示的是配置文件内容,不是服务器订阅列表。
本次只需确认配置已启用,并理解 Rule 负责规则匹配。规则通常按从上到下的顺序判断,先命中先执行,FINAL 负责此前均未命中的请求。不要为了完成首次连接就同时开启 URL Rewrite 或 HTTPS Decryption,也不要把 Add Rule 当成添加服务器入口。有关关键字含义,参阅术语表,具体设置再查选项手册。
临时比较:代理(Proxy)与直连(Direct)
代理(Proxy)适合临时检查代理路径是否能完成访问,但不应理解为每个应用、每种系统流量都会被相同方式处理。直连(Direct)可用来检查本地网络访问情况,也不能据此验证代理服务器是否正常。两种姿态主要用于明确当前测试路径,不建议在排错时连续切换后忘记恢复。
例如某个目标在代理(Proxy)下能访问,而在配置(Config)下失败,应优先看该目标命中的规则与策略,而不是立刻重建服务器。比较结束后恢复配置(Config),再次确认使用的是预期配置。接下来回到 Home,保留刚选好的服务器和姿态,准备打开顶部连接开关。
STEP 03 / CONNECT
打开连接并确认 VPN 权限
先选服务器,再开顶部开关;系统权限通过后,还要检查应用中的实际状态。
在 Home 的 SERVER 分组点选准备使用的服务器,检查选中标记是否落在正确条目上。存在多个订阅分组时,要特别留意同名条目来自哪个分组。随后确认 Global Routing 仍是刚才选择的姿态,再打开顶部位于 Not Connected 区域的连接开关。
首次连接时,iPhone / iPad 可能显示添加 VPN 配置的系统提示。确认这是刚才在 Shadowrocket 中主动发起的操作后,点允许,并按系统要求完成设备验证。这个步骤是让系统建立应用使用的 VPN 配置,不会替你填写服务器,也不代表服务商资料已经验证成功。
完成授权后返回 Home,等待状态变化。如果开关立即退回关闭,不要快速反复点击。先看是否仍有系统提示等待处理,再检查系统设置中的 VPN 配置状态。若之前误点拒绝,可以返回应用重新发起连接;若系统配置被删除,也需要重新完成授权。更详细的提示含义见VPN 配置提示说明。
如果设备上另有正在工作的 VPN 连接,应先确认当前由哪一项连接接管网络,避免把其他连接状态当成 Shadowrocket 的结果。受管理设备还可能有组织下发的限制,应遵循设备管理要求,不要为了连接而删除不明用途的管理配置。
顶部显示连接状态变化后,先保持当前设置不动。系统状态栏中的 VPN 标识只说明隧道状态,不能单独证明目标网页访问成功。下一步需要把服务器测试、实际请求和规则命中结果放在一起检查。
STEP 04 / CONNECTIVITY TEST
验证连接是否真正生效
测试结果、目标访问与规则记录分别回答不同问题,需要分开判断。
先测试服务器,再访问实际目标
在 Home 使用 Connectivity Test,观察当前服务器是否能完成所选测试。测试超时可作为进一步排查的线索,但测试成功也不等于所有目标都能访问:测试方法、测试目标和真实业务请求可能不同。不要仅按一个测试数字判断服务商状态,也不要在尚未确认测试方式时比较不同条目的结果。
保持连接,打开浏览器访问一个你平时能够确认内容是否正常的页面,再访问本次需要使用的目标。尽量发起新请求,而不是只看已经加载好的页面或缓存内容。如果浏览器仍显示旧结果,可重新载入页面;必要时关闭该页面后再打开。不要同时改模式、换服务器和切换 Wi-Fi,否则很难知道哪一项改变了结果。
在配置(Config)下核对命中策略
回到 Shadowrocket,查看 Data 或当前界面可用的连接记录,找到刚发起的目标请求,核对目标域名、命中规则及最终策略。预期使用代理却命中 DIRECT 时,优先检查配置与规则顺序;预期直连却走代理时,也应从目标匹配条件入手,而不是把所有规则全部删除。
可以做一次受控比较:记录当前姿态和服务器,只临时更换 Global Routing,再重新请求同一目标。如果差异稳定复现,就有了定位方向;测试后恢复原来的配置(Config)。某个网页显示的出口地址只能反映该次请求的路径,不能证明设备上全部流量都走同一策略。
这一阶段的完成标准是:连接能保持、目标能正常打开、记录中的处理策略符合预期。三项都确认后再考虑自动连接或更细的规则。若只有其中一项异常,沿用当前现场进入下一步,不必重新安装应用或清空全部资料。
STEP 05 / SETTINGS & DIAGNOSTICS
按失败位置逐项排查
先查输入与基础网络,再查权限、DNS 和规则;不要把所有 Settings 同时改动。
导入失败或测试超时
导入时没有产生条目,先回到第一步检查链接类型、完整性与更新结果。更新成功但服务器测试超时,则先断开连接检查本地网络是否正常,再核对当前选中的服务器。订阅中出现条目,只代表获得了资料,不代表该条目对应的服务当前一定可用。
逐项检查 Type、Host、Port、Password、Method,以及该协议需要的其他认证和传输参数。注意大小写、前后空格和复制遗漏;系统时间也应保持正确,以免影响需要时间校验的连接。仍有问题时,应向你的服务商确认现有资料和服务状态。完整顺序可参考节点超时与连接失败排查。
测试正常,但网页打不开
先确认失败的是全部网页还是某一个目标。若只有部分目标失败,在 Data 或连接记录里查看其域名和命中策略;如果能建立连接但出现解析失败,再检查 DNS 相关设置。不要因为服务器测试正常就排除 DNS,也不要把任意 DNS 地址逐个替换作为固定解决方法。
进入 Settings,可看到 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 等设置分组。Test Method 会影响测试方式,Diagnostics 用于收集排查线索;它们不是替代服务器参数的开关。DNS 的具体位置和字段以当前界面为准,首次排查应记录原值,只针对已观察到的问题调整。详见DNS 与网页加载失败说明。
连接后又断开,或关闭后再次连接
如果开关打开后立即关闭,优先检查第三步的 VPN 权限、系统提示与当前连接记录。如果手动关闭后又自动连接,检查是否配置了 On Demand。排错期间可先记录其原有条件,暂时停用自动触发,再手动复现问题;确认原因后再决定是否恢复,避免自动连接掩盖测试过程。
Today Widget 用于快捷操作或查看相关状态,不是首次连接的必要条件。Proxy、TCP、UDP 等分组涉及更细的连接行为,本教程不建议预先修改。需要理解字段含义、默认行为与取值依据时,继续阅读Settings 选项手册,不要照搬与当前协议无关的设置组合。
需要保存诊断信息时,只保留能够说明问题的部分,遮住订阅地址、密码和其他认证数据。描述问题应包含失败发生在哪一步、是否所有目标受影响、切换网络后是否复现,以及最近只改动过哪一项设置。这样的记录比重复导入、重复开关更便于定位。