Shadowrocket 官方手册

Shadowrocket 使用教程

添加服务器或订阅,选择分流模式,再完成首次连接与验证。

开始前:本教程以 iPhone / iPad 界面为例。请先安装 Shadowrocket:iPhone / iPad 从 App Store 获取,美区 $2.99 一次性付费,系统要求以 App Store 页面标注为准;Mac / Windows / 安卓 / Linux 版免费,从本站下载页获取。若电脑或安卓系统拦截安装,请先核对文件来源,再按对应系统的安装说明处理。

请准备已有的订阅链接或服务器信息,二者有其一即可。本站不提供节点或订阅。客户端一次性买断 ≠ 线路套餐。

添加服务器或导入订阅

打开 Shadowrocket,先到 Home 查看 SERVER。如果这里已经有这次要用的条目,选中它即可,不必再导入一遍。列表为空时,按手里的资料选一种方式:单台服务器的连接参数用 Add Server 手动填写;用于获取一组条目的订阅链接选 Subscribe。两种方式不需要都做。

已有单台服务器的信息

点 Add Server,先在 Type 选资料中注明的协议,再填 Host 和 Port。以截图中的表单为例,Password 和 Method 分别对应资料里的密码和加密方法。不同协议显示的字段不完全相同,切换 Type 后以当前表单为准。不要把包含协议前缀和路径的整段链接填进 Host,也不要凭字段名称猜密码或加密方法。资料缺项时,先回到原始资料核对。

如果已有单台服务器的二维码,也可在 Add Server 使用 Scan QR Code。识别后先核对 Type 和地址再保存。不要把含连接凭据的二维码发到公共群组,也不要用来历不明的二维码覆盖当前能用的条目。

已有订阅链接

在 Home 点添加按钮,在添加页的 Type 中选择 Subscribe,把完整订阅链接贴入地址输入框,保留原有路径和参数,检查首尾没有多余空格,再保存。回到 Home,等订阅读取完毕,在 SERVER 找到可选条目。Import from Cloud JSON 对应另一种输入形式,不是普通订阅链接的粘贴入口。

保存成功后,点选一个准备测试的服务器。列表里有名字只表示已经拿到条目,并不表示这些条目都可用。如果没有出现可选条目,先不要打开连接开关,直接看第五步核对导入结果。

Add Server 界面,显示 Type、Host、Port、Password 和 Method 字段
Add Server:先选 Type,再填写当前协议所需字段。

选择 Global Routing 姿态

服务器选定后,仍在 Home,点开 Global Routing。这里决定流量按什么方式处理,不用于更换服务器。首次设置如果已有准备好的规则文件,先选配置(Config),然后确认生效的是预期文件。若只是做一次对照测试,先记下原来的姿态,测试结束再切回。

  • 配置(Config):按当前配置的规则选择策略。选中了服务器,并不意味着每个请求都会经它转发;规则仍可能让请求直连或拒绝。
  • 代理(Proxy):让进入处理范围的流量采用代理路径。需要区分服务器问题和配置规则问题时,可短暂切到这一姿态对照。
  • 直连(Direct):不经当前选中的代理服务器转发。适合检查当前网络能否直接访问某个本来就应该可访问的站点;它与关闭连接开关不是同一项操作。

选配置(Config) 后,进入底部 Config 检查配置列表。对照预期的文件名,确认哪一份处于使用状态。打开文件进入截图所示的编辑页,可以看到 General、Rule、Hosts 等分段。首次连通验证不要求新增规则,也不需要改动 HTTPS Decryption。如果暂时不能确定哪份配置适合当前网络,先保留原文件,不要同时改规则、名称解析与服务器。

同一个服务器在代理(Proxy) 下能访问、在配置(Config) 下却不能访问时,优先查看目标的规则匹配。例如,目标可能先命中较宽的规则,而不是落到最后的 FINAL。如果只需要完成第一次连接,先记录现象;匹配顺序和写法见配置大全。

Config 文件编辑界面,显示 General、Rule、Hosts、URL Rewrite 和 HTTPS Decryption 分段
Config:核对当前文件后,再查看 Rule 分段。

打开 Home 顶部开关连接

返回 Home,看一眼 Global Routing 当前显示的姿态,再确认 SERVER 中选中的条目是刚才准备测试的服务器。截图顶部的 Not Connected 表示尚未连接。点这一行的开关,等待系统或应用反馈,不要连续反复切换。

首次连接时,系统可能要求添加 VPN 配置。确认提示由刚刚打开的 Shadowrocket 发起,再按系统提示允许;如要求验证设备身份,完成验证后返回 Home 查看开关。如果之前点了取消,回到应用重新触发连接并处理提示。如果设备由单位或学校管理且系统限制修改 VPN 配置,先询问设备管理员,不要移除管理设置。

开关打开后若立即回落,先记下屏幕提示,再查看是否有未完成的系统授权,或者是否有其他 VPN 配置正在运行。已有连接如承担工作访问,先确认用途,不要为了测试随意删除。开关保持开启后也不要马上判定一切正常:下一步要分别检查服务器响应和实际网页访问。

Home 界面,顶部显示 Not Connected 开关,下方有 Global Routing、Connectivity Test 和 SERVER
Home:核对服务器与姿态,再打开顶部开关。

验证服务器响应与实际访问

保持当前网络不变,先确认 Home 顶部开关仍然开启,再点 Connectivity Test,观察选中条目的结果。测试有响应,只说明这次测试按当前方法得到了结果,不能据此判断任意网站都可打开,也不能把延迟读数当成下载速度。如果测试超时,先记下当前服务器和测试方式,不要在短时间内连续更换多项设置。

接着打开浏览器,访问一个平时可用、无需登录的网页,并主动刷新一次,避免把缓存当成新请求。在配置(Config) 下,如果你同时维护直连和代理规则,可以各用一个已知应走对应策略的站点对照。两页都能打开,说明这次访问可用;单凭页面加载成功,不能证明请求经过了指定路径。如果需要确认路径,再结合 Diagnostics 中当前版本提供的记录,核对请求和策略。

若只有一个目标失败,保留同一服务器,先比较另一个已知可用的页面。若两者都失败,可以在允许的情况下关闭 Shadowrocket,用原先确定可直连的网页检查基础网络。基础网络也打不开时,先处理 Wi-Fi 登录或移动数据连通问题。验证通过后,把为测试临时切换的姿态恢复到日常使用的选项,再复测一次。

按失败出现的位置排查

导入后没有可选条目

先检查是否用 Subscribe 保存了订阅链接,而不是把它填入普通服务器的 Host。回到原始资料核对链接是否完整、是否仍有效,确认当前网络能够读取订阅后再重试。对于手动条目,先核对 Type、端口和该协议必填字段。打不开订阅不等于单台服务器不可用,这是两个不同的检查点。

开关打不开,或关闭后又连上

打不开时先回到系统授权这一步,不必急着重装。若是手动关闭后又出现连接,打开 Settings 查看 On Demand,确认是否有触发条件生效。若设备策略允许,可记下原设置,暂时停用相关条件后复测手动开关,再恢复需要的设置。

开关已打开,但网页加载失败

先确认从 SERVER 选对条目,再比较 Connectivity Test 与网页结果。需要对比测试结果时,在 Settings 核对 Test Method,不同方法下的读数不宜直接比较。若代理(Proxy) 对同一目标可用,而配置(Config) 不可用,应优先核对当前文件和规则顺序,检查是否命中 REJECT 或走了非预期的 DIRECT。若记录显示域名解析失败,再检查配置中的 DNS 设置,不要把解析失败直接归因于服务器离线。

排查时一次只改变一个条件,并用同一个网页重复验证。需要记录问题时,记下网络类型、连接姿态、失败步骤和提示内容即可;对外分享 Diagnostics 记录前,去掉订阅链接、密码、服务器地址等敏感信息。更多故障入口见疑难解答;不确定某个选项或规则关键字的含义,可查名词解释。

如果只在某一个无线网络下失败,先断开应用连接,再在浏览器打开刚才测试的网页,记录不经过代理时能否加载。若系统提示需要登录无线网络,先完成网络本身的登录,再回到应用选择原来的服务器和配置,重新连接并访问同一网页。若断开后也无法打开网页,可在设备允许的情况下换到另一个已知可用的网络复测,暂时不要改动规则文件。若换网后恢复,再回到原网络复测一次,确认失败是否稳定出现在同一网络。这样可以先缩小排查范围,避免同时更换服务器和配置后无法判断哪项变化起了作用。

Settings 界面,显示 Test Method、On Demand、Diagnostics、Proxy、TCP 和 UDP 等选项
Settings:检查测试方式、按需连接和诊断入口。