官方手册 · 按阶段查阅

Shadowrocket
完整使用手册

获取与权限 → 导入与分流 → 验证与维护。操作以 iPhone/iPad 界面为例。

首次连接可先阅读快速上手教程,按一条主线完成配置;本页解释每一步的前提、参数含义与失败分支,适合遇到问题时按章节返回查阅。

  • 8 个阶段
  • 已有订阅或服务器信息
  • 界面词保留英文

01 / 获取与安装

按设备获取 Shadowrocket

先区分应用获取与连接资料

Shadowrocket 是闭源商业应用,也是全平台规则代理客户端。iPhone/iPad 在 App Store $2.99 一次性付费,Mac/Windows/安卓/Linux 版免费。前者通过商店管理购买与更新,后者使用本站下载页提供的安装包。应用本身不包含用户的服务器权限,安装完成后仍需准备自己已有的连接资料。

请从全平台下载页开始选择设备,而不是根据搜索结果中的文件名判断来源。桌面与安卓安装包由本站 /dl/shadowrocket/ 路径提供,版本信息由下载页动态读取。下载中断时先重新打开该页,不要把其他来源的同名文件与本站文件混用,也不要根据图标相似程度判断安装包是否对应自己的系统。

iPhone/iPad:核对商店条目

进入 App Store 产品页后,依次检查产品名称、官方图标、开发者 Shadow Launch Technology Limited 与应用 ID 932747118。系统要求以 App Store 页面标注为准。付款前确认正在使用的 Apple 账号及商店地区,实际结算货币以商店显示为准;如果搜索不到,先查账号地区、年龄限制与账号状态,不要反复付款。

商店下载完成后,应用应出现在设备上。换机或重装时,先在原购买账号的已购项目中查找。购买记录与连接配置并不是同一份数据:重新获得应用不代表已有订阅、服务器和规则自动恢复。有关商店入口与核对过程,可继续阅读App Store 购买流程,配置恢复则见本页最后一章。

电脑与安卓:选择安装格式并处理系统提示

Mac 用户先打开“关于本机”,根据芯片信息选择 Apple 芯片或 Intel 对应的 dmg,不要仅凭机器外观和购买年份推断。Windows 使用对应的 64 位安装程序;安卓使用 arm64 安装包;Linux 按发行版选择 deb、rpm 或 AppImage。同一平台提供多个格式,是安装方式的区别,不代表需要把所有文件都安装一次。

桌面与安卓安装包没有代码签名,首次打开可能遇到系统拦截。处理前先确认文件确实来自本站下载页,并阅读提示所指向的文件。Windows 的 SmartScreen 可在“更多信息”中选择“仍要运行”;如果设备由单位管理、相关选项不可用,应联系设备管理员,不要为了安装而改动组织策略。

系统提示处理位置或操作
macOS 无法验证开发者尝试打开后,到系统设置的“隐私与安全性”检查“仍要打开”。
macOS 提示已损坏确认来源与路径后,参考下方命令处理隔离属性,再重新打开。
安卓限制安装为当前下载所用的浏览器或文件管理器临时允许“安装未知应用”。
Linux AppImage 无法执行为下载文件增加执行权限;deb 与 rpm 使用发行版的软件包管理工具。
xattr -cr /Applications/Shadowrocket.app

上面的 macOS 命令仅适用于应用已放入所示目录的情况,它会递归清理该应用目录的扩展属性,不应随意把目标改成整个下载目录或系统目录。安卓安装完成后,可以关闭刚才为浏览器开启的安装许可。Linux AppImage 则应对实际下载文件执行 chmod +x,不要对不清楚用途的文件批量授予执行权限。

安装阶段的验收标准是应用可以正常打开,并能访问 Home、Config、Settings 等实际提供的页面,此时不要求已经出现可连接的服务器。若系统仍拒绝执行,回到安装放行说明核对具体提示。先解决应用运行条件,再处理网络配置,可以避免把系统拦截、资料缺失和服务器不可达混成一个问题。

02 / 首次启动与权限

建立连接前检查系统权限

理解 VPN 配置授权的作用

以下步骤以 iPhone/iPad 为例。首次打开 Shadowrocket 时,先辨认 Home、Config、Data 与 Settings 的位置,不必立即调整每个开关。首次启用连接时,系统会要求允许添加 VPN 配置,并可能要求设备密码或生物识别确认。这项授权用于建立系统网络扩展,不会替用户生成服务器地址,也不会补齐订阅凭据。

应在自己主动点击连接之后核对系统弹窗,确认弹窗对应 Shadowrocket,再完成授权。若此前选择了拒绝,可以返回应用重新发起连接,并在系统设置中检查 VPN 配置状态。安装过配置并不等于正在连接;反过来,应用内存在服务器条目,也不表示系统已经允许建立网络通道。这两个层次需要分别确认。

如果授权窗口始终不出现,先退出当前操作并检查系统内是否已有相关配置,再查看设备是否启用了管理限制。单位或学校管理的设备可能限制创建 VPN,这种情况下应遵循管理员的设置。不要连续删除其他用途的网络配置,更不要把不认识的管理描述文件当作普通连接记录处理,以免影响原有工作环境。

权限按实际功能授予

使用 Scan QR Code 时,相机权限只服务于扫描过程;从相册识别二维码时,则按系统要求选择需要访问的照片。手动输入服务器或粘贴订阅并不要求先把所有媒体权限打开。若拒绝后需要重新授权,可到系统设置中找到应用,检查对应权限;返回应用后重新进入扫描入口,避免停留在旧的失败页面。

从剪贴板导入资料时,系统可能提示是否允许粘贴。确认剪贴板中确实是自己准备导入的内容,再继续操作。订阅地址常含有个人访问凭据,不要把它粘贴到搜索框、公共表单或聊天群中进行“测试”。导入结束后,可以复制一段普通文本覆盖剪贴板,减少后续误粘贴的机会。

若出现本地网络相关权限,应根据是否需要访问局域网设备判断用途。访问路由器、打印机或内部服务,与访问互联网服务器属于不同路径;即使允许了本地网络访问,也仍然可能受到当前路由规则或局域网本身的限制。权限决定应用能否执行某类操作,规则决定流量选择哪条路径,两者不能相互替代。

准备可复现的初始环境

首次验证建议选择一个已知可以正常访问互联网的网络,先在未连接 Shadowrocket 的状态下完成一次普通网页访问。这样可以确认设备时间、网络登录与基础解析没有明显问题。酒店、访客网络或公共热点若要求网页认证,应先完成认证,否则应用内的超时可能只是网络尚未允许设备联网。

同时检查系统中是否有其他正在占用 VPN 通道的连接。iPhone/iPad 上不同网络扩展可能互相影响,后启动的连接也可能替换前一个连接。测试期间应记录当前启用的服务,而不是凭状态栏图标猜测由哪个应用接管。若需要暂时停用其他连接,完成测试后再按原用途恢复,不必直接删除其配置。

在添加任何复杂规则前,建议保留一份简短的环境记录:当前网络类型、系统代理或 VPN 状态、是否完成网页认证,以及最初看到的错误文字。记录只需包含现象,不应包含密码或完整订阅地址。发生问题时,有这份基线就能判断变化来自新配置,还是网络环境本身已经改变。

本章完成后,合理的状态是应用能打开、必要权限已确认、基础网络正常,并且用户知道连接授权与服务器资料的边界。接下来再添加已有服务。若只是要尽快完成首次连接,可转到快速上手教程按顺序操作;需要理解每个输入字段时,继续阅读下一章。

03 / 服务器与订阅

导入已有服务器与 Subscribe

先辨认收到的资料类型

开始前确认手中资料是单个服务器参数、单条分享链接、二维码,还是包含多个条目的订阅地址。它们都可能表现为一段文本,却需要不同的导入入口。订阅用于批量获取和更新服务器列表,Config 则可能同时包含规则与其他设置;把订阅地址当作规则配置导入,并不能自动获得预期的分流行为。

服务资料应从用户自己已有的服务方取得。导入前核对链接是否完整,特别注意聊天软件换行、复制时遗漏尾部参数、地址前后混入空格等情况。链接中包含查询参数并不代表可随意删去,某些部分承担身份识别作用。对于无法辨认的短文本,应先询问资料提供方格式,而不是轮流尝试所有入口。

Add Server:字段需要成套一致

在 Home 使用 Add Server 时,先选择正确的协议 Type,再填写地址和端口。地址栏通常只填主机名或 IP,不应把整段网页链接连同路径粘进去;端口是独立数值。协议选择错误时,即使地址和端口完全正确,也无法仅靠更换密码修复,因此应先对照原始资料检查协议,再核对其余参数。

参数类别需要核对的内容
地址与端口主机名或 IP、对应端口,以及是否复制了多余空格。
身份与加密按协议核对密码、UUID、加密方式等,不在不同协议间照搬。
TLS启用状态、Server Name 与证书要求,以已有服务资料为准。
传输层按需核对 WebSocket、Host、Path 等字段,保留大小写和路径符号。

Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 与 HTTP、SOCKS5 的字段并不相同。界面出现额外选项不表示全部都要填写。尤其不要把其他条目的 TLS、Host 或 Path 复制过来凑齐表单。显示名称可以便于自己辨认,但名称只是标签,不会改变服务器的所在地、协议或实际连接方式。

如果资料明确使用域名进行证书验证,Server Name 不一定与连接地址相同,应以服务资料为准。出现证书错误时,先检查设备时间、地址与名称是否匹配,不要把关闭证书验证当作常规修复。缺少关键字段的资料应回到来源补齐,随机尝试安全相关开关只会让后续排查更难复现。

Subscribe:导入后检查更新结果

通过 Subscribe 或当前界面提供的订阅导入入口粘贴地址后,设置一个能识别用途的名称,再执行更新。完成后返回 Home,检查是否出现条目,以及条目归属是否符合预期。订阅名称只帮助区分来源;真正决定获取内容的是地址与其访问权限。界面布局可能调整,应以当前应用显示的入口为准。

更新失败时先区分“地址取不到”和“内容读不懂”:前者需要检查网络、地址与访问权限,后者需要核对返回内容是否是客户端支持的格式。订阅地址如果实际返回登录网页、过期提示或验证页面,重复刷新不会把它变成服务器列表。请保留错误文字,并向自己已有的服务方确认订阅状态。

从二维码导入时,先核对扫描结果的类型,再确认保存。二维码只是承载文字的方式,不是额外的可信证明。若相机识别不稳定,可在确保图片清晰且来源明确的前提下使用相册入口。不要把含凭据的二维码公开上传给识别网站,也不要在公开求助时展示完整二维码,因为他人可能直接读取其中资料。

订阅更新可能增加、移除或改名条目,更新前应记下当前选中的服务器,并区分订阅管理的条目与自己手动创建的条目。重复导入相同地址容易产生难以区分的分组,优先更新已有订阅,而不是每次都新增。导入成功后先选择一个资料完整的条目进入连接验证,暂时不要批量修改所有服务器参数。

本阶段的完成条件是列表中存在可识别的服务器,关键参数与原始资料对应,订阅更新也有明确结果。这里仍不能仅凭列表数量判断连接质量。关于条目选择与测试数字的关系,可参阅延迟测试与服务器选择说明;下一章先确定流量应如何使用这些条目。

04 / Global Routing

区分 Config、Proxy 与 Direct

三种姿态解决不同问题

Global Routing 控制进入客户端处理范围的流量采用哪种总体路由方式。中文可将三种姿态理解为配置、代理、直连,对应界面词 Config、Proxy、Direct。这里的姿态不是服务器协议,也不是是否已经连通的状态。切换到 Proxy 不会修复错误密码,切换到 Config 也不会自动生成一份符合个人需求的规则。

姿态处理依据常见用途
Config依据当前启用配置中的规则和策略处理连接。按域名、地址等条件区分路径。
Proxy受该模式接管的连接使用所选代理路径。临时排除分流规则的影响。
Direct受该模式处理的连接直接访问目标。比较直连结果,检查是否误用代理路径。

日常需要分流时,先在 Config 页面确认正在启用哪份配置,再把 Global Routing 设为 Config。只把文件下载到列表中,不一定意味着文件已启用;同样,编辑了一个未使用的文件也不会改变当前连接。测试前同时记录文件名称与路由姿态,可以避免一直检查正确内容却作用在另一份配置上的情况。

规则从上到下匹配

常见规则按顺序检查,优先匹配的条目决定处理策略,因此精确条件通常应放在宽泛条件之前。DOMAIN 匹配指定域名,DOMAIN-SUFFIX 匹配域名及其子域,DOMAIN-KEYWORD 检查域名中的关键字;IP-CIDR 与 IP-CIDR6 面向地址段,GEOIP 按地址归属数据匹配,FINAL 用于其余未匹配的连接。

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

这段内容是语法示例,不是适合所有网络的完整配置。第一行指定示例域名走 PROXY,第二条会拒绝域名中含有相应关键字的请求,第三条让所示私有地址段直连。GEOIP 的结果依赖地址归属数据,并不依据页面使用的文字判断。最后的 FINAL 提供兜底路径,应位于相应规则列表的末尾。

PROXY、DIRECT、REJECT 是规则策略关键字,与 Global Routing 中大小写形式不同的界面选项不是同一层概念。PROXY 还需要有可用的代理目标,DIRECT 仍依赖当前网络能直接到达目标,REJECT 则主动阻止匹配连接。若配置引用了自定义策略组,也要确认组名存在且组内有有效选择。

修改规则时保留可回退路径

修改前先复制或导出当前可用配置,只增加一条明确针对测试目标的规则,再重新建立连接观察变化。不要一边改订阅、一边替换完整配置,同时又切换路由姿态;否则即使结果改善,也无法知道是哪一步生效。域名规则还可能受到请求是否保留域名信息、解析方式以及连接复用的影响,应结合记录判断。

例如局域网设备无法访问时,应先确认目标实际使用的地址段,而不是看到示例中的私有网段就原样照抄。家中、办公室和访客网络可能使用不同子网;同时存在 IPv6 时,还应检查相关连接实际使用哪类地址。规则写错地址范围,常表现为某些设备能访问、另一些设备却走了意外路径。

规则配置中还可能出现远程引用,导入前应了解其用途和维护来源。来源改变内容后,后续更新可能改变分流结果,因此需要保留自己明确依赖的例外规则。更多语法与顺序案例见规则语法入门。本章结束时,应能够说清当前文件、总体姿态与目标规则分别是什么。

05 / 连接与验证

用分层验证定位连接失败

先建立连接,再验证访问

回到 Home,选中准备测试的服务器,检查 Global Routing,再开启连接。首次连接按系统提示授权;已有权限时,观察开关是否保持开启以及系统是否显示相应状态。开关立刻复位、持续连接中和连接后网页失败,是三个不同现象。先记录发生在哪一步,再决定检查权限、服务器参数还是具体访问路径。

测试前关闭会干扰判断的重复操作,例如连续切换服务器、反复刷新订阅或同时修改多项设置。选一个资料完整的条目,在同一网络上完成一轮验证后再比较下一个。若每次测试都换网络、换目标和换配置,结果之间就缺少共同条件,超时与成功都难以解释,也无法形成可重复的排错顺序。

Connectivity Test 可用于观察特定测试方式下的可达情况,但它不等于所有网站和应用的完整访问测试。测试目标、连接协议与网络条件都会影响结果。某个条目显示测试数字,可能只说明相应探测成功;没有得到数字,也不一定说明所有业务连接都必然失败,应结合实际访问与错误记录继续判断。

按四层顺序检查

  1. 确认设备基础网络正常,公共热点已完成认证,系统时间没有明显偏差。
  2. 核对服务器地址、端口、身份字段与传输参数,确认已有服务仍有效。
  3. 确认当前 Config、Global Routing 与策略组选择,查看目标实际走向。
  4. 使用新的目标请求验证结果,区分网页主文档、图片与其他资源的失败范围。

若是地址解析失败,先检查服务器主机名本身能否在当前环境解析,再看目标域名解析路径;若服务器直接使用 IP,也不能因此忽略目标域名的解析需求。若是连接超时,需要考虑当前网络到服务器的路径、端口可达性与服务状态。超时不是密码错误的专属表现,不能仅凭一个词就删除全部配置。

若错误明确指向身份验证,应回到原始资料检查密码、UUID 等字段,注意是否把显示名称误填为用户名,以及复制时是否带入空格。若指向 TLS,则检查设备时间、Server Name 和证书要求。先按错误所属层级缩小范围,比随意切换加密方式更有效;缺少资料时应向自己的服务方确认。

能够打开网页但部分图片或登录流程失败,通常需要把页面视为多个目标请求,而不是一个地址。主页面与静态资源、身份验证和接口可能使用不同域名,各自匹配不同规则。查看可用的连接记录,找出失败目标及其策略,再决定是否补充规则。不要因为一张图片失败就直接将所有流量长期改走同一路径。

用单变量对照确认原因

怀疑分流规则时,可以在保留原配置的前提下,临时对比 Proxy 与 Config,但需使用同一个目标并重新发起连接。怀疑当前网络路径时,可以保持服务器和配置不变,只切换到另一种自己可用的网络。每次只改变一个条件,记录结果后再恢复,才能判断问题属于配置、服务还是网络环境。

部分应用会保持长连接,即使改了规则也继续使用旧会话。测试新规则时,应先关闭相关页面或重新启动目标应用,必要时重新建立 Shadowrocket 连接,再发起新请求。浏览器缓存还可能直接显示旧内容,因此页面“看起来能打开”未必证明新的网络请求成功;可选择明确需要联网更新的内容进行验证。

如果仍无法定位,可整理为一份最小问题描述:设备与网络类型、操作步骤、失败目标类别、Global Routing、错误原文,以及已做过的单项对照。分享前移除完整订阅、密码、二维码与身份参数。可先查阅FAQ中的相同现象,避免把同一个问题通过多次重复导入变得更复杂。

06 / Data 流量

理解统计口径与请求记录

Data 不是账单页面

Data 用于查看应用提供的流量统计和相关记录。阅读数字前先确认它对应当前连接、某个统计周期还是累计记录,并查看单位和上下行方向。不同页面可能采用不同统计范围,不应只凭数值接近就认定它们完全相同。界面若提供重置或清理入口,也应先确认影响的是展示记录还是其他数据。

客户端可见流量、系统蜂窝网络统计与用户已有服务的用量记录,统计位置和规则可能不同。协议封装、重传、后台连接、直连流量以及计费周期都会造成差异。Data 中出现了数据变化,只能说明相应统计范围内发生了传输,不能据此认定远端服务已成功处理全部请求,更不能直接当作服务用量余额。

想比较一次操作产生的流量,应先记录开始值和当前时间段,停止不必要的后台任务,再完成一次明确动作后记录结束值。不要一边播放媒体、一边下载文件,再尝试把变化归因于刚打开的网页。需要重置计数时,先保存原来的记录;重置客户端显示不会改变系统统计,也不会重置已有服务的计费周期。

从请求目标检查分流结果

若当前应用提供连接或请求记录,优先关注目标域名或地址、匹配规则、选择策略与错误信息。它们可以帮助回答“这个请求是否经过客户端”“匹配到哪条条件”和“最终使用哪条路径”。并不是每条记录都会同时具备所有信息;缺失域名时,应考虑请求形式与解析过程,不要自行补出一个猜测的域名。

同一个网页可能产生很多连接,有些连接来自字体、图片、视频分片或后台接口,因此记录数量不等于打开页面次数。一个应用也可能在屏幕关闭后继续同步数据。排查时应围绕自己刚触发的操作缩小时间范围,再结合目标与策略判断,不要把列表中陌生的域名一概视为故障或异常活动。

在 Config 姿态下,如果目标实际匹配到了 DIRECT,就应优先核对规则顺序和地址条件,而不是继续更换代理服务器。如果匹配到了 REJECT,则应确认阻止行为是否正是配置预期。若记录指向自定义策略组,还要继续检查组内实际选中的目标;只看到策略组名称,不能说明组中的每个服务器都参与了连接。

观察结果可以说明什么仍需继续确认
计数增加统计范围内有数据传输。目标业务是否完成、路径是否符合预期。
出现目标记录应用观察到了相关连接。匹配规则、实际策略与错误原因。
记录命中 REJECT规则主动阻止了连接。该规则是否误伤了目标功能。

把记录用于短时诊断

如果刚操作的目标没有出现在记录中,先确认记录功能当前是否启用、筛选条件是否隐藏了条目,再检查目标是否复用了旧连接或根本没有发起网络请求。浏览器从缓存读取页面时,可能不产生预期的访问记录。缺少记录不是立即判定规则失效的证据,应先建立一次明确的新请求作为对照。

需要排查特定故障时,可暂时开启必要的详细记录,复现一次问题后立即保存相关片段,并恢复原来的记录级别。长时间保留大量诊断数据会增加查找成本,也可能记录个人访问目标。导出前只截取与问题相关的时间段,移除访问凭据、私人域名和可识别个人身份的参数,不必把整个使用历史交给他人。

清理 Data 中的记录前,先区分清理历史、重置计数和删除连接资料这几种动作。它们的影响范围不同,界面文字不明确时应先取消,确认后再执行。为了修复网页失败而清空所有历史,通常既不能修正服务器参数,还可能丢失定位问题所需的线索;应先保留证据,再做有针对性的更改。

本章的使用原则是先问具体问题,再选择对应记录:判断流量是否发生,看统计变化;判断目标走向,看规则和策略;判断失败层级,看错误信息;判断服务余额,回到用户已有服务的记录。把这些口径分开,Data 才能成为验证配置的工具,而不是一组被误解为连接质量评分的数字。

07 / Settings 常用项

按用途调整 Settings

On Demand 与手动连接的边界

Settings 中的选项应按实际用途调整,不必把所有开关都启用。初次配置时先保留能够完成验证的最小设置,等服务器、规则和目标访问都正常后,再增加自动连接或诊断选项。不同系统和应用界面可能显示不同入口,应按功能含义查找,不能因为手册提到某类设置,就假设当前页面一定存在同名开关。

On Demand 用于按系统支持的条件触发连接行为,不是连接速度设置。启用之前,应先确保手动连接稳定可用,再逐项检查当前提供的网络条件和例外设置。如果手动连接都因参数错误而失败,自动触发只会重复失败过程。不要用 On Demand 掩盖尚未定位的断线问题,也不要把自动重连与服务器永远可用等同起来。

设置按需行为时,应特别检查 Wi-Fi 与蜂窝网络切换后的结果,以及自己是否需要在特定网络中停用连接。保存条件后,分别在符合条件和不符合条件的网络中测试一次,观察实际状态。若手动关闭后又自动开启,应先检查 On Demand 条件是否仍在触发,而不是反复删除 VPN 配置或重新安装应用。

DNS、连接测试与配置来源

DNS 相关设置可能分布在 Settings 或当前 Config 中,阅读时先辨认究竟是哪一处正在生效。DNS 负责把域名解析为地址,代理策略负责连接路径,二者相关但不相同。修改解析设置后,已有缓存和旧连接可能暂时保留原结果,因此要用新请求验证。不要同时替换解析方式和整份规则,否则难以判断改善来自哪里。

遇到域名解析问题,应先检查域名拼写、当前网络与配置中提供的解析地址是否可达,再判断解析请求是否受到策略影响。把所有解析方式轮流填一遍通常不能形成可靠结论。若配置引用了远程规则或其他资源,还要确认资源地址能否获取,以及获取失败时当前配置会保留什么内容,避免在不了解结果时覆盖可用文件。

Connectivity Test 的测试方式与目标设置也会影响显示结果。改变测试目标后,不应直接把新数字与之前不同条件下的数字比较。若只是想判断某条服务器能否访问实际业务,应在统一测试条件下保留一次探测结果,再运行真实业务验证。协议、服务器地区和网络时段也应记录,数字变化才有解释基础。

谨慎处理证书、备份与高级选项

普通服务器连接与规则分流不要求为了“设置完整”而安装额外证书。涉及 HTTPS 解密的功能会改变设备对受影响连接的信任方式,应在明确用途、目标范围与隐私影响后单独评估,不属于首次上手必做步骤。若不知道某个证书选项的作用,应保留原状态,而不是按照不明配置的提示连续确认所有授权。

如果启用了同步或备份,先确认所用账号、同步范围与敏感资料存放位置。配置文件可能含有服务器身份字段,订阅地址也可能直接授予访问权限,因此应把备份当作私密资料管理。普通截图适合记录界面布局,不适合备份完整凭据;公共网盘分享链接也不应作为个人配置的日常备份方式。

对于 UDP、IPv6、路由排除或其他连接相关选项,应结合已有服务支持情况与实际故障调整。某个应用需要特定传输,并不意味着所有服务器都具备对应能力;当前网络提供 IPv6,也不保证配置中的所有地址规则都覆盖它。先确认功能依赖,再改开关,避免把兼容性问题误判成应用安装错误。

完成设置后,建议保留一份简单的变更记录,只写设置名称、修改原因、测试目标和回退方式,不记录完整凭据。日后更新应用或迁移设备时,可以据此分辨哪些是默认行为、哪些是自己主动添加的例外。需要查界面概念时可使用概念速查,需要处理具体异常时则回到连接验证章节。

08 / 日常维护

更新、备份与换机恢复

分别维护应用、订阅与 Config

日常维护应分成三条独立流程:应用更新、订阅更新和 Config 更新。应用更新改变客户端功能与兼容性,订阅更新改变已有服务列表,Config 更新可能改变规则、策略和解析设置。它们不需要每次同时执行。连接正常时先保留可用状态,只有在明确知道更新对象和影响范围后,再安排一次可验证的变更。

iPhone/iPad 的应用更新通过 App Store 管理;Mac、Windows、安卓与 Linux 则从本站下载页重新获取适合当前系统的安装包。iPhone/iPad 在 App Store $2.99 一次性付费,Mac/Windows/安卓/Linux 版免费。更新前先备份资料并停止正在进行的重要连接,不要把下载文件的完成时间当作产品发布日期。

更新订阅前记录当前条目与分组,更新后检查原选中目标是否仍存在。服务列表发生调整时,同名条目的参数也可能变化,所以不能只看名称判断完全没有变化。若自动更新失败,应先查地址与当前访问条件,不要立即删除整个分组;删除后再导入可能丢失自己记录的选择与排错线索。

备份要能实际恢复

备份前列出需要保留的内容:手动添加的服务器、订阅地址、当前 Config、自己修改的规则、策略组选择和常用设置。不同导出方式覆盖范围可能不同,一份规则文件不一定包含订阅资料,系统已购记录也不保存个人连接参数。导出完成后,应检查文件能否打开、内容是否符合预期,并保存到自己控制的私密位置。

如果当前版本与设备提供 iCloud 同步,应先检查系统中相应账号和同步权限,再核对应用内实际同步的项目。不要仅凭一个开关开启就认定迁移准备完成。重要迁移前仍应保留独立导出副本,并在旧设备上记下当前启用配置名称。同步可能传播误删和错误修改,独立副本则便于回到迁移前的状态。

备份文件和订阅地址都应按凭据处理。不要在文件名里写密码,不要把完整链接放入公开笔记,也不要将包含身份字段的配置截图发到公共讨论区。如果怀疑订阅地址已经泄露,应联系自己已有的服务方更换相关访问凭据,并更新客户端和备份中的旧资料;只删除聊天消息并不能撤回他人已经保存的内容。

换机按依赖顺序恢复

换到新 iPhone/iPad 后,先通过原购买账号的已购项目恢复应用,再打开应用并按需要授权。接着恢复服务器与订阅,然后导入 Config,最后调整 Global Routing、策略选择与 On Demand。不要在服务器尚未恢复时就启用引用它们的策略,也不要在基本连接验证前恢复所有自动触发条件。

恢复完成后,按本页第五章重新验证基础网络、服务器连接和目标访问,再检查局域网例外与日常使用的规则。新设备可能使用不同系统权限,新网络也可能采用不同地址段,旧设备的可用结果不能直接替代新设备测试。确认新设备可用并保留备份后,再决定是否清理旧设备,避免提前删除资料造成恢复中断。

跨平台迁移时,应把服务资料与具体配置功能分开处理。先确认目标平台支持的导入格式与设置范围,再逐项恢复,不要假设移动端导出的所有系统选项都会在电脑上产生相同效果。Mac 用户还应检查安装包芯片类型;Linux 用户应保留适合发行版的安装方式,而不是把多个格式反复覆盖安装。

若更新后出现问题,优先比较更新前后的单项变化,并尝试恢复已备份的配置或设置,而不是立即清空应用。向他人描述时提供可复现步骤、错误文字与已做的对照,移除个人凭据。有关导出与恢复顺序,可继续查阅配置备份与换机迁移;重复出现的连接现象则可在FAQ中按类别定位。

维护的结束条件不是列表中没有提示,而是当前状态能够被说明和恢复:知道应用从哪里获取、订阅属于哪项已有服务、哪份配置正在启用、常用目标怎样分流,以及备份存放在哪里。保留这一组可核对的信息,后续更换网络、更新应用或迁移设备时,就可以沿着同样的顺序重新验证,而不必从头猜测。

Shadowrocket 全平台下载