Shadowrocket 使用教程

先判断手里的信息是什么，再决定添加方式。一条用于更新服务器列表的完整链接，通常应按 Subscribe 导入；一组明确列出的协议、地址、端口与认证参数，则按单个服务器填写。订阅链接与配置文件链接的用途不同，不应仅凭链接外观互换入口。无法确定类型时，先查阅这份已有信息附带的说明。

通过 Add Server 手动填写

打开 Shadowrocket 的 Home，在 SERVER 区域找到并点按 Add Server。进入后先选择 Type，再填写 Host、Port 和相应认证字段。Type 决定后续显示哪些字段；例如图中的 Password 与 Method 对应当前选定类型，并不意味着每一种协议都使用相同项目。应按照自己的参数逐项对应，不要为了填满页面而补写不需要的内容。

Host 填服务器域名或地址，Port 填服务器给出的端口。注意不要把网页地址中的路径、整条订阅链接或多余空格填进 Host。密码、加密方法及其他协议参数需要与已有信息一致，不能通过猜测补齐。若原始信息缺少必填项，应先向信息提供方核实，再返回填写。

完成后使用页面上的保存操作，返回 Home。确认 SERVER 下出现新条目，名称能与自己的记录对应，再点选它。若已有符合要求的二维码，可在 Add Server 中使用 Scan QR Code 导入，并在保存前检查解析结果；Import from Cloud JSON 只用于相应格式的信息，不是任意链接的通用入口。

通过 Subscribe 导入完整链接

持有订阅链接时，从 Home 进入 Add Server，将 Type 选为 Subscribe，按页面字段填写完整订阅地址，并设置便于识别的备注。复制时应包含查询参数，尤其不要遗漏问号之后的内容。链接可能包含访问凭据，粘贴后只在设备上核对，不要将完整地址放进公开截图或聊天记录。

保存后回到 Home，等待订阅读取完成；需要时使用对应订阅的更新操作。检查列表中是否生成了服务器条目，而不只是留下一个订阅名称。若没有条目，先确认链接返回的是客户端能够解析的订阅内容，而不是登录页面、提示页面或普通网页。订阅能被保存，只说明输入已记录，并不等于读取与解析已经成功。

本步结束时，应至少有一个可以明确选中的服务器条目。保留原始信息以便核对，但不要反复新建相同订阅来代替排错。接下来先选择 Global Routing；只有明确请求将如何处理，后面的连接测试才有判断依据。

返回 Home，点按 Global Routing，查看当前选中的模式。三姿态分别是配置(Config)/代理(Proxy)/直连(Direct)。它们决定请求按什么原则处理，并不是服务器协议的另一种名称。切换模式不会替你补齐服务器参数，也不会自动修复一个已经失效的订阅。

使用 Config 前检查当前文件

如果准备按规则分流，进入 Config，确认当前使用的配置文件及其内容。官方截图展示配置文件编辑页中的 General、Rule、Hosts、URL Rewrite 与 HTTPS Decryption 分段，Rule 下可见 Add Rule。首次连接并不需要把这些分段全部改一遍；先保留已确认的内容，避免把连接参数问题与复杂配置问题混在一起。

订阅主要用于获取或更新服务器列表，Config 则组织规则及相关设置，两者不能简单视为同一份内容。已有订阅成功导入后，仍需确认当前配置是否符合预期。对于来源和用途不明的配置，不应仅因条目较多就直接启用，更不应在没有明确需求时调整 HTTPS Decryption。

下面的片段只说明规则的阅读方式，并非要求直接替换当前配置。第一行让 example.com 及其子域名使用 PROXY，第二行让所列本地网段使用 DIRECT，最后一行负责前面没有匹配到的请求。规则顺序与最终处理方式会影响实际结果。

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

初次验证时，先记下本次选择的模式。如果目标是按已有规则使用，选择配置(Config)并确认文件；如果是在隔离服务器连通问题，可以短暂使用代理(Proxy)对照。测试完成后恢复日常模式，避免把临时检查设置一直保留下来。规则匹配的深入说明见系统教程。

完成添加与模式选择后回到 Home。在 SERVER 下点选本次准备使用的服务器，确认选择标记已经落在正确条目上。订阅分组本身与分组内的服务器不是同一个对象；看到分组标题，不代表已经选中了实际连接目标。若列表中有多个名称相近的条目，应先用备注区分。

点按 Home 顶部连接开关。首次建立连接时，系统可能提示添加 VPN 配置；这用于让客户端通过系统网络扩展处理相应流量。核对提示确由本次操作触发，再按系统提示完成授权或设备身份验证。系统授权只是允许配置建立，并不证明服务器认证、DNS 或规则已经正确。

授权完成后返回 Shadowrocket，检查顶部是否仍显示 Not Connected，以及开关是否保持开启。若仍处于未连接状态，先确认授权流程是否结束、服务器是否已选中，再进行一次连接。不要在尚未看清状态时连续点按开关，否则不容易分辨某次操作是在启动还是停止。

区分开关状态与实际可用性

开关保持开启，说明客户端连接流程已进入运行状态，但目标网页仍可能因为服务器、域名解析或规则处理而失败。系统中的 VPN 状态也不能单独证明某个请求经过了所选服务器。下一步需要实际发起请求，并把结果与模式、测试和记录对应起来。

如果连接刚打开又关闭，或很快返回 Not Connected，记录当前所选条目、模式以及出现的错误文字，然后前往失败点检查。iPad 上可能因布局不同而出现不同的显示位置，但仍应围绕 Home、SERVER 和 Global Routing 核对，不要只按截图中的绝对位置寻找按钮。

本步完成后，暂时保持网络环境不变，不要同时切换 Wi‑Fi、修改 DNS 并更换服务器。固定条件可以让下一步的验证结果更容易解释；若一次改动多个条件，即使网页恢复，也难以确定是哪一项起作用。

遇到失败时，先保留当前配置并记录现象，再从最靠近输入的信息查起。每轮只改一项，修改后重复相同的测试与网页请求；如果没有改善，恢复原值再检查下一项。这样可以避免排错过程本身制造新的问题。

订阅无法读取：先核对链接与返回内容

回到已有订阅的编辑信息，检查链接是否完整、前后是否带空格、是否误复制了说明文字。确认基础网络能访问订阅地址，并留意错误是请求超时、认证失败还是内容解析失败。三者分别指向网络路径、访问凭据与内容格式，不能统一用“再更新一次”解释。

若返回内容不是服务器列表，应向原信息提供方核实链接用途与有效状态。不要用反复新增重复条目的方式重试，也不要把完整订阅地址发送到公开求助页面。修正后只更新对应订阅，返回 Home 确认是否生成实际服务器条目。

连接失败：核对服务器与模式

手动条目先看 Type、Host、Port，再检查认证和协议附加参数。已有订阅生成的条目则先确认是否需要更新，不宜在不清楚含义时批量改写。随后检查 Home 当前选择的服务器，以及 Global Routing 是否仍是本次测试准备使用的模式。

如果连接状态稳定但某个网页失败，使用上一节的 Proxy 与 Config 对照结果缩小范围。只有特定域名出错时，优先检查该域名解析与匹配规则；大多数请求都失败时，再考虑服务器连通性或当前网络。更改前记录原值，避免失去可比较的基线。

DNS、Test Method 与 On Demand 分别检查

怀疑 DNS 时，先判断失败是否集中在域名访问，并检查当前配置中的 DNS 设置及可用诊断结果。不要将某个随意填写的 DNS 地址当作通用修复。域名解析、服务器连接与规则处理是相关但不同的环节，应根据错误信息逐项定位；详细配置说明可继续阅读Shadowrocket 系统教程。

进入 Settings 查看 Test Method，确认 Connectivity Test 采用的方法，再解释测试结果。Settings 中还可以看到 On Demand。它用于按条件建立连接；如果出现手动关闭后又自动连接，或切换网络后状态变化，应检查已有条件。首次手动验证时先明确 On Demand 当前状态，不要同时新增多组条件。

TCP 与 UDP 的表现也可能不同。网页能打开，并不必然证明某个依赖 UDP 的应用请求正常。此时应确认服务器与协议参数是否支持实际需求，再结合相应记录判断，不要仅因网页可用就排除其他传输路径的问题。

保留最少必要的诊断信息

需要进一步定位时，在 Settings 中使用 Diagnostics，记录报错文字、发生时的网络类型、所选模式和复现步骤。对比 Wi‑Fi 与蜂窝网络时，只改变网络这一项，再重复同一目标请求。若结果有差异，将它作为网络条件线索，而不是立即重置所有设置。

分享诊断内容前，移除密码、订阅地址中的访问参数以及不必要的个人请求记录。求助描述可以写清“在哪一步、使用什么模式、出现什么错误、已做哪些对照”，不需要公开完整连接信息。问题解决后恢复日常配置，删除重复测试条目，并再次确认正常请求可用。