Shadowrocket 使用教程
从已有资料开始，依次完成添加、模式选择、连接与验证。先让一条连接可复测，再调整规则和自动化设置。
开始前 / 准备范围
准备应用与已有连接资料
本文只讲 iPhone 与 iPad 的首次使用流程。设备兼容性与系统要求以 App Store 页面标注为准；尚未完成购买安装时，先阅读正版核对与安装说明，再回到本页。操作前保留原始资料，修改已有配置时先留一份副本，避免把能够使用的设置覆盖。
订阅链接是一段用于获取服务器列表的地址；单条服务器信息则通常包含协议、地址、端口与认证字段。两者的录入入口相近，但填写方式不同。先判断手里是哪一种资料，再选下面对应的路径，不要把订阅地址整段填进服务器的 Host，也不要把单条参数当成配置文件导入。
本页配图均为 App Store 官方截图，用于辨认页面与字段。应用内项目可能随当前配置、协议和界面语言有所不同，以设备实际显示为准。完成前四步后再处理 On Demand 等自动化设置，首次排查期间尽量保持网络环境不变。
01 / Add Server · Subscribe
Add Server：添加服务器或导入订阅
打开 Shadowrocket，停留在 Home。下方的 SERVER 分组用于显示服务器记录，点击 Add Server 进入填写页面。接下来只选择一种导入方式：已有订阅链接走 Subscribe；已有一条完整服务器参数则选择对应协议。二维码也必须来自用户已有资料，识别后仍应检查内容，不能只凭显示名称判断参数正确。
已有订阅链接：选择 Subscribe
- 进入 Add Server，点击 Type，在类型列表中选择 Subscribe。
- 在 URL 字段粘贴完整订阅链接。粘贴后检查开头、结尾及查询参数，避免复制时带入说明文字、换行或漏掉字符。
- 保存并返回 Home，等待订阅内容获取完成，再查看 SERVER 分组下是否出现记录。
订阅地址可能包含访问凭据，不要把完整链接贴进公开讨论或截图。若保存后未出现记录，先看是否有获取失败提示，再向提供原始资料的一方核对链接是否有效、内容是否适用于 Shadowrocket。单纯重新命名订阅不会修复地址错误；反复新增同一个订阅还会增加辨认难度，应先检查已有条目。
以后需要更新订阅时，对已有订阅执行更新即可，再检查列表中的服务器是否发生变化。订阅更新解决的是列表同步，不等同于修复所有连接问题。更新后如果原来选中的记录被移除，应重新选择一个现有记录，再继续连接验证。
已有服务器参数：逐项核对 Type
在 Add Server 中先设置 Type，再填写 Host、Port 及该协议要求的认证字段。官方截图展示了包含 Password、Method 的表单；选择其他 Type 后字段会不同，不能把截图当作所有协议的固定填写模板。Host 填服务器域名或地址，Port 按原始资料填写，不要自行猜测或沿用另一条记录的值。
例如 Shadowsocks 的 Method 与 Password 必须对应原始参数；Trojan、VLESS 等类型出现 TLS、SNI 或其他传输字段时，也应逐项照资料核对。不要为绕过错误而随意关闭证书校验。协议字段看不懂时，先查概念速查，确认含义后再改动。
如果资料是二维码，可使用 Scan QR Code；Import from Cloud JSON 则是另一种结构化资料入口，不是填写普通订阅链接的替代位置。保存后返回 Home，确认 SERVER 中已有可选择的记录。此时只完成了资料录入，还没有证明服务器可用，下一步先决定请求应按哪种模式处理。
02 / Global Routing · Config
Global Routing：先确认三种姿态
回到 Home，点击 Global Routing。这里选择的是请求处理方式，不是新增服务器，也不会代替服务器认证。首次使用时要明确区分配置(Config)/代理(Proxy)/直连(Direct)，否则容易把“模式与预期不一致”误判成“导入失败”。
| 姿态 | 处理方式与核对点 |
|---|---|
| 配置(Config) | 按当前启用配置的规则与策略处理请求。先检查 Config 页选择了哪个文件。 |
| 代理(Proxy) | 以代理方式处理请求，适合临时核对当前代理路径。仍受应用和系统的实际处理范围约束。 |
| 直连(Direct) | 使用直连方式，不应把预期代理效果作为此姿态的验证目标。 |
使用 Config 前，核对当前配置文件
如果已有需要使用的配置文件，进入底部 Config 页面，确认文件已存在并已选用；只把文件加入列表，不代表它已经成为当前生效配置。需要查看内容时打开相应文件的编辑页面，辨认 General、Rule 等分段。右侧官方截图展示配置编辑内容，并不意味着首次使用必须逐段手写。
服务器订阅与规则配置是两类资料：前者主要提供连接记录，后者决定 DNS、匹配规则和相关行为。导入订阅之后，不应直接假设已经获得完整的分流规则。若尚未准备配置，可先用代理(Proxy)进行短暂连通性核对，确认服务器路径可用，再回到配置(Config)整理规则；测试结束后恢复原本需要的姿态。
只认识最小规则，不急着增加复杂度
下面两行是阅读示例，不要求在首次连接时粘贴。它们用来说明：同一条连接可以因请求目标不同而得到不同策略。修改任何文件前，应先确认现有配置的策略安排。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT第一行按域名后缀匹配 example.com 及其子域名，命中后使用 PROXY；第二行 FINAL,DIRECT 在前面规则都未匹配时使用 DIRECT。example.com 只作为语法示例。Rule 中的顺序会影响结果，因此验证某个网站是否经过代理，不能只看已选择的服务器，还要看对应请求命中了哪条规则。
本阶段只需记住当前姿态和当前配置文件名称。需要了解 General、Rule、Host 与 URL Rewrite 的完整写法时，继续阅读规则与配置参考；现在先回到 Home，保留已经确认的选择，准备建立连接。
03 / Home · SERVER
Home：选中服务器，再打开连接
回到 Home，在 SERVER 分组点击本次要使用的服务器，确认选中标记落在目标记录上。列表中存在某条记录与当前使用该记录是两件事；尤其订阅包含多个记录时，应明确本次选择，避免测试期间来回切换而无法比较结果。
- 检查 Global Routing 是否为上一步确定的配置(Config)或代理(Proxy)。若选择配置(Config)，再次确认 Config 中的当前文件。
- 打开 Home 顶部连接开关。首次建立连接时，系统可能提示添加 VPN 配置，阅读提示后允许，并按设备要求完成身份验证。
- 返回 Shadowrocket，查看顶部状态是否从 Not Connected 变为已连接状态，观察开关是否保持开启。
VPN 配置授权是让应用建立系统网络连接所需的步骤，不会自动补全服务器字段，仍需使用自己已有的连接资料。若刚才点了取消，返回 Home 重新打开连接开关，并完成系统提示即可。不要因为一次授权被取消，就删除全部服务器或重建配置文件。
如果开关立即回落，先确认系统授权是否完成，再检查是否有其他正在工作的 VPN 配置影响当前连接。对已有配置只做必要核对，不要直接批量删除设备中的网络设置。若系统界面仍显示异常，先断开、返回应用确认资料，再重新连接一次。
开关保持开启，只能说明连接流程已进入相应状态，不能单独证明目标网站访问成功，也不能证明每条请求均按预期分流。先保留当前服务器、模式与网络环境不变，接着使用 Connectivity Test 和浏览器做交叉验证。
04 / Connectivity Test
验证生效：测试结果与实际访问分开看
在 Home 点击 Connectivity Test，观察当前测试是否返回结果。这个操作用于提供连通性线索，不等同于对所有网站、所有协议和所有规则的完整验证。测试失败需要继续定位；测试有结果，也仍要打开浏览器检查实际使用目标。
- 先访问一个在当前网络中原本可以打开的页面，确认基础网络仍正常。若基础网络本身中断，应先恢复网络，而不是继续修改代理参数。
- 再访问一个按当前模式或规则预期需要代理的目标页面。刷新页面或发起新请求，不要仅凭之前缓存的页面判断。
- 若使用配置(Config)，对照规则检查该目标应当走 PROXY、DIRECT 还是 REJECT。必要时查看应用可用的请求记录，再与预期比较。
“页面打开了”与“页面经过代理”不是同一结论。配置中的 DIRECT 本就允许部分请求直连；如果目标命中了直连规则，即使页面可访问，也不能拿它证明代理路径正常。同样，某个页面加载不全，可能涉及不同域名分别命中不同规则，应先辨认失败的请求，而不是立即把全部规则替换掉。
如果需要进一步区分服务器问题与规则问题，可以记录原姿态，临时改为代理(Proxy)，断开并重新连接后访问同一个目标。Proxy 可用而 Config 不可用时，优先检查当前配置、DNS 与规则；两者都失败时，优先检查服务器参数与网络条件。这只是缩小范围的方法，不是对原因的最终判定。
验证完成后，恢复日常需要的 Global Routing 姿态，并再发起一次实际访问。若仍有问题，把异常归入下面的具体阶段：资料没有导入、连接不能建立、连接后全部失败，或只有部分目标失败。按阶段处理比反复打开开关更容易找到原因。
05 / Settings · Diagnostics
常见失败点：按发生阶段排查
先记住失败发生在哪一步，再进入 Settings 查找相关诊断入口。Test Method 会影响测试方式，不同测试方法可能得到不同结果；On Demand 则用于按条件连接，不是首次手动连接的必要步骤。首次排查先用手动开关复现问题，避免自动连接行为干扰判断。
导入后没有记录：回看资料类型与链接
如果 Home 的 SERVER 分组没有新增内容，回到订阅条目核对 Type 是否为 Subscribe、URL 是否完整，以及是否出现内容获取失败提示。检查当前基础网络能否使用，并向原始资料提供方核对有效状态。若是手动添加，确认已经保存，而不是仍停留在编辑页；字段缺失应按原始资料补齐，不要用猜测值填满表单。
开关不能保持开启：先检查系统授权
确认添加 VPN 配置的系统提示已完成，设备没有停留在待验证状态，再返回 Home 重新操作。若设备受管理策略限制，应按设备管理要求处理。此类问题发生在连接建立阶段，优先检查系统状态，不应先改 Rule 或 URL Rewrite；规则调整不能代替系统授权。
已连接但全部访问失败：检查服务器与 DNS
重新打开所选服务器的编辑页面，依次比对 Type、Host、Port、认证字段和 TLS 相关项目。域名不能解析、服务器暂时不可达、认证不匹配，都可能表现为连接后无法使用。订阅用户可先更新一次已有订阅，再确认选中的记录仍然存在；如果原始资料已变化，应以当前有效资料为准。
接着检查 Global Routing 与 Config 中的 DNS 设置。之前手动改过 DNS 时，先记录改动，再恢复已知可用的设置进行比较，不要同时新增多个未经确认的解析地址。DNS 只负责解析链路的一部分，改动解析设置不能修复错误的密码、端口或服务器证书问题。
只有部分目标失败：检查规则与测试范围
若代理(Proxy)能够访问而配置(Config)不能，先检查目标命中的规则、规则顺序以及最终的 FINAL 策略。较宽泛的规则写在前面，可能让后面的具体规则没有机会匹配；REJECT 也可能是配置明确安排的结果。先在副本中做最小调整，再重新发起目标请求验证，不要直接清空原文件。
Connectivity Test 与浏览器结果不一致时，进入 Settings 核对 Test Method，并确认两次测试的目标与网络环境是否一致。需要进一步分析可查看 Diagnostics，但诊断内容只是线索，应结合服务器参数和规则判断。对外分享前，移除完整订阅 URL、Password、认证参数及可识别的个人信息，保留错误现象和必要字段名即可。
仍未定位时，按“当前姿态、是否完成授权、测试结果、失败目标、最近一次修改”整理记录，继续查看疑难解答。需要逐行检查配置，则阅读规则参考。先保住一组能重复验证的设置，再逐项增加功能，避免把入门问题扩展成多个相互影响的改动。
