Clash 订阅导入

先确认订阅内容，再选择导入方式

已经拿到订阅地址时，优先使用客户端的远程 URL 导入。二维码适合跨设备传递地址，本地 YAML 适合离线迁移和检查配置。三种入口解决的是“怎样把配置交给客户端”，不改变客户端内核支持的协议，也不会自动修复订阅格式。

导入前先在订阅提供方页面选择 Clash 或 Clash Meta / mihomo 格式，再复制完整地址。账户登录页、套餐管理页和订阅地址不是同一项。地址中问号后面的查询参数可能包含身份令牌，复制时不要删掉，也不要把结尾的标点一起带入。

URL 导入：下载配置后还要选中启用

桌面客户端通常把远程配置放在“订阅”或“配置”页面，而不是系统代理设置里。下面按常见界面标签描述；不同发布版本和界面语言可能调整按钮名称，应以客户端当前显示为准。

Windows、macOS 与 Linux 桌面端

1. 以 Clash Verge Rev 为例，打开侧栏“订阅”，在订阅链接输入框粘贴完整 URL，再点击“导入”。若界面使用“新建”对话框，选择远程类型并填入 URL。
2. 等待下载和解析结束。确认列表出现新配置，且更新时间发生变化；仅出现一张空配置卡片不代表内容已经获取成功。
3. 点击该配置，将它设为当前配置，再进入“代理”页面检查策略组。切换配置可能改变策略组名称和规则，不要只看之前选中的节点。
4. 在“设置”中启用系统代理，或按实际需求启用 TUN。先只保留一种清晰的接管方式完成验证，避免同时调整多个网络选项。

FlClash 等客户端同样需要在配置管理中添加远程配置，再将其设为当前使用项。macOS 上运行 ClashX Meta 时，可在菜单栏应用的“配置”→“托管配置”中查找管理入口。不要把不同客户端的菜单路径直接互套，也不要把“内核已启动”当成“新订阅已启用”。

Android 与 iOS 移动端

1. Clash for Android 的常见路径是“配置”→“＋”→“从 URL 导入”。填写名称与订阅地址后保存，等待远程内容下载完成。
2. 回到配置列表，点选新条目，再返回首页启动。Android 首次建立 VPN 连接时需要系统授权；若其他 VPN 已占用连接，应先停止它。
3. 使用其他 Android 或 iOS 客户端时，在“配置”或“订阅”中选择 URL 导入，并先确认它支持该订阅格式及节点协议。iOS 客户端不一定使用 Clash YAML，不能仅凭有“订阅”按钮判断兼容。

远程导入失败时，先看具体错误。连接超时偏向网络路径问题；HTTP 401 或 403 常见于凭据失效、访问限制或服务端拦截；下载成功后出现解析错误，则应检查返回内容和内核兼容性。不同原因需要不同处理，不宜反复点击导入来碰运气。

二维码导入：区分订阅地址和单节点

二维码只是文本载体。它可能保存 HTTPS 订阅地址，也可能保存以 ss://、vmess:// 或 trojan:// 开头的单节点 URI。扫描成功只表示读取了文本，不表示客户端能够把它作为完整配置使用。

1. 在客户端的配置添加页查找扫码入口。需要相机权限时按系统提示授权；二维码保存在相册时，选择从图片识别，前提是客户端提供此功能。
2. 识别后检查内容类型。若是 HTTPS 地址，确认它来自可信的订阅来源，再保存为远程配置；若是单节点 URI，应进入客户端支持的节点导入流程。
3. 导入完成后检查配置列表和策略组。单节点导入可能只新增一个节点，并不包含规则、DNS 或策略组，需要客户端的配置模板配合使用。

同一台设备没有图片识别入口时，直接复制原始订阅 URL 更稳妥。不要为了扫码把订阅二维码上传到公共识别网站。若客户端提示“不支持的二维码内容”，应返回订阅页面选择 Clash 格式，而不是把节点二维码反复导入到远程配置入口。

本地 YAML 导入与配置迁移

先把文件保存为 UTF-8 编码的 .yaml 或 .yml，再从客户端的“本地文件”“从文件导入”等入口选择它。Clash for Android 通常可在“配置”→“＋”中找到文件导入；桌面端可从配置管理页新建本地配置或导入文件。

文件扩展名不决定实际内容。浏览器下载到的登录页即使重命名为 config.yaml，仍然不能作为配置使用。用文本编辑器查看开头：若出现 <!DOCTYPE html>、登录表单或网站报错，应回到订阅来源重新获取，而不是继续修改 YAML 缩进。

迁移前检查三项

• 完整性：配置需要具备可用的出站定义和相应策略。只有 proxies: 的节点片段，不等同于包含策略组和规则的完整订阅配置。
• 依赖文件：检查 proxy-providers、rule-providers 中的本地路径。复制主文件不会自动复制其引用的规则文件和节点文件。
• 兼容性：Clash Meta / mihomo 扩展字段和协议不一定被旧 Clash 内核支持。出现“不支持的代理类型”时，应核对内核能力，不能只把字段名称删除。

本地导入后仍要手动选中该配置。若文件在外部编辑器中有变化，还应执行客户端提供的重新加载操作；部分客户端导入时会复制文件，而不是持续读取原路径。

Clash YAML 与 Base64 订阅的区别

“订阅链接”描述的是获取入口，不是统一的文件格式。相同的 HTTPS 地址可能根据服务端参数返回 Clash YAML、Base64 编码的节点列表，或者其他客户端使用的 JSON 配置。能在浏览器打开，不代表能被当前客户端解析。

Base64 是编码方式，不是节点协议，也不是加密保护。若服务商同时提供多个导出格式，优先取用原生 Clash 或 mihomo 配置。必须转换时，优先使用可信的本地工具或自行部署的转换服务；转换服务接收完整订阅地址后，通常也能读取其中的节点凭据。

另一个容易混淆的对象是 proxy-provider 文件。它可以是合法 YAML，但常见内容只有 proxies 集合，应该被主配置的 proxy-providers 引用。将它直接当作完整配置启用，可能没有预期的策略组和规则。完整配置也可能主要依赖 provider，而不直接列出节点，因此不能只靠寻找某一个键判断文件好坏。

导入后不生效，按四个断点排查

1. 配置有没有真正加载

先检查当前选中的配置名称和最近一次加载日志。若日志提示 YAML 解析失败，按报错行号检查缩进、冒号和引号。YAML 缩进使用空格，不使用制表符；规则引用的策略组名称必须与配置中的名称一致。下载成功但加载失败时，客户端可能继续运行之前的配置。

2. 应用是否连到了正确代理端口

系统代理未启用时，普通浏览器流量通常不会因为“配置已导入”就自动进入内核。以下仅是端口设置片段，用来解释端口关系，不是可单独运行的订阅：

mixed-port: 7890
mode: rule
log-level: info

mixed-port: 7890 表示同一监听端口可接收 HTTP 与 SOCKS 代理连接。若当前配置确实使用该端口，手动设置应用代理时可填写 127.0.0.1:7890。实际值以客户端运行设置为准；某些客户端会覆写订阅里的端口。控制接口的端口不等于流量代理端口，不应填入浏览器代理设置。

3. 策略组有没有可用出口

进入策略组选择一个具体节点，再执行延迟测试。结果为 timeout 时，先确认测试地址和节点连通性；显示 120 ms 之类的数值，只表示该次测试请求完成，不保证所有网站都可访问。打开目标网站，同时查看连接记录中的规则、策略组和最终出口，才能确认这次请求走了哪里。

4. 流量接管与 DNS 是否一致

规则模式会按规则顺序决定出口。目标被匹配为 DIRECT 时，即使选中了代理节点，也可能继续直连。TUN 模式负责接管符合路由条件的流量，但需要相应权限和路由设置；它不会把不兼容的订阅变成可用配置。DNS 失败时，应查看解析日志，再检查配置里的 DNS 上游、Fake-IP 设置及过滤项，不要先随机更换多个参数。

• 列表没有配置：检查下载结果、订阅地址和格式。
• 有配置但没有预期策略组：检查是否导入了节点片段，或仍在使用旧配置。
• 策略组有节点但连接超时：检查节点状态、协议兼容性和基础网络。
• 测试可用但浏览器无变化：检查系统代理、TUN 接管、浏览器独立代理设置及连接日志。

保留更新能力与回退配置

首次导入验证通过后，再设置自动更新。配置级订阅刷新与 provider 的 interval 是两套机制：前者由客户端获取整个远程配置，后者由内核更新配置引用的远程资源。不要把 provider 的秒数直接当成客户端订阅更新间隔，客户端界面可能使用分钟或小时。

可先将整个订阅的更新间隔设为 24 小时，并根据提供方要求调整。移动端后台刷新还受系统省电策略限制，设置了周期也不代表应用停止后仍会准时运行。更新前保留一份可用配置；更新后核对策略组、规则与当前出口。需要重新导入或更换客户端时，可查看使用指南中的订阅配置步骤，再继续验证连接。