订阅 Subscribe
导入你已有的订阅;更新的是服务器条目,不自动替代完整的分流配置。
CONFIGURATION / MATCH / POLICY
先确定连接信息,再确定请求走向。Subscribe 管理已有服务器信息,Config 保存分流设置,Rule 决定请求使用哪个策略。三者各有职责,导入成功并不等于连接已经验证。
导入你已有的订阅;更新的是服务器条目,不自动替代完整的分流配置。
按顺序检查匹配条件;更具体的例外,应避免被前面的宽泛规则覆盖。
PROXY 转交代理,DIRECT 直接连接,REJECT 拒绝请求;策略不保证目标可达。
服务器信息回答“使用哪种协议、连接哪个地址、怎样认证”;配置文件回答“哪些请求使用代理、哪些直接连接、怎样解析域名”。已有订阅通常用于批量维护服务器条目,不能仅凭文件名称判断是否包含规则。导入后应分别检查 Home 中的服务器选择,以及 Config 中当前启用的配置。
右上方的规则工作台只是文本匹配示意,不是可直接套用的配置。例如,含有 example 的宽泛条件如果排在前面,后面的 ad.example.com 例外便可能没有机会生效。实际调整时,先确定期望策略,再检查条件范围与排列顺序,不要只在文件末尾不断追加规则。
FUNCTION INDEX
选择下方条目查看说明。代码为局部语法或字段核对示例,使用保留域名和文档地址,不代表可用连接信息。
在 Home 中检查 Global Routing。配置模式 Config 按当前配置执行分流;代理模式 Proxy 将通常的请求交给所选代理;直连模式 Direct 用于直接连接。日常需要按域名或地址区分走向时,先选 Config,再确认 Config 中启用的文件。切换模式不会补齐服务器认证信息,也不代表服务器已经可用。排查时只改变一个条件,比较同一目标的结果,避免同时切换服务器、规则与 DNS 而失去判断依据。下面的片段仅在使用相应规则配置时表达分流意图。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
On Demand 位于 Settings,用于让系统根据设定条件请求建立连接,而不是为服务器增加可用性。首次设置前,先手动连接并完成实际访问验证,再核对适用的网络条件。启用后,如果发现手动断开后又出现连接,应先检查 On Demand,而不是反复删除配置。不同网络下的触发结果还受到系统状态影响,不能理解为所有请求都必然经过代理。需要暂停时先关闭相关条件,再断开连接。下面是排查记录的核对顺序,不是可导入配置。
Settings → On Demand
手动连接验证 → 核对触发条件 → 切换网络复测
已有订阅链接可用于批量导入和更新服务器信息,入口通常从 Home 的添加操作进入。导入前确认剪贴板里是完整链接,导入后检查分组与条目,再选择其中一项测试。更新可能调整地址、认证参数或条目名称,因此应避免把长期手动修改直接混在受订阅管理的条目里。订阅链接可能含访问凭据,求助时应遮盖完整链接及认证字段。本站只说明已有信息的导入和管理,不提供订阅。下方使用保留域名与假值,仅展示链接形态。
https://example.com/sub?token=xxxx
Config 中的配置文件可包含 General、Rule、Host、URL Rewrite 等分段,各段负责不同的行为。打开编辑器看到文件内容,只说明文件存在;是否生效还需要检查当前启用项以及 Global Routing 模式。修改之前保留一份可恢复的副本,先改一处再测试,便于定位错误。订阅更新与配置切换不是同一操作,不应把服务器条目增减当作规则已经更新的证据。下面只展示两个有效规则行,不能替代按实际需求核对的整份配置。
[Rule]
DOMAIN,example.com,DIRECT
FINAL,PROXY
Rule 从上到下检查条件,命中后执行该行指定的策略。DOMAIN 匹配完整域名,DOMAIN-SUFFIX 匹配域名后缀,IP-CIDR 匹配地址范围;不同关键字不能仅凭名称相似互换。处理例外时,应把范围较小的条件放在可能覆盖它的宽泛条件之前。末尾的 FINAL 用于处理此前没有命中的请求。诊断时要同时核对实际目标、命中行和最终策略,不能只看文件里是否写过某个域名。下例先保留特定域名例外,再拒绝其余示例域名请求。
[Rule]
DOMAIN,keep.example.com,DIRECT
DOMAIN-SUFFIX,example.com,REJECT
FINAL,PROXY
DNS 把域名解析为地址,是连接过程的一环。域名打不开而地址可达,只能提示需要检查解析环节,不能直接断言某个解析器有问题。核对当前 Config 的 DNS 设置后,还要结合实际解析结果、缓存和请求走向判断。不要同时填入大量来源不明的地址;先保留可解释的配置,再针对同一域名复测。调整后应重新发起请求,观察结果是否改变。下方为 General 中的局部配置语法,使用 system 表示系统解析设置,并非适合所有网络的固定方案。
[General]
dns-server = system
URL Rewrite 用于对符合条件的 URL 执行指定动作,与 Rule 选择代理或直连的职责不同。编辑前先确定要匹配的请求范围,再确认表达式是否过宽。加密请求的可见范围受到连接方式和相关设置影响,不能把一条改写规则理解为能够覆盖所有应用内容。遇到访问异常时,可以先停用新增改写再复测,不要同时删除整个配置。下面只展示对保留域名的跳转语法,不需要为阅读本页安装证书,也不作为实际网站的通用改写建议。
[URL Rewrite]
^http://example\.com/ https://example.com/ 302
Host 用于为指定域名设置本地映射,适合在已知目标地址时排查解析差异。它不是服务器订阅,也不会代替协议认证或改变目标服务本身。新增映射后,应确认请求是否确实采用该地址,并注意目标服务可能依赖域名与证书匹配。长期保留旧地址容易造成局部访问异常,因此每条映射都应有明确用途和回退方式。下例使用文档地址,不能用于实际访问;如果没有需要固定映射的目标,不必为了完善配置而添加这一段。
[Host]
example.com = 192.0.2.10
在 Add Server 中选择 Type,再按已有服务器信息填写 Host、Port 和该协议要求的认证字段。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的参数不能互相套用;部分类型还需要核对传输方式、TLS 与服务器名称。不要只根据协议名称判断速度或电量表现,网络质量、传输设置与服务端能力同样重要。导入分享链接可以减少手工录入错误,但仍应检查解析后的字段。下方是字段核对清单,真实值应来自你已有的服务器信息。
Type → Host → Port
认证字段 → 传输设置 → TLS(如适用)
Home 的 Connectivity Test 和 Settings 的 Diagnostics 可辅助判断连通状态,但一次测试结果不能代表所有目标与所有协议行为。先记录当前网络、服务器和 Global Routing,再围绕同一目标复测,区分地址解析、服务器连接、认证和规则走向。延迟数字反映的是所选测试方法下的往返或连接过程,不等于持续吞吐量。分享诊断信息前应移除订阅链接、认证字段和个人访问记录。下面列出适合逐项核对的顺序,不是预设的诊断结论。
当前网络 → DNS → 服务器可达性
认证与传输 → 命中规则 → 实际目标访问
Data 中的流量信息用于观察客户端统计范围内的连接活动。阅读数据前应先核对统计周期、是否重置过,以及当前请求采用的策略。上传和下载数值不宜直接等同于服务商账单:协议封装、统计口径和时间区间都可能造成差异。排查异常增长时,先确认是否有后台同步或持续传输,再结合连接记录判断,而不是只凭一个累计值推断来源。记录前后差值时使用相同测试时段,避免把不同周期的数据混在一起。下方仅为阅读维度。
Data
统计周期 / 上传 / 下载 / 当前连接与策略
使用 iCloud 相关同步或导入功能前,先确认设备登录状态、系统权限和客户端内可用选项。应用购买记录、服务器信息、配置文件及连接授权不是同一类数据,重新下载应用不表示所有设置都会自动恢复。重要配置应另行保留可恢复副本,并保护其中可能包含的认证信息。在另一台设备上完成同步后,仍需检查当前配置和服务器选择,再按系统提示建立连接。下面区分恢复时的两个检查方向;具体同步范围以客户端当前界面为准。
App Store → 核对已购记录
iCloud / 客户端导入 → 核对配置与服务器信息
FIRST CONNECTION
开始前准备好你已有的订阅链接或服务器信息。应用购买解决客户端获取问题,实际连接还需要有效的服务器参数。首次操作先采用最少改动,确认一条连接可用后,再逐步增加规则和自动连接条件。
在 Home 进入添加操作。已有分享链接时先完整复制,再检查导入结果;手动填写时,先选 Type,再依次核对 Host、Port 与认证字段。二维码应来自你已有的信息,并在导入后检查解析内容。
订阅导入后,先看分组是否出现、条目是否完整,再选择一个服务器。不要在尚未核对参数时同时开启多项高级设置。若导入失败,先检查链接是否被换行截断、内容是否为空,再判断格式是否适用。
需要规则分流时选 Config,并在 Config 中确认当前启用的文件。Proxy 与 Direct 可帮助对照请求走向,但不是自动修复连接的开关。模式改变之后,要重新发起同一个目标请求进行比较。
如果一个网站可以访问而另一个失败,先检查两者采用的策略是否不同。只有确认使用了预期服务器和配置,后面的 DNS、认证与规则排查才有意义。不要仅凭 Home 中出现条目就判定配置已经生效。
启动连接时,按系统提示核对并允许添加 VPN 配置。该授权仅用于建立系统网络连接;你已有订阅的服务器认证需另行核对。完成后先做 Connectivity Test,再打开实际需要访问的目标,确认结果符合预期。
系统显示已连接,只说明连接配置处于工作状态,不能证明所有目标都可达。失败时记下当前网络与模式,先核对服务器参数,再检查请求策略;每次只改一项,保留可复现的前后对照。
如果首次连接没有达到预期,先保持一份原始信息,确认订阅或服务器参数没有录入错误。随后检查客户端是否选择了目标条目、Global Routing 是否符合预期、当前 Config 是否启用。完成这些基础核对后,再检查解析与具体请求记录。仅有测试超时,尚不足以判断问题出在规则还是服务器。
从一个网络切换到另一个网络时,应重复验证同一个目标,并记录是否只有部分请求异常。这样可以区分环境变化与配置变化。需要他人协助时,提供模式、错误现象和已经尝试的步骤即可;不要公开完整订阅地址、密码或其他认证字段。
DEVICES & APP STORE
唯一获取入口为 App Store。两种设备共用购买的适用范围、系统要求及兼容性,以 App Store 页面标注为准;已购设备仍需分别确认当前账号与连接配置。
先核对 App Store 产品信息,再完成购买与安装。首次建立连接时按系统提示授权,之后回到 Home 选择已有服务器。更换网络或配置后,应再次验证实际访问。
如果商店搜索没有结果,先核对账号所属国家或地区以及产品页显示的信息。不要把搜索可见性问题与客户端连接故障混在一起处理。
查看 iPhone 获取步骤 →使用同一 Apple ID 核对已购记录,购买适用范围以商店页为准。iPad 上仍需检查配置导入、当前服务器和 Global Routing,不应把另一台设备已连接作为本机验证结果。
较大的显示区域便于阅读配置文件,但规则匹配逻辑不因屏幕尺寸改变。恢复已有配置后,先检查内容完整性,再发起连接并核对请求走向。
查看 iPad 获取步骤 →Mac / Apple TV 也可在同一 App Store 获取,以商店页兼容性标注为准。
查看获取步骤 →PRODUCT IDENTITY & PURCHASE
本站是 Shadowrocket 官网与官方手册。“小火箭”是中文辨认别称,购买时应以 Shadowrocket 产品名称、开发者、官方图标与应用 ID 共同核对,不能只依赖搜索结果的标题。
比较图标、开发者与产品页地址中的 ID;三处信息应相互对应。
打开 App Store 产品页,先看应用名称和图标,再查看开发者是否为 Shadow Launch Technology Limited。产品页地址中的 id932747118 对应应用 ID。图标相似并不足以完成核对,同名或近似名称也不能替代这两项文字信息。
如果入口来自搜索结果,进入详情页后仍应再核对一次。本站使用的官方图标可供外观对照,最终的价格、兼容性和购买信息以 App Store 页面标注为准。客户端更新也通过 App Store 管理;需要查看变更时,阅读商店中的更新记录,而不是根据某篇教程的界面外观猜测。
Shadowrocket 为付费应用,美区参考价格为 2.99 美元,一次性买断;各店面按当地货币显示,最终价格以购买确认页为准。一次性购买对应的是客户端应用的获取,不是对服务器连通性、可用时长或访问体验的承诺。
客户端买断 ≠ 线路套餐。本站不提供、不销售、不推荐任何节点或订阅。使用连接功能应先准备你已有的订阅或服务器信息。已有服务的有效期、地址变更和认证信息,由你原有的服务安排决定,不会因为重新安装客户端而自动恢复或延长。
App Store 按账号所在国家或地区展示产品,搜索结果与购买可用性可能不同。如果搜索不到 Shadowrocket,先在账号设置中核对当前所属商店,再打开本页提供的产品页查看提示。搜索不到不等于应用名称变更,也不能据此判断已有购买记录失效。
核对账号时应区分设备登录状态与用于 App Store 购买的账号。任何地区、付款方式或购买限制,都应以账号设置和商店提示为准。不要为了排查客户端无法连接而反复调整购买设置:商店获取和网络连接是两个独立环节,前者不能修复已有服务器的认证错误。
换机或重新安装时,先使用原购买账号查看 App Store 的已购项目,再核对 Shadowrocket 产品页。iPhone 与 iPad 共用购买的适用范围,以及其他兼容设备、家人共享等条件,均以 App Store 页面标注为准。出现再次付费提示时,先确认账号与购买记录,不要立即重复购买。
恢复应用与恢复配置要分开处理。已购记录用于找回应用,服务器信息和配置文件则需要从自己的备份或已有同步内容恢复。完成恢复后重新核对当前服务器、Config 与 Global Routing,并按本机系统提示建立连接;另一台设备上的授权与测试结果不能替代本机检查。
稳定使用后,可按“服务器信息、分流配置、自动连接条件”分别管理。订阅更新后先确认条目变化,修改规则后检查命中结果,调整 On Demand 后验证网络切换。将三类操作分开,能避免出现问题时找不到是哪一步造成的。重要配置应保留可恢复副本,同时妥善保护其中的认证信息。
需要排查 Shadowrocket 无法连接时,记录当前网络、所选条目、Global Routing 和具体错误表现,比只提供“开关已打开”的截图更有帮助。分享日志前应检查是否含有完整订阅地址、服务器密码或个人访问记录。诊断的目标是找到可复现的失败环节,而不是为了追求某个测试数字反复更换所有设置。
导入只是把信息保存到客户端。还需要在 Home 选择要使用的条目,确认 Global Routing 和当前配置,再建立连接。条目存在、测试通过、实际目标可达是不同的检查结果,应按顺序分别验证。查看导入与连接步骤 →
延迟测试反映特定方法下的连接或往返时间,不能覆盖吞吐量、丢包、持续连接及目标服务响应。先保持同一个服务器和模式,用实际目标复测,再判断问题是否随网络变化。查看验证与排查方法 →
先检查 Global Routing 是否为 Config、修改的文件是否已经启用,再检查规则顺序及实际请求域名。新规则如果被前面的宽泛条件覆盖,就不会决定策略。确认后重新发起请求进行对照。查看规则设置说明 →
购买记录与配置数据应分别核对。先从 App Store 找回已购应用,再从自己的备份、已有订阅或客户端支持的同步内容中恢复配置。恢复完成后仍应检查信息完整性并重新测试。查看已购恢复说明 →
TECHNICAL NOTES
入门步骤之外,按问题继续阅读。以下笔记分别解释规则拒绝的范围、商店展示与账号地区的关系,以及延迟测试能够说明什么;阅读时先确认自己的问题属于购买、配置还是连接环节。
从匹配条件与拒绝策略开始,说明按域名处理请求的范围,以及同域内容、应用内嵌请求等不能仅靠域名规则细分的情况。
按步骤核对账号所属商店,区分搜索结果、产品页展示和已购项目。购买问题先回到商店信息核对,不与客户端连接故障混淆。
围绕你已有的服务器条目,解释测试方法、地区与协议设置对结果的影响,并给出保持条件一致的对照思路,不涉及服务推荐。