Shadowrocket 使用教程
导入已有配置,选择流量去向,再完成连接验证。
本页按 iPhone 与 iPad 上的实际操作顺序组织。先完成一条服务器的连接与验证,再处理更多规则或自动连接设置;暂时不需要一次理解所有选项。截图为 App Store 官方展示图,用于辨认界面区域,具体入口位置与可选字段以当前应用内显示为准。
操作路线:Home → Add Server / Subscribe → Global Routing → 连接开关 → Connectivity Test。若某一步的预期结果没有出现,先停留在该步核对,不必继续修改后面的设置。
Add Server 与 Subscribe:添加已有连接信息
打开 Shadowrocket,先进入 Home,找到下方的 SERVER 分组。服务器条目保存的是连接远端所需的信息;订阅则是用于取得和更新一组服务器信息的来源。两者最终都会影响 Home 中可选择的条目,但填写方式不同。先确认手中拿到的是单条服务器参数、单条分享信息,还是订阅链接,不要把订阅网址直接填入 Host。
手动填写 Add Server
在 Home 点按 Add Server,进入服务器编辑页。先选择 Type,再按对应协议填写字段;Type 改变后,页面需要的参数也可能改变。右侧官方截图展示的是包含 Host、Port、Password、Method 的一种表单,并不表示每种协议都使用同一组字段。应逐项对应你的服务器信息,而不是照着截图补齐所有空格。
Host 填服务器地址,Port 填连接端口。Password、Method 或其他认证字段必须与已有信息一致;需要 TLS、Server Name、传输方式或路径时,也应按原始参数填写。协议名称相近不代表参数可以互换,不能只凭名称猜选项。保存前检查复制时是否带入空格、换行或标点,保存后返回 Home,确认条目已经出现在 SERVER 分组。
如果拿到的是二维码,可以使用 Scan QR Code 读取已有连接信息,再检查识别出的 Type、Host 与 Port。Import from Cloud JSON 是另一种导入入口,只有在你已有适配该入口的 JSON 配置时使用;普通订阅链接不应因为同样是网址就填入这里。导入成功只是完成了参数录入,还需要后面的选中与连接步骤。
通过 Subscribe 导入订阅
已有订阅链接时,进入 Config 查看 Subscribe 入口,并按页面提示添加订阅来源;当前界面若将订阅类型放在 Add Server 的 Type 中,则在该入口选择 Subscribe 后填写。把完整链接粘贴到订阅地址栏,确认保存,再执行更新。这里导入的是你的已有订阅,不是从本站获取服务器。遇到菜单位置差异时,应以界面中的 Subscribe 字样和地址字段用途为准。
等待更新结束后返回 Home,展开对应分组,检查是否出现服务器条目。只有分组名称、没有服务器,不能视作完整导入;应检查链接是否复制完整、访问凭据是否仍然有效,以及更新时是否显示错误。订阅内容可能包含多条记录,第一次验证只需选其中一条参数明确的记录,不要同时编辑整个分组。
订阅更新通常用于同步远端提供的记录,不等同于备份本地设置。手动改过的名称或参数可能在后续更新时发生变化,因此先保留原始信息,避免反复删除再导入。完成本步的标准是:Home 中至少有一条可选择、信息来源明确的服务器。关于订阅、服务器与规则文件的区别,可查看概念速查;确认列表正常后,再进入下一步选择流量处理方式。
Global Routing:配置(Config)、代理(Proxy)、直连(Direct)
服务器已经录入后,回到 Home,点按 Global Routing,查看当前选中的姿态。这里决定流量如何被处理,不负责补全服务器密码,也不会修复失效的订阅。先区分“有可用服务器”和“流量交给哪种策略”两个层次,后面的验证才有明确依据。
- 配置(Config):按当前启用的规则文件判断。不同请求可以分别交给 PROXY、DIRECT 或其他已定义策略,适合使用已有规则配置的情况。
- 代理(Proxy):把由客户端接管的流量统一交给代理策略处理,可用于临时核对代理路径。它仍然依赖所选服务器及相应参数正常。
- 直连(Direct):把由客户端接管的流量统一按直连处理,可用于检查当前网络本身的访问情况;选中服务器并不意味着此时流量会经过该服务器。
如果你已有明确用途的规则文件,选择配置(Config)前,先进入 Config 确认该文件已经启用。打开文件可以查看 General、Rule、Hosts 等分段;官方截图展示的是配置编辑页,而不是 Global Routing 的姿态选择页。文件中出现 General 或 Rule 只说明存在相应设置区域,实际流量去向还取决于具体内容和顺序。
服务器订阅与规则文件用途不同:前者主要提供连接记录,后者决定请求如何匹配和分配。导入订阅后,不应仅凭列表中已有服务器就认定规则已经准备完成。若暂时没有可确认的规则文件,可以先用代理(Proxy)进行一次受控的连接验证,确认服务器可用后,再切回配置(Config)检查分流。验证期间应留意当前姿态,避免把临时测试设置当成最终设置。
阅读规则时,先看匹配条件,再看策略。例如 DOMAIN-SUFFIX,example.com,PROXY 表示按域名后缀匹配后交给 PROXY;这里的 example.com 只是说明语法的示例域名,不是连接服务。FINAL,DIRECT 表示前面的规则没有匹配时交给 DIRECT,通常应位于规则末尾。不要只看到 PROXY 就认为整份文件中的请求都经过代理。
首次操作不需要同时编辑 DNS、Hosts、URL Rewrite 与 HTTPS Decryption。先保持已有可信配置的内容,确认当前启用文件与预期一致,再保存并返回 Home。协议字段与传输参数的深入解释在协议参考中,本页只处理完成首次连接所需的选择。完成本步后,应能清楚说明当前使用哪种姿态,以及接下来的测试请求预期走代理还是直连。
Home:选择服务器并打开连接开关
完成导入和 Global Routing 设置后,回到 Home,在 SERVER 分组中点选本次要使用的服务器。注意区分“打开条目编辑页”和“选中条目”:本步需要看到服务器对应的选中圆点或选中标记,而不是仅进入参数详情。分组里存在某条记录,不能代替实际选中它;有多组订阅时尤其要确认当前选择没有落在另一组的旧记录上。
接着再看一眼 Global Routing 是否保持为上一步选择的姿态。确认无误后,打开 Home 顶部连接开关。首次建立连接时,系统可能提示允许 Shadowrocket 添加 VPN 配置;这是 Apple 系统为网络接管配置提供的授权流程。核对弹窗中应用名称后按系统提示完成授权,设备可能要求进行本机身份验证。未完成授权时,应先处理该提示,再回到应用查看状态。
这里的 VPN 配置授权与订阅身份认证不同:系统授权允许客户端建立网络通道,服务器凭据决定远端是否接受连接。允许了系统弹窗,不代表服务器参数已经正确;服务器密码正确,也不能代替设备上的授权。若此前取消过弹窗,可以再次尝试打开开关,按照当前系统出现的提示完成操作,不要为了绕过问题连续添加重复记录。
授权后回到 Home,观察顶部是否由 Not Connected 转为连接状态,并确认开关保持开启。系统的 VPN 标识可作为辅助信息,但不是访问成功的最终证明。如果开关随即关闭、状态持续变化,或者出现明确错误,应记下错误内容并前往本页的失败点排查,暂时不要同时修改多个高级选项。
连接过程中还应留意设备是否已有其他活动的 VPN 配置,或已有自动连接设置正在改变连接状态。首次验证时,尽量让操作条件保持简单,先使用手动开关建立一条稳定连接,再考虑 On Demand。不要仅因开关成功开启就继续导入更多订阅;先完成下一步的 Connectivity Test 和实际访问,确认这条记录确实可用。
iPad 上的页面排布可能因屏幕宽度不同而变化,但操作关系相同:在 Home 选中服务器,确认 Global Routing,再打开开关。判断本步是否完成,应以选中状态、授权结果和连接状态三项为依据,而不是以截图位置是否完全一致为依据。
Connectivity Test:确认连接与分流是否生效
连接状态稳定后,在 Home 点按 Connectivity Test,等待测试返回结果。测试可以帮助判断当前条件下的可达情况,但它只覆盖测试所使用的目标和方法。单项测试通过,不等于所有网页和应用都能正常访问;测试失败,也需要结合所选服务器、测试方式和当前网络继续判断,不能直接归结为客户端本身的问题。
下一步打开浏览器,访问一个你平时能正常打开的页面,确认设备具有基础网络访问能力,再测试一个按当前配置预期经过代理的目标。如果使用配置(Config),还应分别检查预期直连与预期代理的访问结果;如果使用代理(Proxy),本次主要验证代理路径,不应用这次结果判断规则是否按预期命中。直连(Direct)下访问成功,同样不能证明代理服务器可用。
为让对照有效,每次测试尽量保持同一网络、同一服务器和同一目标,只改变一个条件。切换服务器或 Global Routing 后,可以重新发起访问,必要时关闭旧页面再打开,减少已有连接和缓存对判断的干扰。不要把 Wi-Fi 与蜂窝网络、服务器、DNS 和规则同时改动,否则即使恢复访问,也难以知道究竟是哪一项起了作用。
需要确认分流时,结合客户端提供的连接记录或相关日志,查看请求命中的规则与策略。先核对请求对应的域名,再核对是否交给预期的 PROXY 或 DIRECT。仅看页面打开速度、设备上出现 VPN 标识,或看到某个测试数值,都不足以单独确定流量去向。日志中的域名与浏览历史可能涉及个人信息,分享前应做必要遮盖。
如果基础访问正常、只有特定目标失败,先检查该目标相关的规则与 DNS;如果所有访问都失败,优先回查服务器和当前网络。把问题分到具体层级,比反复切换整个配置更容易找到原因。更多常见现象可查阅问答,不必为排查单个目标而重做全部导入步骤。
连接失败:按网络、参数、模式和规则排查
遇到“开关已开却无法访问”时,先保留当前配置和错误提示,不要立即删除全部服务器。把现象写清楚:是开关无法保持开启、Connectivity Test 失败,还是仅某些页面打不开;问题发生在 Wi-Fi、蜂窝网络,还是两者都发生。这个记录决定从哪一层开始检查,也能减少重复操作。
先确认网络与服务器信息
暂时关闭连接开关,确认当前网络能够完成正常的基础访问。如果设备本身尚未联网,应先处理网络登录、信号或路由连接,再回到客户端。基础网络恢复后,重新选中一条已有服务器,核对 Type、Host、Port 和认证信息。使用 TLS 或特定传输方式的记录,还要检查相应字段是否完整,不能只验证地址和端口。
使用订阅时,查看最近一次更新是否实际成功、服务器是否仍在当前分组中。如果订阅链接已失效或权限发生变化,应从你的服务商处确认已有订阅的状态。客户端购买记录不能说明远端服务仍有效。更新失败时先保留旧记录并检查错误,不要重复建立多个相同来源的分组,使当前选中项变得难以辨认。
再用 Global Routing 缩小范围
如果配置(Config)下失败,可临时切换到代理(Proxy),保持同一服务器和同一目标复测。如果代理(Proxy)下能够访问,而配置(Config)下失败,应优先检查启用的配置文件、规则顺序及相关策略;如果两种姿态都失败,则继续检查服务器参数和远端可达性。这个对照只是定位手段,不能单凭一次结果就认定某一层完全正常。
如果直连(Direct)下可以访问某目标、代理(Proxy)下不行,说明两条路径的结果不同,应回查代理路径,而不是把直连成功当作服务器测试成功。完成对照后,记得恢复原本计划使用的姿态。已修改过的规则也应逐项记录,避免临时排错设置留在日常配置中。
最后检查 DNS、设置与诊断记录
域名访问失败可能与解析有关,但 DNS 不是所有连接问题的共同答案。先核对启用配置中的 DNS 设置是否来自你预期使用的配置,是否刚被修改过,再结合错误记录判断。不要为了快速尝试连续填入多个不明来源的地址,也不要用关闭证书校验的方式处理认证或参数错误。
进入 Settings 可以找到 Test Method、On Demand、Diagnostics 以及 Proxy、TCP、UDP 等相关设置。查看 Diagnostics 中当前可用的诊断项目或记录,把错误与实际操作时间对应起来;若调整了 Test Method,要注意新旧结果可能不再具有相同含义。首次手动连接尚未稳定前,先不要同时配置 On Demand,以免自动连接条件干扰观察。
若问题只在某种网络或某类请求中出现,记录对应条件,再查阅协议参考理解当前协议的传输与参数要求;遇到界面词不清楚时使用概念速查。本页不要求逐项修改所有高级开关,而是建立一个可重复的排查顺序:基础网络 → 服务器与订阅 → Global Routing → DNS 与规则 → 诊断记录。
需要向你的服务商说明情况时,只提供必要的错误文字、使用的协议类型和复测条件。发送截图前移除密码、完整订阅地址、认证标识及其他个人凭据。恢复可用后,再执行一次 Connectivity Test 与实际访问验证,并记下最终有效的服务器和姿态;确认无误后,首次设置流程才算完成。