官方手册 · 按操作阶段查阅

Shadowrocket 完整使用手册 安装、订阅与规则分流

先建立可验证的连接,再调整规则与设置。本页覆盖全平台获取,后续操作以 iPhone / iPad 界面为例;其他平台的字段位置以实际界面为准。

iPhone / iPad:App Store $2.99 一次性付费;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux:免费。

  • 获取 → 权限 → 导入 → 分流
  • 验证 → Data → Settings → 维护
  • 使用用户已有的订阅或服务器信息

快速上手按首次连接的顺序完成一条操作主线;本页是系统查阅手册,解释每一步的前提、判断方法与失败分支。首次使用可先完成教程,再按下列目录返回查阅。已经安装的用户,可直接进入与当前问题对应的章节。

01 / GET & INSTALL

获取 Shadowrocket 与安装放行

先按设备选择安装渠道,再准备连接所需的信息。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;电脑与安卓安装包经本站 /dl/shadowrocket/ 路径提供。统一从下载页的全平台列表选择,不根据搜索结果中的相似名称判断文件。安装应用、导入服务器信息和建立连接是三个独立步骤,完成安装不代表已经具备可用的代理连接。

iPhone / iPad:先核对商店条目

在 App Store 产品页同时核对名称 Shadowrocket、开发者 Shadow Launch Technology Limited、应用 ID 932747118,并对照官方图标。系统要求以 App Store 页面标注为准。商店显示的币种和可用性取决于账号店面;搜索不到时,先查看账号地区、内容访问限制和付款状态,不要把相近名称的应用当作同一产品。账户地区的调整应通过系统账号设置进行,并先阅读其中对余额、订阅与付款方式的提示。

已有购买记录时,先确认当前登录的是当初购买所用的 Apple ID,再到已购项目查找。设备更换与重新安装不等于重新购买,但能否找到条目仍取决于账号记录及当前商店可用状态。iPhone 和 iPad 使用同一购买账号时,可按商店规则重新下载。关于查找记录的具体顺序,可阅读已购项目恢复说明。安装完成后暂不导入全部配置,先确认应用能够正常启动。

电脑与安卓:选择匹配的安装包

Mac 提供 Apple 芯片版与 Intel 版两个安装入口。在系统“关于本机”里查看芯片或处理器信息,分别选择对应文件,不以设备外观或购买年份猜测。Windows 使用对应的安装程序;安卓应确认设备架构与下载页标注匹配。Linux 按系统的软件包管理方式选择 deb、rpm 或 AppImage。不同格式的用途不同,不能仅修改扩展名互相替代;企业或学校管理的设备还可能受安装策略限制,应先确认是否允许自行安装。

系统提示处理入口操作前提
macOS 无法验证开发者系统设置 → 隐私与安全性 → 仍要打开确认来自本站下载页
Windows SmartScreen更多信息 → 仍要运行确认所选安装文件
安卓限制安装允许安装未知应用只对本次使用的安装来源授权
Linux AppImage 无法执行授予文件执行权限确认文件架构与系统匹配

这些电脑与安卓安装包没有代码签名,首次打开可能触发系统提示。先确认下载来源,再按表中入口处理;不要为打开单个应用而长期关闭整套系统保护。Mac 若提示应用“已损坏”,确认文件已完整下载并放入 Applications 后,可使用下面的命令清除该应用的隔离属性,再尝试打开。命令仅作用于列出的应用路径,不应扩大到整个磁盘;输入前核对路径中的名称与实际安装位置一致。

xattr -cr /Applications/Shadowrocket.app

Linux 使用 AppImage 时,可在文件属性中授予执行权限,或对实际下载的文件使用 chmod +x;deb 与 rpm 应交给系统包管理器处理依赖。安装失败时,优先记录系统提示、处理器架构和安装格式,再查安装放行说明。不要连续尝试不同架构的文件来碰运气。完成安装后,保留下载来源与安装格式的记录,便于后续更新时沿用同一渠道。

02 / FIRST LAUNCH

首次启动与权限确认

首次启动先认识入口,再决定何时授权。后文以 iPhone / iPad 为例:Home 用于查看服务器与连接状态,Config 用于管理规则配置,Data 用于观察连接和流量,Settings 用于调整客户端行为。不同系统或界面调整可能改变项目位置,但服务器参数、分流模式、系统连接权限之间的职责仍需分开理解。暂时找不到某个选项时,先按它所属的功能查找,不要直接删除应用来重置界面。

连接权限与服务器信息是两回事

第一次启动连接时,系统可能要求允许添加 VPN 配置。只有在刚刚由 Shadowrocket 发起连接、系统对话框的应用名称符合预期时才确认,并按系统要求进行设备验证。这项权限用于建立系统层面的网络接管,并不自动补全服务器地址、密码或订阅内容。若点了取消,通常可以返回应用重新发起连接,再按提示处理;不要把权限被拒绝误判为服务器失效,更不要反复更改协议字段。

系统中若留有其他网络配置,先查看当前究竟由哪一项建立连接。多个接管网络的配置、设备管理策略或系统级过滤设置可能相互影响。为了得到可复现的结果,首次测试只保留当前需要的连接方式,记录原有设置后再调整。受管理设备可能不允许添加或修改 VPN 配置,这种限制应通过设备管理方处理,应用内更换服务器通常无法改变系统策略。权限排查与网络连通性排查应分开进行。

按实际操作授予附加权限

使用 Scan QR Code 时才需要相机访问;从照片识别二维码时,应按系统弹窗选择必要的照片访问范围。二维码包含的连接信息可能带有密码、密钥或订阅凭据,不应把识别画面发送到公开讨论区。拒绝相机权限不影响手工填写 Add Server,因此可以先通过手动方式验证字段。若之前拒绝访问,进入系统中该应用的权限页面调整后,再返回原操作,而不是不断重复扫描动作。

本地网络权限与具体访问目标有关。若需要连接局域网内的服务器或访问家中设备,应检查系统是否允许相应访问;若只是在处理远端连接,不要把所有失败都归因于这个开关。遇到仅局域网地址不可达的情况,可先确认设备处在同一网络、目标设备已开机且服务端口正在监听,再检查规则是否将本地地址交给了错误的策略。把权限、地址和规则分别验证,才能避免一次改变太多条件。

首次配置前建立一份最小记录

开始导入前,记录当前使用 Wi-Fi 还是蜂窝网络、系统是否已有 VPN 配置、应用连接开关是否关闭,以及准备采用手工服务器还是已有订阅。无需记录密码,只需记下信息来源和操作时间顺序。这样在出现错误时,可以判断问题发生在添加权限、保存数据还是实际连接阶段。若界面里已有历史条目,先确认其用途;不清楚的旧配置可暂时停用,确认不再需要后再删除,避免丢失仍有用的规则。

建议先保持默认设置,不急于启用 On Demand、不同时添加多份 Config,也不立即更换 DNS。先让一个已知参数完整的服务器建立连接,再逐项增加功能。每次调整前记下原值,调整后只进行一轮相同的验证。若出现明显异常,恢复刚改动的一项,而不是继续叠加其他设置。这种顺序能把问题限制在较小范围,也能避免将权限问题、配置问题和远端服务问题混成一个笼统的“无法使用”。

03 / SERVER & SUBSCRIBE

添加已有服务器与订阅

先判断拿到的是单条服务器信息、单条分享内容,还是包含多个服务器的订阅地址。单条信息通常对应一个协议和一组认证字段;订阅则是用于取得并刷新一组条目的入口。两者外观可能都像链接,但不能随意填入同一个输入框。所有数据应来自用户自己的既有服务信息。首次导入前,确认内容没有被聊天软件折行、添加空格或截断,尤其注意链接末尾是否完整,复制后也不要公开展示其中的凭据。

Add Server:按协议逐项填写

在 Add Server 中先选择类型,再填写对应字段。服务器地址应填主机名或 IP,端口填服务端提供的数字,不把协议前缀、网页路径或端口一起塞进地址栏。备注只用于辨认,可以按用途命名;备注正确并不说明连接参数正确。协议类型选错时,其他字段即使看起来相似也不能通用。填写完成后逐项复核,再保存为一个独立条目,先不要同时添加多条近似配置,以免测试时选错对象。

协议重点核对字段常见边界
Shadowsocks地址、端口、加密方式、密码加密方式必须与服务端一致
VMess / VLESS地址、端口、UUID、传输参数传输与 TLS 参数不可凭经验套用
Trojan地址、端口、密码、TLS 参数认证密码与证书名称用途不同
WireGuard密钥、端点、地址、路由范围区分本地私钥与对端公钥
Hysteria2地址、端口、认证、TLS 参数网络需允许相关 UDP 通信

启用 TLS 的连接中,连接地址与证书验证名称未必相同,应按已有配置提供的信息填写。传输使用 WebSocket 时,路径和 Host 也属于协议约定的一部分,少一个字符就可能导致握手失败。不要为了让测试数字出现而关闭证书验证,也不要把所有空白字段都补成服务器地址。对缺失的关键参数,应回到原始配置确认;客户端无法仅凭协议名称推断服务端的全部设置。

Subscribe:保留分组与来源关系

添加已有订阅时,选择相应的订阅类型,将完整地址填入 URL 字段并保存,随后执行更新,等待列表返回。为订阅设置可辨认的备注,便于以后区分来源和批量管理。更新后先检查是否产生服务器条目,再选择其中一条验证。若列表为空,先确认地址是否仍有效、网络是否能取得订阅响应,以及内容是否为客户端能够识别的数据;网页能打开不等于返回内容就是可导入的订阅。

订阅更新通常会重新生成其管理的条目,因此直接修改订阅内某条服务器的字段,可能在下次更新时被覆盖。需要做临时对照测试时,先保留原订阅,并在能够明确区分的独立条目中修改,测试完成后清理临时项。多条订阅出现相同名称时,不要仅凭名字删除;应结合所属分组、地址和协议核对。相关整理顺序见多订阅管理说明,避免误删仍在使用的分组。

二维码、导入结果与凭据保护

Scan QR Code 适合导入已有单条信息,但必须检查识别后的类型和字段,不能只看“导入成功”。二维码也可能承载订阅地址,因此导入后要确认得到的是独立服务器还是订阅分组。Import from Cloud JSON 等入口只用于对应格式,不能把任意文本改扩展名后导入。无论使用哪种方式,都应在保存后重新打开条目检查核心字段,确认没有因为格式不兼容而遗漏认证或传输参数。

订阅地址可视为访问凭据,截图、日志和导出的配置都可能包含敏感信息。向他人描述错误时,只保留协议名称、错误类别和已隐去敏感部分的字段结构。若地址曾意外公开,应到原信息管理处处理凭据变更,再更新客户端中的记录。导入完成只代表数据已保存;下一步还需选择正确服务器与 Global Routing 模式,并经过实际连接验证,才能确认这份数据在当前网络下可用。

04 / GLOBAL ROUTING

Global Routing 三姿态与规则顺序

Global Routing 决定受客户端接管的连接如何选择策略。配置、代理、直连分别对应 Config、Proxy、Direct。它们不是三个服务器,也不是三种协议:服务器条目描述“如何连接远端”,模式描述“何时使用哪条路径”。排错时必须同时记录当前模式与所选服务器,否则同一个网站在不同模式下出现不同结果,会被误认为连接随机变化。先理解三者职责,再添加复杂规则,通常比反复切换模式更容易得到稳定结果。

界面模式判断依据适合的验证
Config · 配置根据当前启用配置中的规则决定策略检查目标命中规则及最终策略
Proxy · 代理将受接管的连接交给代理路径验证所选服务器能否完成实际访问
Direct · 直连将受接管的连接交给直连路径建立本地网络访问的对照结果

Config 不等于已经启用某份文件

选择 Config 后,还要确认 Config 页面中实际启用的是哪份配置。导入文件、编辑文件和选中启用是不同动作。配置可能包含规则、策略组、DNS 等内容,其中的策略名称必须与可用策略对应。若文件使用自定义策略组,而本地没有相应定义,即使语法看起来完整也可能无法按预期执行。首次使用应先阅读配置的主要部分,避免在不了解默认策略的情况下整份覆盖现有设置。

从具体规则到兜底规则

规则通常按顺序匹配,较具体的条件应放在较宽泛的条件之前,FINAL 作为最后的兜底。DOMAIN 匹配完整域名,DOMAIN-SUFFIX 按域名后缀匹配,DOMAIN-KEYWORD 按域名中的关键词匹配;关键词范围容易过大,不应只因一条请求异常就扩大到常见短词。IP-CIDR 与 IP-CIDR6 面向地址网段,GEOIP 依赖地址归属数据。域名匹配和地址匹配的输入条件不同,不能视为彼此完全等价。

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

上例只是用于解释顺序的规则片段,不是一份可以覆盖所有网络需求的完整配置。第一行将示例域名交给 PROXY,第二行让列出的局域网网段使用 DIRECT,之后按地址归属判断,最后由 FINAL 接住尚未匹配的连接。PROXY 与 DIRECT 是规则策略关键字,和界面中的 Proxy、Direct 大小写写法应分别保留。复制时不要混入全角逗号或额外引号;保存后先检查文件是否正常载入,再测试对应目标。

局域网地址并不只有示例中的一个网段,实际需要根据网络结构安排规则;IPv6 地址也需要单独考虑。若请求通过域名发起,DNS 解析结果可能影响后续地址规则判断。因此看到某个 IP 被直连时,不能仅凭域名后缀推断匹配过程。排查时应查看实际连接记录中的目标、命中规则与策略,确认是域名规则已命中,还是请求落到了地址判断或 FINAL。缺少记录时,先用少量明确规则构建对照。

用三姿态隔离问题

某目标在 Proxy 下可访问、在 Config 下失败,优先检查规则顺序、策略组选择和当前配置中的 DNS 设置,而不是立即重建服务器。若 Proxy 下也失败,再回到服务器参数、当前网络和远端服务检查。Direct 只用于建立直连路径的对照,并不保证所有目标都可达。测试时一次只改变模式,保留相同服务器、网络和访问目标,才能让结果具有可比性;测试完成后再恢复日常使用的模式。

修改规则前复制一份配置作为回退点,单次只添加解决当前问题所需的规则,并写下修改目的。规则越多并不必然越准确,重复项和互相覆盖的宽泛条件反而增加维护成本。USER-AGENT 等条件还有适用范围,不能假定所有加密连接都能提供可供匹配的应用层信息。不要为了某个条件命中而随意启用额外的解密设置;先确认现有域名、地址与策略规则是否已经足够解决问题。

05 / CONNECT & VERIFY

建立连接与分层验证

连接验证应从最短链路开始:确认本地网络正常、选定一个服务器、记录当前模式,再打开连接开关。首次弹出系统权限时按第二章处理。观察应用是否保持连接状态,以及是否立即出现错误,但不要把开关保持开启当作验证结束。完整路径还涉及服务器握手、域名解析、目标连接和具体应用请求;任何一层出错,都可能表现为网页一直等待,因此需要按层定位,而不是只反复开关连接。

先判断测试数字说明什么

Connectivity Test 的结果应结合所选测试方式理解。不同测试可能仅覆盖网络往返、端口连通或某个 HTTP 请求,不一定执行与你实际使用相同的完整过程。显示延迟不代表认证字段全部正确,也不代表持续传输速度、视频加载或特定应用一定正常。没有结果也可能与测试目标或测试方式有关。保留测试方法与网络环境,再比较同一条件下的结果;不要把不同类型的数字直接放在一起排名。

首次验证宜先使用一条配置明确的服务器,在 Proxy 模式下打开一个日常能够辨认结果的网页,确认出现的是新内容而非缓存页面。然后再测试需要使用的应用,最后切回 Config 检查规则路径。每次切换模式或服务器后,应重新发起请求;某些应用会复用已有连接,即使设置已经变化,旧连接仍可能延续先前路径。必要时关闭目标应用再打开,但不必在每次测试时重启整台设备。

按现象分开检查

若开启后所有目标都失败,先关闭连接确认基础网络是否正常,再检查所选服务器、认证参数和系统 VPN 状态。基础网络本身不可用时,修改规则不会解决问题。若只有部分域名失败,查看是否有错误的域名规则、DNS 返回异常或目标自身故障。若网页可以访问而某个应用失败,进一步确认它使用的域名、协议和现有长连接,避免用浏览器的一次成功替代对目标应用的实际验证。

连接超时与认证失败应分开处理。超时更值得先检查地址、端口、网络可达性以及远端服务是否监听;认证错误则应回到密码、UUID、密钥或协议字段。TLS 相关错误需要检查设备时间、证书名称和传输设置,不能一概通过关闭验证处理。若已有订阅刚刚更新,也要确认当前选中的条目没有发生变化,避免在排错时一直修改旧条目,而实际连接使用的是另一条记录。

可复现现象优先检查下一步对照
关闭连接仍无法上网基础网络、登录门户恢复基础网络后重试
Proxy 成功,Config 失败规则、策略、DNS查看目标连接的命中结果
Wi-Fi 失败,蜂窝网络成功网络限制、解析、UDP 可达性保持相同服务器复测
网页成功,特定应用失败目标请求与长连接重建目标应用连接并看记录

切换网络时保留相同条件

在 Wi-Fi 与蜂窝网络之间切换,可以帮助判断异常是否依赖当前网络。切换时保持服务器、模式和目标一致,等待系统网络状态稳定后再测试。公共 Wi-Fi 可能要求先通过登录门户,这时应先按网络要求完成登录,再建立客户端连接。不要在门户尚未完成时连续更新订阅或更换 DNS;那会让原本属于基础网络的问题看起来像多个功能同时损坏,也会增加无效的错误记录。

验证结果还应包含持续性。一次网页打开只能证明当时某条路径成功,可以再观察一段正常使用过程,查看是否反复重连、是否只在锁屏后中断、是否仅大文件或 UDP 应用异常。不同现象指向不同层面:锁屏问题可检查系统和按需连接行为,特定传输问题可检查协议与网络支持。不要以单次延迟高低作为唯一依据;关于测试局限,可阅读延迟测试与实际访问说明。

06 / DATA & CONNECTIONS

Data 流量与连接记录

Data 用于理解连接期间发生了什么,而不是替代远端服务的账户记录。查看流量前先识别页面展示的是即时速率、累计流量还是单条连接的数据,以及统计从何时开始。不同界面或统计项的范围可能不同,不能把其中一个数值直接当作整台设备在运营商处的计费流量。正确的用法是固定时间窗口和操作条件,观察某次请求是否产生记录、采用了什么策略,以及数据是否持续传输。

区分速率、累计量与连接数量

速率反映一个短时间段内的传输变化,累计量反映某个统计周期内的总量,连接数量则描述请求或会话的数量,三者没有简单的一一对应关系。一个持续下载可能只有少量连接却产生大量数据;一个网页也可能因多个域名、图片和后台接口产生许多连接。看到连接数较多并不能直接判断异常,应该结合当时正在运行的应用和请求目标,确认是否符合实际使用场景,再决定是否需要排查。

上传与下载方向通常以本机为参照,但阅读具体统计时仍应确认标签和统计口径。后台照片同步、系统更新、云存储和媒体预加载可能在没有明显前台动作时持续产生流量。怀疑统计异常时,先暂停已知的大流量任务,关闭不相关应用,再单独打开一个目标观察增量。不要仅凭某个瞬时峰值认定流量泄漏,也不要把页面刷新后显示归零理解为之前的数据没有经过网络。

用连接记录验证规则结果

排查规则时,连接记录比“网页是否打开”更有解释力。根据界面实际提供的字段,关注目标主机或地址、匹配规则、最终策略、所选服务器与错误信息。先发起一个容易辨认的新请求,再回到记录里定位相应条目。若同一应用同时连接多个域名,应逐个看用途,不要看到其中一条 DIRECT 就推断整个应用都在直连。应用登录、内容加载和媒体播放可能分别使用不同的目标。

域名不总能完整呈现在每条记录中。某些请求直接使用 IP,或者解析与连接过程之间存在缓存,因此记录里可能主要显示地址信息。此时要结合请求时间、目标应用与规则条件判断,不宜仅凭一个陌生地址添加大范围屏蔽规则。若已经修改配置,却仍看到旧策略,先确认当前启用文件、保存结果以及是否创建了新连接。旧连接复用会让最新规则尚未参与那条已有会话的判断。

解释客户端与其他统计之间的差异

客户端累计量、系统网络用量和远端账户流量出现差异,并不一定是记录错误。统计起止时间、直连流量是否计入、协议封装、重试以及远端的计量方式都可能不同。要比较时,应先对齐统计周期,并明确只比较同一范围。尤其不要用客户端显示的一个总量反推远端账户剩余额度;后者应以用户自己账户中的记录为准。Data 的主要作用是辅助观察行为和定位问题,而不是出具结算依据。

若需要验证某条规则,可先记录测试前的状态,随后仅执行一个动作,例如重新打开一个网页,再观察新产生的连接。完成判断后恢复正常应用使用。这样的短测试比在后台任务繁多时翻找记录更清晰。遇到疑似循环重试,应先停止目标应用或关闭连接,避免继续产生大量重复请求,再检查错误原因。不要一边让异常持续重试,一边不断清空记录,否则很难保留真正有用的上下文。

分享记录前先处理敏感信息

连接记录可能暴露访问目标、内网地址、服务器信息和时间规律;详细日志还可能包含配置中的凭据。发送截图前先裁去不相关区域并遮去敏感内容,只保留必要错误与字段。完成排错后,按实际需要关闭额外的详细记录,避免长期累积无助于日常使用的数据。如果要重置累计统计,先记下统计范围和重置时间;重置只是改变本地记录,不会改变已经发生的实际网络传输或远端账户用量。

07 / SETTINGS

Settings、DNS 与 On Demand

Settings 中的选项用于调整客户端行为,但不能替代正确的服务器参数与规则。进入设置前先明确目标:是希望特定网络自动建立连接、修正域名解析,还是改变测试方式。若无法说清要解决什么现象,先保持现值。不同平台及界面中的项目位置可能不同,配置文件也可能承载相关设置,因此修改前应确认当前值由哪里控制,避免在设置页改了一处,又被启用的配置内容覆盖。

DNS:先看解析结果,再改解析路径

DNS 负责把域名转换为地址,代理则负责后续连接路径,两者相关但不相同。域名无法解析时,服务器连接即使正常也可能无法完成访问;解析得到地址后,连接仍可能因规则或远端问题失败。排查时先分清是没有解析结果、结果不符合预期,还是已有结果但连接超时。不要把所有加载缓慢都归因于 DNS,也不要因为某个解析地址在别的网络可用,就假定它适合当前网络和规则组合。

选择解析方式时,要同时考虑解析请求本身走哪条路径、解析服务是否可达,以及后续地址匹配会受到什么影响。将一个需要通过代理访问的解析服务用于建立代理前的必要解析,可能形成相互依赖。为避免这种问题,应先确认服务器地址在当前网络下能够被解析,并从简单、明确的设置开始验证。每次只改一个解析相关选项,重新发起请求并查看记录,必要时等待缓存变化后再作判断。

域名规则与 IP 规则混合使用时,DNS 返回的 IPv4、IPv6 地址和缓存状态都可能改变匹配结果。若仅某个地址族失败,应检查当前网络是否具备相应可达性,并核对配置中的地址规则,而不是直接给所有请求统一套用一个解决办法。修改完成后应验证常用网页、局域网设备和目标应用,确保不是修复一个目标却改变其他目标的路径。能够恢复的原始配置,比没有记录地连续尝试更有价值。

On Demand:先验证手动连接

On Demand 用于根据所设条件触发连接,不负责自动修复错误的服务器信息。应先确认手动连接稳定,再逐项配置按需行为。设置时检查条件的范围和先后关系,例如网络类型或指定网络是否符合预期;不要仅启用总开关就假定所有场景都会自动连接。保存后分别在预期应触发和不应触发的网络环境中测试,并观察系统 VPN 状态与实际请求,确认动作与条件一致。

启用按需行为后,手动关闭连接可能在条件再次满足时被系统重新触发。这不一定是开关失灵,应先查看 On Demand 是否仍开启及其匹配条件。需要暂时排错或恢复基础网络时,先停用按需行为,再手动断开,完成后按原记录恢复。网络切换、设备锁屏和应用退出也属于不同事件,不能只验证其中一种就认定所有场景都可靠。遇到管理策略限制时,应区分系统限制与应用条件设置。

测试方式、日志与其他开关

Connectivity Test 的相关设置会影响测试对象和结果含义,改变测试方式后应重新建立比较基准,避免拿前后不同口径的数字作结论。详细日志只在需要时开启,先记下异常发生顺序,再复现一次并查看对应错误;完成后恢复日常记录级别。涉及证书、解密或请求改写的项目不属于首次连接必需项,未经明确需求与权限确认,不应仅为“让规则更完整”而启用,更不能安装来源不明的证书。

设置调整完成后,回到 Home 确认所选服务器与模式没有变化,再验证一组固定目标,并在 Data 中查看实际策略。若新设置没有改善原问题,应先恢复再尝试下一项,不要把一次试验留成长期配置。建议保留一份简短变更记录,写明原值、改动目的和验证结果即可,不记录任何凭据。需要查找具体问题时,可进入问答页按症状对照,而不是一次性修改所有看似相关的开关。

08 / MAINTENANCE

订阅更新、备份与日常维护

日常维护的目标是保留一份可理解、可恢复的配置,而不是不断增加服务器和规则。建立稳定连接后,记录当前有效的订阅分组、启用配置、常用模式及少量必要的设置差异。记录中保留用途和关系即可,不把认证信息写进普通笔记。每次准备大范围修改时,先确认现有连接仍可用,再建立回退点,这样即使后续更新出现异常,也能分辨是原有问题还是本次变更引入的问题。

订阅更新与应用更新分别进行

订阅更新取得的是用户已有订阅中的服务器列表和相关信息,应用更新改变的是客户端本身,两者不是同一操作。订阅更新失败时,先保留原有条目,不急于删除整个分组重新添加。检查当前网络能否访问订阅地址、原地址是否仍有效,以及返回内容是否正常。若原有服务器仍能使用,可先维持当前连接,再处理更新入口;删除订阅可能同时删除其管理的条目,使排错失去可用的对照。

更新后检查分组数量、常用条目是否仍存在,以及当前选择是否被替换。名称相同的条目也可能改变地址或协议参数,因此需要重新进行一次实际访问验证。对于自己手动添加的临时测试项,及时标记并在测试完成后删除,避免与订阅条目混淆。多订阅管理宜按来源分组,不以地区名称作为唯一标识。出现重复时先核对所属分组与用途,再清理,而不是按名称批量删除所有相似条目。

更新客户端时保留可恢复的数据

iPhone / iPad 的应用更新通过 App Store 管理;Mac、Windows、安卓与 Linux 从本站下载页取得对应的新安装包。更新前先保存必要配置并确认原有信息可恢复,不要为了更新直接删除应用及其全部数据。电脑安装应先退出正在运行的客户端,沿用正确架构与安装格式;首次打开新版若再次出现系统拦截,仍按第一章的来源核对与放行步骤处理,不因已经安装过就跳过来源确认。

备份内容应覆盖服务器信息、已有订阅入口、当前启用的 Config 以及重要设置,但具体导出范围要以实际导出界面为准,不假定一个文件包含所有内容。导出后确认文件能够被识别,并妥善保存到自己控制的受保护位置。配置文件可能含有密码、私钥和订阅凭据,不应放在公开网盘链接或讨论区。迁移到另一设备时,应先恢复最小必要数据并验证连接,再迁移剩余规则,避免一次导入后难以定位兼容问题。

换机、恢复与长期失效处理

换机后先完成应用获取,再恢复用户数据。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;已有购买记录的用户应使用原购买账号到已购项目查找,其他平台重新从本站下载即可。购买记录只能帮助恢复应用获取资格,不会自动恢复所有本地配置,也不能恢复用户自己的远端服务信息。应用安装、数据备份与远端账户应分别管理,避免将它们视为同一份资料。

遇到持续失效时,按固定顺序回溯:先检查基础网络与系统时间,再确认连接权限、当前服务器、Global Routing、启用配置和 DNS,最后核对远端参数是否发生变化。每一步都保留可复现的现象;若刚做过更新或规则修改,先恢复最后一个已知有效状态进行对照。不要同时重装应用、清空数据和替换全部参数,这样即使恢复连接,也无法知道真正原因,并可能丢失后续仍需要的信息。

日常检查不需要频繁清空统计、反复测速或不断切换服务器。只有在出现新现象、网络环境变化或完成配置更新后,再执行有目标的验证即可。需要求助时,整理系统类型、网络环境、所选模式、错误类别和已经完成的对照步骤,并隐去敏感信息。想重新沿操作主线核对,可返回快速上手;需要判断商店搜索问题,可阅读App Store 搜索排查;其他常见现象可查分类问答。