Shadowrocket 入门指南
订阅导入、模式选择与首次连接。按五个步骤操作，先验证一条可用路径，再调整规则。
本页只讲第一次使用需要完成的操作；配置字段与匹配顺序见配置字段参考。
添加服务器与订阅
先把已有的信息保存到客户端。导入成功只表示条目已添加，是否能连接还需要后续验证。
从 Home 打开 Add Server
打开 Shadowrocket，停留在 Home。找到 SERVER 分组下方的 Add Server，点击后进入添加页面。先确认手中的是订阅链接、单条服务器分享信息，还是一组需要手动填写的连接参数。这三种资料的用途不同，不要把订阅地址填进服务器的 Host，也不要把单条分享信息当成配置文件导入。
如果资料来自自己的服务商，先阅读随附说明，确认协议、有效状态以及是否需要补充参数。订阅链接通常包含访问凭据，应完整复制，注意聊天软件可能附带的空格或换行。不要把链接提交到公开页面，也不要为了检查格式而将它粘贴到不明网站。
已有订阅：使用 Subscribe
在 Add Server 中点击 Type，选择 Subscribe，再把自己的完整订阅链接填入对应的 URL 字段；如有备注字段，可以填写便于辨认的名称。确认链接未缺少尾部字符后保存，等待客户端拉取内容。完成后返回 Home，检查是否出现订阅分组及其中的服务器条目。分组名存在但没有条目时，不应继续反复打开连接开关，而应先确认订阅是否成功解析。
订阅更新是从原地址重新获取服务器列表，不等于延长服务有效期。首次导入失败时，先确认设备本身可以联网，再核对链接是否过期或被复制截断；不要连续创建多个相同订阅，以免后面选错分组。更新方法与错误原因可继续阅读订阅更新说明。
手动填写或扫描已有二维码
如果拿到的是服务器参数，在 Type 选择与资料一致的协议，再按要求填写 Host、Port，以及该协议所需的 Password、Method 或其他字段。不同 Type 显示的字段不同，截图中的字段不是所有协议都必须填写的通用清单。不要仅凭服务器名称猜测协议，也不要随意更改端口、加密方式或传输参数。
已有二维码时，可使用 Scan QR Code 读取，并按系统提示允许相机访问。读取后先核对识别出的类型与地址，再保存。Import from Cloud JSON 是另一种导入入口，只有资料明确要求使用该格式时再选择，不要把普通订阅地址依次尝试填入所有入口。保存返回 Home 后，在 SERVER 中点选准备使用的条目，再进入下一步选择模式。
选择 Global Routing
服务器决定代理连接使用哪个条目，Global Routing 决定请求采用哪种处理方式。两者需要分别确认。
区分三种常用姿态
回到 Home，点击 Global Routing，先识别配置(Config)、代理(Proxy)、直连(Direct)三种姿态。配置(Config)根据当前生效配置中的规则分流；代理(Proxy)用于让请求采用代理路径，便于初次检查所选服务器；直连(Direct)用于直接连接，不用于证明代理出口已经生效。切换姿态不会修复错误的服务器密码，也不会自动补全配置文件。
第一次操作时，如果已经有明确用途的配置文件，选择 Config，并检查当前选中的配置。如果暂时只想确认服务器能否使用，可以短暂选择 Proxy 做访问对照，测试完成后再切回日常需要的姿态。不要在不清楚当前模式的情况下，同时修改服务器和规则，否则即使恢复访问，也难以判断是哪一项调整起了作用。
在 Config 核对当前配置
进入 Config，找到准备使用的配置文件，确认它是当前选用的配置，再查看其中的 Rule。官方截图展示配置编辑页中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段；这些分段各有用途，首次连接不需要逐项改动，更不需要为了完成本教程开启 HTTPS Decryption。配置文件与服务器订阅并不是同一份资料，导入订阅不代表已经配置好规则。
下面的 Rule 片段只用于理解语法：访问 example.com 及其子域名时使用 PROXY，其余请求交由 FINAL 指定的 DIRECT。它不是完整配置文件，也不是推荐给所有网络环境的默认规则。规则通常按列表顺序检查，较早命中的规则会影响结果，FINAL 应作为末尾兜底。需要添加规则时可以使用 Add Rule，但应先了解所选类型的匹配范围。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT先保留一份可正常使用的原配置，再做单项修改。如果不确定 DOMAIN-SUFFIX、IP-CIDR 或策略名的含义，请先阅读规则与配置参考；本页接下来先完成连接与验证，不要求立即编写一整套分流规则。
打开开关连接
完成条目与模式选择后，再处理系统权限。连接开关与实际访问结果需要分别检查。
确认 SERVER 与顶部开关
返回 Home，查看 SERVER 中当前选中的条目是否属于刚才添加的订阅或服务器。若订阅里包含多个条目，先选一个已知可用的条目，不要在连接过程中连续切换。再看一眼 Global Routing，确认保留的是上一阶段选择的姿态。截图中顶部显示 Not Connected，是尚未连接的状态示例，不是导入失败的提示。
点击顶部连接开关。首次连接时，系统可能弹出添加 VPN 配置的授权提示；阅读提示后选择允许，并根据系统要求使用设备密码或生物识别完成确认。此处授权是让 Shadowrocket 创建系统连接配置，不是再次导入订阅，也不是购买服务器服务。授权完成后回到 Home，等待状态变化，再进入下一步测试。
没有连接时先看权限
如果刚才拒绝了提示，返回应用重新尝试连接，按实际出现的系统提示完成授权。若开关立即回到关闭状态，先检查系统设置中的 VPN 配置是否还在，以及是否有其他正在运行的 VPN 连接产生冲突。不要反复删除全部系统网络设置；先记录具体提示，再根据常见问题确认处理方法。
连接状态变化表示系统连接流程已经启动，但不保证目标服务器、域名解析和分流规则全部正常。系统状态栏的 VPN 标记也不能替代网页访问测试。先保持服务器、模式和配置不变，转到下面的验证步骤，这样出现问题时才有稳定的对照条件。
验证连接与规则
分开检查测试结果、实际访问与规则命中，避免把一个状态标记当作全部结论。
先测试，再访问实际网页
在 Home 点击 Connectivity Test，等待测试完成。测试使用的方式会影响结果：某个测试没有响应，不一定表示所有应用都无法访问；显示测试结果，也不意味着每个域名都会命中预期规则。先记录本次结果，不要据此立即批量删除服务器。需要查看测试方式时，可到 Settings 中识别 Test Method，首次验证期间尽量保持它不变。
接着打开浏览器，先访问一个平时确定可用的网页，确认设备仍然具备基础网络访问能力；再访问一个按当前配置应走代理的网页，等待页面实际加载，而不是只看旧标签页留下的内容。必要时重新载入或新开标签页，减少缓存对观察的干扰。如果使用 Direct，该网页能够打开也不能证明代理路径可用，必须结合当前姿态判断。
用单一变化做对照
如果 Proxy 可以访问而 Config 不可以，先保留同一个服务器，检查当前配置的规则、解析设置与最终策略。如果两种姿态都无法访问，应优先回头核对服务器信息和可用性，而不是继续堆叠规则。在应用提供的连接记录或 Data 中查看目标请求时，重点确认目标域名、命中的规则和策略是否符合预期；没有看到记录时，也不要仅凭猜测认定请求已经走过代理。
验证完成的标准是：所选条目保持正确、连接状态稳定、实际页面能够加载、需要分流的请求采用预期策略。完成这些检查后再恢复日常使用的 Config，并复测一次。后续若要使用 On Demand，应另行设置适用网络条件；它是按条件触发连接的功能，不是服务器不可用时的修复开关。
排查常见失败点
一次只改变一个条件。先检查资料与服务器，再检查权限、模式、DNS 和规则。
订阅没有内容或服务器不可用
如果导入后没有出现服务器，先回到订阅编辑页面检查链接完整性、资料格式和更新错误提示。订阅已失效、返回内容不是服务器列表、设备无法访问订阅地址，都可能导致导入失败。若列表正常但某个条目连接失败，核对 Type、Host、Port 与认证信息；必要时向自己的服务商确认该条目的有效状态。列表能够更新和服务器能够连接是两件事，不能相互替代。
开关打不开或连接后无法访问
开关打不开时，先检查系统 VPN 授权和应用提示；开关已打开但网页无法访问时，先保持当前服务器不变，确认 Global Routing 没有停在与预期不符的 Direct，再做 Proxy 与 Config 的单项对照。若设备断开 Shadowrocket 后也无法访问普通网页，应先处理 Wi-Fi、蜂窝网络或系统网络问题，而不是继续修改客户端参数。
只有部分域名或应用失败
部分目标失败时，应记录具体域名、失败发生的网络环境，以及是否只有 Config 下出现。检查当前配置中的 DNS 与 Rule，但不要仅因为网页打不开就把所有 DNS 项改成同一个地址。解析过程和连接过程都可能失败，需要结合诊断信息区分。若新增规则后才出现问题，先恢复该项修改，再按同一目标重测，同时检查 FINAL 是否把未匹配请求交给了预期策略。
Settings 中可以找到 Diagnostics，以及 Proxy、TCP、UDP 等相关设置入口。首次排错先查看已有诊断信息，不要同时改动多个高级选项；协议或目标应用对传输方式的要求不同，随意切换容易引入新的变量。On Demand 也建议在手动连接验证完成后再配置，以免自动重连影响测试时的观察。
保留有效信息，遮盖凭据
需要进一步排查时，记录设备网络类型、当前 Global Routing、失败目标和错误提示，并注明问题出现在导入、授权还是实际访问阶段。分享截图或日志前，遮盖订阅链接、服务器认证字段和个人信息。完整的逐项检查见开关已打开却无法上网；账号、权限与常见导入问题见常见问题，无需在本教程中继续修改全部高级配置。
