OFFICIAL MANUAL / REFERENCE
Shadowrocket 完整使用手册
从 App Store 正版核验到日常配置维护，按八个阶段逐项查阅。
本页是 Shadowrocket 官方手册的系统查阅部分，适合解释设置之间的关系、核对参数和定位故障。首次使用、只想完成一次连接时，先阅读使用教程；遇到某个步骤不理解，再回到对应章节。以下操作以 iPhone、iPad 为主，界面位置和可用选项以设备上的实际显示为准。
- App Store 正版获取
- 使用用户已有连接资料
- 修改前保留可用配置
01 / APP STORE
正版获取与购买边界
核对产品页，再确认购买
Shadowrocket 是 Apple 平台付费客户端，唯一获取入口是 App Store。购买前先打开本站的正版核验说明，逐项核对产品名、开发者与应用 ID，而不是只凭搜索结果中的名称判断。名称相近并不能证明是同一产品，图标相似也不能代替开发者字段。应进入完整产品页阅读信息，再使用该页提供的购买或重新下载入口。
需要核对的开发者是 Shadow Launch Technology Limited，应用 ID 是 932747118，对应产品页地址末尾的 id932747118。官方图标可与本站使用的图标对照。三项应当同时对应；如果其中一项不同，先返回确认进入的页面，不要根据介绍文案推断。商店展示的信息是购买依据，本站说明用于帮助定位这些字段，不替代商店的实际提示。
购买按钮旁的金额由当前店面显示，美区参考价格为 2.99 美元，一次性付费，实际结算以 App Store 页面为准。不同店面的货币、税费与可用性可能不同，不能把其他地区看到的金额直接用于当前账户。付款前检查当前用于商店购买的 Apple ID，避免把设备登录账户与实际购买账户混为一谈；后续重新下载需要核对购买记录。
客户端购买与连接资料分开准备
客户端一次性买断 ≠ 线路套餐。购买应用获得的是客户端使用资格，不等于已有可连接的服务器。后续操作以用户已有自己的订阅或服务器信息为前提，相关地址、认证资料与有效状态需要从自己的服务商处确认。本站提供官网与官方手册，不提供、不销售、不推荐节点或订阅；手册里的规则示例也不是可直接使用的连接服务。
首次操作前可把资料分成两组：第一组是商店购买记录，负责应用获取；第二组是服务器或订阅资料，负责连接。出现问题时先判断属于哪组：应用无法重新下载，应核对商店账户和购买记录；应用可以打开但连接失败，应检查服务器参数、网络和路由。两者通常不是同一问题，重复购买客户端不能修复失效的连接资料。
准备资料时只记录必要项目，并选择受设备保护的位置保存。订阅地址可能包含认证信息，完整地址不适合贴到公开讨论区；服务器截图也可能露出密码和身份标识。若需要别人协助核对，可先整理协议类型、报错阶段与已经尝试的操作，再去掉敏感内容。用于求助的信息应足以说明故障，但不能让其他人据此访问个人资源。
设备兼容性与重新下载
本手册主要描述 iPhone 与 iPad 上的操作。Mac、Apple TV、Apple Vision 也可在同一商店页的兼容性栏中查阅；系统要求、设备兼容性与购买适用性一律以 App Store 页面标注为准。不要仅凭同一产品名称就假定每台设备的操作布局、功能位置和购买条件完全一致，尤其是屏幕尺寸与交互方式不同的时候。
同一购买账户在另一台符合条件的设备上获取应用时，应先检查 App Store 的已购项目或相应账户购买列表。看到重新下载标识后再执行下载；如果仍显示价格，先核对账户、店面与购买记录，不要立刻再次付款。关于 iPad 的操作可继续阅读iPad 使用与已购项目说明，具体适用范围仍由商店确认。
02 / FIRST LAUNCH
首次启动与 VPN 配置权限
先认识 Home，再启动连接
首次打开 Shadowrocket 后，先查看 Home，不急于打开连接开关。Home 集中了连接状态、Global Routing、Connectivity Test 和 SERVER 等入口。SERVER 中需要有可用资料，Global Routing 决定路由方式，连接开关负责启动系统网络隧道。这些项目承担不同职责：列表里有服务器不代表已选中，选中了服务器也不代表隧道已经建立。
如果 Home 当前显示 Not Connected，只能说明应用报告尚未连接，不能据此判断订阅是否有效。先检查列表内容，再确认准备使用的服务器，最后核对路由方式。这一顺序有助于避免在空列表或错误模式下授权连接，随后又把所有错误归因于系统权限。界面速览也可参照首次打开与 Home 页面说明。
首次使用时保留默认设置通常更便于定位问题，不必同时启用所有辅助功能。先把目标限定为“使用已有资料完成一次手动连接”，成功后再逐步调整 On Demand、DNS 或规则。把权限、资料与高级设置分开处理，可以清楚知道哪个改动导致行为变化，也方便恢复到已经验证过的状态。
理解系统授权弹窗的作用
启动连接时，系统可能请求允许添加 VPN 配置。这是 Apple 系统管理网络扩展所需的授权流程，允许后设备可以建立由 Shadowrocket 使用的 VPN 配置。系统可能要求设备密码或其他身份验证，按照屏幕提示完成即可。授权不是购买步骤，也不会替你填入服务器地址；它只是让客户端具备启动相应网络连接的系统条件。
VPN 配置与代理服务器记录不是同一个对象。前者由系统管理，涉及隧道启动与权限；后者保存在应用中，描述服务器、端口和认证方式。因此，看到系统里有 VPN 配置，不代表 SERVER 列表一定正确；反过来，导入成功也不表示系统授权已经完成。检查时应分别确认，而不是删除全部资料后重新开始。
如果误点拒绝，先返回 Home，再尝试启动连接并观察是否重新出现授权提示。如果没有，进入系统设置，查找 VPN 或 VPN 与设备管理相关入口，检查现有配置和状态；路径名称会随系统和设备有所差异。若设备受到组织管理，部分设置可能无法更改，此时应先确认管理限制，不要反复尝试修改系统策略。
连接受阻时先排除权限冲突
设备上存在其他 VPN 配置或网络扩展时，应先确认当前实际启用的是哪一项。测试期间暂停可能同时接管网络的配置，再单独验证 Shadowrocket，避免自动连接条件互相触发。保留其他配置的原始内容，不必为一次排查就全部移除；如果涉及工作或学校设备，更应先确认该配置的用途与管理要求。
只有明确怀疑系统配置损坏，且重新授权仍不能恢复时，才考虑重建相关 VPN 配置。操作前先保留应用中的服务器与配置资料，停止连接，辨认要处理的配置名称，再执行系统允许的移除和重新授权。删除系统 VPN 配置不是恢复订阅的办法，也不应作为所有故障的第一步。详细关系见VPN 配置提示说明。
授权之后仍然无法连接，需要观察失败发生在哪个阶段：开关立即回退可能与权限或扩展启动有关；保持启动但目标请求失败，则应继续检查服务器和路由。不同现象需要不同检查路径，不能仅用“已授权”推断一切正常。记录系统提示原文、当前网络类型和失败动作，比反复开关更有助于后续定位。
03 / SERVER & SUBSCRIBE
添加已有服务器与订阅
先识别资料类型，再选择入口
导入之前先辨认拿到的资料：完整服务器参数适合在 Add Server 中逐项填写；协议分享链接通常用于添加单条记录；订阅地址用于获取并更新一组服务器。配置文件则通常在 Config 中管理。几种资料可能看起来都是链接，但内容结构和用途不同，把配置文件地址放入服务器字段，或把单条分享链接当作订阅，都可能导致解析失败。
资料类型不明确时，先向自己已有的服务商确认用途与格式，不要通过不断改写地址来试错。复制地址时注意聊天软件带入的空格、换行、标点和省略显示；屏幕上看起来完整，并不代表复制结果没有缺失。含认证信息的地址必须保留原样，随意删除查询参数可能让原本有效的地址失去访问权限。
使用 Scan QR Code 时，先确认二维码来自自己的资料，扫码识别后再检查生成记录的协议、名称和关键参数。二维码只是编码载体，不会自动证明参数正确。使用剪贴板相关导入操作时同样需要复核，尤其是设备上刚复制过其他链接的情况；一次导入完成后先检查一条记录，再继续批量处理。
Add Server 的参数必须成组对应
手动添加时，首先选择与资料一致的协议类型，再填写服务器地址、端口及认证字段。协议选错后，后续字段可能完全不同，不能把某种协议中的密码机械填进另一种协议的身份字段。服务器地址只填写该字段要求的地址内容，端口使用资料明确给出的数值，不根据其他记录猜测，也不以网站访问端口替代服务器端口。
| 参数组 | 核对内容 | 常见误差 |
|---|---|---|
| 地址与端口 | 对应同一条服务器资料 | 混入网址路径或多余空格 |
| 认证信息 | 按协议填写密码、UUID 或其他身份字段 | 复制缺字、使用另一条记录的认证值 |
| TLS 与 SNI | 按已有资料设置，核对证书对应名称 | 把服务器地址直接当作 SNI |
| 传输设置 | 按资料核对传输类型、Host 与路径 | 遗漏路径或混淆 Host 与地址 |
Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 等协议所需字段并不相同，可用选项以应用显示为准。某些连接还需要 TLS、SNI 或额外传输参数，这些参数应作为同一套资料一起核对。不要为了让连接通过而随意关闭证书验证；证书错误可能提示名称、设备时间或服务器配置存在问题，应优先找出不一致之处。
保存前为记录设置能辨认的备注，避免多个同名项目造成误选。备注用于管理，不应包含密码。保存后回到 SERVER 检查记录确实存在，并明确当前选择的是哪一条；新增记录与切换当前服务器可能是两个独立动作。第一次验证建议只使用一条来源清楚、参数完整的记录，减少批量导入带来的干扰。
订阅更新不是配置文件更新
添加已有订阅时，在 Add Server 中选择 Subscribe，并按实际字段填写订阅地址及备注。保存后执行相应更新操作，观察列表是否生成预期项目。更新成功通常说明取回并解析了列表，不代表列表中的每条服务器都可连接；订阅地址本身的访问与服务器连接是两条不同的网络路径，后续还需要分别验证。
列表为空或更新失败时，先核对地址完整性、服务状态与当前基础网络，再看是否有明确的解析提示。不要把“更新失败”直接理解为所有服务器同时失效，也不要反复删除订阅来掩盖问题。更新可能替换订阅管理下的记录，手动修改这些记录前应意识到下一次更新可能覆盖改动，长期自用的特殊记录应单独整理。
Config 文件的更新需要在配置管理环节核对，不能仅凭订阅列表变了就认定规则也已同步。导入完成后分别确认服务器列表、当前选中项目与当前使用的配置文件。若配置中引用策略或分组，还需要确认这些引用有对应对象。资料整理清楚后，才进入 Global Routing 的选择，避免把列表问题误判成规则问题。
04 / GLOBAL ROUTING
Global Routing 三种姿态与规则顺序
Config、Proxy、Direct 各自控制什么
Global Routing 用于选择当前连接的路由方式。配置姿态对应 Config，按当前配置文件中的规则决定请求去向；代理姿态对应 Proxy，作为整体使用所选代理路径的方式；直连姿态对应 Direct，用于直接连接。三种姿态是行为选择，不是速度等级，也不是三个服务器。切换姿态不等于替换认证资料，仍要确认服务器和配置本身有效。
| 姿态 | 主要用途 | 验证重点 |
|---|---|---|
| 配置 / Config | 按规则匹配并选择策略 | 当前配置、规则顺序、命中策略 |
| 代理 / Proxy | 验证所选代理路径 | 服务器、认证、目标访问 |
| 直连 / Direct | 对照基础网络访问 | 本地网络、DNS、目标服务状态 |
排查时可以短暂使用 Proxy 对照 Config：若同一目标在 Proxy 下成功，而 Config 下失败，应优先查看规则匹配和策略去向；若两者都失败，再检查服务器与基础网络。Direct 可帮助观察直接访问情况，但对照结果只对当时的网络与目标成立。每次只改变一个条件，测试后恢复原来的姿态，避免临时设置被遗忘。
Global Routing 不是每个应用都能绕过的独立开关。实际请求还可能受系统网络、DNS、应用缓存以及配置例外影响。判断流量路径时需要结合请求记录，而不是只看当前姿态名称。尤其在浏览器复用连接或应用保持长连接时，切换姿态后应重新发起请求，必要时结束旧会话，再观察新连接的去向。
规则从上到下匹配，先命中先处理
在 Config 姿态下，Rule 中的先后顺序直接影响结果。通常应将范围小、要求明确的规则放在前面，把兜底项放在末尾。DOMAIN 用于完整域名匹配，DOMAIN-SUFFIX 用于后缀范围，DOMAIN-KEYWORD 按域名包含的关键词匹配。关键词规则范围可能很宽，不能只因为写起来方便就放到全部精确规则之前。
IP-CIDR 与 IP-CIDR6 面向地址段，GEOIP 依据相应地址数据判断，不能把这些规则理解成域名分类的同义写法。域名解析结果、地址数据和实际请求形式都会影响匹配。遇到“域名规则没有命中”的情况，应先确认请求记录中看到的是域名还是地址，以及是否存在更早的规则，不能只根据目标网页标题推断。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY这段内容是教学用的规则片段，不是完整连接配置。第一行把匹配该域名后缀的请求交给 PROXY；第二行按 GEOIP 条件选择 DIRECT；FINAL 为前面未命中的请求指定末尾策略。将它放入自己的配置前，应先备份并确认引用策略在当前配置中可用。示例域名用于说明语法，不表示某类网站都应采用相同策略。
策略名称、兜底项与配置生效
规则关键字回答“如何匹配”，末尾策略回答“匹配后怎么处理”。DIRECT、PROXY、REJECT 的作用不同，不能为了排错就把全部规则改成同一个词。配置若使用自定义分组，规则引用的名称需要与实际定义对应；名称错写、分组不存在或分组内没有可用项目，都可能让看似正确的匹配无法产生预期结果。
FINAL 应当承担兜底职责，放在需要继续检查的规则之后。若它过早出现，后续规则就没有机会处理本应匹配的请求。新增规则时不仅要检查新行语法，还要查看它前后的范围关系；一条更宽泛的后缀或关键词规则可能已经覆盖目标。排错应从实际命中位置倒查，而不是不断向文件尾部追加重复规则。
编辑结束后确认保存，并核对当前真正启用的 Config 文件。打开某个文件查看，并不一定代表该文件已经用于连接。规则细节可继续阅读.conf 各段结构说明；需要查阅设置的关联影响时可转到设置说明。保留一份可回退配置，再做范围明确的修改，通常比整份替换更容易验证。
05 / CONNECT & VERIFY
连接、验证与分层排错
按固定顺序建立第一次连接
连接前先确认基础网络本身可以正常使用，尤其是需要网页登录确认的无线网络。暂停 Shadowrocket 后完成该网络要求的正常接入流程，再返回应用测试。如果基础网络尚未获得可用连接，代理测试通常也无法完成；这类失败不能通过修改服务器密码解决，更不应在公共网络登录页面输入订阅凭据。
随后在 Home 核对当前服务器、Global Routing 和 Config 文件，三者对应明确后再打开连接开关。首次启动按系统提示完成 VPN 配置授权，等待应用状态变化。测试过程中不要连续快速开关，避免尚未结束的连接与下一次启动交叠。若出现错误提示，先记下原文与发生步骤，再执行下一项检查。
系统显示 VPN 状态，只说明相应隧道已启动，不等于远端服务器完成认证，也不等于目标网页可以访问。完整验证至少包含隧道启动、实际请求和路径核对三个层次。把“开关保持开启”当作全部成功，会掩盖服务器不可用、规则误命中和 DNS 失败等问题；应继续发起一个明确、可重复的访问动作。
Connectivity Test 与实际访问互相补充
Connectivity Test 用于辅助检查连通性，但测试目标和测试方式会影响结果。某次测试成功，说明该项测试在当时完成，并不保证所有应用都能工作；某次失败也可能与测试目标本身有关。记录使用的测试方式，在同一条件下比较结果，才有分析意义。不同方式得到的数值不适合直接放在一起排序。
延迟值反映一次特定测试的耗时，不等同于文件传输速度，也不等同于日常访问体验。服务器响应、握手、网络拥塞和目标状态都可能影响结果。先看能否稳定完成请求，再看耗时是否持续异常；不要因为单次数字更小，就忽略实际访问中频繁断开或认证失败的现象。连续测试也会产生流量，应适量使用。
实际验证时选用自己熟悉、允许访问的目标，重新打开页面并观察是否完整加载。若只有页面框架出现，图片或接口请求失败，需要检查这些资源是否使用其他域名和策略。再查看请求记录中的目标、命中规则与连接错误，把“网页打不开”拆成具体失败对象，避免把一个资源域名的问题当作整条连接失效。
先定位故障层，再修改参数
开关无法保持开启时，先回到权限与系统配置层检查；开关可保持但服务器连接失败时，再查地址、端口、认证及 TLS；服务器可连接而特定目标失败时，重点检查路由、DNS 与目标服务。这个顺序不是绝对结论，而是减少无关修改的排查路径。每完成一层检查，再把结果带到下一层，不要同时更换所有条件。
| 观察现象 | 优先核对 | 下一步对照 |
|---|---|---|
| 启动立即失败 | VPN 授权、系统限制、其他网络扩展 | 单独启用并记录系统提示 |
| 所有目标均失败 | 基础网络、服务器参数与有效状态 | 保持目标不变，更换已有可用记录 |
| 仅 Config 失败 | 配置是否启用、命中规则与策略 | 与 Proxy 下的新请求比较 |
| 仅部分资源失败 | 失败域名、DNS、目标端响应 | 逐项核对请求记录 |
从无线网络切换到蜂窝网络时，旧连接可能中断，需要等待新网络稳定后重新验证。若问题只出现在某一种网络，先记录这一差异，再检查该网络的接入状态和解析情况。若问题只影响某一条服务器，而已有其他记录在相同条件下正常，应把检查集中到该条资料，不必重建全部配置。
向自己的服务商反馈时，提供协议类型、失败阶段、网络类型与脱敏后的报错，说明是否在 Proxy 与 Config 下都出现。不要提交完整密码、订阅地址或未经检查的日志文件。需要重新梳理最短操作路径时，可返回使用教程逐步复现；复现过程中保持目标不变，才能确认修复来自哪一个操作。
06 / DATA & OBSERVATION
Data 流量与请求记录的读法
先确认统计口径，不把数字当账单
Data 用于观察应用所展示的流量与连接信息，具体统计项目以当前界面为准。阅读数字前先确认它覆盖哪个时间范围、是否会在重连后变化，以及是否区分上传与下载。不同页面可能记录不同对象，不能看到两个数值不相同就认定有异常。一次会话的流量、累计流量和系统按应用统计的流量并不是同一口径。
流量经过隧道时还可能涉及协议封装、握手、重传和后台请求，业务文件大小通常不会与统计数字完全相等。图片缓存、视频预加载和系统后台活动也会改变观察结果。想验证某个动作的影响，应先记录起始值，执行一个明确动作，再读取结束值，而不是把整天累计值归因于刚打开的某个页面。
客户端显示的流量不能替代服务商的用量记录或计费依据。双方可能采用不同时间范围、计量方向和统计规则；如果订阅信息展示剩余额度，也需要确认来源与更新时间。出现差异时先整理时间段和操作，再向自己的服务商确认统计口径，不要通过清零客户端计数来尝试改变远端记录。
用请求记录确认规则实际命中
当访问结果不符合预期时，记录里最有用的是目标、时间、使用策略和错误阶段，而不只是总流量。先重新发起一次目标请求，再查找时间相近的项目，避免把缓存访问或旧连接当作当前结果。如果同一页面产生多个请求，应分别查看失败项，主域名成功并不能证明所有资源都采用相同路径。
看到 DIRECT 或 PROXY 等策略时，应回到 Config 中核对它是由哪条规则产生的。如果目标命中了更早的宽泛规则，继续在文件后面添加精确规则通常不会改变结果。先调整规则顺序并保存，再重新建立请求，才能观察新规则是否生效。对于长连接，旧会话可能保持原来的路径，必须与新建连接分开判断。
DNS 相关失败需要区分“名称解析失败”与“解析后连接失败”。前者应核对解析设置、当前网络和请求域名，后者还要检查目标地址、端口和路径。不要仅凭一条错误文本就推断全部原因。记录所展示的细节可能随请求类型不同而变化，缺少某字段也不等于该环节没有发生，应结合其他可观察信息判断。
把流量、电池与后台活动分开分析
流量较少但电池用量较高，并不矛盾；频繁重连、持续唤醒或不稳定网络可能消耗电量，却不产生大量有效业务流量。相反，短时间下载较大文件也可能带来明显流量增长。观察时同时记录使用时长、网络类型与操作场景，不能把电池百分比和流量大小简单换算，也不能只凭一个截图判断客户端异常。
若怀疑后台持续活动，先确认是否启用了 On Demand，是否存在应用自动刷新，以及设备是否反复在不同网络间切换。选取相近的使用条件做对照，例如保持网络和使用习惯一致，只改变按需连接设置。一次短暂测试很容易受系统任务干扰，应观察可重复的趋势，而不是依据某几分钟的波动下结论。
系统电池页面的统计周期与 Data 页面可能不同，应先对齐观察时段。关于后台行为可阅读On Demand 与电池排查说明。查看这些数据的目的，是找出不必要的活动和失败重试，而不是追求某个固定数值；设备型号、网络环境和使用内容不同，没有适用于所有人的统一阈值。
建立自己的观察表时，保留日期、网络、姿态、配置名称、复现动作和结果即可，不必长期保存全部请求。这样的简短记录更容易比较，也能减少敏感信息积累。只有在问题需要进一步分析时才补充具体日志，并在问题处理结束后重新评估保存范围，把诊断工具与日常使用分开管理。
07 / SETTINGS & CONFIG
Settings 常用项与配置边界
On Demand 适合在手动连接稳定后设置
On Demand 用于按设定条件触发连接，适合已经完成手动验证、希望减少重复操作的场景。它不是修复服务器故障的功能：如果手动连接都失败，启用按需行为可能只会增加重试。应先确认服务器、规则与系统权限正常，再根据自己实际使用的网络设置条件，并通过明确动作验证触发与停止是否符合预期。
配置按需条件时，应区分“希望自动启动”与“希望持续保持”的使用目标。不同选项的具体作用以当前界面为准，不应仅凭名称猜测。设置之后分别测试无线网络、蜂窝网络、锁屏和网络切换后的行为，确认设备没有在不需要时反复连接。临时排错时可以暂停 On Demand，避免手动断开后又被条件重新触发。
如果发现断开后很快再次连接，先检查按需设置和系统当前使用的 VPN 配置，而不是立刻认为开关失灵。记录触发前后的网络状态，核对是否正好满足某个条件。对于需要登录确认的公共无线网络，也应先完成基础接入，再观察自动连接行为；按需连接不能替代网络本身要求的认证过程。
DNS、Host 与 TLS 不要一起试改
DNS 负责名称解析，代理负责后续连接路径，两者互有关联但并不等价。某个域名解析失败时，应先确认解析请求的处理方式和当前网络，不要同时更换服务器、规则和解析设置。新设置应有明确目标，例如排除某个解析源不可达的问题；设置完成后用同一域名复测，并保留原值以便恢复。
Host 用于指定本地名称映射，适合明确知道目标地址并能维护更新的情况。固定映射可能随目标服务调整而失效，还可能影响不同网络中的访问结果。不要为了绕过一次解析失败就把临时地址长期写入配置；如果目标使用多个地址或内容分发，简单固定为某个地址未必能保持正常，应优先查明原本的解析问题。
TLS 相关设置涉及加密连接与身份验证。证书名称不匹配时，应检查 SNI、服务器资料、设备时间与服务端状态，不能把关闭验证当作常规排错步骤。服务器地址、Host 和 SNI 可能承担不同职责，是否相同由实际资料决定。只要来源没有明确要求，就不应从其他记录复制这些字段来拼接新的连接。
区分应用设置与 .conf 各段职责
Settings 中的应用级选项与 Config 文件中的配置内容需要分开核对。编辑文件前先确认当前启用哪份配置，导出或复制一份原始内容，再对照各段职责修改。General 放置全局项，Rule 组织匹配规则，Host 管理映射，URL Rewrite 处理相应请求改写；它们不是可以随意互换的容器，段名错误会影响解析。
[General]
loglevel = notify
[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.org,PROXY
FINAL,PROXY示例仅展示段落与规则格式，未包含服务器资料，不应直接替代自己的可用配置。修改 General 中的选项前，应确认应用当前支持该项并理解取值含义；不要从不明配置中整段复制。日志级别也应按诊断需要选择，过于详细的记录会增加信息留存，排错结束后应恢复适合日常使用的设置。
URL Rewrite 与其他会改变请求行为的配置应当后置学习。普通规则分流尚未验证时，引入请求改写会增加变量，也可能使网页和应用出现与连接无关的错误。若配置涉及 HTTPS 解密，需要充分理解证书与信任边界，不应作为首次连接的准备步骤。基础连接、规则和高级处理应逐层验证，而非一次开启。
系统升级或应用更新后，部分选项的位置可能变化，查阅时以实际界面为准。关于配置各段的展开解释见General、Rule、Host 与 URL Rewrite 结构。阅读示例时先判断它解决什么问题，再决定是否需要采用；参数数量更多不代表配置更适合当前网络。
08 / MAINTENANCE
订阅更新、备份与日常维护
更新前后检查实际变化
日常维护首先是保持资料有效，而不是频繁重建全部设置。订阅更新前确认正在更新哪一组，更新后检查记录数量、名称和当前选中项目是否变化。如果原先选中的记录被替换或移除，需要重新选择并验证。更新完成只代表取回了列表，不能代替服务器测试；规则配置也不会因为服务器列表更新而当然变成最新内容。
若服务商调整了地址或认证方式，应按其提供的新资料核对，不要只修改记录备注。旧地址仍能短暂访问，不代表可以一直使用；新资料导入后也需要在当前网络重新验证。对于手动添加的记录，订阅更新未必会修改它们，应分别维护，避免列表里同时保留多个近似名称却来源不同的项目，导致排错时选错。
应用更新通过 App Store 完成，更新信息与兼容性以商店页面为准。更新前可先备份正在使用的配置，更新后检查权限、当前服务器和关键规则。若行为发生变化，优先对照实际设置与应用提示，而不是凭记忆判断某个选项“应该没有变”。应用更新、订阅更新和配置更新应分开记录，方便定位变化来源。
备份应同时考虑可恢复性与敏感性
备份前先明确要恢复什么：只有规则文件，未必包含服务器认证；只有服务器列表，也未必包含自定义分组和应用设置。使用应用提供的导出或备份功能时，应阅读实际选项，确认包含范围。给备份添加能辨认用途的名称，记录对应配置和保存时间，但不要在文件名里写入密码或完整订阅地址。
备份文件可能包含连接凭据，应保存在受保护、自己能够控制的位置。通过系统文件功能或个人存储空间转移时，确认接收设备与账户正确，避免误选公开共享位置。准备向他人提供规则样例时，应另建脱敏副本，而不是直接发送完整备份；即便表面上只看到规则，文件其他部分也可能保留认证或订阅内容。
可恢复性需要检查，不能仅凭“导出成功”认定完成。至少确认文件可找到、内容完整，并知道如何在应用中重新导入。真正迁移时先保留旧设备资料，在新设备导入后核对服务器、Config 和 Global Routing，再进行实际请求验证。不要在新设备尚未验证前，就删除唯一一份仍可工作的旧配置。
换机、重装与长期不用后的检查
换机或重装后，先通过购买账户的 App Store 已购项目获取 Shadowrocket，购买适用性以商店标注为准。应用重新下载与连接资料恢复是两件事，商店购买记录不会自动证明配置已经恢复。导入备份后还可能需要再次处理系统 VPN 授权，随后重新检查当前配置和按需条件，避免沿用不适合新设备的设置。
长期不用后重新启用，应先验证基础网络，再确认订阅和服务器的有效状态。设备时间异常、服务资料变化和旧配置残留都可能影响连接，不必一开始就修改全部规则。先用已有的有效记录做一次手动测试，成功后再恢复 On Demand 和其他辅助设置。这种逐层恢复方式能区分资料过期与设备配置问题。
准备移除旧记录时，先检查是否仍被分组或规则引用，再确认已有可用替代项。重复记录可以整理，但不应只按名称相似就删除；有些记录可能协议或参数不同。删除后重新验证常用访问路径，确保配置没有留下指向不存在对象的引用。清理的目标是减少歧义和过期内容，而不是让列表数量尽可能少。
当问题持续出现，可整理一份简短检查记录：应用能否启动、VPN 能否建立、订阅能否更新、哪种姿态失败、哪些目标受影响。将这些结果与连接与验证章节对照，比反复重装更有方向。若需要重新走一遍主线，使用快速上手教程；如果只是购买或重新下载问题，转到已购恢复说明。