天枢互联 | 简单易用 与世界互联
tianshuhl.buzz

OpenClash订阅配置怎么导入?链接、YAML上传与节点为0排查

更新于 2026-11-19 · tianshuhl.buzz

简答:先看你手里的是订阅URL、单条协议链接还是YAML文件:订阅URL进入“服务→OpenClash→配置订阅”添加,单条链接通常要开启订阅转换,本地YAML则通过配置管理上传。保存后还要更新、切换当前配置并启动,节点数量、当前配置标记、日志和测试设备都正常,才算真正生效。

定义:OpenClash订阅配置,是由服务商提供的远程订阅地址或本地配置文件,导入后由运行在OpenWrt上的OpenClash管理并交给Mihomo内核使用。

先看输入类型:三种内容不要走同一个入口

先按手里的内容分流,再开始操作。OpenClash官方项目说明,它是运行在OpenWrt上的Mihomo(原Clash Meta)客户端,支持在“服务→OpenClash”中导入订阅或上传配置文件;不同版本的菜单文字可能不同,找不到完全相同的名称时,优先寻找“配置订阅”“配置管理”或“上传”相关入口。可参考OpenClash官方README。

你手里的内容建议入口填写或处理方式
服务商提供的完整订阅URL配置订阅添加配置别名和订阅地址,保存后执行更新
一条或多条vmess://、ss://、ssr://等链接配置订阅并开启订阅转换多条链接按官方字段说明逐行填写,或使用竖线“|”分隔
本地config.yaml、.yml或其他配置文件配置管理或配置文件上传上传后还要切换为当前配置,不能只停留在文件列表

OpenClash官方配置订阅编辑页明确写明:订阅地址字段支持订阅地址以及SS、SSR、Vmess等链接;启用在线订阅转换后,多条链接应当一行一个或使用“|”分隔。字段名称和按钮位置可能随版本变化,若界面没有完全一致的提示,应以当前版本页面显示为准。具体字段可查看OpenClash配置订阅编辑源码。

订阅URL导入步骤:保存、更新、切换、启动

  1. 复制完整订阅地址:从提供方账户页面复制完整URL,不要把网站首页、登录页地址或说明文档地址当成订阅地址。订阅URL通常包含个人凭证,不要发到公开群聊、截图或公开仓库。
  2. 进入配置订阅:登录OpenWrt后台,打开“服务→OpenClash”,寻找“配置订阅”或相近名称,点击添加。
  3. 填写配置别名和订阅地址:配置别名只用于区分多个配置;订阅地址粘贴完整URL。User-Agent或自定义请求头只有在提供方明确要求时再填写,不要为了“兼容”随意修改。
  4. 选择格式:如果拿到的是Clash或Mihomo兼容订阅,优先直接下载;如果拿到的是vmess、ss、ssr等单条协议链接,打开在线订阅转换,再按页面填写转换地址和模板。
  5. 保存并更新:先保存订阅条目,再点击“更新配置”“下载配置”或列表中的更新按钮。OpenClash界面文本将“保存配置”“下载配置”和“更新配置”列为不同操作,因此保存条目不等于已经下载了新配置,可参考OpenClash官方中文界面文本。
  6. 切换当前配置:进入配置管理或配置文件列表,找到刚更新的文件,点击切换、应用或设为当前配置。确认当前配置标记已经移动到新文件。
  7. 启动并测试:启动OpenClash,选择需要的代理模式,再查看节点、代理组和日志。OpenClash界面提供Rule、Global、Direct等代理模式;如果只是验证导入是否成功,先不要同时修改DNS、IPv6和运行模式。

Clash、Clash Meta与Mihomo的名称可能出现在不同服务商的说明中。OpenClash官方README把Mihomo称为原Clash Meta,并列出订阅管理和在线转换功能;因此选择时应优先看提供方明确写出的“Clash/Mihomo兼容订阅”,而不是只看文件名。无法确认格式时,先下载后查看返回内容,若是HTML登录页或空内容,就不是有效的兼容配置。

旧版与新版入口怎么找?按功能名称对照

不同OpenClash版本的菜单路径和翻译可能不同,以下表格只做功能对照,不代表每个版本都会同时显示两套名称。找不到按钮时,按右侧功能定位。

要完成的动作常见新旧名称对照应寻找的功能
添加远程订阅配置订阅/订阅设置/添加配置文件出现订阅地址、配置别名等字段
上传本地文件配置管理/配置文件管理/上传配置文件出现上传按钮或配置文件列表
下载最新内容更新配置/下载配置/检查并更新对已有订阅执行重新下载
让文件真正运行切换/应用配置/设为当前当前配置标记移动到目标文件
查看问题原因运行日志/内核日志/调试日志查看下载、解析和启动过程中的原始信息

如果页面只有“配置管理”而没有“配置订阅”,先检查是否进入了文件管理区域;如果有订阅条目但没有节点,回到订阅编辑页确认地址和转换选项,而不是重复上传同一个文件。

Clash、Mihomo、V2Ray和SSR格式怎么选?

手里的格式优先处理方式不建议的做法
Clash或Mihomo订阅URL直接填入订阅地址,保存并更新不必先转换成其他格式
vmess://、ss://、ssr://等单条链接开启在线订阅转换,并按页面填写转换地址和模板不要把单条协议链接当成普通YAML订阅URL
本地YAML配置上传到配置管理,再切换为当前配置不要只根据“.yaml”后缀判断内容一定兼容
V2Ray、SSR等服务商导出格式优先寻找服务商提供的Clash/Mihomo专用订阅没有兼容订阅时,再按OpenClash的转换选项处理

OpenClash官方README列出订阅管理、Subconverter在线转换和多配置文件切换功能;编辑页还提供转换地址、模板、UDP、节点筛选等选项。在线转换时,页面明确提示存在隐私泄露风险,因此敏感订阅应优先使用服务商直接提供的Clash/Mihomo兼容地址,或确认转换服务和配置来源后再使用。

如果你拿到的是某个服务账户中的订阅地址,可参考站内天枢互联订阅链接怎么获取、复制与失效重置,但该页面只解决地址获取和失效处理,OpenClash内的导入仍按本文步骤执行。

本地YAML文件上传后怎么确认能用?

  1. 确认文件内容是配置文件,而不是网页、登录页、纯节点列表或服务商说明文档。
  2. 进入配置管理或配置文件管理,选择上传,把文件加入列表。
  3. 上传完成后检查文件是否出现在列表中,避免把旧文件和新文件混淆。
  4. 点击切换或应用,让新文件成为当前配置;仅上传不代表OpenClash已经使用它。
  5. 启动后查看日志和节点列表。如果出现解析错误,优先检查YAML缩进、冒号后的空格、重复字段以及文件是否完整。

Mihomo官方配置文档以YAML配置语法为基础,具体字段应以Mihomo官方配置语法文档为准。仅凭文件名无法判断兼容性;如果文件来自旧客户端或第三方模板,先用一份明确标注为Clash/Mihomo的配置做对照。

导入成功速查卡:四项都满足才算生效

成功标志在哪里确认如果不满足
节点或代理组数量大于0配置详情、代理页面或节点列表先查订阅返回内容、格式和转换设置
当前配置标记已经切换配置文件列表重新执行切换或应用,不要只重启插件
运行日志没有持续报错运行日志、内核日志或调试日志记录第一条错误原文,一次只修改一个条件
单台测试设备能访问目标地址同一局域网中的电脑或手机继续检查网关、DNS、IPv6和浏览器是否绕过局域网DNS

“订阅更新成功”只说明下载或处理步骤完成,不等于所有局域网设备都已经经过OpenClash。若是旁路由或独立网关拓扑,应先让一台测试设备的网关和DNS指向承担OpenClash功能的路由器,再逐项验证。OpenClash官方界面也提示,连接设备的网关和DNS应为路由器IP;如果不使用IPv6,可在对照测试中暂时关闭IPv6 DHCP,避免IPv6路径绕过预期设置。相关提示见OpenClash官方中文界面文本。

如果只有部分浏览器或部分域名异常,可暂时关闭浏览器的安全DNS做一次对照测试;若关闭后现象变化,再回头检查局域网DNS、IPv6和OpenClash的DNS接管设置。浏览器菜单名称会随版本不同,找不到时以浏览器当前设置页为准。

更新失败、节点为0或切换不生效:按顺序排查

现象先检查什么下一步处理
订阅更新失败或超时地址是否完整,路由器能否访问订阅域名重新复制URL,确认提供方没有要求特定User-Agent或请求头
更新完成但节点为0返回内容是否为空、HTML登录页或格式不匹配确认是Clash/Mihomo订阅;若是单条协议链接,检查订阅转换
配置解析错误下载内容是否为YAML,文件是否完整重新下载或导出;检查缩进、空格和重复字段
配置已更新但仍使用旧节点当前配置标记是否已切换在配置文件列表中重新切换或应用,再查看运行日志
OpenClash运行但设备无流量测试设备的网关、DNS、IPv6是否仍指向其他设备先只测试一台设备,再处理旁路由和全网接管
  1. 先记录日志中的第一条错误,不要只记“失败”。
  2. 只修改一个条件,例如重新复制订阅地址、关闭转换或换一份本地YAML。
  3. 重新执行更新,再检查节点数量和当前配置标记。
  4. 最后才检查DNS、IPv6、旁路由网关和浏览器安全DNS,避免多个变量同时变化。

订阅链接泄露后怎么处理

  1. 回到提供订阅的账户后台,查找重置、撤销、重新生成或更换订阅链接等功能。
  2. 生成新链接后,在OpenClash的配置订阅条目中替换旧地址。
  3. 禁用或删除旧订阅,避免自动更新继续请求旧凭证。
  4. 重新更新配置,确认节点数量、配置时间和当前配置标记正常。
  5. 如果使用在线转换,重新检查转换地址和隐私提示;OpenClash编辑页明确提示在线转换存在隐私泄露风险。

如果提供方没有重置功能,应联系提供方确认旧链接是否已经失效。只删除OpenClash里的条目,不能证明已经撤销服务端凭证。

本文为独立整理,非OpenClash官方,引用页面仅作参考,与本站无合作关系。核验日期:2026年11月19日。

常见问题

OpenClash订阅配置导入后,为什么还要点击切换?

导入或更新只是把配置下载到路由器,切换或应用才会让它成为当前运行配置。完成后检查当前配置标记,再启动OpenClash并查看日志。

只有一条vmess://链接,可以直接粘贴到OpenClash吗?

通常不要把单条vmess://当作普通订阅URL直接下载。应在配置订阅中开启在线订阅转换,并按当前页面填写转换地址和模板;多条链接按官方字段说明逐行填写或使用竖线“|”分隔。

OpenClash更新成功但节点数量是0,先查什么?

先确认订阅返回的不是登录页、空内容或HTML,再确认提供方给的是Clash/Mihomo兼容订阅。如果拿到的是单条协议链接,检查是否开启在线订阅转换,然后查看日志中的下载和解析信息。

本地YAML上传后提示解析错误怎么办?

先确认文件不是网页或说明文档,再检查YAML缩进、冒号后的空格、重复字段和文件是否完整。重新导出一份明确兼容Clash/Mihomo的配置后上传,并在切换前查看日志。

旁路由导入成功但其他设备仍然直连怎么办?

先只测试一台设备,确认它的网关和DNS指向承担OpenClash功能的路由器,再检查IPv6是否绕过了旁路由。导入成功只代表配置已下载,不能直接证明全网设备已经使用该配置。

订阅链接泄露了,只删除OpenClash里的配置够吗?

不够。应先在提供方账户后台重置或重新生成链接,再在OpenClash中替换旧地址、禁用旧订阅并重新更新。如果没有重置功能,应联系提供方确认旧链接是否失效。

相关阅读

参考资料

  1. OpenClash官方README
  2. OpenClash配置订阅编辑源码
  3. Mihomo官方配置语法文档