Shadowrocket 入门指南

打开 Shadowrocket，进入 Home。下方的 SERVER 分组用于显示已保存的服务器；第一次使用时，先找到 Add Server 入口。添加的目标不是让列表里出现任意一条记录，而是将你已有的信息按正确类型保存。先判断手上的内容是一条订阅链接、一条服务器分享链接，还是分开的地址、端口与认证字段，再选择相应方式。

已有订阅链接：使用 Subscribe

进入 Add Server 后，在 Type 中选择 Subscribe，将完整订阅链接粘贴到 URL 栏位。可填写便于辨认的备注，然后使用页面上的保存操作返回 Home，等待订阅读取完成。若条目尚未展开，先查看对应订阅分组；需要重新读取时，使用该订阅条目的更新操作，避免反复新增同一个链接。

复制链接时应从头到尾完整选中，注意末尾参数、换行和空格。不要把登录网页地址、说明页面地址当成订阅链接，也不要自行删去看似多余的参数。下面只展示链接外形；实际操作应使用你自己的有效链接，不能照抄示例。

https://example.com/sub?token=xxxx

已有服务器字段：按 Type 手动填写

如果已有独立服务器信息，在 Add Server 中先选择对应的 Type，再填写 Host、Port 及该协议需要的认证项目。例如 Shadowsocks 需要核对 Password 与 Method；其他协议的字段会随类型变化，不应强行套用同一张字段表。地址只填要求的主机名或 IP，端口只填端口值，认证内容保持原样。

涉及 TLS 或传输设置时，必须依据已有服务器信息逐项填写，不能因为字段看起来可选就随意修改。尤其应保留给定的服务器名称、路径与传输类型；参数缺失时先向你已有服务的提供方确认。保存成功只说明条目已写入，尚不代表远端认证与连接已经通过。

已有二维码或分享链接：先检查，再保存

已有二维码时，可使用 Scan QR Code，首次扫描按系统提示允许相机访问。已有完整服务器分享链接时，复制后返回应用，若出现导入提示，应先核对解析出的类型、主机名和端口再确认。Import from Cloud JSON 是针对相应 JSON 数据的入口，不是所有订阅链接都应放到这里；不要仅凭入口名称相似就混用。

回到 Home 后，确认 SERVER 中出现预期条目，并点选准备使用的服务器。若订阅有多个条目，先选择一个信息明确的条目做初次验证，不必立即整理全部名称和排序。关于多订阅管理、更新覆盖与删除前备份，继续阅读订阅与服务器管理。完成这一步后，再决定流量采用哪种处理姿态。

服务器保存并选中以后，在 Home 点开 Global Routing。它决定请求如何选择处理策略，与刚才填入的服务器地址不是同一层设置。服务器信息正确但姿态不符合预期时，也可能出现“应用显示连接，访问结果却不同”的情况。先明确本次是验证服务器，还是按已有规则日常使用，再作选择。

1. 配置(Config)：按照当前配置中的规则处理请求。命中直连策略的请求使用直连，命中代理策略的请求使用对应代理路径；不能仅凭已选服务器判断每个请求的去向。
2. 代理(Proxy)：将由客户端处理的请求交给代理策略，适合暂时缩小规则因素的影响。仍需有可用的服务器，不会替代服务器认证或自动修复错误参数。
3. 直连(Direct)：使用直连策略。适合作为对照，检查基础网络或目标页面本身是否可访问，不应用它来证明代理服务器已正常工作。

初次验证已有服务器时，可以暂时使用代理(Proxy)，完成后再切回符合自己配置的姿态。如果你已有明确的规则文件，则进入 Config 核对当前选中的配置，而不是只看列表里是否保存过文件。只有被当前使用的配置中的规则，才会影响配置(Config)姿态下的处理结果。

Config 页面要核对什么

打开相应配置的编辑页面，会看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。入门阶段先关注 Rule 与策略引用，不需要为了完成连接而逐项启用这些功能。Add Rule 用于添加规则；已有配置可用时，不必先改写整份文件。

规则通常按顺序匹配，前面的规则可能先决定处理方式，FINAL 则承接此前未命中的请求。下面是规则语法示例，不是可直接替换当前配置的完整文件；PROXY 所指向的策略也应在实际配置中有效。不要把示例域名当作需要测试的真实服务。

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

若不清楚策略名和协议名的区别，先查看术语表中的规则与策略说明。对首次连接来说，记住当前姿态、当前配置和当前所选服务器这三项即可。确认后回到 Home，下一步才是打开连接开关。

回到 Home，先检查 SERVER 中选中的服务器，再检查 Global Routing 显示的姿态。顶部处于 Not Connected 时，表示客户端连接尚未建立。点按旁边的连接开关开始连接；不要因为已经导入订阅，就认为系统会自动开始处理流量。

第一次打开开关时，系统可能提示允许 Shadowrocket 添加 VPN 配置。这是应用通过系统网络能力处理设备流量所需的授权，并不是再次购买应用，也不是新增服务器的操作。确认提示对应 Shadowrocket 后，按系统流程允许，并完成设备要求的密码或身份验证。授权过程由系统界面完成，不应将设备密码填写到服务器字段里。

如果刚才取消了授权，回到应用再次打开开关，观察是否重新出现提示。授权成功后，返回 Home 等待连接状态变化。连接状态和系统 VPN 标识可以帮助确认系统网络通道已经建立，但不等于所选服务器一定能访问所有目标；仍需继续下一步的实际验证。

连接前后保持条件一致

第一次排查时尽量保持同一个 Wi-Fi 或蜂窝网络，不要同时切换网络、服务器、配置和姿态。若已有其他 VPN 连接，先结束当前不用的连接，再回到 Shadowrocket 重试，以免把系统连接切换误认为服务器异常。每次更改后都重新检查顶部状态，而不是只看开关曾经被点亮过。

在 iPad 上执行同样的逻辑：选中条目、核对姿态、打开开关、完成系统授权。屏幕布局可能因设备与应用显示方式不同而变化，操作依据仍是这些英文界面词。需要停止时关闭顶部连接开关；关闭连接不会自动删除已保存的服务器或订阅，后续可以继续使用原有条目。

如果开关很快自行关闭、持续无法完成连接，先停在此处记录系统提示，不必立刻删掉所有数据。可以直接跳到失败点排查区分授权问题和远端连接问题。若连接状态能保持，再继续验证，不要仅凭“已连接”就结束设置。

排查时先确认失败发生在哪个阶段：是导入后没有服务器、开关无法保持、连接后全部访问失败，还是只有部分请求不符合预期。阶段不同，检查入口也不同。先保留原有数据与错误提示，每次只修改一项，再按“连接 → 测试 → 实际访问”的顺序复查。

导入后列表为空：回查输入与读取结果

返回订阅条目，检查链接是否完整，有没有粘贴多余空格或遗漏末尾参数。确认内容确实是已有订阅地址，而不是账户登录页面。若链接需要在当前网络下读取，先检查基础网络能否完成读取；必要时向你已有服务的提供方确认订阅状态和返回格式。不要把同一链接重复添加多次，也不要在公开求助时贴出完整链接。

开关无法保持：先看系统授权

先核对是否完成添加 VPN 配置的系统授权，再检查是否有其他正在使用的 VPN 连接。如果系统给出明确错误，记录原文后再操作；不应把所有问题都归因于服务器密码。重新打开应用、重新发起连接后，观察是否停在同一个阶段。只有在清楚数据备份位置后，才考虑涉及删除配置或重装的操作。

已连接但不可访问：核对字段与姿态

确认当前不是直连(Direct)，再核对选中服务器的 Type、Host、Port 以及认证、TLS 和传输参数。手动添加时，最容易发生的是协议选错、端口误填或密码混入空格。订阅导入的条目应优先重新核对订阅更新结果，不要凭猜测批量修改字段。若基础网络本身也无法访问常规目标，应先处理网络接入问题。

只有部分请求失败：检查规则和测试方式

如果代理(Proxy)可用，而配置(Config)异常，回到 Config 检查当前配置和规则顺序。若只是测试结果异常，可进入 Settings 查看 Test Method，理解当前方法与实际访问方式是否一致；改变测试方法只影响测试依据，不会修复错误的服务器参数。TCP、UDP 相关设置也应按已有服务的支持情况核对，不能为了排错全部随意切换。

连接行为与预期不同：检查 On Demand

在 Settings 查看 On Demand。它影响满足条件时的自动连接行为，不负责生成服务器信息。第一次建立可用连接时，可以先采用手动连接并记录当前设置；确认手动流程稳定后，再逐项配置自动连接条件。若关闭后又出现连接，或网络切换后行为变化，应先回查这里，而不是直接删除订阅。

需要进一步分析时，使用 Diagnostics 提供的诊断信息，并将问题缩小到一次明确的复现操作。分享诊断材料前，应遮盖订阅链接、认证字段、个人地址与其他敏感内容；截图里也要检查这些位置。更完整的现象分类见常见问题，更新策略、排序与备份见节点管理手册。