官方手册 · 节点管理

Shadowrocket 订阅与服务器管理手册

首次连接请按使用说明走完导入、连接与验证。本页是系统查阅手册,适合已有订阅或服务器资料、需要核对字段、更新条目或迁移记录时使用。下文以 iPhone / iPad 上的界面词定位,其他平台以设备上显示的对应功能为准。

获取 Shadowrocket:iPhone / iPad 在 App Store $2.99 一次性付费,系统要求以 App Store 页面标注为准;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 免费,安装包由本站 /dl/ 提供。客户端一次性买断 ≠ 线路套餐。本站不提供、不销售、不推荐节点或订阅;本文只处理你已有的资料。

Subscribe:登记订阅并核对条目

在 Home 打开 Add Server,选择 Subscribe,登记已经持有的订阅地址。订阅地址从你的服务商处获取。这里保存的是一个可重新读取的订阅入口,读取后才生成供选择的服务器条目。不要把一条服务器分享链接填进订阅地址栏,也不要把一个网页能在浏览器里打开,当作它可以在 Subscribe 中使用的依据。

先判断手里的资料属于哪一类

同一个服务可能同时给出订阅地址、单条服务器链接以及一份参数清单。它们用途不同:订阅适合维护一组会变化的条目,单条链接用于复制当前这台服务器的参数,参数清单用于在 Add Server 中逐项填写。配置文件则在 Config 中管理,主要用于保存路由规则及相关设置。扩展名、二维码的外观和备注名都不能替代这个分类;在不确定时,先查原始资料对这份内容的说明。

已有资料录入位置保存后核对
订阅地址Subscribe订阅下是否出现预期服务器
单条分享链接扫码或从剪贴板导入条目协议与地址是否一致
服务器参数清单Add Server必填字段是否与清单逐项对应
规则配置文件Config使用的配置与规则是否正确

保存后先验证列表,再连接

复制完整地址,保留原有的协议前缀、路径和查询参数。末尾不小心粘入的换行或额外空格可以去掉,但不要删掉地址中看似无意义的一段字符。填写备注时写能辨认的短名称,不把账号、凭据或完整链接当备注。若需要在多台设备上辨认同一份订阅,可以统一备注,再在设备自己的维护记录里注明用途。

保存后回到 Home,展开对应的订阅,按备注、协议和地址核对熟悉的条目。若只看到订阅名称而没有下属记录,先确认是否已经展开,再查看是否有可用的更新结果。完成核对后,选择一条你认识且允许使用的服务器,并以一次实际连接来验收。列表出现、服务器选中、实际请求成功是三个独立结果,不能用其中一个替代另外两个。

把订阅读取异常与连接异常分开处理

如果首次读取没成功,先确认设备的普通网络可用,再对照手边的原始资料,检查复制内容是否被聊天工具分行、截短或加上引号。如果确认读取完成却没有条目,应优先核对是否选对资料类型,以及返回内容是否与 Subscribe 兼容。若更新后返回了账户提示或普通网页,说明需要检查订阅访问本身;反复更换 Global Routing 并不能把网页转换成可导入的列表。

如果列表完整而选中的服务器连不上,切回服务器这一层去查。先确认 Home 当前选中的确实是刚核对的条目,再用相同网络测试同一订阅中的另一个已知可用条目。只有一个条目失败时,先保留这一组记录,再对照地址、端口和协议字段;同组多条都失败时,再检查网络、订阅状态和路由。每次只改一处并记录结果,这样重试成功时才知道哪一步有效。

Add Server:按协议手填服务器字段

只有已经掌握完整的服务器参数时,才用 Add Server 手填。先选协议,再照原始资料填写地址、端口、认证和传输参数。协议一旦选错,表单即使允许保存,也可能把一个看似正确的值放在错误位置。已有能用的条目时,建议保留原件并新建一条测试记录,确认新记录能用后再决定是否替换。

把通用字段与协议专属字段分开

地址栏填主机名或 IP,端口填服务端指定的数值。除非界面明确要求完整 URL,否则不要把协议前缀、路径、查询参数和端口一起塞到地址栏。若资料给了带端口的 IPv6 地址,先分辨哪一部分是地址、哪一部分是端口;分隔完整端点的方括号不应被误当成地址内容,也不要按冒号随意把 IPv6 地址截成两段。备注只帮助辨认条目,不参与连接。

协议认证或配置重点不要混填
Shadowsocks加密方法与密码都要与服务端一致加密方法不是密码的一部分
VMess / VLESSUUID 和资料中指定的传输参数共用 UUID 形式不代表协议可互换
Trojan密码与资料中指定的 TLS 参数不要用备注或地址栏代填密码
Hysteria2认证及资料中指定的 TLS 参数不要照搬其他协议条目的设置
WireGuard密钥、接口地址与对端参数公钥、私钥和对端地址各有用途

区分地址、SNI、Host 与 Path

服务器地址决定连接发往哪里;在相关协议和传输启用了 TLS 时,SNI 是握手中携带的服务器名称。资料还可能给出 Host 或 Path,它们属于对应的应用层传输设置。例如服务器地址是一个 IP,而 TLS 使用域名,这不等于所有填域名的地方都应复制同一值。只有资料明确给出对应关系时才重复使用。先选正确的传输,再填它要求的字段;如果看不到该字段,应回头核对协议和传输,而不是找一个名称相近的输入框代填。

留空也是一种设定。资料没有指定的可选项不必逐一打开,已有默认值也不意味着它适合所有端点。遇到明确指定的空值,保留空值,不用其他条目中的参数填补。复制密码、UUID 或密钥时,检查是否误带了空格和换行,但不要擅自改变大小写。能够保存只说明客户端接受了这组输入,不代表服务端认可认证、传输方式或证书名称。

按错误出现的阶段回查

保存后在 Home 选中新条目,用同一网络做测试。完全超时,先查地址、端口以及当前网络是否能到达该端点;能到端点但认证失败,再看协议、密码或 UUID;能开始握手却在 TLS 或上层传输失败,回查 SNI、Host、Path 等对应参数。提示信息不一定能精确指出原因,因此不要只凭一条通用的超时提示就改密码。和已导入的同一服务器作对照时,先确认两条记录确实指向同一端点。

调整时一次只改一个字段,改完重新测试同一个请求。如果旧记录可以连接、新记录仍然失败,比较两条记录里看得见的协议和传输选项,比重建整个订阅更省事。如果新记录最终生效,给它清楚的备注,并记下来哪些值来自原始资料、哪些保持默认。以后端口或凭据轮换时,这份不含敏感值的记录能帮助定位需要动的字段。

扫码与剪贴板:导入后核对内容

二维码和剪贴板只是载体,导入后的对象由内容决定。一张二维码可以装一条服务器链接,也可以装订阅地址或网页;扫描成功不等于已经添加服务器。先确认手里的码或文本对应哪类资料,再从当前设备可用的入口导入。导入前如果应用正在使用别的连接,记下当前选中条目的备注,便于导入完成后恢复原来的工作状态。

使用 Scan QR Code,先检查识别结果

在 Home 打开 Scan QR Code。扫描另一块屏幕上的二维码时,保持整个二维码及四周留白可见,避免裁切、反光和显示过小。如果系统询问相机权限,仅在确实要使用相机扫描时按设备提示授权。二维码在本机时,若扫描入口提供选取图片的能力,可选取已有图片;如果该入口不支持图片,就改用同一份资料的原始文本,不把图片上传到在线解码页面。

识别后先阅读应用显示的内容,再决定是否继续。若识别成普通网址、预期之外的订阅或不认识的协议,退出并回查原始资料。某些二维码显示在带文字说明的页面里,旁边还可能有网页跳转码;不要把旁边那个能顺利识别的二维码当作服务器记录。保存后回到 Home,核对出现的是一个单独条目还是一份包含若干条目的订阅,并查看能辨认的地址和备注是否相符。

用剪贴板导入完整的一条记录

从原始文本只复制要导入的一条数据,不连同标题、序号、代码围栏或前后说明文字一起复制。聊天窗口的自动折行未必真的写入换行,手工换行则可能破坏链接本身。先检查复制范围的首尾,再使用应用提供的剪贴板导入方式;当系统询问是否允许粘贴时,只在剪贴板确实是你刚复制的内容时继续。不要从来源不明的剪贴历史中恢复旧的服务器凭据。

批量文本先用一条记录验证,不假定每种格式都支持整段导入。如果整段文本里有多行地址、说明或备注,把目标条目从原始资料单独复制出来,再检查是否被误添加到已有订阅。不要为保证一次成功把同一条链接同时走扫码和剪贴板两遍:两次导入可能留下重复记录,也会让后续测试无法确认实际选中的是哪一条。

区分没有读到、读到了但没添加、添加后连不上

所谓没有读到,是扫描无反应,或粘贴后连协议前缀都未能识别;此时先改用同一份原始资料的另一种载体。读到了但没添加,通常要检查识别内容属于什么类型、字段是否完整,以及你是否完成了保存。已经添加但不能连接,则应选中刚导入的记录,再核对协议、端口、认证和传输设置。重新扫码最多重做一次录入,不能修复端点本身的不可用。

有时导入成功却看不到新条目,是因为对应分组仍然折叠、筛选条件遮住了它,或导入后的备注和原来的显示名称不同。先展开并按类型找对象,再打开条目核对实际地址;不要为了让它出现在列表开头而先删除同名记录。若要向他人说明失败过程,写清使用的是二维码还是剪贴板、停在哪个确认步骤,以及保存前后列表有何变化。不要把实际链接或二维码放进反馈内容。

订阅更新:比较差异后再切换

更新订阅是重新读取该订阅的服务器列表,不是更新 Shadowrocket 应用,也不等于下载新的规则配置。更新之前先记住正在使用的条目和一条已经验收的备用条目,只记录不含凭据的辨认信息。更新以后先看列表变化,再看连接与规则。若设备近期有重要工作,不要在尚未准备恢复资料时同时改地址、刷新订阅和切换 Config。

手动更新时只改变一个对象

在 Home 找到目标订阅,使用该订阅提供的更新操作。手上有多个订阅时,先确认分组备注和对应地址确实是要更新的那一份。等待本次读取完成,不要在有加载迹象时连点或去刷新其他分组。遇到地址已变更的情况,先确认新资料和原订阅的对应关系,保留原始记录,随后单独验证新地址;不要把排查中的临时地址误当成长期设置。

刷新成功后比较新增、移除和修改三类变化。新增条目不一定适合马上切换;原条目名称没变,也可能更换了端口或传输。对于当前选中的服务器,尤其要核对它更新后是否仍存在,并检查 Home 的选中状态。若应用没有保留原选择,手动选择已核对的条目,然后在同一网络下做一次实际请求。仅凭列表总数不变,不能说明原来的连接仍然有效。

按变更节奏安排更新

刚收到已知变更,或者需要检验一次配置调整时,先手动刷新目标分组并留出验收时间。如果当前界面提供订阅自动更新选项,再根据平时的变更节奏与可用网络安排,不把自动更新视为故障修复工具。设备休眠、网络未就绪或后台执行条件不满足,都可能让刷新未在预期时间发生;有紧接着要做的操作时,回到前台核对实际结果,不只根据设定的间隔判断。

如果当前正在使用的服务器同时是读取订阅所依赖的连接,刷新失败时应分开验证两条路径:访问订阅地址所需的网络是否可用,现有服务器的业务连接是否仍正常。两者可能同时失败,也可能只有一项出问题。比如普通请求正常但订阅读取出现访问提示,此时该查订阅状态和返回内容,不是先清空服务器列表;若更新正常但新条目连不上,则回到协议与端点逐项核对。

更新后分开验证服务器和策略

先在 Home 确认实际选择,再检查 Global Routing。若使用 Config,除了确认单条服务器能工作,还要核对当前配置是否继续将预期请求送往合适的策略。规则若引用某个按名称区分的策略或分组,更新使该对象变化时,应检查引用是否仍有效;不要仅凭新条目名称相似就认为旧引用会自动调整。测试时先用固定的请求,避免不同网站本身的状态差异干扰判断。

更新只影响其中一个分组时,暂停刷新其他分组,先保留仍可用的对照组。如果换回已知可用的记录后请求恢复,就着重查本次列表变化;如果当前可用记录也失败,再查设备网络、DNS 或路由。对照步骤可见开关已开启但无法上网的排查说明。故障结束后记下哪一项已恢复、哪一项仍待核对,避免下次把之前的临时改动当作正常设置。

多订阅整理:命名、去重与配置引用

多订阅环境先区分分组来源,再处理条目之间的重名。订阅备注、订阅内的服务器名称和 Config 里的策略名称是三种标识。即使它们恰巧是同一串字,也不代表指向同一个对象。整理前记录当前选择的服务器、所属订阅和使用中的配置;如果接下来要改分组或删重复项,先保留可恢复的记录。

命名应让下一次排查找得到同一条

给订阅使用稳定、可辨认的本地备注,把用途与条目显示名分开记录。服务器名称可能随订阅刷新而变化,不适合独自承担长期辨认任务,也不建议把原始显示名称都改得一样。对从订阅复制出来作诊断的手填记录,使用一眼能看出是测试项的备注,并在测试结束后清理,免得以后误把它当作原订阅持续维护的记录。

如果界面允许折叠分组,日常可只展开正在使用和需要处理的部分。折叠不会改变分组是否参与更新,也不能代替断开连接。整理表可记分组备注、条目备注、协议、调用场景与最近一次核对的结果,无需抄录完整的访问地址或任何密钥。记录里的时间用于比对维护动作,不用于推断服务端是否已经完成一次变更。

同名不等于重复,同址也不等于重复

两条名称相同的记录,可能端口不同,也可能使用不同的传输和认证。反过来,两条名称不同的记录也可能指向相同端点,但分别由不同订阅维护。先比较协议、地址、端口和必要的传输字段,再确认订阅归属;无法安全核验敏感字段时,就保留两条记录并注明待确认。即使当前参数相同,未来凭据轮换时,两份订阅内的记录也可能按不同时间更新。

如果同一份订阅被登记了两次,优先确认哪一份正被使用,哪一份在备份里有可恢复的资料。先把当前连接切到决定保留的那份并完成测试,再考虑删掉另一份。若列表只是在筛选或排序后出现相似记录,先恢复到能看清分组归属的视图;不要以相邻、同名或延迟接近作为去重依据。

检查 Config 的策略,不用规则管理服务器清单

订阅提供服务器记录,Config 决定哪些请求走预定策略。以下是一个用于解释匹配关系的 Shadowrocket .conf 规则片段,不包含服务器凭据,也不会添加、更新或删除任何条目。在当前使用的配置文件里调整前,先保存副本,并确认你是在修改已有规则段,而不是给同一文件再加一段重复的规则区。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

在 Global Routing 使用 Config 时,规则按顺序参与匹配。后缀匹配的请求走 PROXY;未匹配前项且目的 IP 符合这一 GeoIP 条件时走 DIRECT;漏过前面规则的连接由 FINAL 兜底。这里的 PROXY 是策略词,不是名叫 PROXY 的订阅。更多匹配边界见规则关键字说明。

清理前如果发现配置里用到了特定策略组,先查清组内怎么选择可用条目,再核对这次要删的记录是否正被引用。改好后分别验证预期直连和预期经代理的请求;一个页面能打开,并不能证明另一种策略也按预期工作。若只有部分请求偏离预期,先恢复原配置或相关引用,不必立即重建整份订阅。

Connectivity Test:比较延迟并验证连接

延迟用来筛选当下值得试用的条目,不能单独决定长期选择。Connectivity Test 的结果取决于当前网络、测试方式、目标以及服务器当时的状态。成功的一次测试表示它通过了本次测量,不代表所有应用都能通过它访问每个目的地。超时同样只是一次未得到结果,先建立可以复测的条件,不急着删除服务器。

先固定网络与测试条件

在 Home 找到要比较的条目或分组,使用界面提供的 Connectivity Test。第一次只选少量已知的记录,并记下是在 Wi-Fi 还是 Cellular 上测试。若当前设置允许选择不同的测试方式或目标,比较期间保持不变。笔记里记测试方式、网络与对应的服务器备注即可,不需要保存地址或认证资料。换了网络或者改变测试目标后,另开一组记录,不把前一组数字拼在一起排行。

先测一条最近已知可用的记录,再测刚导入或刚更新的记录。若多个结果差异较大,等当前测试完成后再复测一轮,观察顺序是否稳定以及是否反复超时。尽量避免一边大流量传输一边批量测试:设备与当前网络上的竞争会影响读数。若一组记录当中只有一条反复失败,优先检查那条;如果包括对照条目在内都失败,先查网络和测试目标。

把排序、选中与路由分开看

如果当前列表提供按延迟排序,可用排序把候选条目集中到前面,但仍要核对 Home 的选中状态。前面的记录不一定就是实际连接采用的记录;也不要把手动排序当作策略组会自动改选的依据。刚刷新的条目可能没有有效读数,超时值也不应当作一个可以和成功结果直接比较的普通数字。先复测未得到有效结果的条目,再决定是否暂时搁置。

界面词请求的处理方式验证重点
Config按当前配置规则选择策略核对命中项与实际选中的服务器
Proxy采用代理姿态处理连接确认选中的服务器可承载目标请求
Direct采用直连姿态处理连接核对当前网络的直接访问结果

用实际请求验收,不只看测试结果

选好候选后先看 Global Routing,再访问一个平时使用、允许你测试的目标。若走 Config,确认目标确实命中了要验证的策略;否则网页打开可能只是直连成功,不能证明新服务器能工作。如果为了诊断临时换了姿态,测试结束后恢复原设定,尤其不要让临时使用的 Proxy 替代日常的 Config。对照时尽量用相同的请求,不要用一个能打开的目标和另一个失败的目标比较服务器优劣。

测试显示成功但实际请求失败时,先确认测试与业务请求使用的不是两条不同路径。若路径判断无误,回查目标 DNS、握手和 Config 是否有影响该请求的规则。只有速度不理想时,再判断问题是偶发延迟、传输不稳定,还是目标端响应较慢。此时保留一个同网络下已知能用的对照条目,比不停更换选中项更容易找出真正变化的条件。

删除与备份:先验证可恢复,再移除

删除前先确定要移除的是单独服务器、整个订阅还是 Config。三者影响的范围不同。单独服务器只是一条连接记录;移除整个订阅可能同时移除它管理的条目;移除 Config 则涉及规则和策略。若要删除当前正在使用的对象,先记下原选择,切换到保留的对象并验证工作正常,再执行删除。不确定影响时,先保留或暂时切换,不做批量清空。

按资料类型准备备份

订阅备份要能重新登记原有订阅,不只是留下当前服务器的截图或名字。手填服务器与单条分享记录需要保留可重新录入的参数,规则需要另存 Config 文件或能重新导入的副本。备份清单可另外写明当前选中的条目、对应的订阅备注以及 Global Routing 的姿态;这些状态不一定同文件一起迁移。不要默认一次导出会带上所有服务器、订阅地址、策略选择与系统权限。

若当前界面提供导出或同步功能,先核对导出的范围与恢复入口是否对应。有的文件只适合还原规则,而不是恢复 Home 的服务器清单;有的导出资料包含凭据,不能当作普通文档发送。把备份保存到你能控制访问的位置,将不含敏感值的清单与备份本体分开管理。文件命名用能区分用途和先后顺序的名称,不把完整订阅地址、账号或服务器密钥写进文件名。

删除时逐项确认归属与依赖

在 Home 先识别目标所在的订阅分组,再做删除。如果目标是订阅下的单条记录,之后更新时可能重新出现,因为远端列表仍含该条目;临时不用它时,改选其他记录比反复删除更合适。删除整个订阅前确认没有保留需求,也没有计划靠它继续获得更新。清理配置文件前,先确认当前模式与替代配置,保留能还原正常分流的副本。

每删除一个对象就返回列表核对,并做必要的连接检查,而不是一次确认多项。若发现当前选择指向已删除记录,先切换到已知可用的条目,然后确认 Global Routing 与 Config 是否仍是预期设置。若删错的是订阅,应从备份资料重新登记并读取;若删错的是手填记录,则按保留的参数新建。删除本地记录不会撤销服务端凭据,也不会使已传出的链接自动失效。

换机恢复按清单分批验收

换机时,先在新设备获取 Shadowrocket,再依次核对订阅、独立服务器和 Config。先恢复一份订阅并实际读取,随后选一条已知可用的记录测试;接着恢复独立记录与使用中的配置,最后核对 Global Routing 与 On Demand。设备级的连接授权或按需触发条件可能需要在新设备重新确认。应用已购恢复与服务器资料恢复是两件事,前者不保证后一项也被迁移,商店与换机问题可查已购恢复说明。

新设备出现重复分组时,先判断是同步已有一份,还是手动导入又添加了一份。确认有一份完整可更新、且当前配置工作正常之后,再处理多出的条目。至少复测一次正常网络下的实际请求;如果平时在两类网络间切换,再分别核对需求对应的触发行为。等服务器、配置和使用状态都已核对,再处置旧设备资料。其他获取、连接与使用疑问可查FAQ。

返回章节目录