官方手册 · 系统查阅

Shadowrocket
完整使用手册

从安装与权限开始,逐步核对服务器、规则、连接记录与日常设置。操作以 iPhone / iPad 界面为例,安装章节同时说明 Mac、Windows、安卓与 Linux。

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

本页用于系统查阅,不要求首次使用时一次读完。使用教程按一条可执行的主线完成首次连接;本手册解释每一步依赖什么、怎样确认结果,以及遇到异常应回到哪个阶段。已经完成导入的用户,可以从 Global Routing 或连接验证开始,避免重复修改正常工作的部分。

以下步骤以用户已有自己的订阅或服务器信息为前提。配置文件、服务器信息与订阅地址是三类不同资料,保存位置和用途不能混用。界面词保留英文原文;实际可见项目应以设备上当前 Shadowrocket 的界面为准。

01 / ACQUIRE

获取与安装:先确定设备和渠道

先完成应用安装,再处理服务器与配置,能够把系统安装问题和连接问题分开。iPhone / iPad 版从 App Store 获取,$2.99 一次性付费;Mac(Apple 芯片版与 Intel 版)、Windows、安卓、Linux 版免费。各平台入口集中在全平台下载页,电脑与安卓安装包经本站 /dl/shadowrocket/ 路径提供。不要把教程中的配置文本当成安装文件,也不要用订阅地址替代下载入口。

iPhone / iPad:核对商店条目

打开下载页的 App Store 产品入口,核对应用名称 Shadowrocket、开发者 Shadow Launch Technology Limited,以及产品地址中的应用 ID 932747118。官方图标与这些文字信息应同时一致,不能只看搜索结果中的名称。系统要求以 App Store 页面标注为准,购买前也应查看当前账号所在商店显示的价格与兼容性。商店显示不支持当前设备时,应先确认系统与设备条件,而不是反复尝试导入配置。

中国大陆商店没有此应用。搜索不到时,先检查 Apple ID 所在商店地区,而不是把搜索无结果理解为应用已经停止提供。账号地区可以在系统设置的 Apple 账户、媒体与购买项目、查看账户、国家或地区中核对,具体名称随系统界面变化。地区调整可能涉及余额、有效订阅与付款方式,应先阅读系统提示。详细定位方法见App Store 地区与商店可见性说明。

电脑与安卓:选择对应安装包

Mac 需要先在“关于本机”中查看芯片信息:显示 Apple 芯片时选对应版本,显示 Intel 时选 Intel 版,两种安装包不能仅凭文件大小判断。Windows 在下载页选择对应的安装入口;安卓选择提供的 arm64 安装包。Linux 根据发行版的软件包体系选择 deb 或 rpm;使用 AppImage 时,还需允许文件作为程序执行。文件下载完成不等于安装完成,应按系统提示完成安装并确认能正常打开。

桌面与安卓安装包没有代码签名,首次启动可能触发系统拦截。只对从本站下载、且设备使用政策允许运行的文件执行放行;受组织管理的设备应先咨询管理员。macOS 遇到“无法验证开发者”时,在系统设置的隐私与安全性中查看“仍要打开”。若出现“已损坏”提示,可在确认应用已放入 Applications 后使用下面的命令清除隔离属性;命令不能修复实际未下载完整的文件。

xattr -cr /Applications/Shadowrocket.app

Windows 的 SmartScreen 如显示拦截,可先展开“更多信息”,核对文件来源后选择“仍要运行”;如果没有此按钮,应检查系统策略,不要修改组织限制。安卓需要为实际打开安装包的浏览器或文件管理器开启“允许安装未知应用”,安装后可关闭这项权限。Linux 的 AppImage 先添加执行权限,再运行文件;deb、rpm 应交由系统软件包工具处理依赖。完整放行路径见安装放行表。

安装后要保存哪些信息

首次打开前,准备已有服务器的地址、端口、协议及认证信息,或者用户自己的订阅地址。不要把敏感地址发到公开评论或截图里。iPhone / iPad 换机重装时,先在原购买账号的已购项目中查找;电脑与安卓可重新访问下载页获取安装包。应用获取资格并不包含服务器资源:客户端一次性买断 ≠ 线路套餐。本站不提供任何节点或订阅,后续章节只说明怎样使用已有资料。

返回章节目录 ↑

02 / PERMISSIONS

首次启动与权限:建立可排查的起点

首次启动的目标是确认应用能打开、界面能找到、系统允许建立连接,而不是立即调整全部设置。打开 Shadowrocket 后,先查看 Home 中是否已有服务器条目,再识别 Config、Data、Settings 的入口。Home 用于服务器选择与连接操作,Config 用于配置文件,Data 用于查看连接和流量相关记录,Settings 用于应用设置。后续操作都围绕这几处进行,记住入口比记住按钮位置更可靠。

先检查设备原有网络

保持 Shadowrocket 的连接开关关闭,用浏览器打开平时能够访问的页面,确认 Wi-Fi 或蜂窝网络本身可用。酒店、校园或公共 Wi-Fi 可能需要先在认证页面登录;未完成认证时,服务器测试和网页请求都可能失败。应先处理系统弹出的认证流程,再回到应用。若设备连普通网页也失败,应检查网络连接、飞行模式和当前网络权限,不要直接修改服务器密码或规则。

同时检查设备是否有其他正在运行的 VPN 连接或由组织下发的网络配置。系统通常不会让多个普通 VPN 隧道同时按各自预期工作,自动连接功能也可能在用户操作后重新接管。排查时先确认当前由哪项连接生效,必要时暂停自己可以控制的其他自动连接。不要删除不认识的组织配置;设备管理策略可能是安装和连接限制的原因,应保留错误提示并交由管理员核对。

理解 VPN 配置授权

第一次开启连接时,系统可能提示允许添加 VPN 配置,并要求设备密码或生物识别确认。这是允许应用创建系统网络隧道,不是导入订阅,也不是服务器账号验证。只有在用户主动打开 Shadowrocket 并执行连接操作后,才应确认相应提示。授权完成后返回应用,观察连接状态是否变化;若取消授权,连接不能完成是预期结果,应重新执行连接并在系统提示中确认。

VPN 配置授权与服务器认证是两个独立环节。前者成功,只能说明设备允许建立隧道;后者仍取决于远端地址、端口、协议和认证参数。系统出现 VPN 状态标识,也不能直接证明所有目标都可以访问。不要为了消除连接错误而反复删除系统中的 VPN 配置,这会丢失一个稳定的排查起点。先记录错误发生在授权之前、开启之后立即断开,还是保持连接但请求失败。

按实际功能授予权限

使用 Scan QR Code 时,系统可能询问相机权限;拒绝后不能扫码,但仍可用手动填写或已有链接导入。需要从照片读取二维码时,应只按系统提示授予所需访问范围。通过剪贴板粘贴资料时,系统可能提示是否允许粘贴,应确认剪贴板里确实是自己的服务器或订阅信息。权限与所用功能对应,不必为尚未使用的入口提前开放所有权限,也不要把授予相机权限误当成完成服务器配置。

建立首次测试记录

开始导入前,记下当前网络类型、是否完成 VPN 授权,以及 Home 中有没有现成条目。如果是在旧设备迁移后首次打开,也应先检查 Config 当前选中的文件,不要默认迁移内容已经全部生效。发现界面名称与教程位置不同,可以按英文词寻找对应功能,并参考界面英文词对照。不要依据一张旧截图连续点击相同坐标,尤其在 iPad 的不同布局下。

本阶段完成的标准是:应用可以稳定打开,基础网络正常,权限提示能够完成,用户知道如何回到 Home 和 Settings。此时即使还没有可连接的服务器,也不应把空列表认定为应用故障。继续下一章添加已有资料;如果授权后立即退出、系统限制无法确认或设备管理阻止连接,应先处理权限层的问题。把权限、服务器和规则分层检查,可以避免以后每次失败都从重新安装开始。

返回章节目录 ↑

03 / IMPORT

服务器与订阅:分清资料,再选择导入方式

先判断拿到的是单个服务器信息、单节点分享链接,还是订阅地址。单个服务器需要填写协议参数;分享链接通常以协议前缀开头;订阅地址一般通过网络获取一组服务器资料。三者不能因为都能复制成文字就使用同一导入入口。已有资料如果附有参数说明,应先核对资料类型与适用协议。不要把网页说明地址、账号管理页面地址,或者配置文件下载地址直接当成服务器地址。

Add Server:逐项填写服务器

在 Home 进入 Add Server,先选择与已有信息一致的协议,再填写服务器地址和端口。地址字段通常是域名或 IP,不应混入浏览器地址中的路径、查询参数或页面标题。端口必须使用资料给出的值,不要根据协议名称猜测。备注只用于本地辨认,不能替代服务器地址。填写后保存,回到 Home 核对条目是否出现,再进入条目复查协议类型,避免创建过程中切换协议却沿用了不对应的字段。

协议重点核对常见混淆
Shadowsocks地址、端口、Password、MethodMethod 与服务器配置不一致。
VMess / VLESS地址、端口、UUID、传输参数只填 UUID,遗漏传输或 TLS 设置。
Trojan地址、端口、Password、TLS、SNI连接地址与证书名称混用。
HTTP / SOCKS5地址、端口、认证要求把网页登录信息当成代理认证信息。

协议字段必须按已有服务器配置对应填写。UUID、Password、Method 不是可以互换的认证方式;TLS、SNI、Host、Path 也承担不同作用。以 Trojan 为例,连接地址用于找到服务器,SNI 用于 TLS 握手时指明名称,两者可能相同,也可能由服务器配置指定为不同值。不要通过关闭证书验证来掩盖名称填写错误。相关字段可以继续查阅Trojan 参数说明。

分享链接与二维码

已有单节点分享链接可以按应用提供的导入入口处理,二维码则使用 Scan QR Code。扫描前应确认二维码来自自己的服务器资料,扫描后仍要检查生成条目的协议、地址和端口。二维码只是信息载体,不会替用户验证服务器是否有效。若识别后出现普通网页,说明二维码内容可能不是节点格式,应回到资料来源核对,而不是把网页域名填进 Add Server 的地址字段。

复制时要防止漏掉开头、末尾或把说明文字一起复制。聊天软件自动换行、全角标点、链接外层的引号,都可能使解析失败。导入成功后,参数可以隐藏在条目详情里,不应仅凭条目名称判断内容正确。需要理解不同前缀时,阅读分享链接与订阅链接的区别;手动修改编码后的链接容易破坏结构,优先重新取得完整原始文本。

Subscribe:添加和更新已有订阅

对于自己的订阅地址,进入添加入口选择 Subscribe,填写完整 URL,并给订阅设置便于辨认的名称。保存后执行更新,确认该订阅下是否生成服务器条目。订阅更新是一次网络请求,可能受基础网络、地址有效性或远端返回内容影响。出现空列表时,先看是否有更新错误,再核对地址是否被截断;不要连续创建多个相同订阅,否则后续难以区分哪个分组仍在更新。

订阅导入不等于规则配置导入。它通常负责刷新服务器资料,而 Config 中的文件决定分流规则等行为。更新订阅后,原先选择的服务器可能已经改名或被移除,应重新确认 Home 中的选中项。订阅地址往往带有访问凭据,提交问题时只描述错误类型,不公开完整地址。此阶段完成的标准是:至少有一个参数可核对的服务器条目,或者已有订阅能够正常刷新,并且用户知道当前选中了哪一条。

返回章节目录 ↑

04 / GLOBAL ROUTING

Global Routing:配置、代理、直连三种姿态

Global Routing 决定请求怎样选择处理方式,不负责修复服务器参数。界面中的 Config、Proxy、Direct 对应配置、代理、直连三种姿态。日常按规则分流通常使用 Config;临时判断所选服务器是否能承载请求,可以使用 Proxy;隔离代理因素时,可以用 Direct 做对照。切换姿态后,应重新发起请求并观察记录,不能用切换前已经建立的长连接来判断新设置是否生效。

姿态处理依据适合核对什么
Config当前配置文件中的规则与策略。目标是否匹配了预期规则。
Proxy以代理方式处理适用请求。所选服务器与目标的基本连通性。
Direct以当前本地网络直连。不经过所选代理时的对照结果。

Config 与配置文件的关系

选择 Config 前,先进入 Config 页面确认当前正在使用哪个文件。下载了一个文件,不代表它已经成为当前配置;编辑后未保存,也不会得到预期结果。配置中可能包含 DNS、规则和策略引用等内容,不能只检查文件名称。下面的片段展示基本结构,示例域名只用于解释语法,不代表需要访问的服务,也不应把示例替换成一整套未经核对的日常配置。

[General]
bypass-system = true
dns-server = system

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

规则按顺序检查,先匹配到的适用规则决定处理结果。因此具体例外通常放在宽泛规则之前,FINAL 放在末尾作为兜底。若把过于宽泛的规则提前,后面的精细规则可能没有机会执行。GEOIP 的判断依赖目标 IP 及相应数据库,不等于识别网站使用的语言,也不等于识别公司注册地。把所有中文网页都预期为同一策略,是常见的规则理解误差。

规则关键字与策略不是同一类内容

DOMAIN 表示精确域名,DOMAIN-SUFFIX 表示域名后缀,DOMAIN-KEYWORD 表示域名中包含的关键字;IP-CIDR 与 IP-CIDR6 分别针对对应地址范围。它们描述“匹配什么”,末尾的 PROXY、DIRECT、REJECT 描述“匹配后怎样处理”。策略关键字不能填进域名位置,协议名也不能替代策略名。修改时应保留英文逗号,并检查是否把中文说明或多余空格混入了关键字段。

PROXY 将适用请求交给代理处理,仍依赖可用的服务器;DIRECT 使用本地网络直连,不代表目标必然可达;REJECT 拒绝匹配请求,可能正是某些请求失败的预期原因。配置如果引用自定义策略组,还需要检查组本身的成员和选择状态。看见规则命中并不等于整个路径已经成功,策略之后的 DNS、连接和远端响应仍可能出错。

用三种姿态定位问题边界

同一目标在 Proxy 下正常、Config 下失败时,优先比较命中的规则、策略组以及配置中的 DNS 行为;不要立即重填服务器。若 Direct 正常而 Proxy 失败,先检查服务器连通性和远端路径。三种姿态都失败时,应回到基础网络、目标服务状态与 DNS 层面。对照时保持同一设备、同一网络、同一目标,并尽量在接近的时间内测试,否则网络切换会让结果失去可比性。

返回章节目录 ↑

05 / VERIFY

连接与验证:区分隧道、服务器和目标请求

连接验证至少包含三个层次:系统是否允许隧道启动,所选服务器是否可通信,目标请求是否按预期完成。Home 中的开关保持开启,只能作为第一层状态的线索,不能直接推导后两层全部正常。验证时先确认选中服务器,再确认 Global Routing,最后发起一个明确的请求。每次只改一个变量,并记录修改前后的结果,比同时更换服务器、DNS 和规则更容易找到原因。

开启连接前做最后核对

在 Home 检查选中的服务器是否来自刚刚导入的条目,尤其是在订阅更新、名称变化或分组较多时。不要仅看列表顶端的名称,要核对实际选中状态。随后查看 Global Routing;若计划测试规则,应选择 Config 并确认当前文件。需要临时隔离规则影响时再切到 Proxy。打开连接开关,按系统提示完成 VPN 授权,等待状态稳定后再切到浏览器,不要在状态变化过程中连续点击开关。

如果一开启就立即断开,先看应用是否给出配置错误或系统授权错误。此时浏览器测试的意义较小,因为请求可能还没有进入预期隧道。检查是否取消过权限、配置文件是否存在无法解析的内容、系统里是否有自动接管的连接。若开关能保持开启但请求超时,则把排查重点转到服务器、DNS 和规则;这两类现象应分别记录,不能统称为“连不上”后直接重装应用。

Connectivity Test 能说明什么

Connectivity Test 用于观察应用所提供测试方式下的连通情况。不同测试方式检查的目标与环节可能不同,应先查看当前选项,不要把一个显示的时间值当成所有网站的实际速度。测试成功说明相应测试路径得到了响应,不保证目标网页的证书、登录、内容加载与其他域名请求全部成功。测试失败也需要结合实际网页请求判断,不能仅按一次测试结果认定整个订阅失效。

选择一个自己熟悉的普通网页重新打开,观察是否能完成主文档和必要资源加载。网页文字出现而图片失败,可能涉及不同资源域名或既有连接;应用能登录而某个功能失败,也可能是该功能使用的独立目标。应记录失败的具体请求,而不是只记产品名称。浏览器可能复用连接与缓存,切换设置后可以重新打开页面,必要时关闭对应页面再重试,以减少旧连接对判断的干扰。

按失败现象逐层检查

若域名请求失败,但基础网络正常,检查当前 DNS 设置及连接记录中的错误。DNS 负责把名称解析成地址,解析失败和连接到地址后超时不是同一件事。不要随意输入不明 DNS 地址,也不要认为更换解析方式一定改善访问。若提示 TLS 或证书相关错误,应核对设备日期时间、服务器名称、SNI 与已有资料中的要求。关闭验证会掩盖问题,不应作为常规处理步骤。

若只在某个 Wi-Fi 失败,而蜂窝网络正常,检查该 Wi-Fi 是否需要认证、是否限制相应协议,或者是否存在本地 DNS 与网络策略差异。切换网络后重新建立连接,再用同一目标测试;不要把两次网络条件不同的结果当成服务器忽好忽坏的唯一证据。涉及 UDP、实时音视频等需求时,还要确认服务器与实际协议支持对应传输,网页能够打开并不能自动证明这些功能也能正常工作。

验证完成后保存基准

一次有效验证应留下明确基准:在什么网络下,使用哪个本地备注的服务器,选择哪种姿态,访问哪个目标,结果是什么。不必记录真实密码或公开完整地址。确认工作正常后,再逐步启用需要的自动化设置;出现新问题时就能回到已知可用的状态。若全部步骤仍无法定位,可到疑难解答按现象继续核对,并在求助前整理错误文本和已做过的测试,避免只提供一张开启开关的截图。

返回章节目录 ↑

06 / DATA

Data 与连接记录:从现象回到具体请求

Data 和相关连接记录的用途,是把“某个页面失败”缩小到“哪个目标、采用什么策略、在哪个阶段失败”。不同界面提供的统计范围和字段可能不同,应以当前应用实际显示为准。先阅读字段名称,再解释数字含义;不要把设备上的所有流量、隧道内的流量、应用记录到的请求以及服务器计量当成同一个范围。记录帮助定位问题,但不能替代对服务器状态和目标服务本身的检查。

先限定一次可重复的观察

开始观察前,记住当前时间和正在测试的目标,然后只执行一次明确操作,例如重新打开一个页面。返回 Data 或连接记录,寻找时间接近的条目。后台同步、消息推送和其他应用也可能产生连接,因此最新出现的条目不一定属于刚才的页面。应结合目标域名、时间和实际操作筛选,避免看到一条失败请求就认定主页面失败,或者看到一条成功请求就认为整个页面已经恢复。

一个页面可能包含主域名、图片、脚本、登录接口和统计请求,分别命中不同规则。排查时先找与主要功能直接相关的目标,再检查附属资源。若无法分辨,可以对照页面操作前后的新增记录,而不是一次修改所有出现的域名。对于复用已有连接的请求,未必每次都能看到全新的连接条目;这时应重新发起测试,并在必要时重建连接,避免把“没有新条目”直接解释为应用没有接管流量。

把策略结果与规则顺序对应起来

当记录提供策略或规则信息时,先看实际采用的是 PROXY、DIRECT、REJECT,还是某个自定义策略组,再回到当前配置寻找对应条目。如果预期走 PROXY 却显示 DIRECT,检查前面是否有更宽泛的域名或 IP 规则抢先匹配。如果显示 REJECT,应确认是不是配置中的拒绝规则生效。修改前保存原文,调整后重新连接并产生新请求;历史记录不会因为规则已修改就自动改写。

[Rule]
DOMAIN,account.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-SUFFIX,ad.example.net,REJECT
FINAL,PROXY

上面的顺序说明了例外与范围的关系:精确匹配的 account.example.com 先于整个 example.com 后缀规则出现,其余适用的子域名才继续匹配后缀规则。示例只说明规则顺序,不表示这些域名需要加入日常配置。若记录只显示目标 IP,不能凭名称猜测域名规则一定生效;应结合 DNS、请求产生方式和实际可见信息判断,避免把无法观察到的字段当作已经确认的事实。

流量数字的边界

上传与下载统计可以帮助判断是否发生数据交换,但存在数据交换不等于业务完成。TLS 握手失败、重复重试或只加载了错误页面,也可能产生流量。反过来,缓存命中会让页面显示正常而新增流量很少。观察前应先确认统计是当前连接、累计值还是某一界面的汇总,切换网络与重连也可能影响观察范围。不要用短时间内的一组数字估算长期用量,更不要直接据此判断服务器计费是否准确。

需要分析异常耗量时,先停止不相关的大文件下载或后台任务,再观察特定操作产生的变化。系统统计、应用统计与远端统计可能采用不同周期和口径,协议封装、重传及连接维护也会造成差异。应先对齐观察时间,再比较趋势,不应要求不同界面的数值逐字相等。如果设备在闲置时仍有流量,先检查后台应用和自动更新,而不是立即认定规则或服务器出现故障。

整理可分享的诊断信息

提交排错信息前,遮盖订阅 URL、服务器地址、认证字段和可识别个人行为的域名,只保留必要的错误类型、策略、时间关系与操作步骤。若需要清理记录,应先保存经过脱敏的关键信息,再使用当前界面提供的清理功能。完成定位后不必长期保留高密度调试记录;日常观察只要能回答“当前是否按预期分流”即可,把敏感记录的保存范围控制在实际需要之内。

返回章节目录 ↑

07 / SETTINGS

Settings 常用项:稳定连接后再做自动化

Settings 中的选项应按需求逐项调整,不需要把所有开关都打开。先保留一个已经验证可用的基准,再处理 On Demand、测试方式、订阅更新以及与记录有关的设置。部分网络行为也可能由 Config 中的配置控制,因此遇到设置结果与预期不符时,应同时确认当前配置文件。应用不同界面出现相似词语,并不代表作用范围完全相同,要先确认正在修改的是全局设置还是某个服务器的单独参数。

On Demand:明确何时自动连接

On Demand 用于根据设定条件触发连接,不会让错误的服务器资料自动变得可用。启用前先手动完成一次连接与验证,再确定希望在哪些网络环境中连接、在哪些环境中保持停止。如果当前界面提供按网络条件设置的项目,应逐条阅读条件,并避免重叠条件导致结果难以理解。第一次配置后,分别在预期触发和不触发的环境测试,不要只看到一次自动连接就认为全部条件正确。

当用户手动关闭连接后又出现重新连接,应先检查 On Demand 及系统中其他自动连接配置,而不是连续点击开关。进入需要网页认证的公共 Wi-Fi 时,自动连接可能让认证流程变得难以判断,应暂时停用相关自动化,先完成网络认证。排查结束后再恢复原设定。需要停止连接进行对照测试时,也应确认自动化不会在测试过程中重新启动,否则 Direct 与未连接状态的对照会被混淆。

Connectivity Test:固定测试条件

设置测试方式时,先了解测试究竟检查什么。某种方式得到响应,不能等同于所有协议和业务都可使用;不同方式得到的时间值,也不适合直接比较。为了观察同一服务器的变化,应尽量保持测试方式、网络和测试目标一致。若更改了测试设置,应在自己的排错记录中注明。不要仅因一次测试时间较长就重建订阅,更不要为了追逐更小数字而同时更改 DNS、服务器和路由姿态。

测试产生请求,也会受到设备当前状态和远端响应影响。设备正在下载、网络刚刚切换或公共网络尚未认证时,结果可能偏离平时状态。先等待网络稳定,再重复少量测试,结合实际网页和应用功能验证。若测试一直失败但实际目标正常,检查测试目标本身是否可达;若测试正常但业务失败,回到连接记录寻找业务使用的具体域名,而不是继续反复点击同一个测试按钮。

DNS:先确认配置来源

DNS 设置应与当前配置一起阅读。配置文件中如果已经写入 dns-server 等项目,应先理解它们的作用,再决定是否调整相关设置。使用 dns-server = system 的示例意味着按该配置使用系统解析来源,不是固定指定某个公共解析服务。解析错误可能表现为找不到名称,也可能因得到的地址不同而影响后续连接,因此排查时要区分解析阶段和连接阶段,不能只看最终网页是否打开。

不要同时堆叠多处用途不明的 DNS 修改。家庭路由器、系统网络配置、组织策略和应用配置都可能参与解析链路,修改其中一处后应重新测试并观察结果。涉及内网名称时,还要考虑该名称是否只能在对应局域网中解析。对内网目标误用外部解析方式,可能造成名称不存在;将公网解析问题简单归因于规则,也可能让无关的分流条目越来越多。保留原始设置有助于快速恢复。

更新、记录与敏感功能

如果当前界面提供订阅自动更新,应结合使用频率设置,不必在每次切换应用时反复刷新。自动更新失败后仍要查看错误原因,不能认为打开开关就保证远端资料始终有效。与日志或记录有关的选项,应在诊断期间按需启用,完成后恢复合适范围。涉及 HTTPS 解密、证书或脚本的功能不属于基础连接必需步骤,应在理解作用、隐私边界及配置来源后单独研究,不要从陌生说明中整段复制执行。

每次调整 Settings 后,只测试与该设置直接相关的行为,并记录原值。若出现异常,先撤销最近一次修改,观察能否回到基准,而不是继续增加补偿设置。Settings、当前 Config、所选服务器和 Global Routing 应作为一组状态保存理解;仅备份其中一部分,迁移后不一定能复现原来的行为。对界面入口仍不确定时,可以回到使用教程核对主线,再按本章逐项扩展。

返回章节目录 ↑

08 / MAINTENANCE

日常维护:更新、备份、迁移与回退

维护的目标是保留可用状态,并且能够解释最近发生了什么变化。应用更新、订阅更新与配置文件更新是三件不同的事:应用更新改变程序本身,订阅更新刷新服务器资料,配置更新改变规则等网络行为。它们不一定同时发生,也不应在没有记录的情况下同时操作。出现故障时先回忆最近修改的是哪一层,往往比重新安装更接近问题来源,也能避免覆盖仍有价值的记录。

分别处理三类更新

iPhone / iPad 的应用更新通过 App Store 处理;Mac、Windows、安卓与 Linux 访问下载页重新获取对应安装包。更新前应保存自己的配置和必要资料,尤其是在设备空间不足、系统中断安装或跨设备迁移之前。电脑与安卓重新安装时仍可能出现系统放行提示,应按下载页说明核对来源后操作。不要用应用更新来代替订阅刷新,也不要因为订阅里的一个条目失效就推断应用需要重装。

订阅更新后,检查服务器数量变化、名称变化和当前选中项,但不要把条目变多当作更新质量更好的依据。某条服务器被移除时,原选择可能需要重新确认;某个名称保留时,内部参数也可能已经改变。更新失败应先确认基础网络和订阅地址有效性,保留具体错误,避免删除现有订阅后才发现没有保存原地址。对于用户自行维护的服务器,参数变化应以服务器实际配置为准。

配置文件更新前,保存一份当前可用的副本,并记录自己添加的例外规则。远程配置重新下载后,不能假定本地修改一定被保留,也不能假定新文件已经自动选中。应回到 Config 检查当前文件,再按固定目标验证 DIRECT、PROXY 与拒绝规则的效果。若更新后只有某个功能异常,比较相关规则与 DNS 项目,先回退涉及的部分,不要立刻把整份旧配置覆盖到所有设备。

备份时区分内容和凭据

备份至少应覆盖当前配置文件、必要的服务器资料、订阅来源及自己修改过的设置说明。导出内容具体包含哪些项目,应以应用当前提供的导出方式为准;不要假设一个文件已经包含全部密码、订阅和偏好。备份后先确认文件能够读取,名称能区分用途,再放入自己控制的安全存储。配置中也可能含有敏感信息,因此即使扩展名只是文本文件,也不应公开上传或作为普通附件随意转发。

订阅 URL、UUID、Password 和部分服务器链接具有访问价值,分享时不能只遮住备注名称。若凭据已经公开,应到用户自己的服务管理处撤销或更换相应资料,再更新设备上的条目;仅删除聊天记录或更改本地备注并不会使旧凭据失效。日常保存问题截图时,也应检查顶部名称、详情字段和完整 URL。对外描述可以使用错误类型和操作顺序,不必附上能够重建连接的完整资料。

换机和重装后的恢复顺序

新设备先安装应用并完成基本权限,再恢复已有资料,最后恢复自动化设置。iPhone / iPad 可在原购买账号的已购项目中查找;iPhone / iPad 版 App Store $2.99 一次性付费,Mac、Windows、安卓、Linux 版免费。购买记录与本地配置是两个独立部分,恢复应用不代表服务器和规则一定同时回来。恢复后重新确认当前服务器、Config 文件与 Global Routing,执行一次完整连接验证,再启用 On Demand。

迁移不宜只测试一个网页。应选择自己日常使用的几类目标,检查需要直连的本地资源、需要代理的请求,以及原配置主动拒绝的目标是否符合预期。不同设备所在网络不同,内网地址和 DNS 条件也可能不同;旧设备正常不代表新设备可以跳过网络检查。确认新设备稳定之前,保留旧设备上的可用配置与备份,不要在迁移第一步就清空原设备资料。

形成可回退的维护习惯

每次维护只做一类变更,保存变更前状态,完成后按第五章验证,必要时按第六章检查记录。遇到异常先撤销最近修改,再检查是否是基础网络或远端服务变化。向他人说明问题时,提供设备类型、网络环境、路由姿态、错误表现和已测试步骤,并去掉所有敏感字段。后续可以用疑难解答快速定位常见现象,用日志文章查阅单个概念;需要复查整体流程时,再回到本手册对应章节。

返回章节目录 ↑
Shadowrocket 官方下载