iPhone / iPad · 首次配置
Shadowrocket 快速上手
按“添加资料 → 选择路由 → 连接 → 验证”的顺序操作。先确认每一步的界面状态，再继续下一步；遇到失败时，从最近改动的一项开始核对。
本页是首次操作路线。订阅整理、字段解释与更新策略见服务器管理手册。
以下截图来自 App Store，具体按钮位置及文字以当前应用内显示为准。建议先完整读完一个步骤，再对照自己的屏幕操作。
步骤 01 / 准备连接资料
添加服务器或导入已有订阅
先判断手头是哪种资料：如果是一组单独的服务器参数，就使用 Add Server；如果是一条由你自己的服务商提供、用于更新服务器列表的链接，就使用 Subscribe。两者是不同的录入方式，不必把订阅链接填进单个服务器的地址栏。开始填写前，保留原始资料以便逐项比对，尤其不要漏掉端口、认证字段或协议附加选项。
手填时，在服务器列表找到 Add Server，进入后先选 Type，再按已有资料填写地址、Port 与相应的认证信息。不同 Type 显示的字段可能不同：例如某些配置需要 Password 与 Method，另一些还会要求与服务端一致的传输或安全设置。截图中的地址字段写作 Host；录入时以当前页面上的字段名和你持有的资料为准。不要因为某个字段暂时看不到，就把它的值挪到别的字段。
若持有的是订阅链接，进入 Subscribe 的添加入口，完整粘贴链接，保存后执行更新，再回到服务器列表检查是否出现预期项目。链接里若有查询参数，应从开头到结尾一起复制；空格、换行或被聊天工具截断的末尾字符都可能影响读取。订阅更新只负责读取已有资料，不能替代服务商侧的有效状态。导入后先确认列表有内容，再从中选中一个属于自己的服务器，不要仅凭“已保存订阅”就认为已经完成连接。
如持有二维码，可在 Add Server 页面查看 Scan QR Code；如持有适用的配置文件，可核对 Import from Cloud JSON 的入口及文件格式。这些入口适用于不同形式的已有资料，无法保证任意文本互相通用。第一次操作建议只采用与你实际资料相符的一种方式，保存、核对列表后再进入下一步。单个字段的详细对照与多份订阅的整理方法，见服务器管理手册。
步骤 02 / 确定流量如何处理
选择 Global Routing 姿态
服务器已加入列表后，先不要急着反复切换连接。返回 Home，找到 Global Routing，确认当前采用哪一种姿态。这里的选择决定连接建立后流量如何处理，与“选中了哪台服务器”是两件事。先确定你希望按配置文件分流，还是采用统一处理方式，后续验证结果才有可解释的依据。
三个常见姿态分别是配置（Config）、代理（Proxy）和直连（Direct）。Config 按当前配置文件中的规则处理不同请求；Proxy 适合暂时检查流量经所选服务器处理时的表现；Direct 则用于检查直连状态。做日常规则分流时，先选 Config，并确认所用配置文件就是自己打算使用的那份。切换姿态后，之前的验证结论可能不再适用，下一步需要重新检查。
如果选择 Config，进入配置相关页面核对规则文件是否存在，以及规则是否按预期组织。官方截图中的 General、Rule、Hosts、URL Rewrite 与 HTTPS Decryption 是不同的配置段落；本次只需认识 Rule 所在位置，不必为了完成首次连接而逐项修改。Add Rule 用于添加规则，填写前应明确匹配条件和处理结果。例如 DOMAIN-SUFFIX,example.com,PROXY 仅展示规则语法，其中 example.com 是示例域名，不是需要照抄的目标。
先用现有配置完成一次连接和验证，再决定是否要调整规则。若直接改动多条规则，出现异常时就难以分辨是服务器信息、路由姿态还是匹配条件导致。PROXY、DIRECT 等规则关键字及匹配顺序可查术语表；配置文件的管理与备份步骤见服务器管理手册。确认 Global Routing 后，再回到 Home 打开连接。
步骤 03 / 建立连接
在 Home 打开连接开关
回到 Home，先看服务器列表里是否选中了刚才核对过的项目，再看 Global Routing 是否仍是预期姿态。Home 截图可用于辨认顶部连接开关、SERVER 分组及 Connectivity Test 的相对位置；截图上的 Not Connected 表示当时尚未连接，并不是你操作后必须看到的结果。以自己设备上的实时状态为准。
确认所选项目后，打开 Home 顶部的连接开关。首次建立连接时，系统可能显示添加 VPN 配置的授权提示；阅读系统弹窗，并按提示完成授权，才能让应用请求系统建立连接。这是系统级提示，不等于订阅导入或服务器参数已经正确。完成授权后返回 Shadowrocket，观察 Home 上的连接状态是否发生变化，等待连接过程结束后再进行测试。
如果开关很快回到关闭状态，先不要连续快速重复点击。回看服务器是否确实选中、资料是否完整，以及当前网络是否可用，然后按第五步的顺序排查。若 Home 显示已连接，也只说明当前连接状态发生了变化，还不能单凭开关判断目标访问一定符合预期。保持这时的服务器选择与 Global Routing 不变，继续做连通检查和实际访问核对，才能区分“已连接”与“按预期工作”。
在 iPad 上仍按相同顺序寻找 Home、SERVER、Global Routing 与连接开关；屏幕排版可能与 iPhone 不同，不必依照截图的像素位置逐个寻找。首次操作的关键是记录自己选中的服务器与路由姿态，测试失败时才能回到同一条件复查。有关应用获取与首次打开的说明，可看iPhone 说明或iPad 说明。
步骤 04 / 区分连接状态与实际结果
用 Connectivity Test 验证是否生效
连接状态稳定后，回到 Home 使用 Connectivity Test。先留意测试开始前的条件：使用的是哪一个服务器、Global Routing 选了 Config 还是 Proxy、测试时设备接入的是哪一个网络。测试结果应和这些条件放在一起看，而不是只保留一个成功或失败的印象。如果刚刚修改过服务器或规则，重新运行测试，避免把修改前的结果当成当前结果。
连通测试之后，再打开你原本需要访问的目标，观察实际表现。Connectivity Test 检查的是其测试项目的连通情况，不能代替所有应用和网站的使用结果。尤其在 Config 姿态下，不同请求可能命中不同规则；某一项测试有结果，不代表每个目标都会按同一方式处理。如果某个目标未按预期工作，记录目标、当时的 Global Routing 姿态及是否使用了自定义规则，再去检查对应的 Rule，而不是立即重填所有服务器字段。
需要缩小问题范围时，可以暂时选择 Proxy 进行对照，完成测试后再恢复原先的 Config。若两种姿态表现不同，重点检查配置文件、规则匹配和规则顺序；若两种姿态都无法完成预期访问，则先回查服务器资料与连接状态。Direct 可用于核对直连条件下的表现，但切换到 Direct 后不应再把该结果当作经所选服务器处理的证据。每切换一次姿态，都要重新测试。
排查时尽量只改变一个变量：例如保持同一服务器和网络不变，仅切换 Global Routing；或保持路由姿态不变，仅重新核对一个服务器字段。这样才能知道哪项改动影响了结果。关于规则关键字、测试含义和常见状态的解释，可分别查阅术语表与疑难解答。如果已经得到预期结果，首次配置到这里即可结束，暂时不需要修改更多 Settings 选项。
步骤 05 / 从输入到系统逐层检查
连接失败时按顺序排查
先从输入资料检查。手填项目逐项比对 Type、地址、Port、认证字段及该 Type 需要的附加设置，注意数字、大小写与前后空格。订阅项目则核对链接是否完整、是否成功更新，以及更新后服务器列表是否真的出现内容。列表为空与列表有内容但无法连接是两类问题：前者先查链接和更新结果，后者再查所选服务器及其参数。订阅更新失败的逐项清单见订阅更新排查文章。
接着检查选择状态。Home 的 SERVER 分组中应选中准备使用的项目；仅添加、保存或更新资料，不会替你完成选择。核对 Global Routing 是 Config、Proxy 还是 Direct，并确认自己正在用对应姿态解释测试结果。如果只有 Config 下某个目标异常，而 Proxy 下的对照测试正常，就查看当前配置文件中的 Rule；不要把所有异常都归因于订阅本身。若刚改过规则，先恢复到可以确认的状态，再一次只调整一条。
最后查看系统连接状态与 Settings。确认 Home 开关状态和系统授权过程已经完成，再查看 Settings 中与当前排查有关的 On Demand、Diagnostics、Test Method 等项目。On Demand 会影响符合条件时的连接行为；不确定现有规则如何生效时，先记录原设置，再做对照测试。Diagnostics 可作为检查线索，但仍要结合 Home 状态、实际访问结果与自己持有的服务器资料判断。截图中的其他 Settings 分类不是首次连接的必填清单，不需要逐个改动。
如果更换网络后表现不同，分别记录两种网络下的测试结果，避免一边换网络一边改服务器字段。若自己的资料在服务商侧有变更，应以服务商提供的当前信息重新核对；本站只解释应用中的填写和检查位置。完成一次排查后，把服务器选择、Global Routing 姿态和改动过的 Settings 项目恢复到你打算日常使用的状态，并重新运行 Connectivity Test 与实际访问检查。更多按现象分类的步骤见疑难解答。
