Shadowrocket 快速上手
添加、连接与验证
从已有服务器信息或订阅链接开始，依次完成导入、Global Routing 模式选择与连接检查。首次操作按顺序阅读；已完成导入可直接跳到连接步骤。
开始前：用户已装好 Shadowrocket，并已有自己的订阅链接或服务器信息。iPhone / iPad 从 App Store 获取，价格为 $2.99 一次性付费；Mac（Apple 芯片与 Intel）/ Windows / 安卓 / Linux 版从本站下载页免费安装。本教程以 iPhone / iPad 界面为例，系统要求以 App Store 页面标注为准。
客户端一次性买断 ≠ 线路套餐。本站不提供、不销售、不推荐节点或订阅；下文只说明如何导入与使用用户已有的配置。尚未安装时，先阅读下载指南。
01 · Add Server：添加已有服务器
打开 Shadowrocket 后进入 Home，找到 SERVER 区域的 Add Server，或使用页面上的添加按钮进入编辑页。先判断手中的资料类型：如果是一组服务器地址、端口、密码与协议参数，按本步骤填写；如果是一条用于更新服务器列表的订阅链接，直接阅读下一步 Subscribe。两种方式是导入路径的选择，不必把同一份资料重复添加。
进入 Add Server 后，先点 Type，选择资料中明确写出的协议，例如 Shadowsocks、VMess、VLESS 或 Trojan。Type 决定下方显示哪些字段，因此不要先填写密码再随意切换协议。以 Shadowsocks 为例，Host 填服务器域名或 IP 地址，Port 填端口，Password 与 Method 分别对应密码和加密方法。不同 Type 的认证字段并不相同，应以已有资料为准，不能把某一种协议的字段照搬给另一种。
Host 通常只填写主机名，例如 example.com，不要把完整网页地址连同路径一起放入；Port 是单独的数字字段。复制长密码时留意首尾空格和换行，Method 应与服务器端完全一致。若资料包含 TLS、SNI 或传输相关参数，也要逐项对应，不要为了减少填写项目而关闭必要选项。不确定参数含义时，先向原资料提供方核对，而不是连续尝试不同取值。
如果已有服务器二维码，可以使用 Scan QR Code 读取，再检查识别后的 Type、Host 与 Port。Import from Cloud JSON 是另一种配置导入入口，并不是填写任意订阅链接的位置；只有持有相应格式资料时才使用。确认字段后点页面的保存按钮，返回 Home，检查 SERVER 中是否出现新条目。条目出现只说明保存完成，尚不能证明连接成功；接下来仍需选择模式、开启连接并验证。
02 · Subscribe：导入已有订阅
如果手中是自己的订阅链接，在 Home 进入 Add Server，点 Type 选择 Subscribe，然后把完整链接粘贴到 URL 字段。订阅链接用于获取一组服务器资料，往往含有个人访问凭据；不要把它公开贴到评论、截图或聊天群中。填写便于自己辨认的备注即可，不需要修改链接里的查询参数，也不要用服务商的登录网页地址代替订阅地址。
保存后等待订阅请求结束，再回到 Home 查看对应分组。正常导入后，分组下会出现可选择的服务器条目；只有分组名称而没有条目时，应先检查更新是否完成，而不是立刻打开连接开关。部分订阅可能返回错误信息或不受支持的内容，这时要确认复制的是完整订阅链接，并检查它是否仍有效。导入订阅不等于导入规则文件，下一步的 Config 仍需单独确认。
以后需要刷新列表时，使用该订阅分组对应的更新操作，等待请求完成后再查看条目变化。服务器清单由订阅返回的内容决定，本地手动改动可能在下次更新时被覆盖。对需要长期保留的个人调整，先确认它属于订阅条目、独立服务器还是规则配置，避免混淆三者。已有单条服务器且不使用订阅的用户，可跳过本步继续。
若显示更新失败，先确认设备当前网络能访问订阅地址，再核对链接是否少了一段或带入了空格。不要反复删除后重建同一订阅，以免丢失原先用于比较的状态。订阅能更新也不代表其中每一条服务器都可连接；选择一条后仍需执行后面的连接检查。更完整的异常分类见常见问题中的连接排查。
03 · Global Routing：选择模式与规则
服务器保存完成后，返回 Home，点 Global Routing 查看路由模式。三种姿态分别为配置(Config)、代理(Proxy)、直连(Direct)。这里决定请求按什么方式处理，不是选择服务器协议；改变它不会替用户补齐服务器资料，也不会自动修复过期订阅。初次使用时，先理解当前模式再连接，避免开关已开启却对访问路径产生误判。
| 模式 | 作用与使用前提 |
|---|---|
| 配置(Config) | 依照当前选中的配置文件匹配规则，分别使用 PROXY、DIRECT 等策略；前提是已经有适用配置。 |
| 代理(Proxy) | 将由客户端处理的请求按代理方式转发，适合临时对照服务器连接，不代表规则文件正在分流。 |
| 直连(Direct) | 按直连方式处理请求，可用于对照本地网络，不能用它证明服务器代理连接正常。 |
日常需要规则分流时，先进入 Config 页面确认存在配置文件并已选中，再返回 Home 选择配置(Config)。打开配置文件可看到 General、Rule、Hosts 等分段；初次操作只需检查 Rule 的策略是否符合自己的用途，不必同时修改 URL Rewrite 或 HTTPS Decryption。这些功能不属于首次连接的必需步骤，不应为了尝试连接而额外启用。
Rule 中的规则通常从上到下匹配，命中后使用对应策略。PROXY 表示使用代理策略，DIRECT 表示直连，REJECT 表示拒绝；FINAL 用于前面规则都未命中时的兜底。不要只看到 FINAL 就认为所有请求都会走同一路径，它仍取决于前面是否已有匹配项。已有配置正常工作时，先保持原样完成连接；规则写法与优先级另见Config › Rule 手册。
如果暂时没有规则配置，可用代理(Proxy)对照已知可用的服务器，验证后再处理分流配置。完成模式选择后返回 Home，确认 Global Routing 一行显示的是刚选的姿态，再进入下一步。每次排查最多只改变一个条件，才能区分问题来自服务器还是规则。
04 · Home：打开开关并允许 VPN 配置
回到 Home，在 SERVER 中点选本次要使用的服务器，确认选中标记，再核对 Global Routing。不要把“条目已经添加”与“条目已经选中”混为一件事；当列表中有多个分组时，尤其要确认当前选择属于哪一组。连接前记下本次使用的服务器和模式，后续测试才能有明确的对照条件。
打开页面顶部 Not Connected 所在行的连接开关。首次使用时，系统可能请求允许 Shadowrocket 添加 VPN 配置，按提示选择允许，并通过设备密码或系统要求的认证方式确认。此权限用于让系统建立由应用管理的网络连接，并不是再次购买客户端。若当时取消授权，返回应用后重新开启连接，再按系统提示处理即可。
授权后回到 Shadowrocket，观察顶部状态是否完成切换。如果开关立即关闭、状态一直无法进入连接状态，先停止连续点击，转到失败点排查。系统已有其他正在工作的 VPN 连接时，也要检查是否产生冲突，不要让多个应用在排查期间反复接管连接。对设备管理策略限制的情况，应先确认设备是否允许创建或使用此类配置。
连接状态建立后，仍要继续验证实际访问。系统 VPN 标识只表示相关网络连接处于活动状态，不能证明所有目标都能打开，也不能代替 DNS 与规则检查。需要主动断开时，回到顶部关闭开关；若关闭后又自动连接，下一步排查应查看 On Demand，而不是直接删除全部服务器资料。
05 · Connectivity Test：验证是否生效
在 Home 点 Connectivity Test，等待测试完成。先看所选服务器是否有可用的测试结果，再打开浏览器访问平时使用的网页，检查页面是否真正加载完成。Connectivity Test 的结果受测试方法与目标影响，它不是整条访问链路的完整证明：测试可达，不代表域名解析、网站证书、登录状态和所有应用请求都正常。
建议在同一个本地网络下，用同一页面做前后对照。先记录连接开启时的结果，再在需要时断开复测；不要同时切换无线网络、服务器、模式和 DNS，否则即使恢复也难以判断是哪项起了作用。使用配置(Config)时，不同域名可能分别走 PROXY 或 DIRECT，一个直连页面能打开，并不能证明代理策略对应的服务器可用。
若测试失败但网页可以正常使用，先查看 Settings 的 Test Method，确认测试方式与服务器支持情况，而不是仅凭一次结果删除条目。若测试有结果但网页打不开，则转查域名解析和规则；必要时临时用代理(Proxy)与配置(Config)做对照，完成后恢复预期模式。对照过程中仍保持同一条服务器，避免把服务器差异误认为规则差异。
验证通过后，保留这组可复现的设置，再逐项增加自己的规则调整或 On Demand 条件。正常使用不需要频繁更换测试方式，也不应把单次测试数值当作长期表现。想进一步了解测试与网页访问为何可能不一致，可阅读连接相关常见问题。
06 · Settings：按现象排查失败点
先关闭连接，确认设备本身可以正常上网，并完成当前网络可能要求的登录。接着按“资料是否正确、连接能否建立、请求怎样路由、域名能否解析”的顺序检查。每次只改一项，复测后记录结果；不要一开始就重装应用或清空所有配置，这会丢失用于定位问题的上下文。
订阅导入失败，或服务器无法测试
先核对完整订阅链接、有效状态和当前网络，再检查单条服务器的 Type、Host、Port 与认证字段。手动添加时常见的错误是协议选择不符、密码多出空格或漏填传输参数。订阅能更新而单条服务器无法连接时，应分开看待更新地址与服务器连接，不要认为更新成功就意味着服务器必然可用。
开关立即关闭，或断开后自动重连
开关立即关闭时，检查系统 VPN 配置授权是否完成，以及其他 VPN 是否正在占用连接。断开后自动重连时，进入 Settings 查看 On Demand，排查期间可暂时关闭它，再手动连接复测。On Demand 控制按条件建立连接，不会修复密码、服务器地址或规则内容；确认普通连接正常后，再按实际网络条件配置它。
连接建立，但网页打不开
先检查 Global Routing 是否误选直连(Direct)，或配置(Config)中的规则是否将目标交给了不符合预期的策略。如果代理(Proxy)可以访问、配置(Config)不行，优先检查规则命中与配置选择。如果两种模式都失败，再结合 DNS 和服务器参数继续判断。不要把所有访问失败都归因于 DNS，也不要一次粘贴多组未知解析地址。
DNS 的具体位置与选项可能随配置和平台界面变化，调整前先记下原值；不了解覆盖关系时，保持当前配置，并按Settings › DNS 手册逐项核对。Settings 中还可看到 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 等项目，这些项目用途不同，不应全部开启。首次上手只处理与当前现象直接相关的项目。
提交排查信息前先整理复现条件
需要查看 Diagnostics 或分享日志时，先复现一次问题，记录本地网络类型、当前模式、出错步骤以及是否所有目标都失败。分享前遮盖订阅链接、密码、个人服务器信息与可识别的访问记录。描述“能导入但无法连接”或“已连接且测试有结果，但特定网页打不开”，比只提供一张开关截图更有助于区分问题。更多情况转到连接排查 FAQ，设置项的含义则查阅选项手册。
