iPhone / iPad App Store $2.99 一次性 · Mac、Windows、安卓、Linux 版免费

价格两档说明 →

官方手册 · 按使用阶段查阅

Shadowrocket完整使用手册

从获取与安装开始,逐步说明已有订阅、Global Routing、连接验证与设置维护。获取覆盖全平台;后续操作以 iPhone / iPad 界面为例,不将某个平台的菜单位置套用到其他系统。

教程用于完成第一次连接;本页用于理解参数、检查边界情况与建立日常维护顺序。

SubscribeConfig / Proxy / DirectDataSettings
  • 08 使用阶段
  • 02 获取价格档
  • 03 Global Routing 姿态
  • CONF 规则片段说明

阶段 01 / 获取前先确认设备

获取与安装:按系统选择入口

Shadowrocket 是全平台规则代理客户端。本章先区分获取渠道,后续再进入应用内操作。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。这里的价格描述针对客户端,不包含用户已有服务商的任何服务。客户端一次性买断 ≠ 线路套餐;本站不提供、不销售、不推荐节点或订阅。安装完成后,仍须准备自己的服务器信息或已有订阅,才能继续本手册的连接步骤。

iPhone / iPad:核对商店条目再获取

从下载指南的 iPhone / iPad 分区进入商店,或打开 Shadowrocket App Store 产品页。将开发者名 Shadow Launch Technology Limited、官方应用图标和应用 ID 932747118 对照核实,不只根据搜索结果中的名称判断。系统要求以 App Store 页面标注为准,价格以当前店面实际结算显示为准;价格档仍是 iPhone / iPad 一次性付费、其他平台免费。

搜索不到时,先确认当前商店地区是否提供该条目,再查看登录的购买账户。大陆商店没有此应用;需要调整地区时,应先阅读系统账户内的地区变更条件,处理余额、现有订阅及付款资料要求。已购买用户重装时,优先进入同一购买账户的已购项目,不要把另一个账户的购买记录当作当前账户的权益。iPhone 与 iPad 使用同一购买账户时,可按商店的已购记录重新获取。

电脑与安卓:先选架构,再处理系统提示

其他平台统一从全平台下载页获取,安装包由本站 /dl/shadowrocket/ 路径提供。Mac 在“关于本机”查看“芯片”或“处理器”,分别选择 Apple 芯片版或 Intel 版;两个安装包不是按外观或电脑购买年份区分。Windows 选择对应的 64 位安装程序,安卓使用页面列出的 arm64 安装包,Linux 按发行版和安装习惯选择 deb、rpm 或 AppImage。不要把订阅文件当作安装程序。

桌面与安卓安装包没有代码签名,首次打开可能触发系统拦截。只有确认文件来自本站下载页后,才按下面的对应步骤处理;来源不明、文件路径不符或系统给出其他风险说明时,应先停止操作。放行只是允许系统执行文件,不等于已经导入服务器,也不代表网络连接已经配置完成。

首次安装与系统放行参考
系统操作与边界
Mac将应用移入 Applications。遇“无法验证开发者”,到“系统设置 → 隐私与安全性”选择“仍要打开”。若提示“已损坏”,确认来源后对实际应用路径执行 xattr -cr /Applications/Shadowrocket.app。
WindowsSmartScreen 提示时,确认本站来源,再选择“更多信息 → 仍要运行”。组织策略不允许继续时,交由设备管理员处理。
安卓为正在打开安装包的浏览器或文件管理器启用“允许安装未知应用”。安装完成后可撤回该来源的安装权限。微信内下载不响应时,改用系统浏览器打开本站。
LinuxAppImage 先执行 chmod +x 并跟随实际文件路径;deb 可用 sudo apt install ./ 后接实际文件名。rpm 使用发行版的包管理器安装,并阅读依赖提示。

执行命令前核实路径与文件名,不要将表中的命令前缀当成完整安装命令直接运行。受管理设备可能限制应用安装、VPN 或网络扩展,手册不能替代管理员授权。安装后先打开一次应用,确认能正常进入 Home,再继续下一章。需要更详细的商店恢复与系统放行步骤时,转到下载安装说明,不要通过反复重新下载代替定位系统提示。

阶段 02 / 建立可控的初始状态

首次启动与权限:先理解连接开关

以下章节以 iPhone / iPad 上的操作为例。首次打开 Shadowrocket 时,先认识 Home、Config、Data 和 Settings 的分工:Home 用于查看服务器、选择当前项目与控制连接;Config 管理配置文件及其规则;Data 提供流量观察入口;Settings 放置应用相关设置。具体排列与可用项目可能随系统和应用变化,应以当前实际界面为准。不要为了让界面看起来与某篇文章一致而随意开启所有选项。

VPN 配置请求何时出现

首次尝试建立连接时,iOS / iPadOS 会请求添加 VPN 配置,并可能要求设备密码或系统认证。这一步让系统允许客户端接管相应的网络流量,是本地授权,不是向服务商申请账号。应核对请求来自刚打开的 Shadowrocket,再决定允许。允许后回到应用观察开关与状态变化;如果拒绝授权,单纯重新选择服务器通常不能解决问题,需要再次触发连接并完成系统确认。

若系统始终不出现确认窗口,检查当前是否已有其他 VPN 连接、是否存在设备管理限制,以及系统 VPN 设置中是否已有相关配置。先断开当前连接再测试,避免两个工具同时调整网络路径。不要一开始就清除所有系统网络设置,那会同时影响已保存的无线网络和其他连接资料。设备受组织管理时,应先确认网络权限要求,而不是尝试绕过管理策略。

按任务授予权限,而不是一次全部允许

从剪贴板粘贴已有订阅、使用 Scan QR Code 扫码或从相册读取二维码时,系统可能分别请求剪贴板、相机或照片访问。权限应与当前操作对应:正在扫码时才需要相机;手动填写服务器参数时,不需要为了连接而开放整个相册。拒绝某项导入权限后,可改用手动输入,或在系统中重新调整对应权限。不要把“导入失败”和“VPN 配置未获准”混为一类故障。

系统可能对本地网络访问另行提示。是否需要允许,取决于所用功能是否访问局域网设备或进行相关检测,而不是所有远程连接都必须用同一种权限组合。遇到权限问题时,记录触发它的动作、提示文字以及当前网络,再到系统设置核对 Shadowrocket 对应的权限。这样可以只修改有关项目,避免一次改变多个条件后无法判断真正原因。

首次测试前保留一个简单基线

先保持 On Demand 关闭,选择一个已知来源的服务器,暂时不导入复杂远程配置,也不同时修改 DNS、规则和传输参数。此时的目标是确认“系统允许建立连接”,而不是完成全部日常策略。记录当前 Global Routing 姿态和 Config 中的活动文件;即使暂时不准备使用规则,也应知道后续切换到配置 Config 时会读取哪份文件。

如果应用切到后台后连接状态与预期不同,先分清是系统状态栏显示变化、应用界面尚未刷新,还是实际请求已经中断。重新回到 Home,观察当前服务器和开关,再用同一个目标复测。省电、网络切换和按需连接都可能影响观察结果,因此首次测试应尽量固定无线网络与设备状态,不在测试中同时切换蜂窝数据。

完成本章后,理想的初始状态是:应用可以正常打开,权限来源清楚,连接开关可以由用户主动控制,已有其他 VPN 已退出,关键设置尚未被大幅修改。还没有自己的服务器或订阅时,可继续阅读原理,但不要把列表为空理解为安装损坏。下一章只介绍如何使用已有资料;如需更短的操作顺序,可先阅读快速上手教程,再返回这里查阅参数细节。

阶段 03 / 将已有资料放入客户端

添加服务器与 Subscribe:区分三类输入

导入之前,先确认手里的内容是什么。单个服务器分享内容描述一项连接;Subscribe 订阅地址用于获取一组服务器,并可能在后续更新;Config 配置文件则还可以包含规则、DNS 等设置。三者用途不同,不能因为都是链接就放入同一个输入框。以下操作以用户已经拥有自己的服务商资料为前提,本站不提供连接资源,也不根据名称或地区评价服务器质量。

Add Server:逐项对照协议参数

在 Home 进入 Add Server,先选与资料一致的 Type,再填写 Server、Port 及认证字段。Server 一般填写域名或 IP,不要将整段网页地址连同路径一起放进去;Port 只填服务端给出的端口。Shadowsocks 的加密方法和密码、VMess 或 VLESS 的标识字段、Trojan 的密码,必须分别按对应协议填写。看到名称相似的字段,也不能认为它们可以互相替换。

常见参数的核对重点
参数类别核对内容常见误区
连接地址Server 与 Port 对照原始资料。把网页路径填入 Server,或遗漏端口数字。
认证按协议检查密码、UUID 或其他认证字段。复制时带入首尾空格,或用旧凭据覆盖新值。
TLS核对是否启用及指定的 Server Name。误把显示名称当作证书验证所用域名。
传输核对所需传输方式及 Host、Path 等参数。只填地址和认证,遗漏服务端要求的传输设置。

显示名称用于辨认,不决定服务器实际连接到哪里。TLS 的 Server Name、传输使用的 Host 与 Server 也可能不同,不能为了“统一”而改成同一个值。除非服务商资料明确要求,否则不要自行开启跳过证书验证之类的选项来掩盖错误;证书问题应先检查设备时间、目标名称与原始配置。保存后重新打开这一项目,确认字段确实保存,而不只是停留在编辑页。

Subscribe:保存地址与更新结果分别检查

添加已有订阅时,在对应的 Subscribe 类型或订阅导入入口粘贴完整地址,为它设置可辨认的名称,再保存并执行更新。粘贴后检查开头、结尾以及查询参数是否完整,避免把聊天说明、换行或标点一起复制。订阅中的认证信息具有访问意义,不要将完整地址放入公开截图。二维码只是另一种资料载体,使用 Scan QR Code 后仍须检查识别结果属于单个服务器还是订阅。

保存订阅名称不等于已经成功取得服务器。更新完成后查看列表是否出现项目,数量是否与服务商提供的信息大体一致,以及是否有错误提示。列表为空时,先检查地址能否在当前网络取回、服务商侧是否已停用该地址、返回内容是否属于客户端支持的订阅格式。普通说明网页即使能在浏览器打开,也不一定是订阅数据。不要连续重复添加同一条地址,这只会让列表出现重复分组。

更新、分组与配置文件保持分离

订阅更新可能覆盖该来源下的服务器名称、地址和参数,所以长期手动修改订阅内单个项目时,应先确认后续更新是否会重置这些修改。需要保留个人备注时,采用清楚的分组和命名,而不是依赖改写关键连接字段。多条订阅并存时,每次只更新一个来源,检查结果后再处理下一项;删除旧来源之前,确认当前选中的服务器不再依赖它。

订阅仍无法解析时,按照订阅解析失败自查清单检查输入和返回内容;列表过于混乱时,参考多个订阅的分组与清理说明。这一阶段的完成条件是列表中至少有一个来自自己资料、参数可核对的服务器,并且能够明确说出它来自手动添加还是某个订阅,而不是单纯看到列表里出现了名称。

阶段 04 / 决定请求按什么方式处理

Global Routing:配置、代理与直连

Global Routing 决定请求采用哪一种整体处理姿态。中文说明中的配置、代理、直连,分别对应界面中的 Config、Proxy、Direct;规则动作则使用大写的 PROXY、DIRECT、REJECT。两组词有关联,但层级不同:Global Routing 是整体选择,规则动作是某条规则命中后的处理结果。先确认整体姿态,再讨论某条规则是否有效,可以避免把未启用的规则文件当成故障来源。

Global Routing 三种姿态的使用边界
姿态判断依据适合检查什么
配置 Config按当前活动配置中的规则和策略处理。日常分流,以及特定目标命中了哪条规则。
代理 Proxy对客户端接管的普通请求采用代理路径。短暂排查服务器链路,不能据此验证配置分流。
直连 Direct对客户端接管的普通请求采用直连路径。比较本地网络表现,不等于关闭系统 VPN。

配置 Config:规则顺序比条目数量重要

在 Config 中确认当前活动文件,然后回到 Global Routing 选择配置 Config。规则通常按顺序匹配,先匹配到的条目先决定结果,因此较具体的条件应放在较宽泛的条件前面。FINAL 表示前面未命中时的最终处理,通常应处于规则末尾;如果把兜底动作放在前面,后续更具体的规则可能无法发挥预期作用。编辑前先保留原文件,避免修改后找不到基准。

[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.net,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

上面的片段用于解释语法与顺序,不是一份包含全部网络设置的完整配置,也不是对具体网站的分流建议。DOMAIN 匹配完整域名,DOMAIN-SUFFIX 匹配域名及相应子域范围,DOMAIN-KEYWORD 按域名中的关键字匹配,范围通常更宽。IP-CIDR 按地址网段匹配;示例中的 no-resolve 用于避免仅为该条 IP 规则额外触发域名解析。GEOIP 依赖相应地理数据库的判断,不等于目标网站的业务归属。

代理 Proxy 与直连 Direct:用于隔离变量

某目标在配置 Config 下失败时,可以短暂切到代理 Proxy,用同一服务器、同一网络和同一目标复测。若此时可用,应返回 Config 查规则命中、策略指向与 DNS 行为;不能直接得出“配置文件全部失效”。如果代理 Proxy 也失败,则进一步检查服务器连接与认证。测试结束后恢复原来的姿态,并重新验证,而不是把临时排错设置永久保留下来却忘记原因。

切到直连 Direct 是改变客户端内部的路由处理,不是关闭 Home 的连接开关。系统可能仍显示 VPN,客户端也可能继续处理与当前设置相关的请求。要比较“客户端接管”和“完全未连接”的区别,应另外关闭连接并记录这个动作。三个测试状态分别写清,可以避免把 Direct 下的结果误记为已经断开后的结果。

规则动作与当前服务器的关系

规则命中 PROXY 后,仍要有可用的代理目标或配置中定义的有效策略;规则写对,并不能补齐错误的认证资料。DIRECT 表示直连,REJECT 表示拒绝该请求,看到拒绝记录时不应继续用更换服务器来修复。若配置引用了特定策略名称,还要检查该名称实际存在且指向有效项目。拼写不一致、删除了被引用的组或更新后名称变化,都可能影响结果。

验证规则时优先使用少量、可解释的条件,而不是一次导入大量来源不同的条目。规则越多不代表判断越准确,宽泛关键字还可能覆盖原本希望直连的子域。需要了解单个设置与规则关系时,可继续查看设置说明;本章的目标是建立顺序、范围与动作三个判断层次,为下一章的连接验证提供明确依据。

阶段 05 / 逐层验证而不是反复切换

连接与验证:从服务器到实际请求

完成导入与路由选择后,回到 Home 确认当前服务器,打开连接开关,并完成系统可能出现的授权。先观察应用是否保持连接,再发起实际请求。不能只根据一个开关颜色、一次 Connectivity Test 或系统状态栏图标判断全部设置正确:它们分别反映不同层面的信息。完整验证应覆盖系统连接、服务器可达、认证成功、域名解析与规则结果,且每一步尽量使用相同的测试条件。

先记录测试基线,再运行 Connectivity Test

记录当前使用无线网络还是蜂窝网络、选中的服务器名称、Global Routing 姿态以及活动配置。随后运行 Connectivity Test,阅读实际使用的测试方式和结果。不同方式可能只检查端口响应、某种协议握手或特定请求,并不一定覆盖真实应用的全部访问过程。一次较快响应不能直接说明大文件传输速度,超时也需要结合测试目标与当前网络判断,不应立即认定订阅内全部服务器失效。

如果服务器列表包含多个项目,先固定一个来源明确的项目完成整个流程。每次只改变一个条件,例如保持网络不变,只换服务器;或者保持服务器不变,只换网络。若同时更新订阅、修改 DNS、切换配置并重启设备,即使问题消失,也无法知道是哪一步产生影响,之后遇到同样情况就很难复现。

用实际访问区分连接与应用问题

连接保持后,打开一个自己熟悉、当前应可访问的页面,再检查另一个不同目标。优先使用新请求,必要时关闭旧页面后重新打开,因为浏览器缓存与既有连接可能让测试结果滞后。还要区分浏览器页面、应用内嵌页面与后台任务:它们可能复用不同连接,不能用其中一个成功就推断所有应用都采用相同路径。

若只有某个应用失败,先查看它是否依赖多个域名、是否在登录与内容加载阶段访问不同目标,以及失败时间附近的请求记录。主页面域名走 PROXY,并不代表图片、认证或接口域名也会命中同样规则。调整时应根据可观察到的请求补充具体条件,不宜直接用一个范围很大的 DOMAIN-KEYWORD 覆盖所有相似名称。已有连接还可能继续保持旧路径,修改后应重新建立测试请求。

按现象选择下一步
现象优先检查暂时不要做
连接开关无法保持系统授权、VPN 冲突、活动配置是否可用。反复更改业务域名规则。
端口可达但请求失败认证、TLS、传输参数与 DNS。把可达性等同于认证成功。
Proxy 可用,Config 不可用活动文件、命中规则、策略引用。删除全部订阅重新开始。
无线网络失败,蜂窝可用当前网络条件、门户认证与 DNS 差异。立即覆盖所有服务器参数。

DNS、TLS 与网络切换分开处理

出现域名无法解析、证书名称不符或握手失败时,先按错误层次排查。DNS 负责获得地址;TLS 验证远端身份并协商加密;协议认证还可能在另一阶段发生。手动填入某个 IP 只能暂时改变解析路径,不能自动解决证书名称和服务端路由要求。设备日期明显错误时也可能影响证书验证,应先让系统时间恢复正常,再考虑修改应用设置。

公共无线网络可能需要先完成网页认证。遇到所有目标都失败时,可以断开客户端,确认本地网络本身可正常访问并完成门户登录,再返回测试。无线与蜂窝切换之后,原有连接可能中断重建,因此要等待状态稳定后重新发起请求。不要把切换瞬间的一次失败当成长时间不可用,也不要忽略仅在特定网络持续出现的规律。

需要查阅错误记录时,只保留与当前失败时间相邻的必要内容,隐藏订阅地址、认证字段、私人域名与设备信息。向自己的服务商询问时,描述协议类型、错误文字、网络环境和已尝试的单变量测试,比只发送“连不上”更有帮助。常见现象可到问答页继续定位;确认可以稳定发起请求后,再进入 Data 建立流量读数的理解。

阶段 06 / 把统计当成观察证据

Data 流量:理解读数与统计边界

Data 用于观察客户端能够统计到的流量活动,不能直接替代服务商账单或运营商用量。应用内统计、系统蜂窝用量与远端账户记录可能具有不同的时间范围、方向定义和计费口径。阅读之前先确认当前视图、统计起点以及是否发生过重置,再解释数字。若界面提供按服务器或按应用的视图,应分别在相同条件下观察,不把两个范围不同的总量直接相加。

上传、下载、累计与速率分开阅读

上传与下载描述流量方向,累计值表示某个统计区间内的总量,实时速率则反映较短时间窗口内的变化。页面刚打开时速率接近零,并不代表此前没有传输;看到累计值增长,也不等于当前仍在持续下载。单位同样重要,字节量与按秒计算的速率不是同一指标,比较时应先看界面标注,不把不同单位的数字当作直接的性能对比。

浏览一个页面通常会产生多个连接,包含正文、图片、字体、接口请求以及后台刷新。关闭可见页面后,系统和其他应用也可能继续发起请求,因此 Data 不一定立即停止变化。要做一次可解释的观察,可先记录开始值,保持其他活动尽量稳定,完成一个明确任务后再看差值。不要用整天混合使用后的累计读数倒推某一次请求的完整路径。

按服务器与按应用查看时的限制

按服务器观察有助于发现所选服务器是否承接了预期流量,但要结合路由姿态理解。在配置 Config 下,一部分请求可能直连或被拒绝,不会全部落在当前代理服务器名下;只看到代理服务器增长较少,不能说明应用没有正常工作。服务器由订阅更新而改名、替换或重新分组时,历史显示与当前列表也不一定能够仅凭名称一一对应。

按应用查看时,应先确认当前系统和构建确实提供相应归属信息。部分请求可能显示为系统进程、公共组件或无法细分的来源,应用内嵌网页也不一定按照用户直觉归属。不要为了得到“每个应用都完整对应”的列表而不断修改规则。统计归属是观察维度,规则匹配则要查看实际目标与处理结果,二者不能互相替代。

用一段受控请求检查流量走向

先记下测试前的 Data 读数、当前服务器和 Global Routing 姿态,随后只打开一个明确目标,等待加载完成后记录变化。若要比较 Config 与 Proxy,两个阶段使用同一目标与相近操作,并注明缓存可能导致第二次传输减少。需要重新加载时,应以实际产生新请求为准,不通过反复刷新制造大量无意义流量。对受限移动网络尤其要避免使用大文件作为常规验证手段。

如果客户端记录与服务商用量存在差异,先核对统计周期是否从同一时间开始,账户是否还有其他设备使用,以及远端是否包含协议开销、重试或不同方向的流量。订阅更新后切换到另一服务器,也可能使本地视图分散,而远端仍按同一账户累计。只有将范围、周期和设备数量对齐后,差异才具备进一步讨论的基础。

重置统计之前先保留必要上下文

重置通常影响本地观察基线,不会同步清除服务商已产生的用量,也不会重置账户额度。准备清理时先记录当前周期需要保留的数据,再确认界面说明的影响范围。不要把统计重置当作连接修复步骤:它不能更改服务器认证、修正规则或恢复已到期的服务。若只是想开始一次实验,记录起始值往往已经足够,不必清除长期统计。

当流量异常增长时,先暂停不必要的任务,再检查正在同步、更新或反复重试的应用,结合当前路由姿态寻找原因。不要仅凭服务器名称推断是哪一项业务产生用量,也不要将包含私人目标的完整统计截图公开。更具体的读数解释可参阅Data 按服务器与按应用的读数说明。建立稳定的观察口径后,才适合评估 Settings 调整前后是否真正出现差异。

阶段 07 / 每次设置修改都应有目的

Settings 常用项:DNS、On Demand 与诊断

Settings 不应被当成必须全部调整一次的检查表。不同系统与当前构建所提供的项目、位置和说明可能不同,先阅读实际界面,再判断某项是否与当前问题有关。还要注意配置文件中也可能包含网络相关设置,因此观察到的行为不一定只由 Settings 决定。修改前记录原值、活动 Config 与网络环境;修改后只验证一个明确目标,确认效果再决定是否保留。

DNS:先区分地址解析与规则匹配

DNS 的作用是把域名解析成地址,路由规则则决定请求如何处理,两者会互相影响,但不能简单等同。域名规则可能在获得地址前就匹配,IP 规则则需要对应的地址信息;配置中的解析方式、缓存与规则参数会影响观察结果。遇到“网站打不开”时,不应先随机更换多个 DNS 地址,而应确认错误是解析失败、服务器连接失败,还是规则把请求送到了不合适的路径。

如果 Config 文件已经明确设置 DNS,先检查该文件的内容与说明,再修改应用其他位置的解析选项。保留一个能工作的基线,避免同时改变上游解析、回退策略与规则顺序。修改后重新发起请求,并留意缓存可能暂时保留旧结果。清除缓存可以帮助建立新测试条件,但不应被描述成解决所有连接问题的固定动作;对真正的认证失败,它通常没有直接作用。

On Demand:把触发条件与连接状态分开

On Demand 用于按指定条件触发或管理连接。开始配置之前,应先确认手动连接已经稳定,否则自动触发只会让故障更难观察。逐项阅读当前界面的条件设置,检查网络类型、无线网络范围或其他适用条件,再决定启用。初次只设置一条容易验证的条件,在满足与不满足条件的环境分别测试,不要一次加入大量例外后仅凭一次状态变化判断全部正确。

开启后若出现“手动断开又自动连接”,先检查是否仍处于触发条件内,而不是立即删除 VPN 配置。排错时临时关闭 On Demand,再回到手动连接基线;恢复使用时重新检查条件。按需连接不保证所有系统后台任务都遵循用户直觉中的时机,也不代表某个特定目标一定使用代理,具体请求仍受整体姿态与活动配置影响。

本地网络与连接测试项目

访问局域网设备时,应同时检查系统本地网络权限、配置中有关局域网的处理和当前网段,而不是只看远端服务器是否可用。无线打印机、存储设备或路由器管理页可能使用私有地址,规则如果没有按预期直连,就可能出现远程页面正常而本地设备不可达。需要添加 IP-CIDR 条目时,先核实实际网段,避免把过大的地址范围一并改变。

Connectivity Test 的测试目标、方式与超时条件若可配置,应选择能对应实际排错问题的设置。更短的超时可能更快报告失败,但也更容易在波动网络下产生误判;测试目标不可用,也可能让多个本来可用的服务器同时显示异常。更改测试设置后记录新的条件,不要拿修改前后的读数直接比较并得出服务器性能变化的结论。

日志与高级功能保持最小变更

诊断需要时再打开详细记录,并在复现一次问题后及时检查相关时间段。日志可能包含目标域名、服务器地址或认证相关上下文,分享前只摘取必要行并隐藏敏感部分。若某项高级功能需要额外证书、脚本或远程资源,先确认自己的具体用途、来源与影响范围;本手册的首次连接主线不要求启用这些功能,不应为了模仿截图而增加额外变量。

更换 Config 文件后,应重新检查与网络有关的实际行为,不假设原先 Settings 的调整仍具有相同优先关系。需要定位单个选项时,结合设置页与分类问答查阅。完成本章不意味着每个选项都被改过,而是能够解释已经修改的项目解决什么问题、怎样验证,以及如何恢复原值。

阶段 08 / 保留来源、基线与恢复路径

日常维护:更新、备份与故障记录

日常维护的重点不是频繁更换配置,而是让资料来源、活动文件和修改记录始终可追溯。每隔一段时间检查订阅是否还能正常更新、当前选中的服务器是否仍属于有效来源,以及 Config 中启用的是哪份文件。删除重复内容、调整分组或更新应用时,一次只处理一类对象,操作后做一次短验证。这样出现问题时,可以从最近的明确变更开始回退,而不是从零重建全部设置。

把三种更新安排成不同任务

应用更新改变客户端本身;Subscribe 更新改变相应来源下的服务器列表或参数;远程 Config 更新可能改变规则、解析或其他配置内容。三者没有天然同步关系。某次订阅更新成功,不代表客户端已经更新,也不代表活动配置取得了新规则。维护记录应写清执行了哪一种更新、是否有错误以及随后验证的目标,避免用“已更新”三个字概括完全不同的动作。

iPhone / iPad 通过 App Store 管理应用更新;Mac、Windows、安卓、Linux 到本站下载页重新获取对应安装包,仍使用本站 /dl/shadowrocket/ 路径。更换安装包前先保留必要资料,首次打开的系统提示按第一章处理。客户端价格档仍为 iPhone / iPad App Store $2.99 一次性付费,其他上述平台免费;应用获取与用户已有服务商的服务期限分别管理。

备份时区分配置、凭据与统计

先查看当前界面提供的导出或备份入口,核对导出说明覆盖哪些对象。配置文件、手动服务器、订阅地址、设置偏好和 Data 记录不应默认都包含在同一份文件里。即使成功导出,也要确认文件可读取并能辨认内容类别;重要资料还应保留原始来源。迁移设备之前,先在旧设备记录活动配置与整体姿态,再进行恢复测试,避免迁移完成后才发现缺少订阅认证信息。

订阅地址、服务器密码、UUID 与部分分享二维码都可能携带访问凭据,应当像账户资料一样保存。备份放在自己可控、具有适当访问保护的位置,不放入公开相册、公开文档或协作聊天记录。向他人展示规则时,尽量单独导出不含认证资料的片段;分享整个配置之前,逐项检查远程地址与账户字段,而不是只隐藏屏幕上的显示名称。

整理多条订阅与长期例外规则

多条订阅并存时,使用能说明来源与用途的名称,不依赖临时排序记忆。清理前先确认是否有同一来源重复导入、是否存在已经停用的旧地址,以及当前服务器或策略是否仍引用其中项目。删除一条来源后,检查列表与活动选择,再进行下一次删除。需要更多分组细节时,可参考多个订阅的管理说明,不必通过重新安装应用来整理列表。

自己增加的规则应附带简短用途说明,并定期检查是否仍需要。临时为排错加入的宽泛规则,最容易在问题解决后被遗忘,长期改变其他目标的路径。远程 Config 可能覆盖本地修改,因此更新前保留差异;若发现更新后行为变化,先比较规则顺序和策略引用,不立刻把整份旧文件覆盖回去。只有明确恢复范围,回退才是可重复的操作。

形成一份可复现的故障记录

记录至少包含失败的具体动作、错误文字、网络类型、Global Routing 姿态、活动 Config、服务器来源及最近修改。再按“手动连接基线 → 服务器连接 → 实际请求 → 规则命中 → DNS 与应用差异”的顺序检查。使用同一目标复测,每一步写下是否改变结果;失败后恢复原值再试下一项,避免把多个未经验证的改动叠加成新的故障。

需要联系自己的服务商时,只提供定位所需的信息,并隐藏访问凭据;客户端与系统问题则结合错误原文继续查阅官方手册。首次上手主线仍以使用教程为准,获取与重装转到下载指南,具体疑问进入问答。本页八个阶段可以独立查阅,但实际排错最好保持从基础条件到规则与设置的顺序,避免在服务器信息尚未确认时就修改高层策略。