Shadowrocket 快速上手
订阅导入与首次连接
先把已有资料放进 Home，再确定 Global Routing，最后连接并验证。首次设置按顺序完成；遇到问题时，回到第一个未通过的环节。
截图来自 App Store 官方素材，用于辨认页面与字段。应用内具体排布可能有所调整，操作时以当前界面词为准。
Add Server / Subscribe：放入已有资料
订阅链接与单个服务器资料选一种入口即可，不必把同一份内容重复导入。
打开 Shadowrocket 后先停留在 Home，暂时不要打开连接开关。确认手中资料的形式：如果是一条用于更新服务器列表的订阅链接，走 Subscribe；如果是服务器地址、端口、协议类型和认证信息，走手动填写。两者解决的是资料录入，不等于已经建立连接，也不会自动证明服务可用。
手动填写 Add Server
在 Home 点右上角的添加入口，或列表中的 Add Server，进入添加页面。先点 Type 选择与你已有资料一致的协议，再填写其余字段。顺序很重要：Type 改变后，需要填写的项目也可能改变，不能先照着截图填完再随意切换协议。
Host 填服务器地址，Port 填服务商给出的端口。Password、Method 或其他认证字段按所选 Type 与原始资料核对。截图展示的是一种填写页面，不代表所有协议都只有这些字段。若资料还包含 TLS、传输方式或其他选项，应一起核对；不能用猜测值替代缺失信息。
保存前检查地址前后是否夹带空格、端口是否抄错，以及认证内容是否完整。保存后返回 Home，确认 SERVER 列表里出现对应项目。备注便于辨认，但备注文字本身不决定连接方式；同名项目也不代表它们使用相同的服务器资料。
用 Subscribe 导入已有订阅
如果持有订阅链接，在 Add Server 的 Type 中选择 Subscribe，把完整链接填入页面显示的 URL 输入项，再保存。链接从你自己的服务商处获取，不要把网页介绍页地址当成订阅地址，也不要删掉链接末尾的参数。返回 Home，等待订阅请求完成并查看是否出现服务器列表。
导入成功后先展开对应分组，选一个你能辨认的项目继续后续步骤。若只出现订阅名称、没有服务器条目，先检查更新结果，而不是反复新增相同链接。订阅更新用于重新取得列表；手动添加的服务器则需要按原资料维护。更换录入方式前，保留一份自己的原始资料，避免误删后无法恢复。
页面底部的 Scan QR Code 与 Import from Cloud JSON 是其他导入入口，仅在你已有对应格式资料时使用。本次首次连接不需要把所有入口都操作一遍。订阅链接及二维码可能含认证信息，不要直接公开截图；名词区别可查术语表中的订阅与配置说明。
继续条件：Home 已有可选择的服务器。接下来确定请求应该按哪种路由方式处理。
Global Routing：确定处理方式
本页统一写作配置(Config)、代理(Proxy)、直连(Direct)，括号内对应应用界面词。
返回 Home，点 Global Routing 查看当前选择。它决定请求按什么方式处理，与服务器是否已被添加是两件事。导入资料后如果没有核对这里，可能出现列表内容正常、连接开关也已打开，但访问路径并不是预期路径的情况。
| 姿态 | 处理原则 | 首次设置时的用途 |
|---|---|---|
| 配置(Config) | 按当前配置文件中的规则与相关设置处理请求。 | 使用已有规则方案前，确认所需文件已选中。 |
| 代理(Proxy) | 以代理方式处理请求。 | 临时对照选定服务器能否承载实际访问。 |
| 直连(Direct) | 以直接连接方式处理请求。 | 对照当前网络本身能否访问目标。 |
准备使用 Config 时先核对文件
如果你已有需要使用的配置文件，打开底部 Config，检查文件列表及当前选中项，再进入文件查看内容。配置编辑页面按 General、Rule、Hosts 等分段组织；Add Rule 用于添加规则。首次上手先确认选对文件，不必为了完成连接去修改每个分段。
订阅与 Config 文件并不等同。订阅通常负责提供服务器列表，Config 文件负责规则及相关处理设置；导入订阅后，不应据此推断已经切换到某份指定配置。若现有文件包含策略或分组引用，还要确认它们能对应到实际可用的服务器。这里的核对重点是“当前使用哪一份”，不是“列表里是否曾经保存过一份”。
配置(Config)会依据规则决定处理方式，因此某个请求可能走 PROXY，另一个请求可能走 DIRECT 或 REJECT。规则顺序也会影响结果，不能只凭文件里出现某条规则就断定它一定被使用。首次连接阶段先保留已有配置，复杂规则含义留到规则关键字术语表查阅。
用 Proxy 做一次可控对照
如果暂时没有明确的规则方案，或想先区分服务器问题与规则问题，可以记录原来的 Global Routing 选择，临时切到代理(Proxy)，继续下一步连接测试。验证后恢复自己的日常模式。不要把临时测试的选择误当成永久设置，也不要用直连(Direct)下访问正常的结果证明代理服务器可用。
继续条件：已知道当前是 Config、Proxy 还是 Direct；使用 Config 时，能确认当前选中的文件。
Home：选定服务器并连接
先选服务器，再开顶部开关；第一次连接还需要完成系统 VPN 配置授权。
完成路由选择后回到 Home，在 SERVER 列表中点选准备使用的服务器，确认对应的选中标记。不要把打开编辑页与选定服务器混为一谈：编辑页用于修改资料，列表里的选择才是本次连接时需要核对的对象。如果有多个分组，先确认选中的项目属于预期分组。
接着打开 Home 顶部的连接开关。未连接时可看到 Not Connected。首次建立连接时，系统可能弹出添加 VPN 配置的请求；这是让应用建立系统网络隧道所需的授权步骤，不是购买流程，也不会替你补齐服务器信息。核对发起请求的应用是 Shadowrocket 后，按系统提示允许，并完成设备要求的验证。
完成系统操作后返回 Home，观察顶部状态是否从未连接变为已连接。如果授权被取消，先重新发起连接并检查提示，不要立即删除订阅。若设备受组织管理、相关设置不可操作，需先确认设备管理限制；反复切换应用内开关无法替代系统层面的许可。
在 iPhone 与 iPad 上，这一步的核对目标相同：选中的服务器、Global Routing 与连接状态。屏幕较宽时列表排布可能不同，但不需要重新录入一套不同的服务器资料。切换无线网络或移动网络后，连接表现也可能改变，首次测试尽量保持在同一个网络环境中，以免把网络变化误判为设置变化。
连接状态出现后先不要继续调整多个选项。系统显示 VPN 状态，只能说明隧道已建立，不能单独证明远端服务器认证成功、所有目标都可访问，或每条规则都已按预期处理。保持当前服务器与模式不变，进入下一步做实际验证，这样失败时才有明确的比较起点。
继续条件：系统授权已完成，Home 显示已连接；服务器与 Global Routing 的选择已确认。
Connectivity Test：验证实际结果
分开检查“隧道已建立”“测试通过”“实际访问符合预期”，不要用一个结果替代全部判断。
保持连接开关打开，在 Home 点 Connectivity Test，等待应用显示本次测试结果。若测试失败，先记下当前网络、服务器、Global Routing 与结果提示，再做修改。列表测试及 Connectivity Test 都是诊断线索；它们使用的测试目标与方法可能不同，不能只凭某次测试结果给所有网站下结论。
再做一次真实访问
切到需要使用的应用或浏览器，访问你实际需要验证的内容，确认新请求是否能够完成。不要只看已经打开的旧页面：页面缓存可能让结果看起来正常，实际并没有产生可用于判断的新连接。可以重新打开目标页面，或执行一个明确需要联网的操作，并观察它是否完整结束。
如果 Connectivity Test 通过，但实际目标仍失败，先看 Global Routing。配置(Config)下，目标可能被规则交给 DIRECT、PROXY 或 REJECT；代理(Proxy)下的对照结果可以帮助判断是否与规则有关。切换前记录原设置，每次只改变这一项，使用同一个目标复测，完成后恢复需要的模式。单个目标失败也可能与目标服务本身有关，不能据此判定整个连接不可用。
保存一次可以重复的检查顺序
第一次成功后，记住“选择服务器 → 核对模式 → 打开连接 → Connectivity Test → 实际访问”的顺序。以后更新订阅或更换网络时，仍按同一顺序验证，比同时改协议、DNS 和规则更容易定位问题。需要留存设置时，只记录必要的选择与结果，不把完整订阅链接或密码放进公开笔记。
如果只是想了解 PROXY 与 DIRECT 的区别，可查术语表；如果需要追踪具体规则、DNS 或特定应用的异常，进入问题诊断按症状继续。本页验证完成的标准是所需的实际访问能够按预期工作，而不是所有测试项目都必须呈现相同结果。
Settings：按失败环节排查
先查资料与网络，再查连接与规则。一次只改一项，改后回到相同目标复测。
订阅没有生成服务器列表
回到订阅项目，核对 URL 是否完整、是否粘贴了网页地址，以及原链接是否仍在有效使用期内。订阅需要先通过当前网络取得内容，列表为空时并没有可供下一步使用的服务器。查看更新提示后，再向自己的服务商核对链接状态与内容格式，不要靠重复创建同一订阅解决。订阅能更新，也只代表列表取得成功，不代表其中每个服务器都已通过连接验证。
开关回落或一直无法建立连接
先看系统授权是否已完成，再确认 Home 中有选定服务器。检查 Type、Host、Port 与认证字段是否匹配原资料；若服务端要求额外的传输或 TLS 参数，也要完整对应。保留原值后逐项修正，避免同时改动多个字段。若当前有其他 VPN 连接，先停止它，再重新测试 Shadowrocket，排除同时争用系统连接状态的影响。
测试超时或结果前后不一致
打开 Settings，核对 Test Method。不同方法检查的环节可能不同，超时应结合实际访问判断，而不是直接删除该服务器。也可以在另一种可用网络下用相同服务器复测，但切换后需要重新确认连接状态。若同一网络中持续失败，先保留错误提示，再核对服务器信息与服务状态。
连接后部分内容失败
先用 Global Routing 的代理(Proxy)作短暂对照。如果 Proxy 正常而配置(Config)异常，优先检查当前配置文件、规则顺序和策略引用。若两种模式都失败，优先回到服务器与网络环节，不要立刻大幅改动规则。DNS 等问题需要结合具体错误继续判断，完整路径见问题诊断中的按症状排查。
关闭后又连接，或设置变化难以解释
在 Settings 检查 On Demand 是否启用，以及它的条件是否符合当前网络。按需连接可能使手动关闭后的观察变复杂；首次排错可记录原设置，暂时停用相关条件，完成对照后再恢复。不要为了保持连接而直接修改 Proxy、TCP、UDP 下所有选项，这些设置需要针对具体症状处理。
Diagnostics 可用于进一步查看诊断线索。准备向自己的服务商反馈时，说明失败发生在订阅更新、建立连接还是实际访问，并提供已做过的对照结果。分享任何记录前，先移除服务器认证内容、完整订阅链接与其他个人信息。这样既能保留排错价值，也不会把访问资料随截图一起公开。
完成标准：已有资料可正常使用，连接与实际访问结果符合预期。日常按需要选择模式；更深入的设置留到有明确问题时再调整。
