Shadowrocket
订阅与服务器管理
已有订阅或服务器信息的导入、维护与恢复。先分清订阅、服务器和 Config,再按任务查阅对应章节。
本页是系统查阅手册,适合导入后需要核对参数、维护多个订阅或迁移设备的用户。第一次连接请先阅读使用说明中的快速上手主线,完成一次完整连接后,再回到这里处理更新、排序和备份。订阅链接从你的服务商处获取;下文不涉及订阅来源。
Shadowrocket 提供 iPhone、iPad、Mac(Apple 芯片与 Intel)、Windows、安卓和 Linux 版本。iPhone / iPad 经 App Store $2.99 一次性购买,Mac / Windows / 安卓 / Linux 版免费;具体获取方式见全平台下载页。本文保留界面词英文原文,不同设备的入口位置可能不同,以当前界面实际提供的项目为准。
01 · Subscribe:导入并识别订阅
先判断拿到的是哪一种内容
订阅是可再次请求的服务器列表入口,不等于列表中的某一台服务器。单条分享链接通常描述一个连接对象,而 Config 文件还可能包含规则、DNS 与策略设置。导入前先看服务商提供的内容说明,不要只凭链接长度判断类型。把配置文件地址填进服务器订阅字段,即使地址能够访问,也不代表客户端能够解析出服务器。
订阅链接从你的服务商处获取。复制时应保留完整地址中的路径、查询参数与大小写,尤其不能漏掉末尾的一段字符。聊天软件可能把长链接折行显示,视觉上的换行不一定属于地址;如果复制结果包含说明文字、引号或额外空格,应回到原始内容重新复制,不要逐字猜测修补。
通过 Subscribe 建立可维护的列表
在 Home 进入 Add Server,按当前界面在 Type 中选择 Subscribe,再填写订阅地址与便于辨认的备注。已有独立订阅入口的界面,可直接进入 Subscribe 完成相同任务。保存前再次核对内容类型;这里填写的是订阅地址,而不是从地址中截取出来的服务器域名。
备注建议描述来源归属和使用场景,例如“个人订阅·日常设备”,不要把完整地址或凭据写入可见名称。保存后执行更新,观察是否出现实际服务器条目。只看到一条订阅记录,说明入口可能已保存,但还需要确认列表是否成功取得;保存成功与下载成功应分别判断。
用三个层次判断导入结果
第一层是请求结果:客户端能否访问该地址,是否遇到网络错误或身份失效。第二层是解析结果:返回内容是否为当前入口支持的服务器列表。第三层才是连接结果:解析出的服务器是否具备完整参数、是否能够建立连接。三个层次不能互相替代,尤其不能把“订阅能更新”直接理解为“所有服务器都能用”。
导入后先查看条目数量是否符合预期,再抽查一两条服务器的 Type、地址和端口。部分条目名称可能包含说明信息,并不一定用于连接;名称中的文字也不能代替实际字段。如果返回内容是网页、登录提示或错误说明,应核对订阅权限与地址,而不是反复调整服务器密码。
| 对象 | 主要内容 | 维护方式 |
|---|---|---|
| Subscribe | 获取服务器列表的地址 | 保留来源,按需更新列表 |
| 服务器条目 | 协议、地址、端口与认证参数 | 选择、测试或核对具体字段 |
| Config | 规则、DNS 与策略等配置 | 单独管理并确认当前生效文件 |
第一次更新失败时保留什么
失败后先保留原始订阅记录和完整错误提示,不要马上删除重建。检查设备当前是否能正常联网,再核对地址是否已过期、是否需要重新生成。若其他网页也无法访问,应先处理基础网络;若只有订阅请求失败,则重点检查地址和访问条件。已经保存的旧条目也应先保留,避免同时失去排查线索。
如果同一地址在其他设备已有可用列表,比较的是入口类型、地址完整性与获取时间,而不是复制可见名称。旧设备缓存着列表,并不能证明当前订阅地址仍然有效。向服务商反馈时说明请求阶段和错误现象即可,不要把完整订阅地址放进公开截图;需要提交的字段应通过适当的私密渠道提供。
02 · Add Server:逐项填写服务器参数
先选 Type,再填写共同字段
Add Server 用于手动建立服务器条目。开始前准备完整参数说明,先选择 Type,再填写地址、端口与认证信息。协议选择会影响后续字段,不能先把所有内容填完,再随意切换 Type。若服务商只给出一条完整分享链接,优先使用导入方式,避免手动转录时丢失传输层或 TLS 参数。
地址字段填写服务器域名或 IP,不附加浏览器地址栏中的整段路径;端口单独填写,并核对是否误用了订阅网页的端口。备注只负责辨认条目,不参与认证。保存前检查数字中的空格、域名末尾的标点与复制产生的换行,尤其留意中文输入法自动加入的全角符号。
认证字段不能按名称相似互换
Shadowsocks 通常需要地址、端口、加密方法与密码;加密方法必须与服务器一致,密码相同并不能弥补方法错误。VMess、VLESS 常见的身份字段是 UUID,不能把账户登录密码填入其中。Trojan 的认证信息应按服务端说明填写,不能因为同样出现密码字段,就沿用另一种协议的整套设置。
HTTP 与 SOCKS5 的认证可能由用户名和密码组成,是否需要认证取决于服务器设置。WireGuard 涉及密钥、地址与对端参数,不能按普通用户名密码的方式处理。Hysteria2 还涉及基于 UDP 的传输条件。这里的原则是按所选协议核对字段,而不是寻找一组能在所有 Type 中通用的值。
| 参数层次 | 典型项目 | 核对重点 |
|---|---|---|
| 连接目标 | 地址、端口 | 服务器实际监听的位置 |
| 身份认证 | 密码、UUID、用户名或密钥 | 类型与内容均匹配 |
| 传输设置 | 传输类型、Host、路径 | 与服务端要求一致 |
| TLS | 服务器名称、证书验证、ALPN | 名称与验证条件相符 |
区分服务器地址、Host 与 TLS 名称
服务器地址决定连接发往哪里,Host 可能属于特定传输的请求信息,TLS 服务器名称用于握手中的名称标识;三者有时相同,有时不同。不要看到一个域名就覆盖所有相关字段。路径也不是订阅地址的路径,应按服务端给出的传输参数填写,并保留开头斜杠、大小写与必要的查询内容。
证书验证失败时,先核对设备时间、TLS 服务器名称与服务端证书状态,不应把关闭验证当作通用修复办法。ALPN 等项目只在明确需要时按说明设置;没有提供的参数不宜凭经验添加。随意增加一个看似合理的选项,可能使原本正确的握手条件发生变化。
保存后只做一次有目标的验证
保存条目后,先返回列表确认它仍属于预期的手动条目或来源,再选中进行测试。若地址、端口和认证均未确认,不要同时修改 DNS、规则和传输设置。建议每次只调整一个存在证据的问题,记录修改前后的现象;这样出现改善时,才能知道是哪一项修正产生了作用。
手动条目适合保存明确、独立的连接参数,但不会自动继承订阅后续变更。服务器轮换密码、端口或证书名称时,旧条目可能仍在列表中,却已不能使用。若这组参数来自订阅,先考虑更新原订阅;确实需要本地副本时,应在备注中标明用途,防止以后把临时副本误当成持续维护的来源。
03 · 扫码与剪贴板:确认内容后再导入
二维码只是内容的载体
Scan QR Code 读取的是二维码中的文本,二维码本身不代表某种固定协议。里面可能是一条服务器分享链接,也可能是订阅地址或普通说明。扫描后应查看识别结果和将要建立的对象,再决定是否保存。不要因为二维码来自已有聊天记录,就跳过地址与协议检查;历史图片也可能对应已经失效的参数。
在支持相机扫描的设备上,进入 Scan QR Code,并按系统提示授予相机权限。相机应能完整看到二维码四周边界,避免只对准中间图案。光线反射、图片压缩和屏幕摩尔纹都可能降低识别成功率;适当调整距离比不断点击扫描入口更有效,也不需要先修改任何服务器字段。
从图片识别时保护原始内容
如果当前界面提供从图片识别的入口,可选择保存的原图;没有该入口时,使用另一台自己的设备显示二维码,再以相机读取。裁剪图片时只去掉外围无关区域,不要切掉二维码边缘。二维码内通常已经包含连接凭据,保存、同步和发送图片时,都应按敏感资料处理。
扫描成功却无法导入,说明问题可能已从图像识别转为内容解析。此时继续换角度扫描通常无助于解决,应检查识别到的文本是不是当前客户端支持的格式。如果二维码展示的是说明页地址,就先辨认该页面的用途,不能把网页地址直接当作服务器参数保存。
剪贴板导入前检查复制范围
复制一条服务器分享链接后,返回 Shadowrocket,使用当前界面提供的剪贴板导入入口,并在系统请求时允许此次粘贴。复制内容应从协议前缀开始,到链接末尾结束,不夹带“服务器地址”等说明文字。某些聊天界面会把显示文字和真实链接分开,复制后应确认取得的是链接本身。
同一段内容包含多条链接时,应先查看客户端是否识别为多个独立条目,再决定批量导入。不要在未经确认的情况下把说明段、空行和链接混在一起反复粘贴。部分记录导入成功、部分失败时,保留成功部分,对失败项单独核对,避免把整批内容重复添加多次。
导入后的检查比入口选择更重要
无论来自相机、图片还是剪贴板,最终都应打开生成的条目,核对 Type、地址、端口与必要的传输参数。能显示一个名称,只证明至少解析到了可见信息;名称可能只是分享链接末尾的备注。特别是包含非默认 TLS 或传输设置的条目,应与原始参数说明逐项比较。
导入重复条目时,先比较实际连接参数,不要仅按名称判断。两个同名条目可能有不同端口,同一地址也可能承载不同协议。确认完全重复后,再删除多余副本。若其中一条属于订阅,另一条是手动导入,二者的更新关系不同,应先保留来源信息,再决定以后维护哪一条。
权限与隐私问题分开处理
相机权限被拒绝时,到系统的应用权限设置中检查 Shadowrocket 的相机访问,不需要删除服务器列表。粘贴提示被拒绝时,重新执行一次明确的复制与导入操作,观察系统是否再次询问。系统权限故障发生在内容读取之前,与服务器密码是否正确并不是同一层问题。
完成导入后,避免让完整分享链接长期留在公共剪贴板或公开笔记中,也不要把二维码发到公开讨论区求助。需要展示错误时,保留错误文字,遮盖地址中的身份参数、密码和二维码。若凭据已经外泄,应从你的服务商处获取替换信息;只删除本地图片不会使旧凭据失效。
05 · 更新策略:把列表更新与连接故障分开
更新改变的是来源列表
订阅更新会重新请求订阅地址,并用返回内容维护其管理的服务器列表。它不是重新安装客户端,也不等于刷新 Config。更新后可能出现新增、删除、改名或参数调整,因此应把订阅看作由来源持续维护的数据集合。对其中条目所做的本地编辑,不应被当作可靠的长期保存方式。
准备更新前,先记下当前选用条目的来源和辨认信息,必要时保存独立备份。尤其在需要连续使用的时段,不宜一边保持重要连接,一边同时更新所有来源、切换规则和删除旧条目。先完成一项维护,再验证结果,能减少状态变化带来的判断困难。
何时手动更新,何时检查自动更新
首次添加订阅、服务商通知参数调整、原有条目明显失效时,可以执行一次手动更新。短时间内反复请求通常不会修复认证问题,也可能增加无意义的失败记录。一次请求失败后,先读错误并检查基础网络;确认条件已有变化,再重新请求,比连续点击更新更容易得到有用结论。
如果当前 Subscribe 或 Settings 界面提供自动更新选项,应根据实际使用频率设置,并确认设备后台运行条件。系统可能限制后台活动,因此自动更新不能替代重要使用前的主动检查。不要把某个设备上看到的刷新行为,推断为所有设备都按同一时间表完成更新。
更新失败时沿请求链排查
先确认域名能否解析,再看地址是否可访问,最后看返回内容能否解析。身份参数失效时,网络本身可能正常,但返回内容是错误说明;证书或时间问题则可能在下载列表前终止请求。此时修改列表中某台服务器的端口,并不能修复订阅地址的身份验证。
还应留意获取订阅时所处的网络和路由状态。若当前连接本身已不可用,订阅请求可能受其影响;可先在可信、正常联网的环境中验证基础网络,再按界面实际提供的选项处理。不要为了让地址暂时可访问,就持续保留来源不明的代理或证书设置。
更新成功后检查条目变化
更新没有报错时,仍应查看服务器列表是否为空、常用条目是否改名以及当前选择是否变化。返回空列表可能是来源内容变化,也可能与账户状态有关,不能仅凭“请求完成”判断结果完整。先保存现象和时间线,核对服务商说明,再决定是否再次更新或替换地址。
旧条目被移除后,不要盲目把旧参数手动补回订阅组。先确认是正常下线、命名调整,还是列表异常。若临时需要保留一个已知条目,应作为明确标注的手动副本管理,并认识到它不再自动跟随来源。这样可避免下次更新后,本地修正与来源内容互相覆盖。
区分服务器更新、规则更新与应用更新
服务器更新处理连接目标和认证信息,Config 更新处理规则及相关配置,应用更新处理 Shadowrocket 本身。三类操作的故障表现可能相似,但修复对象不同。服务器能够建立连接、只有特定域名走向不符时,应先核对规则;多个条目同时认证失败时,先检查来源参数,而不是直接重装。
iPhone / iPad 的应用更新通过 App Store 管理,其他平台的更新获取说明见全平台下载页。本手册不以重装作为列表故障的常规第一步,因为删除应用可能同时移除排查所需的数据。安装与首次打开的问题,请按下载页安装说明处理,不要和订阅内容故障混在一起。
06 · 多订阅整理:保留归属与维护关系
先按来源分组,再考虑使用场景
多订阅管理的首要目标,是能够回答每条服务器从哪里来、由谁更新、删除后如何恢复。建议保留原有来源边界,再用备注区分日常使用、测试或临时副本。若当前界面提供分组、折叠或筛选功能,可用于减少列表干扰;没有这些选项时,也可通过清晰的来源备注保持可查阅性。
不要把所有服务器都复制成无来源的手动条目。这样短期看似方便,后续却难以判断哪些密码已更换、哪些条目已经停止维护。订阅归属是一种维护信息,不是装饰名称。需要长期使用某个来源时,应维护其订阅入口,而不是依赖一次导入留下的大量静态副本。
建立不泄露凭据的命名方法
备注可以包含来源简称、用途和必要的设备区分,但不应包含密码、订阅身份参数或完整连接地址。名称过长时,列表可能截断关键差异,因此应把最重要的来源标识放在前面。服务器原名中的说明也要谨慎解读,名称描述不等于经过客户端验证的实际能力。
对于临时手动副本,可加上“手动核对”或“迁移副本”等明确后缀,完成任务后再清理。不要用“最快”“永久可用”这类无法长期成立的判断代替身份信息。同一服务器在不同网络下表现可能不同,测试结果应单独记录,而不是不断改写来源名称。
去重时比较参数和更新关系
同名不是重复,同域名也不必然重复。判定前至少比较协议、地址、端口、认证信息和传输设置,并确认是否属于不同订阅。两个来源即使暂时返回相同参数,也可能在以后独立变化;删除其中一个入口之前,应先确定是否仍需要保留其持续更新关系。
真正需要去重的常见情况,是同一条分享链接被多次扫码或粘贴。先保留一条经过验证的记录,再删除其余副本,并确认当前连接没有仍指向将被删除的条目。对于订阅内部的相似条目,优先保留来源原貌,避免每次更新后都重新做一遍无法持久保存的手工整理。
不要把列表顺序当成策略设置
列表显示顺序只帮助查找,不天然决定 Config 的匹配顺序,也不能证明第一条服务器正在承载所有流量。实际使用路径还取决于选中条目、Global Routing 和配置中的策略引用。整理时如果同时调整了排序与当前选择,应分别验证,避免把界面位置变化误认为连接行为变化。
多来源也不意味着客户端会自动把所有服务器组合成适合自己的切换策略。若配置中存在策略组或明确引用,应检查其成员与选择状态;不要仅因为列表里出现了新服务器,就认定已有配置会自动使用它。对规则不熟悉时,先保留当前可用配置,完成服务器整理后再单独修改规则。
用一个完整维护周期检验整理结果
整理完成后,不只检查当下列表是否整齐,还应执行一次有计划的更新,观察来源备注、手动副本和常用选择是否仍可辨认。若更新后本地名称被覆盖,应把需要长期保存的信息移到独立维护记录,而不是依赖来源生成的条目名称。维护记录与凭据文件应分开存放。
随后选取每个仍在使用的来源,抽查至少一条服务器的参数和连接结果。长期不用的来源可以先做备份与记录,再决定删除;不确定归属的条目先查明用途,不要靠名称猜测。清理的目标是减少重复维护,而不是追求列表尽可能短,更不是把所有来源混成无法追溯的一组。
多人共用一台设备时,还应明确谁负责更新、谁可以修改备注与配置。设备上的服务器数据可能包含个人凭据,不能因为是共享设备就默认适合任意导出。需要交接时说明操作范围,并把恢复资料交给有权管理该订阅的人;一般使用记录只保留来源简称与处理结果。
07 · Connectivity Test:延迟测试、排序与故障定位
测试结果只回答对应层次的问题
Connectivity Test 用于检查条目的连接表现,但不同测试方式验证的层次可能不同。基础连通、协议握手和实际页面访问并不是同一个问题。测试显示一个时间值,不代表所有应用请求都已通过;测试失败,也不能直接证明订阅失效。应先看当前选择的测试方法,再解释结果。
延迟反映某次测试条件下的往返或请求耗时,不等于持续传输速度。一个响应很快的服务器,仍可能在长连接或特定网络下不稳定。反过来,耗时略高也不必然影响实际任务。比较时应使用相同测试方法、相近网络条件与合理次数,不把一次结果当作长期排序标准。
建立可比较的测试过程
测试前先确认设备基础网络正常,尽量避免在系统切换 Wi-Fi 与移动网络时采样。先测一条已知参数完整的服务器,再对同一来源进行批量测试;若批量结果全部失败,应先检查公共条件,而不是认定每条服务器都同时损坏。测试期间也不宜连续更改规则或 DNS。
记录测试方法、网络类型和具体现象即可,不必把完整凭据写入记录。若同一条目偶尔成功、偶尔超时,可间隔重测,观察是否与网络切换、设备休眠或负载相关。短时间密集测试可能得到难以比较的波动结果,不能通过增加点击次数消除网络本身的不确定性。
按失败阶段核对参数
所有请求都失败时,先看基础网络、域名解析和当前路由状态;仅一条失败时,再核对地址与端口。连接建立后认证失败,应重点检查密码、UUID 或对应身份字段。涉及 TLS 的错误则要检查时间、服务器名称与证书条件。按阶段缩小范围,比把所有高级选项轮流开关更有效。
使用基于 UDP 的协议时,还要考虑当前网络是否允许相关流量。若同一配置在一个网络可用、另一个网络持续失败,应记录网络差异,而不是立刻覆盖正确参数。协议本身的传输条件、服务端状态和设备网络都可能影响结果,不能只靠一个超时提示判断根因。
| 现象 | 优先检查 | 暂不应下的结论 |
|---|---|---|
| 订阅更新失败 | 地址、身份状态、请求网络 | 所有服务器都已失效 |
| 单条持续超时 | 地址、端口、协议与传输 | 必须重装应用 |
| 测试通过但页面失败 | Global Routing、规则、DNS 与目标 | 所有参数都正确 |
| 切换网络后表现不同 | 网络限制与传输条件 | 原有配置需要全部重写 |
排序用于筛选,不代替实际访问
如果当前列表提供按测试结果排序,可用它快速找到需要复查的条目,但排序不会自动证明某条最适合长期使用。测试超时的条目也不宜立刻全部删除,先确认是否存在临时网络问题。来源更新后,列表和测试结果可能变化,因此排序应视为一次整理工具,而非固定事实。
选定条目后,回到 Home 核对 Global Routing,开启连接并使用自己的正常业务进行验证。检查系统连接状态与实际访问结果是否一致,必要时查看对应连接记录。若目标命中 DIRECT,服务器测试通过与否可能不影响该请求;应先判断请求走向,再评价所选服务器。
保留能复现的最小问题
向服务商反馈时,说明协议类型、失败阶段、测试方法和网络环境,比只说“连不上”更有帮助。公开反馈应遮盖服务器身份参数,错误截图也应检查列表中的二维码和地址。能够复现的问题通常只需要一条服务器和一组明确步骤,不需要导出全部订阅资料。
进一步排查可阅读节点超时的检查顺序,常见连接问题集中在问答页。若只是首次连接时的系统授权提示,应先按添加 VPN 配置说明完成授权,不要把权限未完成与服务器故障混为一谈。
08 · 删除与备份:按对象恢复,而不是重头整理
先列清楚要保存的四类资料
备份至少应区分订阅入口、手动服务器、Config 文件与个人维护记录。订阅入口帮助重新取得列表,手动服务器保留独立参数,Config 保留规则和相关设置,维护记录解释来源与用途。只有其中一项,并不一定能恢复原先行为;例如只有服务器链接,就无法还原自己修改的规则顺序。
开始前先检查当前界面提供哪些导出或分享方式,再逐项确认导出范围,不应假定一个导出按钮包含全部数据。对于订阅,还要保留必要的来源识别信息,以便确认重新导入后属于哪一组。备份文件可以用用途命名,但文件名不应暴露密码或完整身份参数。
把备份当作凭据文件保存
服务器链接、二维码和导出文件可能包含密码、UUID、密钥或订阅身份信息,普通编码不会降低其敏感程度。应保存在自己可控制访问权限的位置,必要时使用受保护的存储方式。不要把完整文件贴进公开问题页面,也不要为了方便辨认,把凭据写入截图标题或共享文件名。
如果使用设备同步服务保存文件,应检查账户登录状态、共享范围与其他设备访问权限。备份的目的不是让资料复制得越多越好,而是在需要时能安全读取并恢复。旧设备转交他人前,应先确认新设备已恢复成功,再清理旧设备中的链接、二维码、导出文件和相关剪贴板记录。
删除单条、删除订阅与删除 Config 的影响不同
删除手动条目通常影响该条连接记录;删除订阅入口可能同时影响其管理的服务器列表;删除 Config 则影响规则与配置选择。具体操作前应阅读界面的确认提示,确认删除范围。不要因为列表中某一条测试失败,就直接删除整个来源,更不要用删除配置来处理认证字段错误。
订阅内部条目即使被单独删除,也可能在下次更新时重新出现,因为来源仍然返回它。需要长期减少显示干扰时,应优先使用当前界面已有的整理功能,或保留清晰的来源边界。若准备彻底停止维护一个来源,先备份并切换当前连接,再删除入口,最后检查相关配置是否仍引用旧条目。
恢复时按依赖顺序操作
在新设备上先完成 Shadowrocket 的正常获取与首次打开,再导入订阅或手动服务器,随后恢复 Config,最后核对 Global Routing 和当前选择。平台入口见全平台下载页。不同设备的界面组织可能不同,迁移时应比较对象和字段,不照搬旧设备上的点击位置。
订阅重新导入后执行一次更新,确认地址仍有效;手动条目则逐项抽查参数。恢复 Config 后不要立即假定已经生效,应查看当前选中的文件,并检查引用的策略或服务器是否存在。系统 VPN 配置权限也可能需要重新确认,导入数据并不能代替设备层面的连接授权。
用恢复演练判断备份是否完整
备份完成后,应做一次不破坏现有环境的小范围核对:确认文件能够读取、导出对象可识别、订阅地址能对应正确来源。具备另一台自己的设备时,可先恢复一条服务器与一份配置进行验证;没有其他设备时,至少检查文件内容范围和保存位置,不要以“文件已存在”代替完整性判断。
恢复成功的标准包括列表来源可辨认、关键参数相符、Config 已选中、Global Routing 符合预期,以及实际业务能够正常完成。全部确认后,再处理旧副本与重复条目。不要在恢复尚未验证时清空唯一可用设备,也不要把删除应用当成清理少量重复记录的替代操作。
如果删除后没有本地备份,订阅管理的内容可先尝试通过已有订阅入口重新获取;独立手填参数需要从原始记录或你的服务商处重新取得。涉及已泄露或已更换的凭据,应使用新信息恢复,而不是反复找回旧文件。完成后回到使用说明走一遍连接验证主线,形成维护闭环。