OpenClash订阅配置怎么导入?链接、YAML上传与节点为0排查
简答:先看你手里的是订阅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导入步骤:保存、更新、切换、启动
- 复制完整订阅地址:从提供方账户页面复制完整URL,不要把网站首页、登录页地址或说明文档地址当成订阅地址。订阅URL通常包含个人凭证,不要发到公开群聊、截图或公开仓库。
- 进入配置订阅:登录OpenWrt后台,打开“服务→OpenClash”,寻找“配置订阅”或相近名称,点击添加。
- 填写配置别名和订阅地址:配置别名只用于区分多个配置;订阅地址粘贴完整URL。User-Agent或自定义请求头只有在提供方明确要求时再填写,不要为了“兼容”随意修改。
- 选择格式:如果拿到的是Clash或Mihomo兼容订阅,优先直接下载;如果拿到的是vmess、ss、ssr等单条协议链接,打开在线订阅转换,再按页面填写转换地址和模板。
- 保存并更新:先保存订阅条目,再点击“更新配置”“下载配置”或列表中的更新按钮。OpenClash界面文本将“保存配置”“下载配置”和“更新配置”列为不同操作,因此保存条目不等于已经下载了新配置,可参考OpenClash官方中文界面文本。
- 切换当前配置:进入配置管理或配置文件列表,找到刚更新的文件,点击切换、应用或设为当前配置。确认当前配置标记已经移动到新文件。
- 启动并测试:启动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文件上传后怎么确认能用?
- 确认文件内容是配置文件,而不是网页、登录页、纯节点列表或服务商说明文档。
- 进入配置管理或配置文件管理,选择上传,把文件加入列表。
- 上传完成后检查文件是否出现在列表中,避免把旧文件和新文件混淆。
- 点击切换或应用,让新文件成为当前配置;仅上传不代表OpenClash已经使用它。
- 启动后查看日志和节点列表。如果出现解析错误,优先检查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是否仍指向其他设备 | 先只测试一台设备,再处理旁路由和全网接管 |
- 先记录日志中的第一条错误,不要只记“失败”。
- 只修改一个条件,例如重新复制订阅地址、关闭转换或换一份本地YAML。
- 重新执行更新,再检查节点数量和当前配置标记。
- 最后才检查DNS、IPv6、旁路由网关和浏览器安全DNS,避免多个变量同时变化。
订阅链接泄露后怎么处理
- 回到提供订阅的账户后台,查找重置、撤销、重新生成或更换订阅链接等功能。
- 生成新链接后,在OpenClash的配置订阅条目中替换旧地址。
- 禁用或删除旧订阅,避免自动更新继续请求旧凭证。
- 重新更新配置,确认节点数量、配置时间和当前配置标记正常。
- 如果使用在线转换,重新检查转换地址和隐私提示;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中替换旧地址、禁用旧订阅并重新更新。如果没有重置功能,应联系提供方确认旧链接是否失效。