一、添加前准备：确认订阅地址与客户端状态
Clash Verge Rev 的订阅导入，通常是把服务提供方给出的订阅 URL 添加为远程配置，再由客户端下载配置文件并交给 mihomo 等代理内核加载。订阅地址不是单个节点的服务器地址，也不是控制面板地址；不要把它填入系统代理设置、代理节点编辑框或浏览器地址栏后再复制网页内容。
开始前，先确认 Clash Verge Rev 已正常启动，并从可信的服务提供方账户页面复制完整订阅链接。订阅 URL 往往带有访问令牌，任何拿到链接的人都可能在有效期内下载配置或使用相关服务，应按密码保管。不要把完整链接发到公开聊天、截图、工单或在线转换网站；需要反馈错误时，应遮住域名路径中用于识别账户的部分及查询参数。
- 确认链接用途：选择标注为 Clash、Clash Verge、通用配置或 mihomo 的订阅地址。若提供方给出多个格式，优先使用其明确说明适用于 Clash Verge Rev 的版本。
- 确认客户端可联网：先检查浏览器能否打开普通网页，并暂时关闭可能冲突的其他代理客户端。订阅下载依赖网络连接，不能只看主窗口是否已经打开。
- 准备核对信息：记下客户端版本、当前内核名称与版本，以及订阅服务的有效状态。不同版本的菜单文案可能略有变化，但远程配置通常位于「配置」或「Profiles」页面。
二、在配置文件页面添加远程订阅
桌面版 Clash Verge Rev 的常见操作入口是左侧「配置」或「Profiles」。进入页面后，寻找新增配置、导入远程配置或带有加号的按钮。不同发行版本的图标和译名可能不同；判断入口时看它是否用于添加远程 URL，而不是导入本地 YAML 文件。若打开的是文件选择窗口，通常说明当前选中的是本地文件导入方式，可以返回配置列表重新选择远程导入。
- 复制完整地址：在服务提供方页面使用复制按钮，避免手动输入时漏掉字符。订阅链接可能很长，也可能含有问号、等号、百分号等符号，不要自行删改或在末尾添加空格。
- 新增远程配置：在配置页面点击新增或导入入口，选择 URL、远程配置或同义选项。若界面提供名称字段，可以填写便于识别的名称，例如服务商名称或「个人订阅」，名称只影响本地显示，不会改变订阅内容。
- 粘贴并确认：将完整订阅 URL 粘贴到地址栏，核对开头是否完整、末尾是否被截断，然后保存或确认。不要把只显示在网页标题中的文字当作订阅地址。
- 等待首次下载：客户端通常会自动拉取一次配置。网络较慢时先等待请求完成；如果页面显示更新失败或出现错误提示，记录错误类型后再按后文排查，不必连续重复添加同一个地址。
- 选择当前配置：下载成功后，在配置列表中找到新添加的项目并点击选中、启用或切换为当前配置。部分版本会用勾选状态、边框或状态标记表示当前配置。列表里出现订阅名称，不代表内核已经开始使用它。
如果服务提供方给的是本地配置文件，应使用本地文件导入入口；如果给的是 URL，则应添加为远程配置。两类入口不要混用。远程配置会保留地址，供后续更新使用；本地文件通常不会自动从服务端刷新。
三、动手验证：更新、启用并检查节点
完成导入后，按「远程配置是否更新成功 → 配置是否已选中 → 内核是否正常运行 → 代理组是否有可用节点」的顺序检查。这个顺序可以把下载、解析、启用和连接这几个不同环节分开，避免把所有问题都归结为“订阅没导入”。
手动更新远程配置
- 在「配置」或「Profiles」列表中找到刚添加的远程项目，点击其更新按钮；按钮可能显示为刷新图标，也可能位于项目的更多操作菜单内。
- 等待状态提示结束，再检查更新时间或操作日志。成功更新表示客户端从地址取得了内容，但还需要确认内容是否能被当前内核解析。
- 如果服务商提供更新间隔设置，可以按其说明配置。订阅并非必须每隔几分钟刷新；频繁请求可能触发服务端限流，节点信息也不会因此更稳定。
确认当前配置与节点组
回到配置列表，确认刚更新的项目处于选中或启用状态。随后进入「代理」页面，查看是否出现代理组及节点。如果只有代理组名称、组内没有节点，或者页面提示配置未运行，应继续检查配置内容、内核启动状态和解析日志。首次验证时，可在一个有节点的选择组中手动选择服务提供方给出的节点；若列表显示延迟测试按钮，可运行一次测试，但延迟数值只反映当时的连通结果，不等于所有网站都可访问。
确认节点可选后，再打开客户端的连接记录或日志，观察一次新建访问是否进入内核并命中预期策略。测试时应新开网页或新建连接，避免已有连接缓存造成误判。若代理组当前选择的是 DIRECT，规则模式下的流量可能直连；订阅导入成功本身不会自动保证流量经过代理节点。
- 配置已更新、节点可见：说明远程下载和基础解析大致正常，接下来检查当前配置是否激活及代理组选择。
- 配置已更新、节点为空：可能是订阅内容不含节点、服务端账户状态异常、订阅格式不匹配，或内核不支持配置中的节点类型。
- 节点可见、连接失败：再检查节点是否过期、服务商网络状态、系统时间、网络防火墙和协议兼容性。节点名称出现在列表中，不代表远端服务器当前可连接。
四、更新管理：保留远程配置并避免覆盖问题
远程配置的优势是可以重复从原地址更新。节点变更、订阅到期续费或服务端调整后，可在配置列表中手动刷新；如果客户端提供自动更新选项，可结合服务商建议设定合理间隔。更新后若客户端提示配置错误，先查看日志并保留原有可用配置，不要立即删除所有配置或重装客户端。
远程订阅通常由服务端生成。直接编辑客户端缓存目录中的 YAML，可能在下一次更新时被覆盖，也可能因为客户端重新生成配置而失效。需要添加自定义规则、DNS 设置或本地策略时，应优先使用当前版本提供的覆写、合并或扩展配置功能，并确认最终生效配置确实包含改动。若不确定覆写规则，应先备份并只修改一个项目，随后更新、重载并观察日志。
添加多个订阅时，为配置取清晰且不含敏感信息的名称，避免把令牌或完整 URL 写进名称。每次更新前确认正在操作的项目，更新完成后再确认当前激活项；误把另一份配置设为当前配置，可能导致节点组和规则突然变化。旧订阅已失效时，可以先移除本地条目，再添加服务商重新生成的地址，但应确认新配置已成功加载后再删除最后一份可用配置。
- 更新失败：检查设备网络、系统代理冲突、订阅是否过期，以及客户端日志中的 HTTP 状态或连接错误。
- 更新成功但行为变化：检查服务端是否调整了节点、策略组或规则，并确认客户端选中的仍是预期配置。
- 需要回退：若列表中保留了旧的有效配置，可切回旧配置验证；不要把远程配置缓存文件当作稳定的手动备份。
五、导入失败或节点列表为空：按错误类型排查
先区分“无法下载”“下载到的内容无法解析”“配置已解析但没有节点”和“节点存在但无法连接”。查看「配置」页面的更新提示及运行日志，记录发生时间、错误类型和客户端、内核版本。反馈问题时可以提供经过脱敏的错误文本，但不要提交完整订阅 URL、访问令牌、节点密码或含凭据的配置片段。
- 提示超时、连接失败或无法解析主机名：先用浏览器检查网络是否可用，并确认没有代理环路或其他 VPN 干扰。若其他网站正常但订阅域名无法访问，可能是服务端、域名解析或当前网络路径问题；不要只通过反复点击刷新判断原因。
- HTTP 401 或 403：通常表示未授权、订阅已过期、账户权限不足或访问额度受限。登录服务提供方账户核对状态，必要时重新生成链接。
- HTTP 404：检查复制的地址是否完整、服务商是否更换了订阅链接，以及链接是否来自当前账户。不要自行猜测或拼接新的 URL。
- 返回 HTML、登录页或普通错误页面：请求可能到达了网站，但返回内容不是 Clash 配置。确认复制的是订阅专用地址，而非服务商门户网页地址；必要时联系服务提供方确认格式。
- YAML 解析失败或出现未知字段：可能是响应内容损坏、格式并非 Clash 配置，或当前内核版本不支持订阅中的字段和协议。检查日志中第一个报错位置，并核对客户端实际使用的内核，而不是只看 Clash Verge Rev 的界面版本。
- 配置加载成功但代理页没有节点：检查订阅是否只包含规则或策略组、服务端账号是否仍有节点权限，以及配置中是否存在
proxies内容。某些服务会按指定格式生成文件，格式选错也可能得到不含节点的配置。 - 代理组存在但节点显示故障：先确认节点信息没有过期，再查看具体连接错误。握手失败、认证失败和超时对应的检查方向不同；不要通过随意修改传输参数来掩盖服务端信息错误。
排查时一次只改变一个变量。例如先重新复制订阅地址并更新，再检查内核兼容性，最后测试节点连接。若要重新安装客户端，应先确认配置和必要的本地设置已备份，并从可信渠道获取安装包；重装不能修复已经失效的订阅权限，也不能让不兼容的节点协议自动获得支持。