Shadowrocket 使用教程

Add Server：添加服务器或导入订阅

打开 Shadowrocket，先停留在 Home，暂时不要打开连接开关。查看手中资料属于哪一类：一条用于更新服务器列表的订阅链接，还是一组明确写有协议、地址、端口和认证信息的服务器参数。两类资料的填写入口不同；订阅链接不能直接当作服务器地址，单台服务器的分享内容也不一定是订阅。

已有订阅链接：选择 Subscribe

在 Home 点击右上角添加入口，进入 Add Server，在类型选择中选 Subscribe，将自己的完整订阅链接粘贴到 URL 字段。填写便于辨认的名称后保存。粘贴前后检查链接是否多出空格或换行，尤其保留问号后的查询参数；这些参数可能用于识别订阅，删去一段就可能导致获取失败。

保存后返回 Home，等待订阅内容获取完成。成功时应能看到订阅分组及其包含的服务器条目；仅出现一个订阅名称，并不等于已经获得可连接的服务器。如果列表为空、出现错误或一直没有内容，先查看获取结果，不要靠反复打开连接开关解决。首次导入通常也需要当前网络能够访问订阅地址。

订阅链接应视为敏感信息，避免发到公开评论区或截图中。订阅更新会重新读取远端列表，可能增加、删除或替换其中的条目。需要调整某个服务器参数时，先确认它是否由订阅维护，以免手动修改在下一次更新时被覆盖。

已有服务器信息：选择对应协议

如果拿到的是一组独立参数，同样进入 Add Server，但应选择资料指定的协议类型，例如 Shadowsocks、Trojan 或 WireGuard。按字段名称填写服务器地址和端口，再填写该协议所需的密码、标识或密钥。不同协议的认证字段不能互换；不要仅凭地址相同就选择另一种协议。

如果资料还给出了 TLS、SNI 或传输相关字段，应逐项与原资料一致。服务器地址用于建立连接，SNI 用于 TLS 中的服务名称识别，两者在部分配置中可以不同，不宜自行改成一样。看不懂字段时，先查协议技术参考，不要用猜测填满表单。

保存并回到 Home 后，在 SERVER 列表中选中准备使用的条目，确认当前选择标记落在预期服务器上。已有多条记录时，名称相似不代表参数相同；可以用自定名称区分，但不要把密码写进名称。至此完成的是服务器资料准备，下一步还要确定流量采用哪种路由姿态。

Global Routing：选择连接姿态

在 Home 找到并打开 Global Routing。本教程先理解三种基础姿态：配置(Config)、代理(Proxy)、直连(Direct)。它们决定请求采用什么策略，与“服务器是否已经导入”是两件事；列表里有服务器，不代表每个请求都会使用它。

首次操作且尚未准备规则配置时，可以先选择代理(Proxy)，把验证范围缩小到当前服务器与本地网络。它不是长期使用必须选择的姿态，也不代表所有系统流量在任何情况下都会经过代理。选择后返回 Home，再确认一次当前服务器，避免实际测试的是另一条记录。

准备使用配置(Config)时，先进入 Config 页面，确认已有预期配置并将其选为当前配置，再回到 Global Routing 选择配置(Config)。Config 页面用于管理配置文件，路由选择中的 Config 则表示按配置规则处理流量。两个入口名称相关，但“文件存在”和“正在使用该文件”不能混为一谈。

还要区分服务器订阅与规则配置：Subscribe 导入的内容通常用于维护服务器列表，不应据此认定分流规则也已经准备好。若资料只包含连接参数，先完成代理(Proxy)下的连接验证，再处理规则。已有配置中若引用策略名称，还需确认这些名称能够对应到实际可用的策略。

直连(Direct)可以作为排查时的对照，但它不能用来证明代理服务器可用。如果切到直连后页面能访问，只能说明这次直接连接成功。更多关于规则顺序、最终策略和场景设置的解释，见代理模式说明；不熟悉的术语可在术语手册继续查阅。

Home：打开开关与完成授权

返回 Home，在打开顶部连接开关前，快速核对当前服务器、Global Routing 和当前网络。若仍在输入密码或编辑参数，先保存并退出编辑页。首次验证期间建议保持同一种网络，不要一边连接一边在 Wi-Fi 与蜂窝网络之间切换，否则失败时很难判断是哪一项条件发生了变化。

打开连接开关后，首次使用可能出现系统添加 VPN 配置的请求。这是 Apple 系统用于建立相应网络配置的授权流程。确认本次操作由 Shadowrocket 发起后，再按系统弹窗提示允许，并完成设备要求的身份验证。系统配置授权与订阅服务器认证是两件事，前者通过并不说明后者的参数已经正确。

如果刚才取消了系统请求，不必重新导入服务器。回到应用，再次主动开启连接，并按实际系统提示处理。若设备由组织管理，相关权限可能受到管理策略限制；此时应检查设备管理要求，不要通过删除不认识的管理配置来尝试解决。无法添加 VPN 配置属于系统权限阶段的问题，应与服务器超时分开排查。

授权结束后回到 Home，查看连接状态是否维持。如果开关立即回落、出现错误，或者状态长时间不能稳定，先记下提示内容，不要连续快速切换。系统状态区域中的 VPN 标识会随设备和系统显示方式不同而变化；即使出现标识，也只说明相关网络配置处于连接状态，不能替代下一步的实际访问验证。

为让首次测试可重复，暂时保持 On Demand 条件不变，优先完成一次手动开启、访问和关闭的流程。如果此前已经启用按需连接，手动关闭后可能因条件匹配而再次连接；遇到这种现象，先查看 On Demand 的设置，再判断是不是开关异常。需要调整自动连接条件时，可在基础连接验证完成后再进行。

在 iPad 上也按相同顺序操作：先确认选中条目与路由姿态，再完成系统授权。分栏或横屏显示可能让内容位置变化，但不改变这组依赖关系。现在连接已经建立，接下来要确认请求能否完成，以及结果是否符合所选策略。

Connectivity Test：检查连接是否生效

先在 Home 找到 Connectivity Test 并执行测试，观察当前服务器的结果。测试结果与具体测试方式、目标和当时网络有关；显示可达，不等于任何网站都能访问，某次超时也不必然说明所有业务请求都会失败。它适合提供初步线索，不适合作为唯一结论。

随后打开浏览器，访问自己熟悉且有权访问的 HTTPS 页面，尽量使用一次新的请求，避免仅凭已经缓存的页面判断。可以刷新页面或打开另一个页面，观察正文和图片是否都能加载。若只有个别资源失败，应把它与整个页面完全打不开区分开，不要立即更改所有连接参数。

如果当前为代理(Proxy)，先确认实际使用的还是刚才选中的服务器，再结合访问结果检查连接。若当前为配置(Config)，至少准备两类测试目标：按照自己的规则应当直连的目标，以及应当使用代理的目标。两者都访问成功只是第一层验证，还需要核对它们各自采用的策略是否符合预期。

在应用可查看连接或请求记录的入口，检查测试目标对应的域名、命中策略和错误信息。若界面提供匹配规则信息，也一起核对。规则通常涉及匹配顺序与最终策略，某条规则存在于配置中，不意味着它一定会被本次请求命中；记录比“页面看起来能打开”更有助于确认分流结果。

测试时每次只改变一个条件。例如保持服务器与目标不变，只切换路由姿态；或者保持姿态与目标不变，只切换本地网络。记录改变前后的结果，才能知道哪一项影响了连接。一次同时更换服务器、网络和配置，即使恢复访问，也很难为下一次故障留下可用结论。

如果需要理解 DOMAIN-SUFFIX、GEOIP 或 FINAL 的含义，先看规则关键字与界面术语。首次上手不必立即编写规则；先保留能工作的基础配置，再逐项增加需求，通常更容易维护。

常见失败点：按顺序缩小范围

遇到问题时先判断失败发生在导入、授权、连接还是访问阶段。不要一开始就删除全部配置，也不要把每次失败都归为服务器问题。保留当前可恢复的资料，记下网络类型、路由姿态、测试目标和提示内容，再按下面顺序检查。

订阅无法获取或导入后列表为空

先确认本地网络能够正常访问，再核对订阅链接是否完整、是否仍然有效。服务端返回登录页面、错误提示或普通网页时，即使地址能打开，也不代表返回内容适合导入。向自己的服务商确认链接用途与有效状态；不要公开链接，也不要随意删改认证参数。若原有列表仍可使用，先保留，避免在无法重新获取时失去全部记录。

服务器已出现，但连接超时或认证失败

重新打开该条目的编辑页，对照原资料检查协议、地址、端口和认证字段。端口不是固定通用值，密码大小写与前后空格也可能影响认证。对于使用 TLS 的配置，再检查 SNI、证书验证及设备日期时间；时间明显不正确可能影响证书有效性判断。不应把降低证书验证要求作为默认修复办法，参数不明时应回到原始资料核对。

如果同一配置仅在某一种本地网络下失败，可在条件允许时换到另一种网络复测，同时保持服务器与路由姿态不变。测试结果只能说明两种网络条件下存在差异，还需结合错误信息判断。持续认证失败或服务器端拒绝连接时，应由你自己的服务商核对服务端状态，客户端重复保存通常不能修复服务端问题。

连接已建立，但网站访问不符合预期

先查看 Global Routing。若选中直连(Direct)，本次访问本就没有按代理策略处理；若选中配置(Config)，检查当前启用的是否为预期配置，并查看请求命中的策略。代理(Proxy)下可以访问而配置(Config)下失败，通常应优先检查规则、策略引用及相关 DNS 条件，而不是立即替换全部服务器参数。

若所有目标都失败，先回到基础网络与服务器连接检查；若只有一个目标失败，则检查该目标的匹配规则、解析和服务状态。已有 DNS 自定义设置时，记录原值再逐项验证，不要同时叠加多个来源不明的配置。域名解析和连接路径的关系较长，可继续阅读协议参数与技术参考，本页先保留最小排查范围。

如何留下可复查的结果

排查记录保留现象和必要条件即可：例如“Wi-Fi 下，代理(Proxy)，目标页面正文无法加载，Connectivity Test 超时”。分享记录前遮盖订阅链接、密码、密钥及其他认证信息。恢复到上一次能工作的设置后，再重试单项修改；如果无法确定改动影响，先停止继续叠加配置。

完成本页流程后，应能明确说明自己导入了什么资料、当前选中哪条服务器、使用哪种路由姿态，以及如何验证一次请求。后续需要分流时阅读代理模式，需要核对协议字段时阅读技术参考。把连接验证与高级设置分开处理，能够让下一次更新订阅或更换设备时继续沿用同一套检查顺序。