Shadowrocket 使用教程
订阅导入与连接验证
先让一条已有服务器完成连接，再检查规则分流。以下以 iPhone 与 iPad 为对象，按实际操作顺序说明入口、预期结果与失败后的下一步。
- 01 导入信息
- 02 选择模式
- 03 打开连接
- 04 验证结果
- 05 定位问题
添加服务器 / 导入订阅
本步完成标志：Home 的 SERVER 分组出现你自己的服务器条目。
先判断手中的资料属于哪一类。单台服务器资料通常包含协议、地址、端口和认证字段；订阅链接则用于获取并更新一组服务器条目。两者不能互相代填：不要把整条订阅链接放进单台服务器的 Host，也不要把只有域名和端口的文字当作完整订阅。开始前保留原始资料，避免在多次复制过程中丢失字符。
手动填写 Add Server
打开 Home，在 SERVER 分组找到 Add Server 并进入。先选择 Type，再按该协议显示的字段填写。以截图中的表单为例，Host 是服务器地址，Port 是端口，Password 与 Method 应与已有资料一致；选择其他 Type 后，出现的字段可能不同，应以对应协议资料为准，而不是照着截图把所有字段都填一遍。
地址与端口分开填写，留意复制后首尾的空格、换行及全角标点。密码、认证标识等内容区分大小写时，必须保留原样；Method 也不能凭名称相近自行替换。若资料中还有传输或安全相关参数，应展开对应设置逐项核对，不要为了让表单更短而删除已有参数。填写后保存，回到 Home 检查条目名称，确认保存的是刚才输入的服务器。
通过 Subscribe 导入已有订阅
已有订阅链接时，使用 Config 页的 Subscribe 入口，核对所选项目接受的是服务器订阅还是配置文件地址；在要求 URL 的位置粘贴已有链接，确认保存并执行更新。不要把仅用于打开账户页面的普通网页地址当作订阅。界面入口若因当前页面状态不同而变化，应根据 Subscribe 的项目说明判断内容类型，最终以 Home 是否出现服务器条目作为服务器导入的检查点。
保存成功不等于获取成功。回到 Home 后，若分组为空，应先检查更新结果，再核对链接完整性与当前网络能否获取订阅。链接可能含个人访问凭据，不要在公开截图或留言中完整展示。二维码资料可使用 Scan QR Code 读取；读取后仍需核对生成的服务器字段。Import from Cloud JSON 接受的是相应格式内容，不是任意订阅链接的通用替代入口。
确认列表已有条目后，先不用连续更新或重复导入。保留一个易于辨认的条目，继续选择 Global Routing；重复导入带来的相似名称会让后面的服务器选择更难核对。入口与格式的进一步区别见订阅导入常见问题。
选择 Global Routing 与当前配置
本步完成标志：能说明当前模式，以及请求应走哪一种连接路径。
服务器已经存在之后，回到 Home，点 Global Routing 检查当前姿态。这里决定请求如何分流，不负责补齐服务器资料。初次操作最容易混淆的是“已经导入服务器”和“已经启用配置”：前者提供连接目标，后者决定哪些请求使用该目标，二者需要分别确认。
三种姿态的选择依据
配置(Config)按当前配置文件中的规则决定请求使用 PROXY、DIRECT 或 REJECT 等策略，适合已有明确分流配置的使用场景。它不是“所有请求都经过当前服务器”的同义词。如果某个域名被规则指定为 DIRECT，即使连接开关已经打开，该请求也可能直接连接。
代理(Proxy)用于让普通请求采用代理路径，适合首次检查所选服务器是否能够承载实际访问。它不能把错误的服务器字段变成正确资料，也不能替代系统授权；系统与应用的特定流量处理仍受相关设置约束。直连(Direct)用于直接连接，适合与代理路径作基础对照，不应在选择它之后又把“访问路径没有经过服务器”判断为连接故障。
Config 页检查什么
准备使用配置(Config)时，进入 Config，确认当前选用的文件是你希望启用的那份。官方截图展示配置编辑中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段，以及 Add Rule 入口；这些分段承担不同职责，不需要为了完成首次连接而逐一改动。服务器订阅更新成功，也不代表当前规则文件已经切换或更新。
例如下面这条规则表示按域名后缀匹配并选择 PROXY。它仅用于解释语法，example.com 是示例域名；一条规则不构成适用于所有请求的完整配置。规则的排列顺序、兜底策略和当前文件是否被选用，都会影响最终结果。
DOMAIN-SUFFIX,example.com,PROXY首次检查可以先使用代理(Proxy)验证已有服务器，再切换配置(Config)观察分流差异。每次切换只改变这一项，并记录测试对象，避免同时换服务器、换模式又改规则，导致结果无法比较。配置文件结构与匹配顺序请继续阅读规则手册，本教程先保留已有配置，进入连接步骤。
选中服务器，打开 Home 连接开关
本步完成标志：服务器选中标记明确，系统授权完成，连接状态保持。
回到 Home，在 SERVER 分组点选本次要使用的服务器，查看条目旁是否出现选中圆点。列表里有服务器不等于已经选定默认服务器，打开某条目的编辑页面也不等于完成选择。若有多个分组，先记下选中项所在分组与名称，之后测试时保持不变，便于将结果对应到同一条资料。
确认 Global Routing 后，打开 Home 顶部连接开关。尚未连接时，截图顶部显示 Not Connected；实际操作中应观察开关与连接状态是否随操作改变，而不是只看列表中是否有延迟结果。首次启用时，系统可能提示添加 VPN 配置，核对提示中的应用名称，允许后按系统要求完成设备认证，再返回 Shadowrocket。
该授权是让应用建立系统网络连接所需的配置权限，不是导入服务器的过程，也不会自动生成订阅或补充认证资料。若刚才取消了弹窗，先回到应用再次尝试连接；若设备受管理策略限制或系统明确阻止修改，应先确认设备的允许范围，不要通过反复切换开关来猜测结果。
授权后给连接过程一点时间，观察状态是否稳定。如果开关刚打开就回落，先记录当时提示，再检查是否已有其他 VPN 连接正在使用，或系统配置是否尚未完成。不要立刻删除当前应用及所有配置；先保留原有信息，后面的排错步骤可以区分授权问题与服务器问题。
当开关保持打开、状态显示已连接时，仍只能说明系统连接通道已经建立，不能据此判断每个网站都会成功访问。下一步应使用 Home 的 Connectivity Test 与真实访问交叉验证。这个区分很重要：系统状态、服务器响应和规则命中是三层不同结果，任何一层都不应代替另外两层。
Connectivity Test 与实际访问验证
本步完成标志：测试结果与实际访问能够对应，模式切换的影响可以解释。
保持刚才选定的服务器与 Global Routing，在 Home 点 Connectivity Test，等待本轮检查完成。测试用于观察服务器在当前测试方式下的响应情况，并不是对所有协议、所有目标和所有网络条件的完整认证。出现响应数值不代表每个目标都可访问；出现超时也要结合 Settings 中的 Test Method 判断，不能只凭一次结果删除服务器。
接着打开浏览器或需要联网的应用，访问自己平时使用、地址明确的页面。确认页面确实重新请求了内容，而不是仅展示之前的缓存；必要时刷新一次，或重新打开该页面。先只测试一个目标，把服务器、模式、网络类型和结果对应起来，成功后再扩大检查范围，比同时打开许多页面更容易判断。
如果代理(Proxy)下访问正常，切换配置(Config)后只有某个目标失败，应优先检查当前配置文件及该目标命中的策略，而不是立即判断服务器失效。Config 中 DIRECT、PROXY 与 REJECT 的结果不同，连接开关一直打开也不会消除这些区别。需要进一步核对时，结合应用可查看的连接记录，确认目标域名与策略，再到规则手册查匹配顺序。
如果 Connectivity Test 有响应但实际访问失败，下一步核对协议参数、目标请求类型及当前规则；如果测试与实际访问都失败，则先检查当前网络是否可正常联网，再检查服务器资料。Wi-Fi 与蜂窝网络的结果可作为对照，但切换网络后应重复同一项测试，不能拿两个不同目标的结果直接比较。
常见失败点与 Settings 检查
按层定位，每次只改一项；已有可用配置先保留。
导入后没有服务器
先回到导入入口看保存与更新是否都完成。订阅内容、配置文件和普通网页用途不同，链接能够在浏览器打开不等于它返回了可识别的服务器内容。核对链接是否完整、是否被复制工具换行、访问凭据是否仍有效；如果原始资料已经变化，应依据你自己的最新资料更新。不要在空列表状态反复打开连接开关，这不会补全缺失的条目。
开关回落或已连接但没有响应
开关回落时优先看系统 VPN 授权、应用提示和当前是否存在连接冲突。开关保持而请求失败时，再核对服务器选择、Type、Host、Port、认证与传输参数。即便名称相同，不同服务器的字段也不应拼在一起使用。确认一次只测试一个选中项，并在修改保存后重新发起连接，让后续结果对应到最新设置。
测试超时或网络切换后异常
进入 Settings 查看 Test Method，了解当前测试采用的方式，再解释 Connectivity Test 的结果。测试方式的变化可能改变响应表现，不意味着服务器资料本身发生变化。对于切换网络或断开后又重新连接的现象，检查 On Demand 是否按你的预期启用；初次排错先记下它的状态，避免把按需连接触发的行为误判成开关失灵。
Settings 中还有 Diagnostics、Proxy、TCP、UDP 等项目。Diagnostics 适合在基础检查后收集进一步线索；Proxy、TCP、UDP 涉及更具体的连接行为，不建议为了尝试而同时更改。某些网络对不同传输的处理不同，单个网页成功也不能证明所有类型请求都已通过。先复现问题，再根据实际协议与错误信息检查相应项目。
准备进一步排查时保留什么
保留失败发生在哪一步、当前模式、网络类型以及可复现的错误文字。如果需要提供截图，先遮盖服务器认证、个人订阅地址和其他敏感字段；不要把完整配置直接公开。回退到上一组可用设置后重复同一测试，可以判断问题是否由本次调整引入，比一次清空全部资料更有依据。
完成首次连接后，日常使用只需围绕已有服务器与明确的分流目标逐步调整。关于订阅更新、授权提示与连接问题，继续查看FAQ；关于 General、Rule 与策略关键字，进入规则手册。如果目前已经能够稳定复现一次成功访问，先保留当前配置，不必为了完成教程而改动其余高级设置。
