官方手册 · 首次连接流程
Shadowrocket 使用教程
添加已有配置 → 选择 Global Routing → 连接并验证
适用于 iPhone 与 iPad。先完成一次可复查的连接，再调整规则、On Demand 与其他设置。文中的界面位置结合官方 App Store 截图说明，实际显示以当前应用内界面为准。
01 · Add Server：添加与导入
先辨认手中的资料类型：一组服务器地址、端口与认证参数适合手动填写；已有订阅链接适合使用 Subscribe；已有可被识别的配置二维码则可用 Scan QR Code。三种方式不必全部执行，选择与你的资料相符的一种即可。订阅链接可能带有访问凭据，不要把完整链接贴到公开页面或发到公开讨论中。
手动填写服务器信息
打开 Shadowrocket 的 Home，在 SERVER 分组中找到 Add Server 并进入。先点 Type，选择资料明确注明的协议类型，再填写页面随之显示的字段。以 Shadowsocks 为例，核对 Host、Port、Password 与 Method：Host 是服务器域名或地址，Port 是连接端口，Password 与 Method 必须分别与已有资料一致。不要根据字段外观猜测参数，也不要把一整段分享链接填进 Host。
不同 Type 的字段并不相同。选择 VLESS、VMess、Trojan 等类型时，应继续核对对应认证信息，以及资料中明确要求的传输和 TLS 参数。某个字段没有资料依据时，先向原资料提供方确认，不要为了保存而随意填值。填写完成后使用页面的保存操作返回 Home，确认列表中出现新条目，再点选准备使用的条目。保存成功只说明录入已完成，还不代表服务器已能连接。
使用 Subscribe 导入已有订阅
如果已有订阅链接，进入 Add Server 后在 Type 中选择 Subscribe，把完整链接填入 URL，并按需填写便于辨认的备注。复制时检查链接开头和结尾，避免混入说明文字、空格或换行。这里填写的是你已有的订阅地址，不是一般网页地址，也不是某一台服务器的 Host。保存后返回 Home，等待订阅内容载入，观察是否出现相应分组和条目。
若只看到订阅名称却没有可选条目，先检查更新是否完成，再确认链接是否仍有效、基础网络是否能访问该地址。订阅更新用于重新取得服务器列表，并不等同于更新 Config 中的规则文件。以后需要刷新内容时，在该订阅的管理操作中执行更新；已有手动条目与订阅条目也应分别辨认，避免改错对象。
使用 Scan QR Code
在 Add Server 页面选择 Scan QR Code，按系统提示授予相机权限，再扫描你已有配置对应的二维码。识别后先检查 Type、Host 与 Port 等信息是否与预期相符，再保存。二维码也可能携带认证资料，因此展示截图或求助时应遮蔽完整二维码。Import from Cloud JSON 是另一个导入入口，仅在你确实持有相应格式资料时使用，不必为了首次连接额外操作。
完成本步的判断依据是：Home 中已经有可选择的服务器条目，且参数与原资料对应。接下来先确定流量处理方式，再开启连接；不要在没有条目的情况下反复切换顶部开关。
02 · Global Routing：选择模式
回到 Home，点击 Global Routing 查看当前模式。这里决定客户端如何处理请求，不是服务器协议选择器。三种姿态分别为配置(Config)/代理(Proxy)/直连(Direct)。先明确本次要验证什么，再选择对应姿态；更换姿态并不会自动修正服务器参数，也不意味着订阅内容发生了变化。
配置(Config)：依据当前配置处理请求
日常需要按规则区分请求走向时，选择配置(Config)。随后进入 Config，核对当前实际启用的配置文件，而不是只看文件列表中是否存在一个名称。配置文件可以包含 General、Rule、Hosts 等分段；截图还展示 URL Rewrite、HTTPS Decryption 等入口。这些入口不要求首次使用时逐项开启，也不需要为了连接而添加自己尚不了解的内容。
在 Rule 中，规则顺序会影响命中结果。例如 DOMAIN-SUFFIX,example.com,PROXY 表示按域名后缀匹配并指定 PROXY；DIRECT 表示直连处理。前面的规则没有命中时，还要看配置中的最终处理方式。初次验证应优先使用来源明确、内容可理解的已有配置；Add Rule 留待需要有依据地调整规则时再操作。协议字段与规则作用不同，更深入的说明见协议参考。
代理(Proxy)：用于检查所选代理路径
选择代理(Proxy)后，客户端接管的请求按该姿态使用代理处理，可用于判断问题是否与 Config 中的分流规则有关。切换后仍要确认 Home 选中的是哪一条服务器，并重新发起测试请求。不要把 Proxy 理解为某种加速保证；基础网络、服务器可用性、目标响应和协议参数仍会共同影响结果。
直连(Direct)：用于对照基础访问
选择直连(Direct)时，请求按直连姿态处理，而不是使用所选服务器作为代理路径。它适合与其他姿态做对照，但不等同于关闭系统 VPN 配置。如果要停止客户端连接，应使用 Home 顶部连接开关。测试结束后回到原本计划使用的姿态，并记录选择，避免把排错时临时切换的模式当作日常状态。
本步结束前应能回答两个问题：Global Routing 当前选了什么；若为 Config，实际使用的是哪份配置文件。确认这两项后，再继续系统授权与连接。
03 · Home：授权并打开连接
返回 Home，先检查 SERVER 分组中的当前选择，再检查 Global Routing。两者都正确后，打开顶部连接开关。官方截图中的 Not Connected 表示截图拍摄时尚未连接，它是状态文字，不是需要填写的参数。连接过程中应观察应用内状态变化，不要在短时间内反复开关，以免难以分辨哪一次操作对应当前结果。
首次添加 VPN 配置
首次启用连接时，系统可能请求添加 VPN 配置。阅读弹窗，确认请求来自正在使用的 Shadowrocket，再按系统流程允许并完成设备认证。这个授权用于让应用通过系统提供的网络机制处理连接，不会替你创建服务器、补全订阅信息或修复失效参数。授权完成后返回应用，检查连接是否已建立；若没有，确认页面状态后再尝试一次。
如果此前取消了请求，先回到应用重新发起连接，查看系统是否再次出现确认提示。若系统中的相应配置曾被删除，也需要按应用与系统提示重新建立。不要仅因为系统设置中存在 VPN 项目就认定连接成功：配置存在、连接开关开启、目标请求可用，是三个需要分别确认的状态。
连接后先保留当前设置
当应用显示已连接，先不要立即启用更多选项。保持当前服务器、Global Routing 与配置文件不变，进入下一步做实际访问验证。这样如果出现问题，可以围绕这组已知设置排查。iPad 上的列表与详情位置可能因布局不同而变化，但先选条目、再确认模式、最后启用连接的顺序一致。
若开关立即恢复关闭，或长时间停留在连接过程，先转到设置与排错检查系统授权和其他连接的影响，而不是连续新建相同条目。成功进入连接状态后，再进行 Connectivity Test 与浏览器验证。
04 · Connectivity Test：验证效果
回到 Home 执行 Connectivity Test，观察当前条目的测试结果。测试结果与 Settings 中的 Test Method 有关，不同测试方法检查的环节不同。出现耗时数值通常只能说明相应测试得到了响应，不能直接证明所有网页、所有应用或所有协议流量都能正常工作。相反，一次测试超时也不能单独定位为密码错误，需要结合实际访问判断。
随后打开浏览器，访问一个熟悉且可核对的目标页面，并主动重新加载。尽量使用新发起的请求，避免只看已经缓存的页面。再访问另一个独立目标作对照：只有单个网站失败时，先考虑该目标本身、对应规则或解析问题；多个目标都失败时，再回到服务器、模式和基础网络检查。测试期间不要同时切换服务器和配置，否则结果难以比较。
如果当前使用配置(Config)，应结合可查看的连接记录，核对目标域名以及命中的规则、策略或处理结果。预期走 DIRECT 的请求没有使用代理，并不一定是故障；预期走 PROXY 的请求却按其他方式处理，则需要检查启用的 Config 与规则顺序。记录的具体入口和字段以当前应用内显示为准，不要仅凭一个系统 VPN 标识判断分流结果。
建议记下这次验证使用的服务器备注、模式和配置文件名称，但不要记录或公开完整认证资料。之后若要测试另一条服务器，先只切换服务器并重复同样的访问流程。需要理解更多测试结果时，继续阅读疑难解答，避免把延迟测试、DNS 解析和实际内容访问混为同一个指标。
05 · Settings：设置与排错
遇到失败时，按下面的顺序缩小范围。每次只改变一个条件，改变后重复相同目标的访问测试，并记录结果。Settings 中提供 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 等设置入口，但入口存在不代表每项都需要调整；首次连接应先检查基础条件，再考虑更深入的参数。
先区分基础网络与配置问题
- 基础网络：关闭应用连接，检查当前 Wi-Fi 或蜂窝网络是否能访问原本就可访问的页面。如网络需要先完成登录，先处理登录，再回来连接。
- 导入内容：确认 Home 已有实际服务器条目。订阅更新失败与服务器连接失败属于不同环节，先解决列表获取问题，再测试列表中的条目。
- 参数与选择：检查 Type、Host、Port、认证信息及资料要求的其他字段，同时确认正在测试的确实是刚核对过的条目。
- 模式与配置：检查 Global Routing。使用 Config 时核对当前配置文件；必要时临时切换 Proxy 作对照，测试后恢复原来的姿态。
- 系统连接：检查授权是否完成、应用状态是否保持连接，以及是否有其他 VPN 连接影响当前会话。先停止冲突连接，再重新验证。
测试有响应，网页仍打不开
先换一个独立目标检查，再看失败是否只发生在某个域名。可能相关的环节包括 DNS 解析、规则命中、目标服务响应，以及所用测试方法与实际请求的差异。不要直接把所有问题归到 DNS，也不要一次替换全部解析设置。先核对当前 Config 中的相关设置与记录，再有依据地修改一项并复测；需要展开排查时查看规则分流与故障排查说明。
On Demand：基础连接稳定后再设置
On Demand 用于依据设定条件触发连接行为，与手动打开 Home 开关不是同一件事。首次使用建议先完成手动连接和验证，再进入 Settings 查看 On Demand 的条件。若发现手动断开后又自动连接，应回头检查这里的设置，而不是反复删除服务器。更改后分别观察符合条件与不符合条件时的表现，确认行为符合预期。
使用 Diagnostics 并保护连接资料
需要进一步定位时，可在 Settings 查看 Diagnostics 中可用的诊断入口。保存问题发生时的现象、网络类型、所选模式，以及是否仅有特定目标失败，比只写“不能用”更有助于判断。对外提供截图或记录前，移除订阅完整链接、认证字段、二维码与其他个人信息。不要为了排错公开整份配置文件。
如果某次调整使情况变差，先恢复到上一组已验证的设置，再逐项重试。正常连接后可停在这里，后续按需要阅读协议参考与设置说明；本教程的目标是建立清晰、可重复的操作流程，而不是在第一次使用时修改所有选项。
