Shadowrocket 入门教程
从已有资料开始，依次完成添加、选择模式、连接和验证。先让一条连接正常工作，再调整规则或自动连接设置。
下面的配图为 App Store 官方截图，用来识别页面与字段。实际选项会随协议和应用界面变化；只填写自己的资料，不照抄截图中的示例内容。订阅链接、密码和配置文件可能包含访问凭据，请勿公开分享。
Add Server / Subscribe：添加已有资料
订阅链接与单台服务器参数是两种不同的输入。按手头资料选择一种方式，不必同时执行。
已有订阅链接：选择 Subscribe
打开 Shadowrocket 的 Home，在 SERVER 分组找到 Add Server，进入添加页面。点开 Type，选择 Subscribe，再把自己的完整订阅链接填入 URL 字段。保存前核对开头的协议、路径和查询参数，确认复制时没有带入说明文字、换行或首尾空格。备注只用于辨认，不能代替实际链接。
保存后回到 Home，等待订阅内容载入。成功取得资料后，应能在列表中看到订阅分组及其服务器条目；若只出现订阅名称却没有可选条目，不能视为导入完成。先确认链接是否仍有效，再使用该订阅项提供的更新操作。订阅更新会重新取得远端内容，不等同于备份本地修改，因此首次使用阶段先保持原有参数。
已有服务器参数：按 Type 逐项填写
若手头是单台服务器的地址、端口和认证资料，在 Add Server 的 Type 中选对应协议，再填写 Host、Port 及该协议要求的字段。Shadowsocks 的 Method、Trojan 的 TLS 相关参数、WireGuard 的密钥并不能互换。界面会根据 Type 显示不同选项；资料缺少必填内容时，应先向自己的服务商核实，不用猜测值填满表单。
Host 通常填写资料指定的域名或地址，Port 填写对应端口。Password 的大小写与特殊字符需要完整保留。如果资料另外给出 SNI、传输方式或路径，逐项对应到当前协议页面；不要把浏览器页面地址直接当成服务器地址。保存并返回 Home 后，核对备注及类型，避免将刚添加的条目与已有条目混淆。
已有二维码：使用 Scan QR Code
若已有资料以二维码提供，可在 Add Server 使用 Scan QR Code，按系统提示授权相机后扫描。识别完成仍要检查 Type、地址与端口，再保存。二维码承载的是具体资料，不能从一张普通网页图片推断服务器参数。Import from Cloud JSON 是另一种导入入口，不应把订阅链接随意填入该流程。
Global Routing：选择连接模式
三种姿态写作配置(Config)、代理(Proxy)、直连(Direct)。模式决定处理路径，不负责补齐或修复服务器资料。
回到 Home，点开 Global Routing 查看当前选项。日常按规则使用时选择配置(Config)；需要临时检查代理路径时，可选择代理(Proxy)；希望请求走直连路径时，选择直连(Direct)。完成选择后返回 Home，确认 Global Routing 一行显示的是刚刚选中的值，再进行连接。
配置(Config)：先确认当前配置文件
Config 按当前配置中的规则决定请求如何处理。进入底部 Config 页面，确认正在使用的配置文件；需要查看内容时打开相应文件的编辑入口，可看到 General、Rule、Hosts 等分段。首次使用不必逐段修改，先检查 Rule 是否符合自己预期。若使用已有配置，优先阅读它的说明，而不是把多个来源的规则直接拼在一起。
下面只展示规则含义，不要求在首次连接时粘贴。DOMAIN-SUFFIX 匹配域名后缀，匹配后交给指定策略；FINAL 是前面的规则都未匹配时的兜底。示例中的 example.com 不是可用服务器地址，PROXY 也不是订阅名称。修改前保留原文件，避免一次调整规则、DNS 和连接参数后无法判断是哪项变化产生了影响。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT代理(Proxy)与直连(Direct)：用于区分路径
Proxy 用于让请求使用代理路径，适合在短时验证中区分“服务器连接问题”与“规则匹配问题”。Direct 使用直连路径，因此即使连接开关打开，也不能据此认定网站正在经由服务器访问。这里的选择仍需结合实际配置与应用设置判断，不将一种模式作为所有问题的通用解决办法。
如果临时切换 Proxy 后目标页面可用，而恢复 Config 后异常，应回头检查配置和规则顺序，而不是重复导入同一份订阅。更细的规则解释见功能说明；需要系统排查时阅读疑难手册。确认模式后，下一步才打开连接开关。
Home：选服务器，再打开开关
列表里有条目不等于已经选中；开关打开也不等于所有目标网站都已通过验证。
回到 Home，在 SERVER 分组中点选这次要使用的服务器。确认该条目左侧出现选择圆点，再检查 Global Routing 是否仍是上一部选定的姿态。仅打开条目的编辑页面、查看参数后返回，并不能代替点选默认服务器；有多个分组时，尤其要确认圆点对应的是哪一条。
接着打开 Home 顶部开关。未连接时顶部可见 Not Connected，开始连接后观察状态变化。第一次建立连接，系统可能询问是否允许 Shadowrocket 添加 VPN 配置。阅读弹窗中的应用名称与说明，确认是在本次操作中触发，再选择允许，并按系统要求完成设备验证。此步骤是系统为应用建立网络连接配置，不是再次购买。
授权完成后返回 Shadowrocket，检查开关是否保持开启、顶部是否离开 Not Connected 状态。如果开关立即回落，先看应用显示的错误信息，不要连续快速点击。若之前拒绝了授权，可以重新尝试连接并处理系统提示；设备受管理或系统限制时，相关权限也可能影响配置建立，应先核对设备允许的操作范围。
首次验证期间，暂时不要让其他 VPN 连接同时参与测试，也不要立刻启用 On Demand。先通过手动开关建立一个可重复的过程：选中同一服务器、使用同一网络、打开连接，再检查结果。状态栏中的 VPN 标识只能说明系统存在 VPN 连接状态，不能证明某一个域名实际采用了预期策略。
Connectivity Test：分开检查连接与访问
按“测试结果 → 实际访问 → 规则路径”的顺序确认。一次测试成功，不代表所有网站和所有请求类型都可用。
先在 Home 使用 Connectivity Test，等待当前测试返回结果。测试用于提供连通性线索，结果会受测试方法、测试目标与当前网络影响。出现超时时，记录它发生在哪个服务器、哪种网络下；出现响应结果时，也不要只凭显示数字判断长期速度。这里应比较的是同一条件下能否完成测试，而不是追求某个固定数值。
随后打开浏览器，访问一个已知正常且适合当前网络环境的页面。先完成一次普通网页加载，再试原本需要验证的目标。若浏览器一直停留在旧页面，可以重新载入或打开新的标签页，避免把缓存内容当成连接已经生效的证据。测试中保持服务器不变，才能将当前结果与上一步对应起来。
使用配置(Config)时，还要确认目标请求是否本来就应走 PROXY。规则从上到下匹配；目标若命中 DIRECT，能够打开页面不代表代理路径已经验证成功。反过来，某个页面无法打开，也不能直接证明整个服务器失效。可以在保留原配置的前提下短时切换代理(Proxy)复测，完成后恢复原姿态，并把两次结果一起记录。
如果普通页面可访问，但只有某个网站异常，优先检查该目标对应的规则、DNS 解析与站点自身状态；如果所有页面都异常，先关闭连接开关检查原网络。原网络也无法访问时，先恢复网络本身，再回到本教程继续。需要进一步区分这些情况，可查阅常见问题与按症状组织的疑难手册。
Settings：按失败位置逐项检查
保留当前资料，每次只改一项。先定位失败发生在导入、授权、连通性还是规则处理阶段。
添加失败或订阅列表为空
先回到添加资料这一步，核对 Type 与输入内容是否匹配。Subscribe 需要完整订阅链接，单台服务器需要对应协议的参数；两者不能混填。订阅无法更新时，检查链接是否过期、当前网络是否能访问其地址，以及资料提供方是否要求额外操作。不要反复新建同名订阅，否则容易混淆后续选中的服务器来自哪一组。
开关无法保持或连接后全部不可用
开关无法保持时，先核对系统 VPN 配置授权，再查看应用错误提示。开关能保持但无法访问时，检查是否选中了正确服务器，以及 Host、Port、Password 和协议附加字段是否与原资料一致。临时关闭连接后，确认原网络可以正常上网；原网络正常再打开连接，重复同一测试，才能判断问题是否跟随服务器设置出现。
Connectivity Test 超时或结果不一致
进入 Settings 查看 Test Method，确认当前采用的测试方式。不同测试方式检验的条件不同，结果不能混为同一个指标。若调整测试方式，应记录调整前后的设置，再对同一服务器复测；不要同时修改端口、DNS 和测试方式。需要在 Wi-Fi 与蜂窝网络间比较时，也一次只换网络，保留其余条件。
连接自动变化或个别网站异常
在 Settings 核对 On Demand。如果已经启用，按需连接条件可能影响自动建立连接的时机；首次排错先暂停自动连接，再用手动开关复现问题，完成后按需要恢复。个别网站异常时，优先回到 Config 检查 Rule 与当前 Global Routing，不要为了单个目标直接改动所有 Proxy、TCP、UDP 选项。
需要进一步定位时，可在 Settings 查看 Diagnostics。整理问题时记录“当前模式、选中服务器、网络类型、测试是否超时、实际访问现象”，比只写“连不上”更有帮助。向他人提供诊断信息前，隐藏订阅 URL、认证字段和其他个人资料；不要直接公开完整配置文件。涉及 DNS、耗电或更新后异常的长流程，转到疑难手册按对应症状处理。
至此，已完成从导入到验证的基本闭环。关于购买、授权和资料管理的简短解释见常见问题；需要理解各项能力的适用范围，可继续阅读功能说明。
