01 · Subscribe 入口与首次导入
Subscribe 管理的是一个可以再次获取服务器列表的地址,而不是某一台服务器本身。地址返回的内容经过识别后,才会成为客户端中的服务器记录。因此,“订阅保存成功”“列表下载成功”“服务器连接成功”属于三个不同阶段。排查时先明确停在哪个阶段,可以避免在地址失效时反复修改协议参数,也能避免把单台服务器故障误认为整份订阅无法导入。
保存前先确认输入对象
从你的服务商处获取订阅链接后,确认拿到的是完整地址,而不是账户管理页面、说明页面或某个服务器的详情页。通常需要保留问号之后的查询参数,参数可能携带访问凭据;不要因为地址较长而删去尾部,也不要把聊天工具显示的省略号当作地址内容。复制后检查开头和结尾,去除误带的引号、换行和空格,但不要改写地址内部的大小写与编码。
在 Home 的添加入口进入 Add Server,使用当前界面提供的 Subscribe 类型或订阅入口,将链接填入对应地址栏,再设置能辨认用途的备注。保存后返回列表,观察是否出现对应订阅组及服务器记录。各平台布局不必完全相同,若没有看到同名入口,先确认正在编辑的是订阅,而不是要求填写单个服务器地址与端口的协议表单。
把首次获取拆成两次核对
第一次核对的是获取结果:列表是否出现、服务器名称是否合理、协议类型是否可识别。第二次核对的是连接结果:选择其中一条记录,检查必要字段,再执行测试与实际访问。出现列表只能说明内容被读取,不能说明服务状态、凭据有效期、线路或本地网络都正常。订阅名称与服务器备注也只是标识,不是地理位置、性能或可用性的证明。
若保存后列表为空,先保留原地址,不要立即删除整个订阅。确认当前网络能够访问订阅地址,留意是否收到登录页面、权限错误或其他说明文本。浏览器能打开某个网页,也不代表返回内容就是客户端支持的服务器列表。若必须向服务商反馈,描述导入时间、错误提示和网络类型即可;完整链接属于敏感信息,不应贴到公开讨论区。
订阅地址本身可能就是访问凭据不要把完整订阅链接放入截图、公开笔记或共享剪贴板历史。需要演示结构时,使用 example.com 与明显的示例值,不使用真实账户地址。
理解订阅、服务器与配置的分工
订阅负责补充和维护服务器记录,服务器记录负责描述连接端点,Config 中的规则负责决定请求如何处理。三者可以相互配合,但不会彼此替代:导入订阅不等于已经设置规则,切换配置也不会自动修复失效密码。若规则引用某个特定名称,还要确认该名称在当前列表中确实存在,不能只凭“订阅已经更新”判断规则目标有效。
首次导入完成后,记录一个最小基线:订阅备注、导入时使用的网络、能否获取列表,以及一条已实际验证的服务器名称。这个记录不需要包含密码或完整地址。以后发生异常时,先与基线比较,再决定重新获取订阅还是检查单条记录。若只想尽快完成第一次连接,可回到快速上手使用说明继续操作;本章的检查方法适合在结果不符合预期时逐项查阅。
02 · Add Server 手填字段与协议边界
Add Server 用于把已有服务器信息整理成一条连接记录。手填之前,先取得协议名称、服务器地址、端口、认证信息以及所需的传输与 TLS 参数。只有地址和端口通常不足以完成配置。应当按照服务商提供的字段逐项对应,而不是因为几个协议都出现密码或密钥输入栏,就把同一份资料填进任意类型。类型选择错误时,即使表单可以保存,握手也可能失败。
先填端点,再填认证与传输
选择准确的协议类型后,填写服务器地址。地址栏通常只接受域名或 IP,不应混入协议前缀、网页路径和端口;端口填入单独的输入栏。若服务商提供的是完整分享链接,优先使用导入方式,避免人工拆分时遗漏参数。域名与 IP 也不能随意互换,因为域名解析、证书验证和服务端的路由判断可能依赖原始名称。
接着填写认证信息。Shadowsocks 需要与服务端一致的加密方法及密码;Trojan 使用密码,并通常需要核对 TLS 相关参数;VMess、VLESS 应核对 UUID 及其余连接设置。HTTP 与 SOCKS5 的用户名和密码只在服务端要求认证时填写。不要把账户登录密码直接当成服务器密码,也不要把订阅地址中的凭据复制到协议认证栏,除非参数说明明确要求如此。
| 参数组 | 核对内容 | 常见误填 |
|---|---|---|
| 端点 | 服务器地址、端口 | 地址中混入路径或端口 |
| 认证 | 密码、UUID、加密方法 | 混用不同协议的凭据 |
| TLS | 开关、SNI、证书验证 | 把 SNI 默认等同于地址 |
| 传输 | 传输类型、Host、Path | 遗漏路径或改变大小写 |
| WireGuard | 密钥、Address、Endpoint、MTU | 混淆本端与对端密钥 |
区分 SNI、Host 与服务器地址
服务器地址决定连接到哪里;SNI 在 TLS 握手中用于声明目标名称;某些传输方式还会使用 Host 和 Path。它们可能相同,也可能被有意设置为不同的值,不能用“看起来像域名”作为互相替换的理由。Path 中的斜杠、大小写和查询部分也可能参与服务端匹配。收到参数后按原值填写,缺少关键项时向你的服务商核对,不通过反复猜测来补齐。
证书验证失败时,先检查设备时间、SNI、目标域名与证书是否对应,再检查是否连到了预期端点。不应把关闭验证当作常规修复步骤,因为这会改变连接的身份验证边界。若参数说明涉及特殊证书安排,应先弄清服务端的验证要求。Hysteria2、WireGuard 等协议还有各自的专用字段,不能套用 Trojan 的字段含义理解所有输入框。
保存后采用单变量排错
建议先用明确的备注保存一条记录,再核对协议、地址、端口和认证四组基础信息。发现问题时每次只改一组,并记下改动前后的表现。如果同时改密码、SNI 与传输类型,即使连接恢复,也无法知道真正原因。测试记录应描述“连接超时”“认证失败”“TLS 错误”等现象,而不是笼统写成“不能用”,这样才能选择下一步检查方向。
手填记录若来自订阅内容的人工复制,应在备注中说明它是本地副本。服务商调整密码、端口或传输参数后,这条副本未必随订阅更新,需要自行复核。WireGuard 的字段含义可继续阅读WireGuard 参数详解。不清楚的选项先保留当前默认值,并确认服务端是否要求修改;默认值只能减少无依据改动,不能替代服务商提供的完整参数。
03 · Scan QR Code 与剪贴板导入
扫码和剪贴板导入只是不同的输入方式,最终仍然需要识别其中承载的内容。二维码可能装着一条服务器分享链接,也可能装着订阅地址、普通网页或其他文字。剪贴板同样可能包含标题、说明与多条链接。因此,导入成功的判断不能只看有没有弹出确认,而应当检查新增对象的类型、数量和字段,确认它与原始资料表达的是同一件事。
扫码前后的完整检查
使用 Scan QR Code 时,按系统提示授予相机权限,将完整二维码放入取景范围。避免裁掉边缘、拍摄反光屏幕或把图片压缩到细节难以辨认。若使用当前界面提供的图片识别功能,应选原始清晰图片,不必为了识别而把二维码上传到外部网站。二维码包含的密码或订阅凭据,与可读文本具有相同敏感性,不能因为肉眼不易读取就公开转发。
扫码之后先查看识别结果或待保存表单:是 Subscribe,还是某一种协议的服务器记录;地址与备注是否符合预期;是否出现需要补填的字段。若扫描后跳向网页,不要假设它已经完成订阅导入,应先判断该网页与实际地址的关系。扫码无法识别时,可以请资料提供方重新给出同一内容的文本形式,再通过剪贴板输入,以区分图像质量与内容格式问题。
剪贴板内容只保留需要导入的部分
复制文本时尽量只选完整链接,不把“点击这里”等说明一并复制。系统询问是否允许读取剪贴板时,应在确实准备导入的操作中决定是否允许。若拒绝后未能继续,可改用手动粘贴入口,不必为了反复尝试而修改协议参数。导入前特别检查链接是否跨行;显示换行与实际插入换行不同,后者可能让一条完整链接被识别成两段。
多条服务器链接应按原始资料的分隔方式保留,通常一行一条更便于复核。先用一条确认格式可以识别,再处理批量内容,可以减少一次导入大量错误记录的清理成本。复制自富文本、文档或聊天消息时,还需留意全角标点、不可见字符与尾部句号。不要对整段内容进行随意替换,因为密码和编码参数中的符号可能本来就是有效组成部分。
导入方式不决定更新能力扫码得到单条服务器记录后,它通常只是该时刻的参数副本。只有被保存为订阅并保留订阅地址的对象,才具备再次获取服务器列表的基础。
处理重复、缺项与权限问题
连续点击导入可能产生重复记录,但名称相同并不能证明内容相同。删除之前比较来源、协议、地址和端口;需要时再在本地核对认证与传输参数。两个备注不同的记录也可能连接同一端点。若不能确定,先保留原先验证可用的记录,为新记录加上可辨认备注,完成测试后再整理,避免清理过程中把唯一正确的一条删掉。
导入后某些字段为空,不一定意味着客户端丢失了内容:可能是原始链接没有携带,也可能是参数写法无法识别。对照服务商提供的完整资料,优先补齐必须项,不要根据名称推断协议。若相机打不开,先查看系统权限;若文本读不到,先检查剪贴板和粘贴入口;若字段不完整,再进入格式与参数排查。把权限、识别和连接三个阶段分开,能显著减少无效操作。
完成导入后,按自己的安全习惯清理剪贴板中的敏感内容,并检查设备是否开启跨设备剪贴板或第三方输入历史同步。需要保留原始资料时,应放入受保护的存储位置,不靠长期留在剪贴板中保存。遇到平台权限提示或导入后无法连接的情况,可结合FAQ中的对应问题继续核对;不要为了绕过一次提示而扩大不必要的长期权限。
05 · 订阅更新策略与覆盖处理
更新订阅的实质,是重新请求地址并把返回的服务器信息交给客户端处理。它不同于更新 Shadowrocket 应用,也不同于重连当前服务器。更新可能带来新增记录、参数变动或旧记录移除;具体保留和替换行为应以当前界面结果为准。不要假设本地改过的每个字段都会永久保留,也不要假设更新操作会自动修复已有连接中的全部问题。
先保护本地修改,再执行更新
准备更新前,记下当前正在使用的服务器和路由模式;如果曾在订阅记录上修改密码、传输设置或备注,先记录修改内容及原因。重要调整更适合保存为明确标识的独立副本,而不是隐藏在订阅管理的记录里。独立副本的代价是需要手动维护,因此应当只为确有用途的改动创建,不宜把整份订阅长期复制成另一份难以追踪的列表。
执行一次手动更新后,先检查订阅层面的提示,再检查服务器列表变化。成功获取不代表所有原记录都还在,也不代表当前选中项仍有效。若原先使用的记录消失,应确认是否被服务商移除或改名,再选择新记录验证。不要为了保住旧名称而随意把新参数覆盖进去,因为其他规则或自动选择设置可能仍然依赖原有对象关系。
根据变化频率安排获取
如果当前平台与界面提供自动更新选项,可结合服务商的调整频率和设备使用习惯设置。后台任务受到系统调度、网络和省电状态影响,不能把设定时间理解为必定准时执行的承诺。重要使用之前,可以主动更新一次并核对结果;不需要在短时间内连续点击,以免触发地址端的访问限制,反而使原本正常的获取变成失败。
更新失败时,先看本地网络能否正常联网,再判断订阅域名是否可访问、凭据是否仍有效、返回内容是否符合预期。有些地址的访问依赖当前网络路径,切换网络后结果可能不同。此时需要区分“取不到列表”和“列表中的服务器连不上”:前者检查获取路径,后者检查连接端点。已保存记录可能仍能使用,但这不意味着新的列表已经成功获取。
失败后先保留现状在尚未确认地址失效或内容错误之前,不要用删除全部记录的方式处理一次更新失败。先保存可用信息,再定位失败阶段。
识别覆盖、改名与内容异常
若更新后本地备注恢复成原名称,说明该项可能仍由订阅内容管理。若排序变化,也要先确认是否采用了新的列表顺序或先前测试排序,而不是立即认定记录被替换。对重要服务器,用来源、协议、地址和端口共同辨认,不依赖单一名称。认证与传输参数同样可能更新,但比较这些敏感字段时应在本地进行,不发送完整前后对照截图。
若更新后突然出现大批不认识的记录,或者原来的协议类型整体改变,暂停继续连接,重新核对订阅地址与返回内容。可能是选错订阅、地址被改写,也可能是服务商调整了输出。确认之前不要把异常内容当作正常升级接受。恢复时应以已知的原始资料为依据,而不是从历史消息里随意挑一个看似相同的地址替换。
发生批量更新后的故障,建议按“列表获取、字段核对、单条测试、实际访问”的顺序复核,并记录每一步结果。客户端应用版本与订阅内容是两条独立维护线;若需要检查客户端获取方式,转到下载页,不要把重新获取应用当成替代订阅排错的固定步骤。明确更新了什么、没有更新什么,才能判断回退参数、重新选择或联系服务商中的哪一步有必要。
06 · 多订阅命名、分组与记录整理
同时管理多份已有订阅时,首先要解决的是可辨认性,而不是把列表压得尽可能短。订阅名称、服务器备注、连接端点和配置中的策略目标属于不同层次。把这些概念混为一谈,容易在清理时误删有效记录,也容易在改名后发现规则不再指向原对象。整理应围绕“来源清楚、用途清楚、变更可追踪”展开,而不是依赖颜色、符号或名称中的地区字样判断功能。
为订阅与手填记录建立命名约定
订阅备注可以按自己的用途命名,例如日常、测试或临时迁移,并在个人记录中说明其对应关系。不要把完整账户名、密码或订阅凭据塞进备注;备注可能出现在列表、导出文件和截图里。服务器备注则保留必要的辨认信息,不必把所有协议参数都写入标题。名称足够区分即可,过长的备注在窄屏中容易截断,反而增加选错记录的机会。
建议把手填记录、本地修改副本与订阅记录明确区分。例如在备注中使用一致的用途前缀,并在备份说明中注明来源类型。这样在订阅更新后,能够知道哪些记录应随来源维护,哪些需要自行复核。如果界面提供分组显示,可以利用它减少混排;若没有适合的分组功能,仍可用清晰备注和外部的非敏感索引达到同样的辨认目的,不必假设所有平台都有完全一致的管理入口。
去重时比较对象,不只比较名称
两条记录名称相同,可能分别来自不同订阅,认证信息或传输设置也可能不同。两条名称不同的记录,则可能实际指向同一地址和端口。去重时先比较来源和协议,再比较端点,最后根据需要核对认证与传输参数。即使端点相同,也不一定可以合并,因为服务端可能按不同凭据或请求名称区分连接。无法确认时,先标记候选重复项,不立即批量删除。
同一订阅地址被重复添加,会让用户误以为服务器数量增加,也会使更新结果难以判断。确认地址时可以在本地比较完整文本,但不要把敏感地址放进公开对比工具。若确认两份订阅完全重复,保留备注清楚、已验证的一份,并先检查当前选择和配置引用,再移除另一份。整理后执行一次更新与实际访问,确认留下的订阅仍能独立维护列表。
| 对象 | 主要用途 | 整理风险 |
|---|---|---|
| 订阅 | 维护远端服务器集合 | 删除后可能失去更新入口 |
| 服务器记录 | 保存具体连接参数 | 误删当前使用的端点 |
| 本地副本 | 保存独立修改 | 参数不会必然跟随来源变化 |
| 配置引用 | 指定规则或策略目标 | 改名、删除后目标可能失效 |
把整理与规则调整分成两次操作
先完成列表命名与来源整理,验证连接正常后,再处理配置中的引用与策略。若把去重、改名、更新和修改规则一次做完,异常出现时很难定位是哪一步改变了行为。尤其是按具体名称引用服务器的配置,改名后需要检查实际目标是否仍存在;使用通用策略名称的规则,也要确认它最终采用的是当前预期的服务器,而不是先前留下的选择。
整理记录可以采用简短的变更说明:保留了哪份订阅、删除了什么重复来源、哪些手填记录需要复核,以及整理后验证了哪条连接。说明里不放密码和完整链接。暂时停用的记录可以先通过备注标识,待验证备份可恢复后再删除。列表管理追求的是下一次发生问题时容易查清,而不是当下看起来条目最少;保留少量有明确用途的备选记录,比保留大量来历不清的重复项更容易维护。
07 · Connectivity Test、延迟与排序
Connectivity Test 和其他延迟测试用于观察特定条件下的连接表现,不是对服务器全部能力的评分。测试可能涉及不同目标、不同连接阶段和不同超时设置,因此只有在测试方法、设备网络及时间条件接近时,结果才适合比较。数值较低不等于下载吞吐更高,显示超时也不能单独证明服务器已经失效。先理解测试在测什么,再决定怎样排序与选择。
在一致条件下建立测试样本
测试前确认本地网络能够正常访问,再固定网络类型,避免一部分记录在无线网络下测、另一部分在移动网络下测。查看当前界面使用的测试方式与目标;如需修改,应记录修改前后的差别。首次可以只测少量候选记录,间隔后再重复一次,观察结果是否稳定。大批并发测试可能受到设备、网络或服务端限制,不宜把一次批量结果视为最终结论。
如果所有记录都失败,优先检查共同因素:设备联网状态、测试目标、当前路由模式以及是否存在系统层面的连接限制。若只有某一条失败,再查看该条的地址、端口和认证。若同一条记录在不同网络表现不同,应记录网络差异,不要立刻重建全部配置。这样的分层方法能够把局部端点故障与公共测试条件问题分开,避免根据一条错误结果清空可用列表。
区分延迟、吞吐与实际请求
延迟描述特定交互所需的时间;吞吐反映持续传输能力;实际访问还受目标网站、DNS、规则匹配和服务端负载影响。测试通过后,应选择该记录并访问自己需要使用的正常目标,确认请求确实走了预期路径。若只有某个应用异常,应继续检查应用连接方式与规则,而不是直接把整条服务器记录判定为不可用。已有长连接也可能让切换后的效果不能立即反映出来。
排查时可短暂对照 Global Routing 的不同模式。Config 按配置规则处理,Proxy 与 Direct 可帮助区分代理路径与直连路径的差异,但测试本身会改变流量处理范围,因此需要明确测试目的,结束后恢复日常设置。不要仅根据页面最终是否打开判断规则正确;有时直连也能访问同一目标,仍需结合当前模式及可用的连接信息确认请求去向。
排序结果是当时条件下的参考延迟排序不会承诺后续请求都更快,也不会必然自动切换当前连接。完成排序后,仍需确认实际选中的服务器和当前路由模式。
排序、选择与故障记录
按测试结果排序前,先确认当前列表的范围,是某个订阅、全部记录还是筛选后的候选项。不同范围混排容易让来源不清。排序后核对当前选择是否变化;如果界面只改变显示顺序,就需要自行选择并验证。对持续超时的记录,可以先标记或放到后续复核清单,不必立即删除,因为问题可能来自临时网络、测试目标或服务商维护。
记录故障时,保留测试方式、网络类型、错误表现、是否能够获取订阅、实际访问结果以及最近做过的参数修改。不要为了说明问题而公开完整日志;日志中可能包含域名、地址、请求信息与认证相关内容,应先在本地检查并最小化披露。需要服务商协助时,提供足够定位的现象即可,敏感凭据仍通过其正常受保护渠道处理。
若延迟正常但速度慢,可以按本地网络、协议参数、线路与服务端状态逐层对照,详见速度慢的分层排查。同一时段只改变一个条件,例如仅切换网络或仅更换一条已有记录,才能形成有意义的对照。连接诊断的目标是找到影响因素,而不是追逐一次测试中的最低数值;稳定复现与清晰记录通常比频繁排序更有帮助。
08 · 删除、备份与恢复验证
删除之前先确定对象:删除一条服务器、删除整份订阅、删除配置文件和移除客户端,影响范围并不相同。某些记录可通过重新获取订阅恢复,手填参数与本地修改则未必有第二份来源。不要把“还能看到订阅名称”当作已经完成备份,也不要认为保存一张列表截图就能恢复认证与传输设置。可靠的备份应能说明保存了什么、缺少什么以及怎样验证。
先盘点需要保留的内容
至少区分四类资料:订阅地址、独立服务器参数、配置文件,以及与使用方式有关的本地设置。订阅地址可以用于重新获取列表,但无法保证服务商未来仍返回相同内容;服务器分享链接可能没有包含所有本地修改;配置文件可能只有规则,并不包含可用服务器。备份前查看当前平台实际提供的导出范围,不凭文件名或文件大小推断它已经包含全部信息。
使用界面提供的导出或分享功能后,在受保护的位置检查文件内容与用途,记录对应来源和恢复顺序。涉及认证信息的文本、二维码和文件都应按敏感资料管理。不要把它们放入公开网盘链接、共享文档或普通截图相册中长期传播。若采用云端存储,应使用自己认可的账户保护与访问控制;备份的方便程度不能替代对读取权限的检查。
删除按最小范围逐步进行
清理单条记录前,先切换到另一条已验证的记录,并检查配置是否引用待删对象。若删除的是订阅组,要阅读确认提示,弄清关联服务器会如何处理。不要假设删除订阅只会移除地址,也不要假设保留下来的服务器仍具备自动更新能力。对不能确定的行为,先在不影响日常连接的小范围对象上验证,再处理重要订阅与配置。
删除由订阅维护的某条服务器后,它可能在下次更新时重新出现,因为远端列表仍包含该条目。这不一定是删除失败,而是本地删除与远端内容维护之间的差异。若只是暂时不想使用,优先通过明确备注、选择其他记录或当前界面提供的管理方式处理。不要为了阻止一条记录回来而破坏整个订阅地址,更不要把地址中的凭据删改成无效值保存。
备份完成的标准是能够恢复确认文件存在只是第一步。还要核对协议字段、配置引用、当前选择和实际访问结果;仅有导出成功提示,不足以证明恢复链路完整。
恢复时先连通,再恢复自动化
恢复应从最小可用状态开始:先恢复订阅或一条独立服务器,核对参数并完成实际访问,再恢复 Config 与相关规则,最后检查 On Demand 等自动连接设置。这样即使恢复后有异常,也能判断是连接资料本身、规则引用还是自动化条件造成。不同设备的权限和网络环境可能不同,不能因为同一个文件在旧设备可用,就跳过新设备上的验证。
恢复之后,重新确认订阅能否更新、当前服务器是否存在、本地副本是否仍需维护,以及规则是否引用了过时名称。若备份中保存的是旧密码,重新导入并不会使它恢复有效;若订阅凭据已经更换,也应从你的服务商处获取当前资料。旧备份可保留用于理解历史改动,但不应在缺少核对的情况下反复覆盖新设置,否则可能把已经修复的问题再次带回。
怀疑订阅地址或服务器凭据泄露时,仅从本机删除记录不能使已泄露内容失效,应按服务商提供的正常流程更换或撤销相关凭据,再更新客户端与备份。处理完成后,清理不再需要的旧文件,并留下不含敏感内容的恢复说明。日常管理形成“修改前留存、修改后验证、确认后清理”的顺序,比长期堆积无法辨认的导出文件更可靠。后续常见问题可继续查阅FAQ,首次连接流程见使用说明。