官方手册 · iPhone / iPad 入门
Shadowrocket 导入与连接教程
按“添加 → 选择路由 → 连接 → 验证 → 排错”的顺序操作。第一次使用时，先确认一条已有服务器能够连接，再调整规则和自动连接条件。
以下截图为 App Store 官方截图。界面布局可能随设备和应用调整而变化；找不到入口时，先按英文界面词定位，不要根据图中条目的位置机械操作。
步骤 01 · Add Server / Subscribe
添加服务器或导入已有订阅
订阅链接、单条分享链接和手动填写的信息不是同一种输入。先确认手里的资料属于哪一类，再选择对应入口。
使用 Subscribe 导入订阅
打开 Shadowrocket，进入 Home（首页），点右上角添加入口或列表中的 Add Server（添加服务器）。在 Type（类型）中选择 Subscribe（订阅），把从自己服务商处取得的完整订阅链接填入对应的 URL 输入项，再保存。链接应完整保留路径与参数；复制时混入空格、换行或说明文字，都会使客户端无法正确读取内容。
保存后返回 Home，等待订阅内容载入，检查 SERVER（服务器分组）下是否出现服务器条目。订阅名称出现但没有条目，不等于已经导入成功：先确认设备当前网络能访问订阅地址，再检查链接是否仍有效。订阅需要更新时，使用该订阅分组的更新操作；不要连续重复添加同一链接，以免生成多个难以辨认的分组。
订阅地址可能包含访问凭据，不要把完整地址发到公开页面，也不要把它贴入本教程的示例文字中。服务商给出的若是某一条服务器的分享链接，应使用客户端对应的导入功能，而不是直接当作 Subscribe 地址填写。拿不准资料类型时，先向你自己的服务商确认格式。
使用 Add Server 手动填写
如果已有的是服务器地址、端口及认证信息，在 Add Server 中先选 Type，再按该类型显示的字段填写。以 Shadowsocks 为例，核对 Host（主机）、Port（端口）、Password（密码）和 Method（加密方法）。其他协议会显示不同的认证及传输字段，不能把一个类型的字段值直接套到另一个类型。
Host 只填写服务商给出的主机名或地址，不要擅自加网页路径。Port 应与服务器端设置一致；密码及其他认证值按原文复制，注意大小写。若信息还包含 TLS、传输方式、路径或服务器名称等要求，应一起核对，不能只填地址与端口就保存后反复尝试。
已有二维码时，可使用 Scan QR Code（扫描二维码），按系统提示允许相机访问。Import from Cloud JSON（从云端 JSON 导入）用于对应格式的数据，不是任意网页地址的通用导入入口。完成任一路径后，都回到 Home 检查新条目是否存在；此时先不打开连接开关，下一步先确定流量如何处理。
步骤 02 · Global Routing / Config
选择 Global Routing
服务器条目决定连接到哪里，Global Routing 决定哪些流量采用哪种处理方式。两项都需要确认。
回到 Home，点 Global Routing（全局路由）。入门时先理解三种基本姿态：配置(Config)/代理(Proxy)/直连(Direct)。选择后返回 Home，查看 Global Routing 右侧显示的当前值。修改了配置文件但仍处于 Proxy 或 Direct 时，不能据此判断配置中的规则是否正确，因为当前姿态并不是按配置规则处理流量。
配置(Config)：按当前规则分流
选择 Config 后，流量按当前配置中的规则匹配。进入 Config（配置文件）页面，确认正在使用的配置，而不只是列表中已经存在某个文件。打开配置后，在 Rule（规则）分段查看规则及顺序；截图中的 General、Hosts、URL Rewrite 和 HTTPS Decryption 是其他配置分段，首次连接时不必逐项修改。
规则通常从上往下匹配，先命中的规则决定去向。例如，下列教学片段把指定域名后缀交给 PROXY（代理策略），其余交给 DIRECT（直连策略）。示例域名只解释写法，不是用于判断连接好坏的测试目标。实际配置还可能引用策略组，不能只看最后一行就推断所有请求的去向。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT使用 Add Rule（添加规则）时，应核对类型、匹配内容、策略及插入位置，再保存。不要为了首次连通就覆盖已有的整份配置；如需试改，先保留原配置副本。初次导入服务器并不代表已经导入了适合自己的分流规则，订阅中的服务器列表与 Config 中的配置文件应分别检查。
代理(Proxy)与直连(Direct)：用于明确处理方式
选择 Proxy 时，交由客户端处理的流量按代理姿态转发，可用于缩小排错范围，暂时排除复杂规则带来的影响。选择 Direct 时，按直连姿态处理，不应期待它使用选中的远端代理服务器。这里的“代理”也不表示设备上所有类型的通信都必然经过同一路径，仍需结合系统和具体连接判断。
若只是想先验证已有服务器能否工作，可以暂时选 Proxy，完成后续连接与测试，再切回 Config 检查分流。不要同时更换服务器、规则和 DNS 设置，否则很难知道是哪一项改变了结果。界面若还列有 Scene（场景）入口，本教程暂不展开；相关区别可在术语表查阅，完整规则说明见使用手册。
步骤 03 · Home / SERVER
选定服务器，打开连接开关
先选默认服务器，再打开顶部开关。进入条目详情与选中条目是两个不同动作。
在 Home 的 SERVER 列表中找到准备使用的服务器，点条目左侧圆点，将其设为默认服务器，并确认选中标记已改变。点右侧详情入口通常是编辑参数，并不等同于选中。若使用的 Config 引用了独立策略组，还要核对组内的实际选择，不能只凭 Home 上的默认圆点判断全部流量都会使用这条服务器。
列表中存在多条服务器时，先选一条资料完整、状态明确的条目测试。可以运行延迟测试辅助检查，但延迟数字只反映该测试方法下的响应，不代表网页一定能打开，也不等于持续传输速度。不要在第一次验证前启用复杂的自动选择条件；保留一个固定对象，后续更容易复现和比较结果。
确认 Global Routing 的值后，打开 Home 顶部连接开关。首次建立连接时，系统可能提示允许 Shadowrocket 添加 VPN 配置。核对提示中的应用名称，选择允许，并按设备要求完成密码或生物识别认证。这里是授权客户端通过系统网络接口处理流量，不是让你在系统弹窗中填写服务器密码。
返回 Home 后，观察顶部状态是否从 Not Connected（未连接）发生变化。若开关立即回落，先检查系统授权有没有完成，再检查是否存在其他正在工作的 VPN 连接。不要通过连续快速开关来处理授权问题；应先停止本次尝试，读清提示，再按最后一节的顺序定位原因。
系统显示 VPN 状态或客户端开关保持开启，只能说明连接配置已启动，不能单独证明远端服务器可用，也不能证明某个网站命中了预期规则。现在保持服务器和路由姿态不变，进入下一步做实际验证。测试完成后需要断开时，回到 Home 关闭顶部开关，再确认连接状态已经改变。
步骤 04 · Connectivity Test / Data
验证连通性与规则去向
在 Home 点 Connectivity Test（连通性测试），等待结果。它用于检查所选测试目标的可达情况，并不是所有网站都能正常使用的证明。若测试超时，先记住当前服务器、Global Routing 值和所用网络，不要立即清空配置；这些条件能帮助区分服务器问题、规则问题与本地网络问题。
先看能否访问，再判断是否符合预期
打开浏览器，访问一个你平时使用、且知道应当如何连接的网站，重新载入页面。应当确认的是本次请求能够完成，而不是只看到已经缓存的文字或图片。单个网站失败时，再换一个已知可访问的目标交叉检查；如果只有一个目标异常，应先把问题范围限制在该目标，不要直接判定整个连接都失效。
处于 Proxy 时，可以先判断当前服务器的基本连接是否可用；切回 Config 后，再对照同一目标的域名与规则顺序检查预期去向。网站页面可能同时请求多个域名，因此“页面部分加载”不一定意味着开关没有生效。需要更精确判断时，应结合可用的连接或诊断记录，查看实际请求命中的策略，而不是只看页面是否打开。
进入 Data（流量统计）查看上传、下载读数是否随测试发生变化，可作为有流量经过客户端的辅助线索。数字增加不代表流量一定走了远端代理；直连请求和后台通信也可能影响读数。不要把 Data 数字直接当作规则命中证明，也不要将它与服务商账户或运营商账单逐字对应。
每次只改变一个条件
若结果不符合预期，先保留同一服务器，只把 Global Routing 从 Config 暂时改成 Proxy，再重复相同访问。Proxy 可用而 Config 异常时，优先回查当前配置、规则顺序和策略选择；两者都失败时，再向服务器参数、当前网络及 DNS 方向检查。完成对照后，恢复你打算日常使用的姿态，避免把排错时的临时设置留作长期设置。
至此，基本导入和首次连接流程已完成。需要理解 DOMAIN-SUFFIX、FINAL 或策略组的含义时，转到术语表；需要进一步编排规则与配置文件时，阅读完整使用手册，不必在首次连接阶段一次改完所有选项。
步骤 05 · Settings / Diagnostics
按失败位置逐项排查
保留当前配置，从发生错误的那一步开始。一次只检查或修改一项，随后重新测试。
导入失败：先查输入与订阅响应
如果 Home 中没有服务器条目，先返回 Add Server 核对 Type 是否正确，再确认输入的是完整订阅链接还是单条分享信息。订阅更新报错时，检查设备当前网络、链接有效性及自己服务商给出的使用说明。重复添加并不会修复已经失效的链接；应保留原条目，确认原因后再决定是否替换。
开关失败：先查系统权限
如果顶部开关打不开或打开后立即关闭，确认首次添加 VPN 配置的授权已经完成，并检查是否有其他 VPN 连接占用当前连接状态。打开系统设置查看 Shadowrocket 的 VPN 配置与提示，再返回应用重试。不要先删除全部服务器或重置整份 Config，因为开关授权失败与服务器列表是否完整是不同层面的问题。
已经连接：核对服务器、路由和网络
如果状态已经改变但访问失败，按顺序检查默认服务器、Global Routing 和该服务器的参数。手动条目重点核对 Type、Host、Port、认证信息及服务商指定的传输要求。订阅条目则先确认已更新且服务仍有效。若有自己已有的另一条服务器，可在其余条件不变时做对照，但不要同时改写规则和测试方法。
只有部分域名失败时，再检查当前配置的 DNS 与规则去向。域名解析失败和远端连接失败并非同一问题；不要看到超时就直接替换所有 DNS 设置。可以在允许的条件下，用同一条目分别在 Wi-Fi 与蜂窝网络测试，以判断是否只在某个网络出现；测试时留意流量使用，并保持目标与路由姿态一致。
到 Settings 查看测试与诊断条件
进入 Settings（设置），先查看 Test Method（测试方法）。不同方法测试的环节不同，列表测试有响应而实际访问失败，并不矛盾。比较前后结果时，应尽量保持方法相同；不要仅凭一个延迟值判断服务器全部功能正常，也不要把测试失败直接解释为账号或应用购买出了问题。
再查看 On Demand（按需连接）。若连接总在手动断开后重新出现，检查是否已有按需连接条件在触发。首次排错可以先暂停相关条件，按 Home 的开关手动测试，确认基础连接后再恢复。On Demand 用于按条件发起连接，不能修复错误的服务器参数，也不能替代连通验证。
需要记录原因时，查看 Diagnostics（诊断）中的可用检查项及输出。记录错误类型、发生步骤、路由姿态和是否更换过网络，比只描述“连不上”更有帮助。向自己的服务商说明问题前，先遮去订阅地址中的凭据、密码、认证标识和个人网络信息，不要直接公开整份配置或完整诊断内容。
Settings 中的 Proxy、TCP、UDP 等选项不需要为了入门逐项调整。先保持当前值，只有在确认某个协议或网络条件相关时，再按具体说明修改。后续可阅读常见问题分类说明，或在使用手册中查找更完整的设置与维护步骤。恢复日常使用前，记得还原测试期间临时更改的路由姿态和按需连接条件。
