OFFICIAL MANUAL / GLOSSARY

Shadowrocket 概念速查

按设置位置查含义，再核对具体参数。本页是 Shadowrocket 官方手册的术语索引，保留界面词、协议名与规则关键字的英文原文，帮助区分“选择什么”“匹配什么”与“如何处理”。

下列导入说明均以用户已有自己的订阅或服务器信息为前提。术语解释不替代完整操作步骤；首次配置可配合使用教程阅读。

01 / INTERFACE

界面与开关

先确认当前设置所在位置。同一个英文词出现在不同入口时，可能分别表示页面、选项或规则策略。

Global Routing: 用于选择整体路由方式，三种姿态为配置、代理、直连，对应界面词 Config、Proxy、Direct。选择 Config 时，连接按当前配置中的规则决定去向；选择其他姿态时，不能再简单按规则列表推断结果。排查分流前先核对这里，避免在整体路由方式不符时反复修改规则。

Config: 在配置管理位置，Config 指向配置文件及其管理操作；在 Global Routing 中，Config 则表示按配置规则处理连接。进入配置页面查看过某个文件，不等于已经将它设为当前使用的配置。修改前应核对当前文件与启用状态，并保留可恢复的副本。

Proxy / Direct: 这是 Global Routing 中的两个选项，分别对应代理与直连，用于选择整体连接的处理方式。它们与规则文本中的大写 PROXY、DIRECT 处在不同层级，不能仅凭名称相似就认为效果完全相同。Proxy 仍依赖有效的服务器参数，Direct 也仍受当前网络可达性影响。

On Demand: 指由系统依据已设定条件按需触发连接的机制，可围绕网络环境或域名条件设置。它解决的是何时触发连接，不会修复错误的密码、证书或服务器地址。建议先验证手动连接，再逐项增加触发条件；需要保持断开时，也应检查是否仍有条件触发重新连接。

Add Server: 用于添加服务器记录，需要根据用户已有信息选择协议并填写对应参数。地址与端口相同，并不意味着不同协议的认证、TLS 或传输参数可以互用。保存前应逐项核对，保存后再确认实际选用的记录，避免测试了另一条同名配置。

Connectivity Test: 用于观察指定测试条件下的连接结果，结论与测试目标、测试方式及当时网络状态有关。某次测试成功，只说明该次检测所涉及的路径能够完成相应操作，不代表所有网站和应用均正常。排障时应把测试结果与实际请求、规则命中和 DNS 情况一起查看。

DNS: 负责将域名解析为网络地址，是建立许多连接前的一环。解析失败、解析结果不适用与代理握手失败属于不同问题，表面上却都可能表现为无法访问。修改 DNS 设置前先记录原值，并区分域名解析走向与解析之后连接所采用的路由策略。

02 / PROTOCOLS

协议名称与参数边界

协议类型应与用户已有服务器信息一致。仅替换类型名称不能完成协议转换，也不能据此判断实际连接表现。

Shadowsocks: 一种代理协议，连接时需要客户端与服务器使用一致的加密方法和密码。若已有信息包含插件或其他扩展参数，也应按原始说明核对，不能只填写基础字段。认证失败时优先检查参数是否完整、复制是否带入多余空格，而不是直接更改规则。

VMess: 一种代理协议，通常需要核对 UUID 等身份信息，以及传输方式、路径和 TLS 相关参数。服务器地址正确只是必要条件之一，传输层设置不一致也会导致握手失败。导入后应对照用户已有的原始信息检查，尤其注意那些没有显示在记录名称里的字段。

VLESS: 一种代理协议，身份认证、传输方式与安全层参数需要分别与服务器要求一致。协议名称本身不代表已经启用某种加密或安全设置，也不能替代对 TLS、服务器名称等字段的检查。排查 Shadowrocket VLESS 连接时，应先核对完整参数，再检查规则与目标可达性。

Trojan: 通常结合 TLS 使用的代理协议，密码、服务器名称与证书验证设置都会影响连接。连接地址与用于 TLS 验证的服务器名称可能承担不同作用，不应看到两个字段不同就随意改成一样。遇到证书错误时应核对名称、证书有效性与设备时间，而不是直接关闭验证。

Hysteria2: 基于 QUIC 的代理协议，使用 UDP 传输，并有相应的拥塞控制机制。它在具体网络中的表现仍取决于丢包、时延、服务器资源及参数，协议名称不构成速度保证。当前网络若限制 UDP 通信，可能出现连接失败；检查时需同时核对认证与 TLS 相关设置。

WireGuard: 基于密钥身份认证的隧道协议，配置通常涉及本端密钥、隧道地址、对端公钥与路由范围。密钥具有对应关系，不能把公钥和私钥互换，也不应向他人展示私钥。排查 Shadowrocket WireGuard 配置时，需要同时核对端点信息、地址范围与 DNS，而不是只检查是否保存成功。

HTTP / SOCKS5: 两种代理协议类型，连接前应确认服务器实际支持哪一种，以及是否要求用户名和密码。类型名称并不自动说明传输已经加密，认证方式与安全层仍需依据具体配置判断。不要将远端代理服务器的端口与本地应用所使用的服务端口混为一谈。

03 / RULES & POLICIES

规则关键字与策略

关键字描述匹配条件，策略描述命中后的处理方式。以下片段仅解释语法，example.com 为示例域名，不是服务地址。

规则: 将匹配条件与处理策略关联的配置条目，通常按从上到下的顺序检查，命中第一条后执行相应策略。范围较大的规则若排在前面，可能让后面的精确规则没有机会生效。编辑后应同时核对顺序、策略名称与当前 Global Routing，不能只看单条语法是否正确。

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD: DOMAIN 匹配完整域名，DOMAIN-SUFFIX 匹配指定域名及其子域名，DOMAIN-KEYWORD 匹配域名中包含的关键字。例如 DOMAIN-SUFFIX,example.com,PROXY 将匹配结果交给 PROXY。关键字匹配通常比精确域名更宽，添加前应考虑是否会覆盖其他不相关域名。

IP-CIDR / IP-CIDR6: 分别用于匹配 IPv4 与 IPv6 地址范围，斜杠后的前缀长度决定网段大小。例如 IP-CIDR,192.168.0.0/16,DIRECT 表示对该 IPv4 范围使用 DIRECT。部分匹配过程会涉及域名解析，排查时应区分目标原本就是 IP，还是通过 DNS 得到 IP 后再参与判断。

GEOIP: 依据 IP 地理数据库中的分类结果匹配，不是按网页语言、域名后缀或账号地区判断。数据库记录与实际服务部署可能存在差异，同一服务也可能使用多个地区的地址。若命中结果不符合预期，应核对实际目标 IP、数据库分类及前序规则，而不是仅凭网站名称判断。

FINAL: 用于处理未命中前序规则的连接，是规则列表的最终兜底，应放在末尾。例如 FINAL,DIRECT 表示此前均未命中时使用 DIRECT，不表示所有连接都直连。如果大量连接落到 FINAL，应先检查前面的条件是否覆盖目标，再决定是否调整兜底策略。

PROXY / DIRECT / REJECT: 这是规则中的处理策略：PROXY 交给代理处理，DIRECT 直接连接，REJECT 拒绝连接。PROXY 的实际出口取决于当前选择及相关配置，不是一个服务器地址。REJECT 命中后产生的失败是规则处理结果，排查连接问题时应先检查是否被拒绝规则覆盖。

04 / SUBSCRIPTION & CONFIGURATION

订阅与配置文件

先识别手中的内容是订阅地址、单条服务器信息还是完整配置，再选择导入位置。本站不提供、不销售、不推荐节点或订阅。

服务器记录: 描述一个连接端点的参数集合，常见内容有协议、服务器地址、端口及认证信息，也可能包含传输和 TLS 设置。记录名称只是便于识别的标签，改名不会改变真实连接参数。两条同名记录也可能指向不同端点，核对时应查看具体字段，而不是只比较名称。

配置文件: 用于组织通用设置、规则及其他配置段，常见段落包括 [General] 与 [Rule]。服务器订阅与配置文件承担的职责不同，更新订阅不应被理解为已经替换全部分流逻辑。导入新配置前应保留原文件，并检查最终实际使用的是哪一份。

延迟: 表示指定测试方法下的响应时间，受测试目标、协议流程与当时网络影响。Shadowrocket 延迟测试的数值不能直接换算为下载速度，也不能单独说明网页、视频或其他业务的体验。比较前应保持测试条件一致，并把实际业务请求是否成功作为另一项独立检查。

URL Rewrite: 根据匹配条件对请求 URL 等内容进行改写，与决定连接走向的路由规则不是同一功能。规则未命中、请求未进入可处理范围或加密内容不可见，都可能使预期改写不发生。使用前应明确改写目的与作用范围；涉及加密请求时还需理解相应证书与隐私边界。

05 / APP STORE & ACCOUNT

App Store 与账号

Shadowrocket 只在 Apple 平台发行，以 iPhone 与 iPad 为主，唯一获取入口为 App Store。兼容性、系统要求与是否通用购买，以 App Store 页面标注为准。

App Store 正版核验: 在产品页同时核对开发者 Shadow Launch Technology Limited、官方图标与应用 ID 932747118，不只看搜索结果中的名称。应用 ID 可从产品页地址中的 id932747118 辨认，图标应与本站使用的官方图标一致。获取步骤与核验位置见下载指南。

Apple ID 商店地区: 指用于“媒体与购买项目”的账号所关联的商店地区，影响应用可见性、可用付款方式与当地货币显示。设备语言、设备当前位置和商店地区不是同一个设置。搜索不到应用时，应先核对当前购买账号与商店地区；更改地区还受 Apple 的账号条件限制，不能仅凭切换语言判断结果。

已购项目: 指 App Store 中与购买账号关联的应用记录，换机或重新安装时可在相应应用列表中查找。应先确认“媒体与购买项目”使用的是购买时的账号，具体入口名称可能随系统界面变化。重新下载应用与恢复本地订阅、配置文件属于不同事项，后者需要另行核对备份。

一次性买断: 描述应用的购买方式，美区定价约 2.99 美元，各店面以 App Store 页面当前显示的价格和当地货币为准。客户端一次性买断 ≠ 线路套餐，应用购买不会自动提供服务器或订阅。用户仍需准备自己已有的连接信息，应用购买与相关服务费用分别处理。

返回分类索引 ↑