已有订阅或服务器信息
先准备用户已有的订阅链接,或由自己的服务商提供的服务器参数。客户端负责读取这些信息并建立连接;安装应用不会自动生成可用服务器。手动填写时,应逐项核对 Type、Host、Port 与对应认证字段,不要把网页登录密码当成连接参数。
订阅中可能包含多个条目,但列表出现内容只代表导入完成。是否可连接还取决于服务状态、协议参数和当前网络。排查时先固定一个条目与一种网络,记录现象后再改变条件。
全平台规则代理客户端,按问答查看获取、配置与规则分流;iPhone / iPad 在 App Store $2.99 一次性购买,Mac、Windows、安卓、Linux 版免费。
当前版本 v2.2.92 · Mac、Windows、安卓、Linux 版免费
首次使用?查看入门指南 →
Shadowrocket 的连接开关、服务器信息与分流规则是不同层次的设置;逐项检查比同时修改更容易定位问题。
先准备用户已有的订阅链接,或由自己的服务商提供的服务器参数。客户端负责读取这些信息并建立连接;安装应用不会自动生成可用服务器。手动填写时,应逐项核对 Type、Host、Port 与对应认证字段,不要把网页登录密码当成连接参数。
订阅中可能包含多个条目,但列表出现内容只代表导入完成。是否可连接还取决于服务状态、协议参数和当前网络。排查时先固定一个条目与一种网络,记录现象后再改变条件。
第一次使用先进入下载页选择设备,再按入门指南完成导入与 VPN 配置授权。已经能够连接的用户,可直接阅读 Global Routing 与 Config 的说明,确认请求为什么使用 PROXY、DIRECT 或 REJECT。
上方为官方 Home 页截图,展示连接开关、Global Routing 与 Add Server 的位置,并非当前设备的连接状态。实际规则应结合自己的配置检查,尤其要留意前面的宽泛规则是否提前覆盖了后面的具体条件。
从真实问题进入对应设置。以下以 iPhone / iPad 的界面词说明,其他平台的具体位置以应用内显示为准。
Global Routing 选择 Config 时,请求按当前配置的规则分流。先进入 Config 确认正在使用的文件,再检查 Rule 的排列顺序。具体域名条件通常放在宽泛条件之前,FINAL 放在末尾处理未命中请求。PROXY 使用代理策略,DIRECT 直接连接,REJECT 拒绝请求。Global Routing 的 Proxy 与 Direct 用于整体切换处理方式,不能与配置中逐条匹配规则的行为混为一谈。
先记录当前文件和 Global Routing 选项,用一个目标请求验证,再查看命中策略。只调整相关规则的顺序,避免同时更换服务器和配置,导致无法判断是哪一处改动起效。
DOMAIN-SUFFIX,example.com,PROXYFINAL,PROXYOn Demand 用于根据设置的条件触发连接,不负责修复服务器参数。在 Settings 中查看 On Demand,按应用内显示的条件配置。建议先完成一次手动连接与访问验证,再启用按需行为;如果手动连接本身失败,自动触发后仍需检查同一组参数。需要观察断开状态时,也应同时检查 On Demand 是否仍在生效,避免把条件触发的重新连接误判为开关失效。
先关闭按需触发进行一次手动测试,确认所选服务器和规则可用,再恢复所需条件。更改网络后观察实际行为,不把触发成功直接等同于目标请求已成功访问。
Shadowrocket 支持 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等协议。手动添加时,在 Add Server 选择与服务端一致的 Type,再填写该类型需要的字段。协议名相同不代表所有参数都能通用,传输方式、认证信息与 TLS 设置仍要逐项核对。已有订阅应优先按原信息导入,不要为了尝试其他协议而只改 Type;是否可连接取决于客户端与服务端参数一致。
将服务商提供的字段与 Add Server 对照。二维码只是一种传递参数的方式,使用 Scan QR Code 后仍要核对导入结果,尤其注意 Host 与认证字段有没有缺失。
订阅链接从用户自己的服务商获取,导入后再检查 SERVER 列表。在添加入口选择 Subscribe,填写已有链接并保存,随后执行更新。导入失败时,先确认复制的是订阅地址而不是账户网页,再检查地址是否完整、服务是否有效以及当前网络能否访问更新地址。更新订阅与更新 Config 是两件事:前者管理服务器条目,后者管理请求处理规则,完成其中一项不会自动说明另一项也正确。
检查复制内容前后是否多出空格或换行。若更新有明确错误提示,保留错误类型供排查,但不要在公开截图或求助内容中暴露完整订阅链接。
Config 用于查看、编辑与选择配置文件,保存文件后还要确认当前选中项。规则编辑可从 Rule 与 Add Rule 开始,先辨认规则类型、匹配内容及策略。修改前保留原文件,修改后检查 Global Routing 是否为 Config,否则规则变化可能不会按预期作用于请求。使用 iCloud 同步时,还应核对设备上的文件和选中状态;文件已同步不等于服务器参数、连接状态或其他设备设置都已一致。
保留一份可以工作的原配置,只修改需要调整的部分。恢复时重新选择原文件并确认模式,不要仅根据文件名判断当前生效内容。
先使用 Connectivity Test 检查所选条目,再结合实际请求和 Diagnostics 定位失败环节。测试结果受 Test Method 与当前网络影响,不能单凭一次测试判断所有网站或协议都可用。连接开关开启但目标打不开时,继续核对 Global Routing、命中规则、DNS 与服务状态。Data 可辅助观察流量变化,但有流量不等于特定目标访问成功;应以目标请求的实际结果作为验证依据。
固定服务器与配置,分别在当前网络和另一可用网络验证。记录失败发生在订阅更新、VPN 建立还是目标访问阶段,再按对应步骤处理,避免反复删除整个配置。
2 档获取:iPhone / iPad 在 App Store $2.99 一次性购买;Mac、Windows、安卓、Linux 版免费,安装包由本站下载页提供。
从 App Store 产品页获取,系统要求以 App Store 页面标注为准。购买前核对账户所在商店;同一购买账户可在兼容的 iPhone 与 iPad 上恢复获取,不需要把设备变化当作新的购买。
查看 iPhone / iPad 获取说明 →先在“关于本机”查看芯片,再选对应的 dmg。下载页分别列出 Apple 芯片与 Intel 按钮;首次打开遇到系统提示时,按安装放行说明核对来源并处理,不需要凭浏览器识别结果猜芯片。
查看 Mac 下载 →在下载页获取本站提供的 exe。首次运行若出现 SmartScreen 提示,先核对文件来自本站,再按“更多信息 → 仍要运行”处理;如果设备由组织管理,应遵循管理员设置的安装策略。
查看 Windows 下载 →从本站下载页获取 apk,并按系统提示为发起安装的浏览器允许“安装未知应用”。如果微信内置浏览器无法下载,改用系统浏览器打开下载页;安装完成后可按需要收回临时授予的权限。
查看安卓版下载 →按发行版的包管理方式选择格式。deb 与 rpm 使用相应包管理器安装;AppImage 需要先添加执行权限。下载页提供格式与安装说明,执行命令前先确认下载文件的位置与实际名称。
查看 Linux 下载 →电脑与安卓安装包通过本站 /dl/shadowrocket/ 提供。更新时重新进入下载页获取当前包;iPhone / iPad 的更新通过 App Store 处理。安装权限与 VPN 连接权限属于不同环节,完成安装后仍应按首次使用步骤确认连接授权。
查看全部平台 →以下预览以 iPhone / iPad 为例。先完成手动连接,再考虑自动触发、同步或更复杂的规则调整。
在 Home 的添加入口输入已有信息。单条服务器按 Type 填写字段;已有订阅则使用 Subscribe 导入并更新。保存后返回 SERVER 检查条目,选中准备测试的服务器,避免把导入成功与连接成功混为一谈。
如果使用二维码,先确认内容来自自己的服务商,再通过 Scan QR Code 读取。导入后仍需核对字段,不要在公开图片里展示订阅地址或认证信息。
需要按规则分流时选择 Config,并在 Config 确认当前配置文件。Proxy 与 Direct 是整体处理姿态,适合在理解用途后用于检查;不要只因为某个目标失败就长期切换模式而忽略具体规则。
第一次验证尽量保持配置简单。先确认所选服务器可连接,再检查分流结果;若同时导入复杂配置、更换服务器和调整 DNS,出现问题时很难确定原因。
首次建立连接时,按系统提示允许添加 VPN 配置。完成授权后回到 Home,检查连接状态并使用 Connectivity Test,再访问自己需要验证的目标,确认实际请求符合预期。
连接开关开启不代表所有请求都走代理。若结果不符合预期,先查看 Global Routing 和规则策略,再检查服务状态。记录具体失败阶段,比反复重装更有助于排查。
Shadowrocket 是闭源商业应用。iPhone / iPad 核对商店产品信息,其他平台从本站下载页获取对应安装包。
在 App Store 产品页确认名称为 Shadowrocket,开发者为 Shadow Launch Technology Limited,再核对链接中的应用 ID 932747118。官方图标可与本站页头图标对照。不要只凭搜索结果里的名称或相近图形判断,三项信息应指向同一产品。
本站为 Shadowrocket 官网与官方手册,获取指南将商店可见性、购买和恢复分章说明。电脑与安卓用户应进入本站下载页,根据设备选择安装包,不需要套用 iPhone / iPad 的商店购买流程。
App Store 按账户所属国家或地区展示应用,中国大陆商店目前无法搜索获取 Shadowrocket。设备语言、系统地区和商店账户地区不是同一个设置;只改变设备语言不会改变账户对应的商店目录。
先在账户设置中查看“媒体与购买项目”对应账户,再核对“国家或地区”。是否可以变更地区还取决于账户余额、有效订阅和付款资料等条件,应以账户页面提示为准。具体核对顺序见获取指南,不要将搜索不到直接判断为设备不支持。
iPhone / iPad 在 App Store 美区定价为 $2.99 一次性购买,其他店面以当地货币显示;Mac、Windows、安卓、Linux 版免费。iPhone 与 iPad 可在同一购买账户下共用购买,换机或重装时先从 App Store 的已购项目查找,再确认设备兼容性。
若页面再次显示购买价格,先检查当前“媒体与购买项目”账户是否与原购买账户一致,而不是直接重复付款。家人共享是否适用及成员获取条件,应核对产品页与家庭设置。系统要求以 App Store 页面标注为准。
iPhone / iPad 应用更新由 App Store 提供;Mac、Windows、安卓、Linux 用户重新进入本站下载页获取当前安装包。应用更新改变客户端本身,Subscribe 更新改变已有服务器列表,Config 更新则可能改变分流规则,三个操作的对象不同。
更新之前保留必要的配置记录。出现异常时,先确认刚刚更新的是哪一部分,再对照连接前后的差异。不要把服务器失效直接归因于应用更新,也不要用重新导入订阅代替检查当前配置文件与 Global Routing。
订阅更新成功只说明读取到了列表,不代表列表中的每个服务器都可用。先在 SERVER 确认当前选中项,运行 Connectivity Test,再检查服务状态、认证参数与当前网络。若条目可连接但目标访问失败,继续检查 Global Routing 与规则命中结果。
按步骤排查连接需要按配置规则分流时选择 Config;Proxy 与 Direct 分别使用整体代理与整体直连姿态。具体使用哪项取决于验证目标,切换后应重新发起目标请求。Config 模式下出现 DIRECT 并不表示客户端失效,可能是请求正常命中了直接连接策略。
查看模式说明先检查 On Demand 的条件与系统 VPN 状态。按需触发可能在符合条件时重新建立连接;服务器不可用或网络变化也可能影响连接。临时关闭按需行为进行一次手动测试,有助于把自动触发问题与服务器连接问题分开判断。
查看首次连接流程先确认编辑的文件就是当前选中的 Config,并检查 Global Routing 是否为 Config。然后从规则顶部向下检查是否已有更早的条件命中。保存修改后重新发起请求,避免用已有连接的表现判断新规则是否生效;必要时恢复原文件进行对照。
查看配置检查方法基础流程之外的问题,按具体主题继续查阅。下面三篇分别说明 Linux 安装、REJECT 规则与首次连接界面。
Linux 版免费。按发行版选择包格式,查看 apt、dnf 安装与 AppImage 添加执行权限的方法。执行前先核对下载位置和文件名,遇到依赖问题时保留包管理器提示,避免混用不同发行版的安装方式。
阅读安装说明 →REJECT 拒绝命中规则的请求。文章说明 DOMAIN-SUFFIX、DOMAIN-KEYWORD 与策略的组合方式,以及为什么规则位置会改变结果。规则匹配针对请求条件,不应将其理解为对页面内容的任意修改。
阅读规则说明 →从 Not Connected 开关开始,区分 Global Routing、Connectivity Test 与 SERVER 列表的作用。按首次连接顺序核对授权、选中条目与测试结果,明确每一步完成后还需要验证什么。
阅读界面说明 →