官方手册 / 首次配置

Shadowrocket 使用说明

订阅导入、Global Routing 与连接验证。按顺序完成一次配置，再逐项检查结果。

本教程面向 iPhone 与 iPad。先准备自己的连接资料，再操作 Home、Config 与 Settings。界面语言或应用布局可能有差异，以下按英文界面词定位；系统要求以 App Store 页面标注为准。

阅读顺序：先让 SERVER 中出现自己的服务器，再选模式、建立连接。每完成一步就核对一次，避免同时修改多个设置。

STEP 01 / Add Server · Subscribe

添加服务器或导入订阅

打开 Shadowrocket，进入 Home。先看下方的 SERVER 区域：如果列表还是空的，连接开关暂时不能代替服务器资料。找到 Add Server，或使用页面上的添加入口进入 Add Server。接下来按手中资料的类型选择一种方式即可，不必把同一份信息同时用多种方式重复导入。

有订阅链接：选择 Subscribe

在 Add Server 的 Type 中选择 Subscribe，找到订阅地址输入项，粘贴自己服务商提供的完整链接。不要只复制域名，也不要漏掉地址后面的路径和参数。填写便于辨认的名称后保存，等待订阅内容获取完成，再回到 Home 检查列表。如果当前界面显示订阅分组，展开该分组，确认其中已有具体服务器，而不只是一个分组名称。

订阅链接可能包含用于识别账户的参数，应当像密码一样保管。粘贴前后只在自己的设备上核对，不把完整地址放入公开截图或聊天记录。保存地址与成功获取内容是两件事：若分组已经出现但没有服务器，先检查更新是否成功，不要立刻尝试连接空列表。后续重新获取订阅时，服务器名称和数量也可能随用户已有服务内容变化。

有单个服务器信息：逐项填写

手动添加时，先选对 Type，再按该类型显示的字段填写。截图中的 Host、Port、Password、Method 对应特定类型的表单，不能把它们当成所有协议通用的固定字段。Host 填服务器地址，Port 填端口；其余认证、传输和 TLS 等项目，应与自己已有资料逐项一致。不要根据名称猜协议，也不要把一个协议的密码填到另一个协议的身份字段里。

如果服务商提供的是兼容二维码，可使用 Scan QR Code 并按系统提示允许相机访问；Import from Cloud JSON 只用于相应格式的资料，不是普通订阅地址的通用入口。导入后仍要进入条目检查 Type、地址与端口。想了解各字段之间的区别，可先看概念速查，本步骤只要求信息完整且与原始资料一致。

本步完成标志：回到 Home，SERVER 中出现能辨认的具体服务器，打开条目后关键字段与已有资料相符。此时只代表资料已经录入，不代表服务器一定可达；先继续选择 Global Routing，再进行连接和访问验证。

Shadowrocket 的 Add Server 官方截图，显示 Type、Host、Port、Password、Method，以及 Scan QR Code 和 Import from Cloud JSON 入口 — Add Server：先选 Type，再按自己已有的资料填写对应字段。

STEP 02 / Global Routing · Config

选择 Global Routing 工作姿态

服务器录入完成后，回到 Home，点开 Global Routing。这里决定连接按哪一种姿态处理，不负责替你获取服务器，也不会修复填写错误的端口或认证信息。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。先理解区别，再选择符合当前目的的一项，避免仅凭名称判断是否已经生效。

配置(Config)：根据当前选中的配置文件处理连接。规则可以让不同目标分别使用 PROXY、DIRECT 或 REJECT；实际结果取决于规则内容与顺序。
代理(Proxy)：把常规连接交给当前代理策略处理，适合暂时减少规则差异、检查服务器访问能力。它不是对所有应用和流量结果的绝对保证。
直连(Direct)：按直连姿态处理连接。可以用于与原有网络作对照，但不能用直连网页打开的结果证明代理服务器正常。

准备按规则使用时，选择配置(Config)，再进入底部的 Config 页面。检查当前选中的文件是否确实是自己打算使用的文件；仅导入或编辑一个文件，不等于它已经成为当前配置。进入对应文件后，可以看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。入门阶段先关注 Rule，不必为了连接服务器把所有分段都修改一遍。

在 Rule 中，规则通常按顺序匹配；具体目标命中前面的规则后，后面的兜底规则不会再替它作决定。例如下面的教学片段把 example.com 及其子域名交给 PROXY，把私有网段交给 DIRECT，其余连接使用 FINAL 指定的策略。这只是语法示例，不是可直接替代个人完整配置的文件，也不提供任何连接资料。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

初次操作不要急着点 Add Rule。先保留原配置副本，确认当前文件与已有服务器的用途相符，再决定是否修改某一条规则。若自己的配置使用了额外策略名称，还要核对这些名称是否存在以及指向何处。规则关键字的详细含义见概念速查；复杂的命中顺序和异常排查留到故障排查手册。

本步完成标志：Home 的 Global Routing 显示预期姿态；如果选择配置(Config)，能够指出当前正在使用的配置文件。接下来回 Home 选择服务器并连接，不要在连接前连续改动规则、DNS 与传输参数。

Shadowrocket 的 Config 官方截图，显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 分段与 Add Rule — Config：核对当前文件，规则分流主要从 Rule 分段检查。

STEP 03 / Home · SERVER

选中服务器，打开连接开关

回到 Home，在 SERVER 中选择自己要使用的具体服务器。确认当前选择标记落在目标条目上，而不是只打开了它的编辑页面。列表中有多个条目时，先选一个资料已核对的服务器作为测试对象，不要在尚未验证时频繁切换，否则后面很难判断是哪一项改变了结果。

选好服务器后，打开 Home 顶部的连接开关。首次建立连接时，系统可能提示添加 VPN 配置；这项权限用于让 Shadowrocket 通过系统网络扩展处理连接，不等于系统已经确认服务器可用。核对弹窗中的应用名称，选择允许，并按设备要求完成 Face ID、Touch ID 或设备密码认证。认证在系统界面内完成，不需要把设备密码填入 Add Server。

如果此前取消过权限请求，返回应用再次操作开关，并留意系统是否重新出现确认界面。若系统限制不允许添加 VPN 配置，先在设备设置中核对相关限制；受组织管理的设备应遵循管理策略。不要反复删除不认识的描述文件，也不要为了测试移除自己不了解的管理配置。

完成授权后回到 Home，观察顶部是否仍停留在 Not Connected，以及开关是否能保持开启。若开关立即回落，先记下应用或系统给出的提示，再进入最后一步排查。若开关保持开启，仍需继续验证：这只能说明本地连接流程已经建立，不足以证明远端服务器、DNS 或每一条分流规则都正常。

连接过程中保持当前网络相对稳定。刚从 Wi-Fi 切到蜂窝网络、设备进入弱信号区域或热点发生变化，都可能让测试结果前后不同。需要对比两种网络时，先在一种网络上完成完整验证，再切换另一种并重新测试；不要把网络切换与协议参数修改放在同一次尝试里。

如发现关闭后又自动开启，检查是否启用了 On Demand。它与按网络条件自动连接有关，不是新的服务器来源。初次排错可先记录原设置，再暂时关闭相关自动连接条件，以便手动控制每一次测试。应用窗口回到后台也不等同于关闭连接，判断时仍以应用状态及系统 VPN 状态为参考。

本步完成标志：系统授权已完成，Home 顶部状态不再停留在 Not Connected，且开关没有立即回落。保持当前服务器和 Global Routing 不变，下一步检查真实网页请求，不要仅凭开关就结束配置。

Shadowrocket 的 Home 官方截图，顶部为 Not Connected 开关，下方显示 Global Routing、Connectivity Test、SERVER 分组与 Add Server — Home：截图展示未连接状态；先选择 SERVER 中的条目，再操作顶部开关。

STEP 04 / Connectivity Test · Data

验证访问结果与规则策略

保持连接开启，在 Home 找到 Connectivity Test 并执行测试，等待结果返回。它用于提供连通性线索，测试方式会影响结果的含义。出现数值不等于所有网页、所有协议都正常；测试失败也需要结合当前网络和测试方法判断，不能直接认定整份订阅失效。先记录当前服务器、网络类型与测试现象，便于前后比较。

接着打开浏览器，访问一个自己确认地址正确、平时可以访问的网页。优先使用普通网页，不要一开始就用大型下载或长视频验证。先看域名能否解析、页面主体能否加载，再观察图片等资源是否完整。若只是旧页面仍然显示，重新载入或打开新的页面请求，避免把浏览器缓存当成刚刚建立的网络访问。

使用配置(Config)时，一次成功访问可能走的是 DIRECT，而不是 PROXY。要验证分流，应选择一个自己知道应由 PROXY 处理的目标，再选择一个预期 DIRECT 的目标分别检查。不要使用陌生域名来猜测规则效果，也不要把“网页打开”直接理解成“该网页经过所选服务器”。是否经过代理，需要结合配置内容和连接记录判断。

返回 Shadowrocket，在 Data 中查看当前可用的连接或流量记录。不同界面布局的记录入口可能有差异，重点是找到刚刚发起的请求，并核对目标域名、使用的策略，以及界面提供的规则匹配信息。若记录显示 DIRECT，就回到 Config 检查该目标为什么命中直连规则；若显示 REJECT，先检查是否命中了阻止策略，而不是不断换服务器。

如果记录没有出现预期域名，先确认自己看的是本次请求，且连接处于开启状态。某些应用会复用已经建立的连接，因此修改模式后应重新发起请求再对比。一次只改一个变量：例如暂时由配置(Config)切到代理(Proxy)作对照，完成测试后恢复原姿态，并重新检查同一目标。这样才能判断差异是否来自规则。

本步完成标志：可以重新加载测试网页，并能把这次请求与预期的模式或策略对应起来。若部分网页仍失败，保留成功与失败各一个例子，进入下一步按症状检查，而不是重新从头填写全部资料。

STEP 05 / Settings · Diagnostics

常见失败点的检查顺序

排错先确定失败发生在哪一步。订阅内容获取失败、服务器测试失败、开关无法保持开启、网页请求失败，属于不同环节。先保留当前配置，记下已选服务器与 Global Routing，再按下面的顺序缩小范围。每次只修改一处，重新发起同样的请求；没有改善时恢复原值，不把多次尝试叠成一份难以解释的配置。

订阅保存了，却没有服务器

返回 Subscribe 对应条目，核对链接是否完整、是否多了空格或换行，以及更新时是否出现错误。检查设备时间是否准确，当前网络能否获取订阅内容，并确认自己的订阅仍然有效。订阅地址是获取服务器列表的地址，不应直接填到普通服务器的 Host 中。若错误涉及服务端返回内容或账户状态，应向自己的服务商核实，本站无法代替其确认。

开关开启，但测试或网页失败

先核对当前选择的服务器，再检查 Type、Host、Port 以及认证字段。延迟测试可用而网页失败时，还要核对传输、TLS 等参数；部分测试结果不能验证这些字段全部正确。然后检查 Global Routing：直连(Direct)不用于证明代理正常，配置(Config)则要看请求是否命中了预期规则。可短暂使用代理(Proxy)做同目标对照，结束后恢复原设置。

部分域名失败，或加载停在某个资源

在连接记录中核对是否出现域名解析失败，或请求是否被送到 REJECT。DNS 是把域名解析成地址的环节，不能仅凭服务器测试数值判断其正常。不要一次替换所有 DNS 设置，也不要直接照抄不理解的完整配置。先用同一个失败域名复测，保存原值，再查看DNS 排查章节，按症状继续检查。

连接反复变化，或需要查看诊断信息

进入 Settings，核对 Test Method 与当前测试目的是否一致；有自动连接现象时检查 On Demand。需要进一步定位时查看 Diagnostics 提供的信息，先关注错误出现的时间、目标与类型，不必改动所有 Proxy、TCP、UDP 选项。Settings 中的 Language 与 Today Widget 等项目不负责修复服务器认证错误，排错应围绕发生故障的环节进行。

准备向自己的服务商说明问题时，可整理设备当前网络、所选协议、错误现象与已完成的对照步骤。分享前移除订阅链接、密码、身份标识、完整配置中的私密字段及其他个人信息；不要把整份配置公开粘贴。iPad 同样按此顺序排查，横竖屏或布局变化不会改变服务器资料必须一致这一前提。

下一步：若已经能稳定访问，保留当前可用配置，并记下选择的服务器与姿态。若仍无法定位，到故障排查按具体症状继续阅读；对 Subscribe、DNS、FINAL 等概念不清楚时，先查概念速查，再返回本教程复测。