Shadowrocket 官方手册
Shadowrocket 使用教程
已有订阅导入 → Global Routing → 首次连接 → 生效检查。先完成一条可用连接,再调整规则与自动连接条件。
Add Server:添加服务器与订阅
打开 Shadowrocket,先停留在 Home。下方的 SERVER 用于显示服务器与分组;首次使用时,这里可能还没有条目。点击 Add Server 进入添加页。接下来只选一种与你现有资料对应的方式:一整条订阅链接用 Subscribe;单台服务器的地址、端口与密码用手动填写;已有二维码则使用扫码入口。不要把同一份信息反复按不同方式导入,以免出现难以区分的重复项。
已有订阅链接:选择 Subscribe
在 Add Server 中打开 Type,选择 Subscribe,再把完整订阅链接填入该类型的链接输入项。粘贴后先检查开头、末尾是否多了空格或换行,尤其不要遗漏问号后面的参数。订阅链接和普通网页地址并不等价:能在浏览器打开一张介绍页面,不代表该地址可以用于导入。应使用你已有服务所提供的订阅地址,不要从网页标题或分享说明里自行拼接。
保存后返回 Home,等待列表读取完成;如果出现订阅分组,展开确认里面确实有服务器名称。只有一个订阅名称、下面没有服务器,并不算导入完成。先尝试对该订阅执行更新,再检查网络与地址是否有效。更新会读取远端内容,可能替换该订阅下的服务器字段;需要保留的手动修改应先记录,长期整理方法见节点管理手册。
已有单台服务器:逐项核对字段
如果拿到的是单台服务器参数,先在 Type 选择相应协议,再依次填写 Host、Port 与该协议要求的认证信息。Host 一般填写主机名或 IP 地址,不要把网页路径一起填进去;Port 填写对应端口。Password 保留原来的大小写及符号;只有所选协议需要 Method 时,才按原资料选择,不要凭名称相似替换。不同 Type 的字段会变化,截图展示的字段不能作为所有协议的固定清单。
如已有二维码,可点击 Scan QR Code,按系统提示给予相机权限后扫描,再检查解析出的协议与字段。Import from Cloud JSON 是另一种指定格式的导入入口,不用于随意粘贴普通订阅链接。完成保存后,回到 SERVER 选中目标服务器;先确认名称和关键字段正确,再进入下一步选择流量处理方式。
Global Routing:选择三种姿态
服务器已经在列表中出现后,回到 Home 点击 Global Routing。这里决定流量总体按什么方式处理,不负责补全服务器参数,也不会修复失效订阅。首次使用最容易混淆的是:选中某台服务器、选择路由姿态、打开连接开关,是三个独立操作。列表里有服务器,并不意味着当前流量已经经过它。
- 配置(Config):按当前启用的配置文件匹配规则。不同目标可能分别使用 PROXY、DIRECT 或 REJECT,适合需要按规则分流的情况。
- 代理(Proxy):以代理方式处理流量,适合临时检查选中服务器是否具备基本连接能力。它不是替代所有规则检查的永久排错开关。
- 直连(Direct):使用本机网络直接连接目标。适合确认直连基线;选择它时,不应把能打开网页理解为代理服务器已经可用。
准备按规则使用时,选择配置(Config),再进入 Config 页面核对当前启用的文件。Global Routing 里的 Config 是一种路由姿态,底部 Config 页面则用于管理配置文件,两者名称相同但作用不同。截图中的 General、Rule、Hosts 等是文件中的不同设置分段;不要只看到文件存在,就默认其中的规则适合当前需求。
初次连接不必立刻编辑规则。如果只是想验证服务器是否能连接,可暂时选择代理(Proxy),完成第四步的基本检查后再恢复配置(Config)。如果 Proxy 可用而 Config 下某个目标不可用,优先检查该目标的规则去向,而不是重新添加同一台服务器。修改前记住原来的姿态与配置文件,方便回退。
Add Rule 用于添加规则,不是添加服务器。像 DOMAIN-SUFFIX,example.com,PROXY 这样的条目按域名后缀选择策略,DIRECT 则表示直接连接。此处只需理解规则会改变目标去向,不要为了照着截图操作而添加示例规则。规则顺序、订阅与配置的区别可继续查看常见问题,先保持当前设置完成连接。
Home:打开开关与系统授权
回到 Home,在 SERVER 中确认已选中准备使用的服务器,再核对上方 Global Routing 是否保持刚才的选择。若列表中有多个近似名称,先用备注或详细参数分辨,不要一边切换服务器一边改配置。确认后打开页面顶部的连接开关;未连接时可看到 Not Connected 状态提示。
第一次发起连接时,系统可能要求允许添加 VPN 配置。阅读弹窗中的应用名称与权限说明,确认操作由 Shadowrocket 发起后选择允许,并按设备提示完成密码或生物识别验证。授权过程中可能暂时离开应用,完成后返回 Home 检查状态。若刚才选择了取消,应重新打开连接开关发起请求,而不是反复删除服务器列表。
连接建立后,顶部状态会相应变化;系统也可能在状态区域或控制中心显示 VPN 标识,具体位置取决于设备与系统布局。这个标识说明系统连接配置处于启用状态,不能单独证明每台服务器、每个域名都能访问。此时先不要开启更多自动化选项,直接进入下一步做实际检查。
如果开关立即退回,先记录发生在授权前还是授权后。授权前通常应先核对系统权限流程;授权后则继续检查服务器、配置与基础网络。设备若有其他正在运行的 VPN 连接,应先结束原连接再测试,避免把连接被替换误判为导入失败。由组织管理的设备还可能限制 VPN 配置,遇到明确的管理提示时应按设备管理要求处理。
Connectivity Test:验证是否生效
连接开关保持打开后,在 Home 使用 Connectivity Test 检查服务器的测试结果。测试需要时间,先等待本轮结束再操作。看到结果后,应把它理解为某种测试方法下的连通性反馈,而不是带宽、稳定性或所有目标访问能力的保证。个别服务器没有响应,也不代表订阅内所有条目都不可用。
接着打开浏览器,访问你实际需要使用、并且可以确认地址正确的目标。可重新载入页面或使用新的浏览窗口,减少已有缓存对观察的影响。先验证一个目标,再验证另一个不同目标;如果只有某个应用异常,应优先比较该应用与浏览器的表现,不要立即认定整个连接失效。
在配置(Config)下,部分目标本来就会走 DIRECT,所以“能打开网页”不足以确认该请求使用了代理。需要结合当前配置的规则判断去向;若应用内的连接记录可供查看,可按目标主机名核对匹配结果。记录里出现了请求,也不等于远端已经完整返回页面,仍需与实际访问结果对应。
如果需要建立对照,可记下原姿态,临时切换代理(Proxy),访问同一个目标,然后恢复配置(Config)。两种姿态表现不同,通常应沿着规则去向继续检查;两者都失败,则先检查选中服务器和网络。每次对照保持相同目标、相同网络与相同服务器,避免同时改变太多条件而失去判断依据。
Settings:按顺序排查失败点
未能完成前面的检查时,先保留当前配置与现象,再按下面顺序定位。不要同时更换订阅、服务器、DNS 和规则;多项设置一起改变,即使恢复连接,也难以知道真正原因。记录“哪一步失败、使用什么网络、哪种姿态、哪个目标”通常比连续重装更有帮助。
列表为空或订阅更新失败
先关闭连接,确认设备当前网络可以正常使用,再检查订阅链接是否完整、是否仍在有效期内。普通分享说明、网页地址和 Subscribe 所需地址可能不是同一种内容。若订阅能更新但没有服务器,检查是否存在分组收起或筛选状态;仍为空时,应向你已有服务的维护方确认返回内容。不要通过重复添加来覆盖错误,先保留原条目及必要的错误信息。
服务器存在,但测试失败
打开该服务器详情,按原资料逐项比较 Type、Host、Port 与认证字段。协议不同,所需字段也不同,不能仅凭服务器名称判断参数相同。确认后可选另一台你已有的服务器做对照,再尝试切换 Wi-Fi 与蜂窝网络;如使用蜂窝网络,应留意自身流量用量。如果只有当前网络失败,排查重点应转向网络环境,而不是反复修改密码。
在 Settings 查看 Test Method。不同测试方法检查的环节不同,改变方法后出现不同结果并不矛盾。保留实际访问验证,不要只追求某个测试项目显示数值。有关测试超时与实际可访问之间的区别,见常见问题中的连接排查说明。
连接成功,但部分目标失败
先确认当前并非直连(Direct),再比较代理(Proxy)与配置(Config)下同一目标的表现。若只在 Config 下失败,回到 Config 检查当前启用文件与规则顺序,确认没有把需要代理的目标交给 DIRECT 或 REJECT。若表现为域名无法解析,再检查 DNS 相关设置;不要直接导入一整份不理解的配置替换原文件。详细的列表整理与配置备份流程放在节点管理手册,本页先完成最小范围的定位。
手动连接可用,自动连接异常
On Demand 会依据设置条件触发连接。首次上手先维持手动连接,等基本访问稳定后再配置自动条件;若出现刚断开又连接、切换网络后状态变化,检查是否已经启用了 On Demand。需要排错时记录原条件,再暂时停用并对照,避免把自动触发误认为顶部开关失效。
Diagnostics 可用于进一步查看诊断信息。对外描述问题前,先去除订阅地址、密码和其他认证内容,只保留必要的错误文本、网络类型与操作顺序。排查结束后恢复临时切换的模式和测试设置;如果连接已经可用,不必继续改动 Settings 中的 Proxy、TCP、UDP 等项目。