Shadowrocket 官方手册 · 上手操作
Shadowrocket
订阅导入与连接教程
以 iPhone / iPad 界面为例，先添加已有服务器，再选择路由方式、打开连接并验证结果。首次操作按下面五步进行，复杂配置留到连接可用之后。
步骤 01 · Add Server / Subscribe
添加服务器或导入已有订阅
打开 Shadowrocket，进入底部的 Home。尚未添加内容时，先找到 Add Server；也可以通过页面右上角的添加入口进入同一表单。这一步有两条路径：订阅链接用 Subscribe，单个服务器资料用对应的协议类型。先辨认手中资料的用途，不要把订阅地址直接填进 Host。
已有订阅链接：选择 Subscribe
进入 Add Server 后点开 Type，选择 Subscribe。返回表单，在订阅地址字段粘贴完整链接，再填写便于辨认的名称并保存。地址应从开头到末尾一次完整复制，尤其要保留问号后面的参数；不要加入聊天消息里的说明文字、引号、空格或换行。订阅地址通常包含个人凭据，应当像密码一样保管。
保存后回到 Home，等待订阅内容载入，再查看 SERVER 下是否出现相应分组及服务器。若只看到订阅名称而没有服务器，先检查更新是否完成以及是否出现错误提示，不要连续重复添加。重复导入同一地址可能使列表更难辨认，也不能修复地址失效的问题。
已有服务器参数：逐项填写 Add Server
如果拿到的是地址、端口、密码及协议说明，先在 Type 选中准确协议，再填写 Host 与 Port。Host 只填写服务商提供的主机名或 IP 地址；Port 填对应端口。Password、Method 等字段是否出现取决于所选 Type，并非每种协议都使用同一套字段。截图展示的是一种字段组合，切换协议后表单变化属于正常情况。
例如 Shadowsocks 要核对 Method 与密码是否成对匹配；Trojan 的密码与 TLS 相关设置也应照原始资料填写。若资料另列 SNI、传输方式或路径，应进入对应设置核对，不能仅凭端口号推断协议。不确定字段含义时先看术语表，参数值仍以自己的服务器资料为准。
已有二维码可在 Add Server 使用 Scan QR Code；扫描前需要允许相机访问，扫描后仍应检查识别出的 Type、Host 与 Port。剪贴板中如果是单个分享链接，可按应用出现的导入提示处理。Import from Cloud JSON 是另一种结构化资料导入入口，不等于普通订阅地址输入框，不能把不同格式混用。
本步完成标准：回到 Home 后，SERVER 中能找到准备使用的服务器。列表有名称只说明保存或导入完成，并不证明它已经能够连接；先继续选择 Global Routing，再进行连接测试。订阅更新、分组整理和批量管理见订阅与服务器管理手册。
步骤 02 · Global Routing / Config
选择 Global Routing 姿态
服务器添加完成后，回到 Home，点开 Global Routing。这里决定流量采用什么路由方式，而不是决定订阅如何更新。三个姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。开始前先明确本次要验证“服务器能否使用”，还是“自己的分流规则是否正确”，两者的检查目标不同。
配置(Config)：按配置规则处理
配置(Config)会按当前选中的配置文件进行匹配。需要规则分流时，先进入底部 Config，确认已有可用文件并选中它，再回到 Home 选择配置(Config)。规则具有顺序，先匹配到的规则通常决定该连接的处理方式；订阅里有服务器，不等于 Config 中已经配好了所需的全部策略。
官方截图展示 Config 内的配置编辑页面，可见 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段与 Add Rule。首次上手不需要逐项修改这些内容，也不要为完成连接而打开 HTTPS Decryption。若服务商给出了自己的配置说明，应先核对适用范围；没有把握时保留原配置，并在编辑前备份。
代理(Proxy)：用于隔离规则影响
代理(Proxy)让受当前代理连接处理的流量采用代理路径，适合在排查时暂时减少规则因素。选择后仍需在 Home 选中可用服务器，并打开顶部开关；仅改变 Global Routing 不会自动使服务器参数正确。如果 Proxy 下可访问，而 Config 下只有部分目标失败，接下来应重点检查规则命中和策略指向。
直连(Direct)：不经远端代理路径
直连(Direct)用于按直连路径访问，不适合证明远端服务器已可用。不要把“开关打开但选择了 Direct”当作服务器连接成功的证据。对比模式后应恢复自己计划长期使用的姿态，避免排错时的临时选择一直保留。
本步完成标准：返回 Home 时，Global Routing 一行显示的选项与预期一致。若选择 Config，还应知道当前启用的是哪份配置。DOMAIN-SUFFIX、GEOIP、FINAL 等规则词的解释可在术语表查阅，本页先不展开规则编写。
步骤 03 · Home / SERVER
选中服务器并打开连接
回到 Home，在 SERVER 分组中点选本次要使用的服务器，确认选择标记落在正确条目上。存在多个订阅时，先看清所属分组，再核对服务器名称；刚导入一份新订阅并不表示应用一定已切换到其中的服务器。若配置使用独立策略组，还要确认相关策略并未指向失效条目。
核对 Global Routing 后，打开 Home 顶部连接开关。首次连接时，系统可能请求添加 VPN 配置；确认这是由刚打开的 Shadowrocket 触发后，按系统提示允许，并完成设备要求的身份验证。这里使用的是设备自身的确认方式，不需要向订阅提供方发送设备解锁信息。
授权完成后回到 Shadowrocket，观察顶部是否由 Not Connected 变为 Connected。若系统授权后开关仍关闭，可以在回到 Home 后再打开一次；若马上关闭或持续无法建立连接，不要反复快速切换，先记下提示并跳到本页的设置与排错部分。
VPN 配置授权与服务器认证是两件事。允许系统添加配置，只表示设备允许建立这类网络连接；服务器端仍要核对地址、端口和认证参数。因此，Connected 是下一步验证的起点，不应直接当作所有网站、所有规则都已经正常的结论。
首次验证建议暂时保持 Home 可见，等连接状态稳定后再打开浏览器。若准备切换服务器或修改重要参数，先关闭连接、保存修改，再重新连接，便于确认当前测试对应的是哪一组设置。测试完成后需要停止使用时，回到 Home 关闭顶部开关。
本步完成标准：已选定服务器，系统授权已完成，Home 显示 Connected。接下来不要继续修改配置，先用固定目标验证实际访问结果，这样遇到问题时才能区分连接建立与应用访问两个环节。
步骤 04 · Connectivity Test
验证连接与实际访问结果
保持刚才选中的服务器与路由姿态，在 Home 使用 Connectivity Test。测试用于观察服务器在当前网络中的可达性，结果受 Test Method、网络环境与目标响应影响。出现时间数值不等于所有业务都可用；出现超时也不能只凭一次结果就断定密码错误，应结合后面的实际访问判断。
接着打开浏览器，访问一个自己知道正常、且与本次测试目的相符的目标。使用新页面或重新加载，避免仅看到此前缓存的内容。先用同一个目标完成一次检查，再更换目标；不要同时切换无线网络、服务器和 Global Routing，否则即使结果改变，也很难判断是哪一项起作用。
如果当前选择代理(Proxy)，重点确认所选服务器是否能够完成访问。如果当前选择配置(Config)，还需要区分该目标预期应走代理还是直连：规则要求 DIRECT 的访问成功，不能单独证明远端代理可用；预期走代理的目标失败，则应继续核对匹配规则及对应策略。
需要比较网络因素时，先记录当前状态，再只改变一个条件。例如保持服务器和配置不变，从无线网络切换到移动网络后重新测试。若同一服务器只在某一种网络失败，排查方向与“所有网络均失败”不同。不要单纯按延迟数字挑选条目，最终应以自己的实际访问是否稳定为依据。
本步完成标准：不仅看到 Connected，还能说明哪个目标已访问成功、使用哪种模式、测试时处于什么网络。若结果不符合预期，保留这三个条件，按下一步缩小范围；如果已经可用，再考虑整理名称、调整分组与备份配置。
步骤 05 · Settings / Diagnostics
按失败范围检查设置
排错先从发生问题的步骤开始：还未导入成功，就先查地址与格式；能看到服务器但测试失败，就先查服务器参数；显示 Connected 却只有部分访问异常，再查路由与解析。每轮只修改一个条件，并在修改后重复同样的测试。这样能保留清晰的因果关系，避免把原本可用的部分一起改乱。
订阅导入失败或更新后为空
重新核对订阅链接是否完整，是否多了空格，是否将单个服务器分享链接误当成 Subscribe 地址。若链接包含有效期或访问凭据，需从你的服务商处确认其当前状态。不要公开粘贴完整订阅地址求助，也不要连续创建同名订阅；先保留现有记录，再按错误提示处理。删除前应备份需要保留的自定义内容。
测试超时或连接立即断开
先确认设备在关闭连接时能正常访问普通网络，再核对所选服务器的 Type、Host、Port、认证信息及传输设置。某一条失败而同组其他条目正常，通常应优先检查该服务器资料；全部失败则还要检查当前网络、订阅状态与系统时间。TLS 相关连接依赖正确时间，可在系统日期与时间中核对自动设置，不要通过关闭证书校验代替诊断。
Connected 后仅部分目标异常
返回 Home 核对 Global Routing，确认没有遗留直连(Direct)。可临时比较代理(Proxy)与配置(Config)的结果：如果前者可用而后者失败，检查当前 Config 是否选中正确文件、规则引用的策略是否存在。若涉及 DNS 或某类应用的独立网络行为，先阅读相关术语，再调整配置，不要一次替换全部设置。
后台行为与 Settings 选项
进入底部 Settings，可以看到 Test Method、On Demand、Diagnostics，以及 Proxy、TCP、UDP 等设置分类。Test Method 会影响 Connectivity Test 的测试方式，因此不同测试方法的数值不宜直接比较。On Demand 与满足条件时的自动连接有关，不是修复错误服务器参数的开关；若手动断开后又自动连接，应先检查是否启用了对应规则。
仍无法定位时，可使用 Diagnostics 查看可用诊断信息。记录发生问题时的网络类型、Global Routing 选择、测试结果与提示文字，再决定是否需要咨询自己的服务商。分享截图或日志之前，遮盖订阅链接、密码、个人地址和其他凭据；SERVER 中的私人命名也应先检查。
本步完成标准：能把问题定位到导入、服务器、系统连接或配置规则中的一类。需要进一步整理多订阅、更新策略、删除与备份时，继续阅读订阅与服务器管理手册；只是不理解某个英文界面词时，使用术语表查阅即可，不必重做全部步骤。
