Shadowrocket 入门指南

手动填写 Add Server

打开 Shadowrocket，进入 Home，在 SERVER 区域找到 Add Server；当前布局若使用顶部添加按钮，也可从该按钮进入添加页面。先点 Type，选择与你已有资料一致的协议类型，再返回填写其余字段。Type 会决定后续显示的认证与传输选项，不能仅因为某个选项看起来熟悉就直接套用。

Host 填服务器主机名或 IP 地址，Port 填端口。Password、Method 以及其他认证字段是否出现，取决于所选 Type。以 Shadowsocks 为例，Method 与 Password 必须与服务器配置一致；其他协议应按各自提供的资料核对。不要把整条分享链接贴进 Host，也不要在仅接受主机名的字段中附加网页路径。

如果资料还给出了 TLS、服务器名称或传输路径等参数，应逐项对应当前表单填写。连接地址与用于证书验证的名称可能不同，不能为了让两项看起来一致而自行改写。字段不明确时，回到你已有服务的配置说明核对，不建议反复猜测参数或关闭证书验证来尝试连接。

通过 Subscribe 导入订阅

如果你已有的是订阅链接，在 Add Server 的 Type 中选择 Subscribe，再把完整订阅地址填入 URL。可以为条目设置便于辨认的备注，然后保存并等待获取完成。复制时检查链接开头、结尾和查询参数是否完整，尤其注意聊天软件或文档是否插入了空格、换行，或只复制了显示文字而没有复制实际地址。

订阅地址通常包含访问凭据，应当按密码一样保管。教程不需要你的真实地址；请勿把完整地址贴到公开评论、截图或诊断记录里。订阅获取成功后，返回 Home，检查 SERVER 分组下是否出现预期条目。若只有订阅名称而没有服务器，先确认更新结果，不要立即重复添加多份相同订阅。

已有分享链接或二维码时

单条分享链接与订阅不是同一类资料。前者通常描述一条服务器，后者用于获取一组可更新的条目。使用客户端对应的链接导入入口，或在 Add Server 中点 Scan QR Code 扫描你自己的二维码；扫码前确认来源可信。Import from Cloud JSON 只适用于你确实持有相应 JSON 资料的情况，不是任意链接的通用导入入口。

无论采用哪种方式，最后都回到 Home 选中一条准备使用的服务器，并重新打开其详情检查 Type、Host 与 Port。选中条目表示后续连接会使用该选择，并不证明它已可用。完成这一步后，继续设置 Global Routing，不要仅凭服务器名称或地区备注判断实际连接结果。协议字段的含义可查阅协议参考。

服务器已经导入后，回到 Home 点 Global Routing，查看当前选择。这里控制的是整体路由姿态，不是服务器协议类型。切换此项不会把服务器的 Type 改成另一种协议，也不会修复填错的认证信息。首次验证时，应先明确当前选的是哪一种，避免把模式差异误认为连接故障。

配置(Config)：按当前配置执行规则

配置(Config)适合按照规则区分不同请求。进入 Config，确认你准备使用的配置文件已被选为当前启用项；只有导入、保存或打开编辑页面，不一定意味着它已生效。配置文件中的 Rule 按顺序匹配，命中后采用对应策略，例如 PROXY、DIRECT 或 REJECT。请求没有经过服务器，也可能只是命中了 DIRECT，而不是客户端没有工作。

如果你还不清楚当前规则来自哪个文件，先不要随意添加大量规则。记录当前启用项，再检查相关 Rule 及其顺序。下方片段仅用于理解“匹配条件后跟策略”的结构，不是一份完整配置，也不要求在首次连接时粘贴替换现有文件。

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

在这个示例中，匹配 example.com 后缀的请求使用 PROXY，指定的局域网地址段使用 DIRECT，其他请求由 FINAL 处理。更靠前的匹配会影响后面的规则是否有机会执行。截图中还可见 General、Hosts、URL Rewrite 与 HTTPS Decryption 等分段；首次连接不需要逐段修改，也不需要启用 HTTPS Decryption。

代理(Proxy)：用于减少分流变量

代理(Proxy)把一般需要由该模式处理的请求交给当前选择的代理路径，适合短暂验证服务器是否可用。若 Config 下某个目标失败，而 Proxy 下同一目标恢复，排查方向通常应转向规则、策略或相关解析设置。Proxy 并不是对设备所有活动的绝对覆盖保证，也不能让服务器凭据或服务状态自动变正确。

直连(Direct)：不使用所选服务器转发

直连(Direct)用于直接访问的场景。若目标依赖已有服务器提供的访问路径，在 Direct 下测试成功或失败，都不能据此评价该服务器。为了建立清晰基线，可以先记录原模式，短暂用 Proxy 验证，再返回你实际需要的 Config。每次切换后重新发起请求，避免把之前已建立的连接结果当成新模式的结果。

模式确定后返回 Home，确认 Global Routing 显示预期选项，再继续打开连接。配置文件的分段与规则管理可进一步阅读功能与设置，首次操作先保持配置简单、来源明确。

返回 Home，检查 SERVER 中已选中的条目，再看 Global Routing。若刚刚编辑过服务器，先确认修改已经保存；若刚切换过 Config，确认当前启用项确实是准备测试的文件。把这两项确认清楚后，再打开 Home 顶部的连接开关。官方截图显示的是尚未连接时的 Not Connected 状态，不是成功连接的证明图。

首次连接时，系统可能提示 Shadowrocket 添加 VPN 配置。这是客户端建立系统网络连接所需的授权环节，与再次购买应用无关。阅读弹窗中的应用名称和请求内容，确认提示由刚才的连接操作触发后，按系统要求允许并完成身份验证。授权过程可能需要设备密码或系统支持的身份验证方式，应以设备当前提示为准。

若误点了取消，不需要反复删除服务器。返回 Home 再次尝试连接，查看系统是否重新提示；仍无法继续时，在系统设置中检查 VPN 配置是否存在，以及设备管理限制是否阻止添加。由学校或单位管理的设备可能受到策略约束，应先确认设备使用规则，而不是不断更改客户端字段。

授权完成后回到 Home，等待状态更新。系统显示已建立 VPN 连接，说明设备到客户端网络扩展这一环节已经启动；它不等于远端服务器认证一定通过，更不等于每一个目标服务都能访问。因此连接开关保持开启只是下一步验证的起点，不能作为整个流程的终点。

如果开关很快恢复关闭，先记录出现的错误提示与发生时机：是系统授权之前、授权之后，还是开始访问时。此时先处理连接建立问题，不要同时调整 DNS、Rule 和服务器参数。如果开关保持开启但访问失败，则保留当前状态，按下一步区分测试结果和实际请求结果。

iPad 的操作顺序相同：选中服务器、确认 Global Routing、打开开关、处理系统授权，再验证访问。不同屏幕布局中按钮位置可能有差异，仍以 Home 与对应界面词辨认。首次连接成功前，可以暂不设置 On Demand，待手动连接能够稳定复现后再考虑自动连接条件。

基础网络无法访问

先关闭客户端连接，检查当前 Wi-Fi 或蜂窝网络是否能够完成普通访问。公共 Wi-Fi 可能需要先完成网络登录；系统也可能对蜂窝数据使用作了限制。基础网络未就绪时，订阅获取、服务器连接和目标访问都可能一起失败，应先解决这一层。完成基础访问后，再回到 Home 使用原服务器与原模式重试。

Subscribe 更新失败或条目为空

核对订阅 URL 是否完整、是否仍有效，以及当前基础网络能否访问该地址。订阅地址与账户管理页面地址不一定相同，复制了网页登录地址通常不能得到服务器列表。不要把含有凭据的地址提交到公开检测页面；必要时只向你已有服务的支持渠道确认地址状态和返回格式。保留原有可用条目，确认更新结果后再决定是否清理重复项。

服务器存在，但认证或握手失败

打开对应条目的编辑页，逐项比对 Type、Host、Port、认证信息和传输参数。手动输入时尤其注意字符大小写、首尾空格及相似字符。使用 TLS 的条目还应检查设备日期与时间，以及资料要求的服务器名称。不要仅修改 Password 后就认定其他字段正确，也不要通过随意更换 Method 或跳过证书验证来掩盖参数不一致的问题。

Proxy 可用，Config 下部分目标失败

优先检查当前启用的 Config、规则顺序与命中策略。先找到失败目标的请求记录，再查看是否被较早的规则指向 DIRECT、REJECT 或非预期策略。若存在域名与地址解析方面的差异，应结合实际记录排查，不要一开始就替换全部 DNS 设置。确认一处修改有效后再保留，其他试验性修改应恢复，避免不断积累无法解释的配置。

Connectivity Test 与实际体验不一致

进入 Settings 查看 Test Method，确认使用的方法适合当前比较目的。测试目标与业务目标不同，结果本来就可能不同；服务器对某种测试响应较慢，不代表所有实际请求都慢。若文字页面正常而某项具体业务失败，把排查范围缩小到该业务的连接类型、目标状态和所需传输能力。Settings 中的 Proxy、TCP、UDP 是相关设置入口，不应为了尝试而全部改动。

连接自动打开或自动关闭

在 Settings 检查 On Demand 是否已配置。On Demand 根据条件触发连接，不是网络加速选项；首次排查时，可以先记录已有条件，暂时关闭自动触发，改用 Home 手动连接建立可重复的测试过程。测试结束后再恢复需要的条件。如果设备上另有正在启用的 VPN 配置，也应确认当前实际生效的是哪一项，避免在错误的连接状态下观察结果。

收集 Diagnostics 时保护资料

需要进一步定位时，可在 Settings 查看 Diagnostics 相关功能。记录失败时间、当前网络类型、所选模式、错误原文以及是否能够复现，通常比仅描述“不能用”更有帮助。分享诊断信息前，检查并遮去订阅地址中的凭据、服务器密码、认证标识和其他私人资料；保留错误类型与必要上下文即可，不要公开整份敏感配置。

完成排查后回到验证步骤

每做一项修改，都重新执行一次连接和实际访问验证。若问题由服务端状态或已有订阅权限引起，客户端本地改动不能替代服务端修复，应向你已有服务的支持渠道核实。只有一个目标异常时，也应考虑目标本身是否暂时不可用，不必因此重建全部配置。

首次使用到这里即可收尾：保留一条已验证的服务器、明确当前 Global Routing、确认正在使用的 Config，并了解如何手动停止连接。继续学习可阅读协议参考和功能与设置；需要复查完整操作顺序时，回到本页的添加与导入步骤。