Shadowrocket 官网 · 官方手册

Shadowrocket
Settings 设置详解

按设置项查用途、取值条件与排错顺序。先确认配置来源,再调整 DNS、连接触发和本地 Proxy。

本页是系统查阅手册,不重复首次连接的完整操作主线。尚未导入自己已有的订阅或服务器信息,请先看使用教程;已经能够连接、需要理解某个开关,再按下面的目录查阅。教程中的设置说明也以本页为参考。

Shadowrocket 支持 iPhone、iPad、Mac(Apple 芯片与 Intel)、Windows、安卓及 Linux。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;获取入口和系统放行说明集中在全平台下载页。iPhone / iPad 系统要求以 App Store 页面标注为准。

查阅方法:记录原值 → 每次只改一项 → 重新建立连接 → 用同一目标验证 → 保留或回退。

01 / SETTINGS & CONFIG

先区分 Settings、Config 与连接状态

设置不都来自同一个位置

查找某个选项时,先判断它管理的是应用行为、配置行为还是单个服务器。Settings 中常见的是测试、记录、同步与本地服务等偏好;Config 用于组织配置文件;服务器编辑页保存地址、端口、认证和传输参数。它们会共同影响一次连接,但不能相互替代。例如修改本地 Proxy 端口,不会改变远端服务器端口;修改测试方式,也不会修复写错的认证信息。

Home 里的连接开关表示是否尝试建立系统网络隧道,不等于所有请求都已经通过目标服务器。Global Routing 决定请求按配置处理、走 Proxy,还是走 Direct;所选服务器则是需要代理的流量可能使用的出口。排错时应同时记录这三处状态,避免只看开关已经打开,就认定配置、解析和远端连接均正常。

默认值、当前值与推荐值怎样理解

本手册把“默认值”限定为当前安装环境中可以核对的初始状态,不把网上某张截图当成所有设备的默认。导入配置、恢复备份、系统升级和更换网络都可能改变实际行为。界面显示空白时,也可能意味着继承系统或配置,并不必然表示关闭。先查看选项说明与当前 Config,再决定是否需要填写,尤其不要把未确认的数字照抄到端口、超时或间隔栏。

推荐值同样需要前提。需要本地测试时,推荐先保留当前可工作的方式;需要按域名分流时,推荐先验证规则和解析路径;没有跨设备需求时,不必为了“设置完整”而启用同步。只有明确当前问题、能说明改动预期并具备回退方法时,才调整相关项目。设置越多并不代表连接越稳定,多个新变量同时加入反而会遮住真正原因。

建立一份可回退的基线

修改前记下当前 Config 名称、Global Routing 姿态、所选服务器、网络类型以及准备修改的原值。涉及配置文件时,先保存可独立恢复的副本,并为副本写上便于辨认的名称。备份里可能包含认证内容,应保存在自己的受控位置;向他人展示问题时,只保留相关字段名称与脱敏后的结构,不展示完整订阅地址。

每次只修改一个变量,再断开并重新建立连接,使新设置能够参与新会话。已经建立的长连接可能继续沿用旧路径,浏览器和应用缓存也可能保留旧结果。验证时使用同一个目标、同一种操作和相近的网络条件。如果改动没有产生预期变化,先确认当前生效的确实是刚修改的配置,再考虑下一项,而不是马上叠加更多选项。

位置主要职责排查时先确认
Settings应用偏好及可用的辅助设置项目是否适用于当前平台
Config解析、分流及配置段内容是否选中预期文件
服务器编辑页远端地址、端口、认证与传输是否符合用户已有服务信息
Home连接入口、所选服务器与运行状态连接后是否产生目标请求

跨平台查阅时的边界

同一概念在不同系统上可能由不同权限实现。iCloud 与 Widget 依赖相应系统能力,本地端口则受监听地址、防火墙和进程占用影响。不要因为一台设备有某个入口,就认定另一台也应显示同样布局。迁移设置时应迁移需求与规则意图,再逐项核对可用入口,而不是照着界面位置机械点击。

本页只讲如何使用用户已有的订阅或服务器信息,不提供、不销售、不推荐节点或订阅。客户端一次性买断 ≠ 线路套餐,应用获取与远端服务是两件事。若还不能完成首次导入,回到快速上手主线先建立最小可工作的连接,再回来逐项优化;与当前任务无关的设置可以保持原状。

02 / DNS

DNS:先确认谁在解析域名

DNS 与代理连接是两个环节

访问域名时,应用通常需要先得到可用的目标地址,再建立后续连接。DNS 负责名称解析,代理服务器负责传输对应请求,两者相关但不是同一项测试。服务器延迟正常,只能说明某种探测获得了响应;如果域名解析失败,网页仍可能无法打开。反过来,域名能解析也不说明远端服务、证书验证或代理传输一定成功。

检查 DNS 时先弄清当前使用的是系统解析、配置中指定的解析服务,还是应用自身的解析行为。系统网络可能通过 Wi-Fi 或蜂窝连接提供不同的 DNS,某些应用也可能维护自己的缓存。修改 Shadowrocket 的 DNS 项目后,如果观察目标仍使用先前的缓存,结果可能暂时不变。因此应把“设置已保存”和“新请求实际使用了新路径”分开验证。

空白、system 与显式地址

配置中出现 dns-server = system,表示该项使用系统提供的解析服务;这不是对任何网络质量的保证。是否保留系统解析,应结合当前网络与目标访问结果判断。若现有解析正常,建议先保留,不必只因看见别人的配置填写了多个地址就跟着替换。显式指定解析服务之前,应确认该地址可达、用途明确,并了解请求会送到哪里。

界面空白不应直接解释成 system,因为它还可能表示未覆盖配置,具体含义要看当前项目说明。也不要把某种加密 DNS 的完整地址填进只接受普通地址的输入框;协议形式和输入格式必须与该项支持范围一致。如果界面没有说明支持某种形式,就不要据此推断。写错格式往往表现为解析异常,而不是保存时立即报错。

[General]
dns-server = system

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

上例只演示配置段及 DNS 与规则可以同时存在,不是所有网络的推荐完整配置。example.com 是教学域名;规则中的 PROXY 还需要有效的代理选择。保留此示例的重点是分清职责:[General] 里的 DNS 选项影响解析行为,[Rule] 里的规则决定请求如何处理,二者不能靠相同的词义互相推导。

延迟正常但网页打不开的检查顺序

先确认问题是否只发生在一个域名,再换一个自己平时可以访问的目标,并查看 Log 是否出现解析失败信息。若只有单一域名异常,检查本地映射、缓存与该域名本身;若多个域名同时异常,再比较不同网络下的表现。测试时不要同时更换服务器、DNS 和 Global Routing,否则即使恢复,也不能知道究竟是哪一项起作用。

若域名已经得到地址,却在随后连接阶段失败,应转向服务器参数、规则命中和目标端口检查。若连接建立后才出现证书错误,还应检查系统时间、目标主机名和相应的 TLS 参数。直接用目标 IP 替代域名并不是普遍有效的验证方式,因为目标服务可能依赖主机名、SNI 或证书匹配,测试条件改变后结果不能简单对照。

IPv6、缓存与本地映射的影响

同一域名可能同时返回 IPv4 与 IPv6 地址。只有其中一条路径异常时,可能出现部分应用可用、部分应用等待较久的现象。不要看到 IPv6 就立即关闭;先确认系统网络是否具备相应连接能力、日志里的目标属于哪一类地址,再进行单变量对照。若关闭相关选项后有效,应记录该结果与网络条件,而不是把它推广为所有网络的固定设置。

[Host] 本地映射也可能改变解析结果。排错时查看当前配置是否针对目标写入了固定地址,并确认这条映射仍符合实际需求。更换 DNS 不一定绕过本地映射,清理应用缓存也不等于撤销配置。恢复前记录原行,只暂时停用与问题目标相关的部分,避免把工作正常的其他映射一并删除。

03 / GLOBAL ROUTING

Global Routing:配置、代理与直连

先选择处理姿态,再解释单条规则

Global Routing 的三种常见姿态是配置、代理、直连,对应界面词 Config、Proxy、Direct。Config 依据当前配置处理请求,适合需要规则分流的情况;Proxy 用于让进入客户端处理范围的请求按代理姿态工作;Direct 用于直连对照。它们是整体处理选择,不是三台服务器,也不是订阅导入的三种格式。

如果需要观察某条规则是否生效,应先确认当前使用 Config,而且选中了包含该规则的文件。在 Proxy 或 Direct 姿态下,仅凭请求最终出口不能证明某条配置规则被命中。这里最常见的误判是:编辑完规则后仍停留在 Proxy,再把所有目标都走代理理解成规则顺序错误。检查整体姿态,应早于修改规则内容。

姿态主要用途不能据此证明
配置 / Config按照生效配置执行分流每条请求都会走代理
代理 / Proxy进行代理路径对照配置中的某条规则已命中
直连 / Direct进行直接连接对照远端代理服务器正常

规则按顺序匹配,具体条件放在前面

DOMAIN 用于匹配完整域名,DOMAIN-SUFFIX 用于域名后缀,DOMAIN-KEYWORD 用于域名中的关键字。它们的范围不同,不应仅为了减少行数而互换。精确到单个域名的需求优先使用明确条件;后缀规则可能覆盖子域名,关键字规则范围更宽,加入之前应考虑是否会误中其他不相关的域名。

GEOIP 与 IP-CIDR 面向地址相关条件,IP-CIDR6 面向 IPv6 网段。FINAL 用于没有被前面条件处理的剩余请求,因此应放在末尾。域名规则与地址规则混用时,解析结果和规则顺序都会影响观察结果,不能只查看列表里有没有某个域名,就断言该请求必然按预期处理。

[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

这个示例中,完整域名 example.com 先匹配 DIRECT;其子域名可以继续匹配后缀规则并走 PROXY。后面的 GEOIP 与 FINAL 处理尚未匹配的请求。示例用于说明顺序,并非建议直接替换现有配置。PROXY、DIRECT 与 REJECT 是处理动作,其中 REJECT 会拒绝对应请求,不能用作一般的连接修复措施。

Config 文件中的段落各管什么

[General] 组织全局行为,[Rule] 组织分流条件,[Host] 保存本地名称映射,[URL Rewrite] 用于请求改写。把规则行写到错误段落,不会因为语法看起来像规则就自动归类。编辑时保留段落标题,并核对相邻行属于同一类内容;不要只复制中间几行,遗漏它们原本依赖的配置上下文。

订阅主要解决用户已有服务器信息的导入与更新,配置文件则可能同时包含规则和行为选项,二者不是同义词。服务器列表更新成功,并不表示当前 Config 被替换;切换 Config,也不必然改变所选服务器。若更新后流量行为变化,应分别核对这两类对象,而不是反复执行 Subscribe 更新来尝试修复规则问题。

推荐的验证方法与回退边界

对一个明确目标建立新请求,查看实际域名、目标地址、处理动作与所选服务器是否符合预期。测试目标应尽量单一,因为一个网页可能同时请求多个资源域名,看到其中一个请求走 DIRECT,并不能代表整页所有连接都相同。先定位真正失败的资源,再决定修改哪条规则,避免用过宽的规则遮盖其他问题。

修改规则后保留一份差异记录:改了哪一行、期望什么请求变化、实际命中什么条件。没有证据时,不建议直接重排整份规则。需要进一步查格式,可读规则关键字与匹配范围;需要理解段落,可读配置文件结构详解。恢复时切回已保存的配置,再重新建立连接验证。

04 / ON DEMAND

On Demand:连接何时由系统触发

按需触发与手动开关的区别

On Demand 用于让系统在符合条件时触发相应的 VPN 连接行为。它回答的是“什么时候尝试连接”,不是“连接后哪个域名走代理”。后者仍应查看 Global Routing 和 Config。把两个层次混在一起,容易出现这样的误判:已经设置某个 Wi-Fi 条件,却期待它同时改变该网络上的域名规则;实际上这属于不同的配置职责。

启用前先确认手动连接已经可以工作。若服务器地址、认证或 DNS 本身错误,On Demand 只会让同一个失败过程在满足条件时再次发生,并不会补全缺失参数。建议先在稳定网络下手动建立连接,完成目标访问与日志核对,再添加触发条件;这样后续出现问题时,才能区分是自动触发失败,还是原本连接就不成立。

Wi-Fi 与蜂窝条件怎样选择

配置网络条件时,先写清需求:是在某个已知 Wi-Fi 下连接,还是在离开该网络后连接,或对蜂窝网络采用不同处理。不要同时堆叠多个互相覆盖的条件。若界面支持按 Wi-Fi 名称区分,应核对实际网络名称,注意名称相同不等于物理网络相同;公共环境里可能存在同名网络,因此名称条件不应被当成身份验证。

蜂窝网络和 Wi-Fi 切换可能伴随短暂断链、地址变化和会话重建。观察 On Demand 时,需要等系统完成网络切换后,再发起新的访问请求,而不是只盯着切换瞬间的图标。已有长连接可能中断,后台应用也不一定立刻重试。推荐用一个可以重复操作的前台目标验证触发结果,并记录切换前后的实际网络类型。

手动关闭后为什么又出现连接

如果手动断开后,系统在新的请求发生时又尝试连接,先检查 On Demand 条件是否仍然满足。此时应先停用相应触发条件,再进行手动开关测试。不要立即删除所有 VPN 配置;系统中还可能存在设备管理要求或其他网络设置,删除前应确认对象和用途,受管理设备则应遵循组织的网络策略。

排查“总是自动连接”时,记录三个时间点:用户断开连接、网络发生变化、应用再次发出请求。若每次都在同一个条件后触发,就应检查该条件;若完全没有规律,再看日志和系统状态。只凭图标消失后又出现,无法判断是 On Demand、生效配置变化,还是上一次连接结束显示延迟,必须结合可重复的操作观察。

默认与推荐:先保持可解释,再增加自动化

本页不把 On Demand 的初始开关状态写死。首次配置、恢复数据与系统 VPN 设置都可能影响当前状态,应以设备实际界面为准。推荐从手动工作基线开始,仅加入一个确有需要的条件,测试通过后再扩展。对于不熟悉条件关系的用户,能够明确手动启停,比配置一组无法解释的自动规则更适合作为排错起点。

测试自动连接时,也要测试不应连接的情况。只验证“应该触发时成功”,并不足以证明配置正确;还应进入预期不触发的网络,手动断开,再观察新请求是否使其重连。若行为与预期相反,先简化为单一条件检查,不要通过在规则末尾加入拒绝动作来代替连接触发控制,那会把两个不同层次的问题叠在一起。

睡眠、后台与电量观察

系统后台调度、网络请求频率和服务端重连策略都会影响连接活动。启用 On Demand 后若觉得耗电增加,应先比较相同使用时长内的实际请求和重连记录,而不是单凭开关状态推断。反复失败并重试值得优先检查,因为它可能来自失效参数或不可达网络;减少无意义重试之前,应先修复连接失败的原因。

恢复使用时,先验证前台访问,再让设备进入常见的锁屏、唤醒与切网流程。系统不会保证每个应用在唤醒瞬间都立刻恢复自己的会话,因此需要区分隧道已恢复和目标应用已重试。若手动连接始终正常,只有特定触发流程失败,可把网络条件、触发动作和日志摘要整理后,对照疑难解答继续定位。

05 / PING & CONNECTIVITY TEST

Ping 与 Connectivity Test:理解测试范围

有延迟数字,不等于业务连接完整成功

Ping、连接探测与完整网页访问可能检查不同环节。某种测试只确认主机或端口可达,另一种可能需要完成握手或请求指定目标;具体应以当前界面的测试方式说明为准。结果中的时间值必须结合测试类型理解,不能把不同方法得到的数字直接排序,再据此判断所有应用的使用体验。

传统 Ping 常与 ICMP 探测有关,但某台服务器不回应 ICMP,不代表它提供的代理端口必然不可达。同样,端口能连接也不代表协议认证正确。若界面允许选择测试方式,建议先明确要验证主机、端口还是经过代理的请求,然后固定一种方法比较。不要把所有显示 timeout 的情况都理解为服务器已经停止服务。

测试地址、超时与并发的取值条件

若测试需要目标地址,应选用途明确、能够稳定重复访问且符合输入格式的目标。测试完整 URL 与只填主机名可能不是同一件事,不应凭经验互换。目标服务可能限制请求、改变响应或暂时不可达,因此单个测试目标失败只能作为线索。应以另一项独立验证交叉确认,避免把目标自身故障归因于全部服务器。

超时时间过短,可能把较慢但能完成的请求标记成失败;时间过长,则会延迟发现明显不可达的结果。没有适用于所有网络的固定数字。推荐先保留当前可工作值,在同一网络、同一测试方式下重复观察,再根据正常完成时间与实际等待需求调整。测试结果波动很大时,优先查网络变化,不要不断增大超时来掩盖异常。

批量测试还会受到并发、设备负载和网络资源竞争影响。一次同时测试很多条目,结果可能不同于只测一条。若只关心当前服务器是否可用,先做单条测试,再进行实际访问;如果批量结果异常而单条正常,应降低测试干扰后重测,而不是立刻修改每个服务器的协议参数。

观察结果可以作为线索下一步
主机探测失败该探测没有得到预期回应检查端口与实际协议连接
端口可达,认证失败已到达某个监听服务核对协议、认证和传输参数
测试正常,网页失败测试路径不等于网页全部路径检查 DNS、规则与目标请求
仅切网后失败会话或网络条件发生改变新建连接并核对触发状态

协议参数应逐项核对,不按名称猜测

用户已有的服务器信息可能使用 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 或 HTTP、SOCKS5 等协议。不同协议所需字段不同,不能因为地址和端口相同就互换类型。先核对协议,再核对该协议实际需要的认证内容,最后检查传输、TLS 与主机名等附加参数;缺少的字段应回到自己的服务信息核实。

对于使用 UDP 或 QUIC 的场景,网络是否允许相应传输也会影响结果。TCP 端口测试正常,并不能证明 UDP 路径正常。若仅某类协议在特定网络失败,应比较同一配置换网后的表现,并在日志里寻找对应的握手或超时信息。关于传输原理,可继续阅读Hysteria2 与 QUIC 说明,但不要据此推断任何网络必然更快。

系统时间与可重复测试

系统时间明显偏差可能影响证书有效期判断或需要时间一致性的认证流程。先检查系统时间和时区是否符合实际,并确认自动校时能够正常工作。证书错误不应直接用关闭验证来处理;应核对目标主机名、TLS 设置与时间,找出错误条件。验证被跳过后“能连接”,也不能证明原配置已经正确。

推荐保存一份测试记录,只写网络类型、测试方式、目标、结果与改动项,不保存认证秘密。对同一服务器连续做少量重复测试,再用实际需要的应用验证。若结果仍为 timeout,按节点超时检查顺序逐项排查,不要把延迟最低当成选择的唯一依据,也不要把一次失败扩大成永久结论。

06 / LOG & DATA

Log 与 Data:把症状定位到具体阶段

先重现一次,再阅读对应记录

Log 的价值是把一次访问拆成可检查的阶段,而不是收集尽可能多的文本。开始前记下时间,暂停无关操作,使用一个明确目标重现一次问题,再查看对应记录。若同时打开多个应用,后台同步、页面资源和自动重试会混在一起,容易把无关错误当成当前故障。缩小测试范围,通常比增加记录量更有效。

不同平台与记录级别展示的字段可能不同,具体以当前界面为准。阅读顺序可以保持一致:有没有目标请求,目标名称或地址是什么,采用什么处理路径,失败发生在解析、建立连接、认证还是传输过程中。先按阶段归类,再看细节;不要只搜索一个熟悉的英文词,就忽略它出现在什么上下文里。

没有请求记录时,先查流量有没有进入

如果重现问题后完全找不到相关请求,先确认记录功能是否已开启、显示范围是否包含本次操作,以及时间是否对应。随后检查系统连接状态和实际使用的网络接口。某些请求可能由缓存直接满足,也可能走了不在当前观察范围内的路径。此时反复修改远端认证字段通常没有帮助,因为还没有证据说明请求已经到达该阶段。

网页是一组请求而非一个请求。页面主体能打开、图片不能加载时,应查失败图片对应的域名,不要只检查地址栏里的主域名。应用登录也可能调用与首页不同的接口。推荐只记录完成某个动作所需的最小步骤,例如打开目标页面后点击一次登录,再根据时间寻找对应连接,逐步缩小问题目标。

解析、握手与远端关闭的区别

解析失败意味着尚未得到预期的名称解析结果,应先查 DNS 与本地映射。建立连接超时可能发生在目标不可达、端口不通或传输受限等情况下,需要结合测试方式判断。认证失败则更值得核对协议类型和用户已有凭据。远端关闭连接可能涉及目标服务或协议不匹配,不能仅凭“关闭”二字判断责任属于哪一方。

日志中的一条错误也可能是后续重试已经恢复之前的中间状态。判断问题时应看用户操作最终是否完成、是否持续重复失败,以及新请求是否仍在同一阶段停止。一次临时错误和稳定可重现的失败应分别处理。若连接实际正常,不必为了清除每一条记录而修改已工作的配置;日志不是要求完全没有提示的成绩单。

Data 统计不等于远端服务计费

Data 中看到的统计应按其显示范围理解,可能与当前会话、设备记录或界面筛选有关。它可以帮助判断是否有数据活动,却不能自动替代远端服务的用量记录。客户端与远端统计的时间范围、协议开销和计数位置可能不同,因此数字不一致不能立即解释成异常。需要核对时,先统一统计起点和观察区间。

重置统计之前,先确认是否还需要保留当前数据来排错。重置 Data 不会修复 DNS,也不等于清空服务器状态;清理日志同样不等于撤销配置。把“清理显示”“重新建立连接”“恢复设置”分开操作,并在每一步后验证目标症状,才能避免一次清理后误认为某个网络问题已经永久解决。

记录级别与保留时间

更详细的记录可能带来额外存储、处理开销和隐私暴露面。推荐仅在需要重现问题时提高详细程度,完成后恢复原状态。若日志量很大,先缩短重现过程,再按目标和时间筛选,而不是长期维持最详细记录。当前版本是否提供级别、保留时间或清理入口,应以实际界面为准,不在配置里猜测不存在的键。

整理求助信息时,用一段话写清系统平台、网络类型、Global Routing、问题操作、失败阶段与已经做过的单变量测试。附上必要的脱敏片段,通常比整屏截取更易判断。若问题还不能归类,可从疑难解答查找相近症状;涉及配置段落的,则回到本页规则章节核对生效对象。

07 / ICLOUD & WIDGET

iCloud 同步、备份与 Widget

先分清同步、导出与远端更新

iCloud 同步依赖相应 Apple 系统、账号和系统权限,不是所有平台共用的通用同步方式。同步是让支持的数据在设备之间保持相应状态;导出备份是保留某个时点的副本;Subscribe 更新则从用户已有的订阅来源重新获取信息。这三种动作可能影响不同对象,不能用“都能带回数据”来视为同一种恢复办法。

开启同步前,先在当前设备保留一份可恢复的副本,并核对另一台设备正在使用什么数据。若两端内容已经不同,应先确定哪一份是需要保留的基线,再进行同步。不要同时在两端大幅编辑后反复开关同步,试图让系统自动理解哪次改动更正确;冲突、删除与覆盖的具体处理需要以界面提示和实际结果为准。

同步范围不能靠推测补全

是否同步服务器、配置、选择状态或部分偏好,应查看当前入口说明,并通过少量可辨认的测试项目验证。不要因为某个配置名称出现,就认定所有认证内容、日志和本地端口都已同步。推荐先用不含秘密的名称变更做验证,确认范围后再安排正式迁移;对于只有设备本地意义的设置,仍应逐台检查。

同步没有立即出现时,先确认设备使用预期账号、系统允许该应用使用 iCloud、网络可用且云端空间状态正常。随后让两端应用有机会完成同步,再观察结果。反复退出账号或删除应用会增加变量,也可能影响本地副本,不宜作为第一步。系统没有提供完成提示时,不要只凭等候时间推断数据必然已经传完。

备份文件怎样保存与恢复

备份可能包含能够访问远端服务的资料,应把它当作敏感文件管理。保存到自己的受控位置,明确文件对应哪台设备、哪套 Config 和什么用途;不需要把认证信息写进文件名。需要转移给自己的另一台设备时,确认接收对象和存放位置,完成后按实际需要清理临时副本,避免备份在多个位置长期散落。

恢复时先保存当前状态,再导入备份,并逐项核对服务器列表、当前 Config、Global Routing 和连接权限。恢复成功的提示只代表数据导入过程完成,不等于远端服务信息仍有效。先选择一个已知可用的条目手动测试,再恢复 On Demand 等自动行为;这样即使出现旧参数,也不会被自动重试掩盖。

Widget 是操作入口,不是完整诊断界面

Widget 的可用形式取决于系统与应用实际提供的能力。它适合快速查看或执行其支持的操作,但显示可能受到系统刷新调度影响。Widget 的状态与刚刚发生的连接变化不一致时,先进入 Shadowrocket 核对 Home 和实际请求,不要只根据桌面小组件的文字判断隧道是否工作,也不要连续点击制造多次相反操作。

添加 Widget 后,先用手动启停进行一次对照,观察它能显示哪些信息、点击后执行什么行为。锁屏与解锁状态下的交互限制可能不同,应按系统提示完成授权。涉及连接权限时,仍需在应用或系统中确认;不能把 Widget 当成跳过系统权限的入口。没有出现预期组件时,先核对该系统是否支持对应形式。

迁移后按清单核对,不只看列表

换设备后,列表看起来相同并不代表运行环境相同。新设备的网络、系统 VPN 权限、局域网访问权限和电量策略可能改变连接行为。推荐按顺序核对:手动连接、DNS、规则命中、测试方式、本地端口,最后才是 On Demand 和 Widget。iCloud 可用的设备之间也应如此,数据迁移不能替代功能验证。

若同步后的错误与另一台设备同时出现,先停止继续编辑,分别保存两端现状,再识别最近发生变化的对象。恢复某台设备时,应考虑同步是否可能把恢复结果再次传播。对于没有跨设备需求的设置,推荐保留本地管理;对于需要同步的数据,则建立独立备份习惯,使同步便利与恢复能力分别得到保障。

08 / LOCAL PROXY & RECOVERY

Proxy 端口、本地访问与恢复顺序

本地监听端口与服务器端口不是一回事

服务器编辑页中的端口属于远端服务参数,必须与用户已有的服务信息一致。本地 Proxy 端口则是当前设备上的监听入口,让支持手动设置代理的应用连接到它。把本地端口改成远端端口,不能使两者自动建立对应关系;同样,修改本地监听也不会修复远端认证错误。操作前应先确认自己正在编辑哪一种端口。

HTTP 与 SOCKS5 是不同的代理接入方式,使用它们的应用需要选择与监听服务一致的类型。只填写地址和端口而选错类型,可能表现为连接立即关闭或请求无法解析。某个应用是否支持相应代理,应以其设置说明为准;没有手动代理能力的应用,不会因为系统里存在一个本地端口就自动改走该入口。

监听地址决定谁能够连接

回环地址表示仅供本机访问,例如 IPv4 的 127.0.0.1;它不是局域网中另一台设备的地址。另一台设备如果填写自己的回环地址,请求会留在那台设备本身,而不是到达运行 Shadowrocket 的设备。需要本机应用使用时,推荐优先限制在本机范围,并保持不需要的局域网共享功能关闭。

若确有局域网接入需求,应先确认当前平台提供对应监听能力,再核对监听地址、设备局域网地址、防火墙与网络隔离条件。监听到更广的接口会扩大可接入范围,不能把“同一 Wi-Fi”视为访问控制。不要为了临时测试把服务暴露到公共网络;测试结束后恢复原来的监听范围,并核对仍有哪些应用引用该端口。

端口取值与占用检查

本手册不指定一个适用于所有平台的固定默认端口。推荐先读取当前实际监听值,再让调用应用填写同一值。若需要修改,选择有效范围内且未被其他服务占用的端口,同时检查系统权限要求。端口保存成功不代表监听已经建立,应查看服务状态或日志,并用本机的一个明确请求验证。

出现端口占用时,先识别占用者,不要直接结束不明系统进程。可以停用不需要的重复监听,或者为其中一个服务选择其他端口;随后同步修改所有引用它的应用。只改 Shadowrocket 而忘记浏览器里的手动代理设置,会让旧入口继续被调用,看起来像刚修改后的客户端无法连接,实际是调用方仍指向旧值。

症状优先检查避免的误操作
本机应用无法接入监听状态、地址、端口、代理类型直接重写远端认证信息
另一台设备接入失败平台能力、接口范围、防火墙、网络隔离关闭全部系统安全控制
退出后浏览器也打不开调用应用是否仍保留手动代理反复导入订阅
只能访问部分目标实际规则、DNS 与失败请求任意更换本地监听端口

从最小改动开始恢复

如果问题出现在一次明确改动之后,先回退那一项,再重新建立连接验证;不要立即恢复全部设置。若最近改动较多,先暂时停用相关自动触发,切回已保存的 Config,核对当前服务器,再检查 DNS。最后才处理本地监听和调用应用设置。恢复应沿依赖关系逐层进行,而不是把清理缓存、删除数据和重装混成一个动作。

准备重置之前,确认可用备份已经保存,用户已有的订阅或服务器信息仍可找回,并记录系统层面的手动代理与 VPN 设置。重装不保证清除所有系统网络状态,也不能使失效的远端信息恢复。若需要重新获取应用,使用下载页选择当前平台,并按其中的安装放行说明操作,不在本页猜测安装包路径。

恢复完成后的验收顺序

先让一个明确目标完成访问,再检查 Config 下规则是否按预期命中,然后比较 Wi-Fi 与蜂窝,最后恢复 On Demand、同步及 Widget。每完成一步都保留结果,出现问题时回到最近成功的状态。这样能将“基础连接正常”和“自动化配置正常”分别验证,避免所有功能一起恢复后再次失去定位线索。

如果仍然失败,按解析、连接、认证、规则、调用入口的顺序整理证据,带着脱敏后的必要字段查疑难解答。设置工作的终点不是填满每个输入框,而是每项改动都有明确用途、可重复结果和回退记录。其余未涉及的项目保留当前已验证状态,后续出现新需求时,再按对应章节逐项查阅。