Shadowrocket 使用教程
先导入已有配置,再选择路由、打开连接,最后用真实访问验证结果。本页按一次首次配置的顺序展开,适用于 iPhone 与 iPad;先完成一条连接,再整理更多服务器。
1. Add Server / Subscribe:导入已有配置
先辨认手中的内容,再选择入口。以 https:// 开头、用于获取一组服务器的地址通常是订阅链接;以 ss://、vmess://、vless:// 或 trojan:// 等开头的内容通常是单条分享链接。如果得到的是地址、端口、密码及协议参数等分开的字段,则应手动添加。仅凭链接前缀不能判断内容是否有效,还需要与原始配置说明核对。
使用 Subscribe 导入订阅
打开 Shadowrocket,进入 Home,点按右上角的添加入口,进入 Add Server。点按 Type,将类型选为 Subscribe,然后把自己的完整订阅链接填入 URL;如有备注项,可写一个便于辨认的名称。确认后保存并返回 Home,等待订阅内容获取完成。不同显示布局可能使入口位置略有变化,应以 Type、Subscribe 和 URL 等界面词定位。
粘贴时不要只截取域名。链接路径及问号后面的参数可能都用于识别订阅,遗漏一段就可能无法更新。也不要把网页标题、说明文字或链接两端的引号一起填入。下面只是一段不可用于连接的格式示例,不需要复制到应用中:
https://example.com/sub?token=xxxx
返回 Home 后,检查订阅分组内是否出现服务器条目。保存了订阅地址与成功取得服务器列表不是同一个结果:如果只看到分组名称、没有可选服务器,应先解决获取失败,而不是继续打开连接。首次导入可以先保留原来的分组和名称,便于后续把条目与原始信息对照;等连接验证完成后,再调整排序或整理名称。
使用 Add Server 手动填写
如果已有完整服务器信息,在 Add Server 中先选择与信息一致的 Type,再填写服务器地址、端口和认证字段。Shadowsocks、VMess、VLESS、Trojan 等协议需要的字段不同,不能把一种协议的密码或标识随意放进另一种类型。地址栏通常只填写主机名或 IP 地址,端口填写在对应端口项,不要把整条分享链接拆得不完整后混入地址栏。
继续对照已有信息检查加密方式、TLS、Server Name、传输方式及相关路径;只填写当前协议实际需要的项目。尤其要区分用于连接的服务器地址和 TLS 校验所使用的名称,两者可能不同,但不能自行猜测。某个必需字段不明确时,回到原始配置信息核对,避免通过反复试填改变多个条件。保存后返回 Home,确认刚添加的条目存在。
已有二维码时,可使用 Scan QR Code 读取;已有单条分享链接时,可按应用出现的剪贴板导入提示操作,并允许必要的相机或粘贴访问。导入后仍要进入条目检查协议与关键字段,扫码或粘贴只是输入方式,并不验证远端服务一定可用。多订阅整理、分享链接字段及备份方法见订阅与节点管理手册。
本步完成标志:Home 中出现预期服务器,点按其中一条后能够辨认当前选择。订阅分组内有多个条目时,先选定一条用于测试;不要把分组名称误认为已选中的具体服务器。接下来保持这一选择不变,设置 Global Routing。
2. Global Routing:选择连接姿态
在 Home 找到并打开 Global Routing。这里决定请求采用什么路由方式,不是修改服务器密码的位置,也不等同于更换订阅。首次操作应明确区分三种姿态:配置(Config)、代理(Proxy)、直连(Direct)。选定后返回 Home,检查 Global Routing 当前显示的值,再继续连接。
| 姿态 | 处理方式 | 入门使用场景 |
|---|---|---|
| 配置(Config) | 依据当前配置中的规则与策略处理请求。 | 已有明确的规则配置,需要按目标进行分流。 |
| 代理(Proxy) | 将通常的代理流量交给所选服务器处理;仍受系统和应用处理范围限制。 | 首次验证服务器,或与 Config 做对照测试。 |
| 直连(Direct) | 采用直连方式,不将目标请求交给所选代理服务器。 | 检查基础网络,或确认直连访问表现。 |
如果目标是先判断新导入的服务器能否工作,可以先选择代理(Proxy),减少规则条件对排查的干扰。这只是验证方式,不代表所有使用场景都应长期保持该姿态。若你已有明确的分流需求,应在连接验证通过后切回配置(Config),并确认 Config 页面选中了预期配置。
Home 中导入的服务器列表与 Config 中的规则配置承担不同职责:前者提供可选的连接对象,后者决定哪些请求采用 DIRECT、PROXY 或其他已定义策略。导入订阅并不意味着已经选好了适合自己的规则文件。在配置(Config)下,某个页面可以正常访问,也可能是因为命中 DIRECT;这不能单独证明代理服务器可用。
直连(Direct)同样需要正确理解。它是一种路由选择,不等于删除服务器,也不等于清除应用数据。排查时可用它与其他姿态对照,但若目标本应经代理处理,留在直连(Direct)就不会得到预期路径。不要把“开关已打开”和“全部请求都经所选服务器”视为同一件事。
本步完成标志:能够说清当前采用哪一种姿态,以及为什么选择它。首次测试可先记下“服务器名称 + 代理(Proxy)”这一组合;下一步只打开连接,不再同时更换配置文件或服务器。
3. Home:打开连接并确认系统授权
回到 Home,再检查一次选中的服务器和 Global Routing。确认无误后,打开顶部连接开关。首次建立连接时,系统可能提示允许 Shadowrocket 添加 VPN 配置;阅读提示,确认由当前操作触发,再按系统要求完成设备密码或生物识别验证。该授权用于建立系统网络通道,不是新的应用购买步骤。
若之前拒绝了授权,连接可能无法继续。可以关闭开关后重新尝试,并留意是否再次出现系统提示;必要时到设备 Settings 中搜索 VPN,检查与 Shadowrocket 对应的配置状态。不要为了重试而删除不认识的设备管理项目。如果设备受组织管理、相关设置不可修改,应先确认管理限制,而不是反复重置网络。
完成授权后返回 Home,观察连接开关是否保持开启,以及应用是否出现错误提示。系统状态栏或控制中心可能显示 VPN 状态,具体位置随设备布局变化。这个标记仅能辅助确认系统通道状态,不能说明远端认证、DNS 解析和每个目标页面都已成功,完整验证仍在下一步。
测试期间,避免同时启用另一个系统 VPN 连接。若原本已经设置 On Demand,自动触发条件也可能让手动断开的连接再次启动;先记录已有设置,首次排查时减少这些自动触发因素。完成基础验证之后,再按实际网络环境配置 On Demand,便于分清手动操作和自动连接各自造成的变化。
如果开关立即退回关闭,先记录错误信息和发生阶段:是在系统授权前退出,还是授权后尝试连接失败。前者优先检查授权状态;后者还要检查服务器参数与当前网络。此时不要急着重新导入全部订阅,更不要把多个协议字段一起修改,保留原始条目才方便对照。
本步完成标志:连接开关保持开启,系统授权已完成,应用未立即报告连接错误。保持应用当前设置,接着用测试与实际访问判断是否达到预期。
4. Connectivity Test:验证连接结果
验证应同时看三个层面:设备基础网络、所选服务器的测试结果、目标页面的实际访问。先确认当前 Wi-Fi 或蜂窝网络本身可以使用;如 Wi-Fi 需要网页认证,应先完成该网络的认证流程。基础网络尚未连通时,订阅刷新和服务器连接都可能失败,单独改应用参数通常不能解决。
回到 Shadowrocket,在 Home 的测试入口找到 Connectivity Test,对选定条目执行测试。测试方式与显示项目以应用当前界面为准。若条目旁出现测试结果,应将它理解为该测试方法下的可达性反馈,而不是对所有网站、所有协议行为的完整验证。测试成功也不代表目标页面一定能打开,测试失败则需要结合下一步的真实访问继续判断。
保持连接开启,切换到浏览器,打开一个自己有权访问且平时可用的页面。必要时重新载入,避免把此前保留的页面内容当成新请求的结果。再检查实际要使用的应用或页面,观察能否完成加载,而不只是首页文字是否已经出现。若只有一个目标异常,先排除该目标自身的问题,避免直接归因于整条连接。
如果正在使用配置(Config),可以查看应用中可见的请求记录或诊断信息,核对目标域名、匹配规则和最终策略。具体记录内容取决于当前设置。命中 DIRECT 表示该请求走直连,命中 PROXY 才需要继续结合相应服务器判断;不能因为连接开关开启,就忽略规则选择造成的路径差异。
需要对照时,保留同一条服务器,先用代理(Proxy)访问一次,再切换到配置(Config)重复同一目标。Proxy 正常、Config 异常时,优先检查当前配置、规则顺序和 DNS,而不是立刻更换服务器。两种姿态都异常时,再检查服务器信息与网络环境。每次切换后发起新的请求,尽量保持其他条件一致。
不必追求单个测试数值。一次反馈受测试方式、当前网络和远端响应影响,不能据此断言长期表现。首次使用更重要的是确认“能连接、能访问、路径符合目的”。测试链接、订阅内容和诊断记录可能含有个人配置,向他人描述问题时应遮去完整订阅地址、认证信息及不必要的访问记录。
本步完成标志:实际目标能正常加载,并且当前路由姿态符合使用目的。如果还需要整理多个订阅,再阅读节点管理;如果验证未通过,按下面的失败阶段继续检查。
5. 常见失败点:按操作阶段排查
先定位失败发生在哪一步,再处理对应条件。把问题简单记成“导入失败”“连接未建立”或“连接后访问异常”,通常比同时刷新订阅、换服务器、换规则更容易得到结论。每次只改一个条件,重复同一个测试;成功后再逐项恢复日常设置。
导入失败:检查完整链接与内容类型
订阅保存后没有服务器,先重新核对 URL 是否完整、有无多余空格或换行,再确认它确实是用于获取订阅内容的地址,而不是账户网页或说明页。链接是否仍有效,应依据你已有订阅的状态确认。刷新会重新获取远端内容,并不能修正一个已失效的地址。若错误提示与格式有关,应核对该内容能否被 Subscribe 识别,而不是直接修改认证参数。
单条分享链接无法导入时,检查是否只复制了部分内容,以及链接是否被聊天文本或换行截断。手动条目能保存但连接失败时,对照原始信息逐项检查 Type、地址、端口及认证字段。保存成功只说明条目已经写入应用,并不说明远端验证已经通过。
连接失败:区分授权、参数与网络
系统授权尚未完成时,先处理 VPN 配置提示;已有配置但开关无法保持开启时,记录应用给出的错误,再核对协议和字段。地址无法解析、端口不可达、认证不匹配、TLS 名称不一致可能出现在不同阶段,不应一律用重新安装应用处理。也不要为消除提示而随意降低证书验证要求,应先纠正配置中与原始信息不一致的项目。
如果在 Wi-Fi 下失败,可在允许的条件下切换蜂窝网络,保持同一服务器和同一路由姿态再测试;也可以反向对照。只有某个网络环境异常时,应先检查该网络的认证、连接限制或解析状况。这种比较用于缩小范围,并不能单凭一次结果判断远端服务的长期状态。
已连接但访问异常:对照路由与 DNS
先回到 Home 看是否仍选中预期服务器,再检查 Global Routing 是否误留在直连(Direct)。若代理(Proxy)能访问而配置(Config)不能,进入 Config 核对选中的配置,检查目标是否命中了预期规则。DNS 解析结果、规则顺序和最终策略都可能影响表现;不要一次改动整套配置,先针对同一个目标复现问题。
如果只是某个应用异常,而浏览器里的同一目标正常,还应考虑该应用自己的缓存、会话及连接复用。可以结束该应用当前任务后重新发起访问,再观察结果,不必先清空 Shadowrocket 数据。若切换姿态后表现没有立即变化,也应等待旧连接结束或重新建立请求,再作判断。
把排查结果保留下来
记录设备使用的网络类型、当前姿态、服务器的自定义名称、失败发生的步骤,以及经过遮盖的错误文本即可。不要公开订阅链接和密码,也不要把完整配置当作普通截图分享。原条目尚可使用时,优先保留备份,再决定是否删除或重新导入,避免排查过程反而丢失必要信息。
更细的购买恢复、权限与规则问题可转到FAQ;订阅更新、多订阅整理、延迟测试与备份可继续阅读订阅与节点管理手册。完成一次可重复的成功验证后,再增加服务器或设置自动连接,每增加一项都重新检查一次实际访问,后续出现变化时就能沿同一顺序定位。