AyuCloud OpenWrt 配置:从订阅核验到连接验证
简答:AyuCloud OpenWrt 配置的关键不是直接粘贴订阅,而是先确认 OpenWrt 版本、CPU 架构、包管理器和订阅格式。OpenWrt 24.10 及更早版本通常使用 opkg 与 IPK,25.12 及更新版本使用 apk;确认后可选择 OpenClash,或在满足版本条件时使用 Mihomo 原生方案。
定义:AyuCloud OpenWrt 配置,是把账户中的可用订阅或配置文件导入 OpenWrt 上的代理客户端,再通过路由、DNS 和运行模式让指定局域网设备使用该连接。
结论速查:先试这一步,再决定安装路线
如果你现在正卡在“节点为空、订阅导入失败或安装包装不上”,先通过 SSH 执行下面的预检命令,不要先下载随机安装包:
ubus call system board
cat /etc/openwrt_release
uname -m
command -v apk || true
command -v opkg || true
free -h
df -h记录输出中的固件版本、目标架构、可用内存和剩余空间。OpenWrt 官方资料显示,25.12 及更新版本使用 apk,24.10 及更早版本使用 opkg;LuCI 的软件包入口通常位于“系统 → 软件包”。OpenWrt 软件包安装说明
| 检查结果 | 优先路线 | 关键动作 |
|---|---|---|
| OpenWrt 24.10 或更早、系统有 opkg | OpenClash IPK | 匹配架构和防火墙后端,使用 opkg 安装依赖与插件 |
| OpenWrt 25.12 或更新、系统有 apk | OpenClash APK | 匹配架构,使用 apk 安装依赖和 APK |
| OpenWrt 25.12.2 及以上,愿意使用命令行 | Mihomo 原生 APK | 选择对应架构 APK,确认 TUN 与自动路由配置 |
| 订阅格式无法确认 | 先回到账户或帮助中心核验 | 不要把 sing-box、Clash、Base64 文本互相当作同一种配置 |
AyuCloud 帮助中心目前展示了“在路由器上配置”分类,但该目录页没有展开具体 OpenWrt 菜单、安装包或订阅字段,因此账户入口、订阅格式和可用转换方式仍应以当前登录页面为准。AyuCloud 帮助中心目录
前置条件:安装前必须拿到的 6 项信息
- 固件版本:从“状态 → 概览”或
cat /etc/openwrt_release获取,不要只凭路由器型号判断。 - CPU 架构:执行
ubus call system board和uname -m;安装包文件名中的架构必须与设备匹配。 - 包管理器:有
opkg就按 IPK 路线,有apk就按 APK 路线,不要交叉安装。 - 防火墙后端:确认设备使用 Firewall3/iptables 还是 Firewall4/nftables。OpenClash 项目分别列出了 iptables 与 nftables 的依赖,不能把两套依赖盲目混装。OpenClash 项目说明与依赖表
- 订阅类型:在账户页面或帮助中心确认是 Clash/Clash Meta、sing-box、WireGuard,还是其他格式。未知格式写给客服的询问模板可以是:“我的 OpenWrt 使用 OpenClash/Mihomo,需要哪一种订阅格式?是否支持直接复制 URL 导入?”
- 网络角色:确认 OpenWrt 是主路由还是旁路由。主路由可负责 DHCP、网关和 DNS;旁路由通常只负责代理服务,并需要避免与主路由同时开启 DHCP。
订阅链接等同于账户凭据,不要粘贴到公开工单、截图、论坛或命令历史中。本文不把当前站点或其他页面称为品牌官方下载站,安装包应以项目发布页和当前固件兼容性为准。
最短流程一:用 OpenClash 完成安装、导入与启动
1. 先安装匹配的插件包
OpenClash 项目说明其 LuCI 插件用于管理 Mihomo 内核,并提供 IPK 与 APK 两类发布资产。项目 README 给出的网页路径是“系统 → 软件包”上传安装,安装后刷新或重新登录,再从“服务 → OpenClash”进入。OpenClash README
通过 LuCI 安装时,先进入“系统 → 软件包 → 更新列表”,搜索可用依赖;外部发布的 IPK/APK 则使用“上传并安装”入口。上传前先核对文件后缀、架构、固件分支和防火墙后端。若页面没有上传入口或安装提示依赖缺失,停止继续启动,改用 SSH 查看具体错误。
2. 通过 SSH 安装依赖:按系统分支执行
下面只展示项目 README 中列出的依赖方向;实际可用包名会随固件分支和仓库变化,执行前先确认命令是否能找到对应包。
OpenWrt 24.10 及更早的 opkg/IPK 示例:
opkg update
opkg install bash curl ca-bundle ruby ruby-yaml dnsmasq-full ip-full unzip kmod-tun kmod-inet-diag luci luci-base luci-compat如果使用 iptables 后端,再核对 iptables、ipset、iptables-mod-tproxy 和 iptables-mod-extra;如果使用 nftables/Firewall4,则核对 kmod-nft-tproxy。不要因为命令能输入就认为所有依赖已经满足。
OpenWrt 25.12 及更新的 apk/APK 示例:
apk update
apk add bash curl ca-bundle ruby ruby-yaml dnsmasq-full ip-full unzip kmod-tun kmod-inet-diag luci luci-base luci-compatOpenWrt 官方文档说明,25.12 使用 apk,外部或未签名 APK 可使用 --allow-untrusted;这不代表文件来源可信,仍要先核对发布页和架构。OpenWrt apk 包管理器说明
3. 进入 OpenClash 后按这个顺序设置
- 内核:进入“服务 → OpenClash”后,先查看内核管理或内核选择页面,选择与当前插件支持范围一致的 Mihomo/Meta 内核。首次使用通常需要下载内核;若下载失败,先检查路由器自身 DNS、时间和出站网络。
- 订阅管理:进入订阅管理页面,新增订阅 URL,粘贴个人账户中复制的链接,保存后执行更新。不要手动修改订阅 URL 中的参数,也不要把链接写入公开配置。
- 配置文件:更新成功后,确认配置文件列表出现新文件,选择它作为当前配置。若订阅返回 HTML、登录页或空内容,不要继续启动,应回到账户页面重新复制。
- 运行模式:先用规则模式完成验证。根据界面支持情况选择 Redir-Host、Fake-IP、混合模式或 TUN;OpenClash README 明确列出了这些模式,但实际字段名称会随版本变化。OpenClash 功能与模式说明
- DNS:先保持单一 DNS 管理链路,避免同时运行多个 DNS 重定向服务。若使用 Fake-IP 或 TUN,确认 DNS 劫持、局域网 DNS 转发和 IPv6 处理方式一致;配置后先测试普通域名和内网设备。
- 透明代理开关:完成配置文件、内核、运行模式和 DNS 检查后,再打开启动开关。不要在多个插件中同时启用透明代理,以免路由表和 DNS 规则互相覆盖。
最短流程二:OpenWrt 25.12.2+ 使用 Mihomo 原生方案
Mihomo-OpenWrt 项目 README 将 OpenWrt 25.12.2 及以上列为前提,并提供 APK 安装示例;其说明的自动配置方向包括 auto-route、auto-redirect、DNS 劫持和自动识别网卡。该路线更适合熟悉 SSH、YAML 和网络路由的用户,不适合只想通过图形界面完成配置的人。Mihomo-OpenWrt README
安装步骤
- 在项目 Releases 页面选择与
uname -m、OpenWrt 版本和设备架构一致的 APK。 - 使用 SCP 将文件传到路由器的临时目录,例如
/tmp/。文件名以下方示例为占位,不要照抄版本号或架构。 - 执行安装命令:
cd /tmp
apk add ./mihomo-对应版本_对应架构.apk --allow-untrusted
apk list -I | grep -E 'mihomo|kmod-tun|kmod-inet-diag'项目说明 APK 包可能自动处理相应内核模块依赖,但如果空间不足、内核版本不匹配或仓库不可用,安装会失败。不要用 apk upgrade 盲目升级整套系统;OpenWrt 文档明确提醒,批量升级可能造成包冲突,升级固件前应先备份。OpenWrt apk 注意事项
配置透明代理前的最小检查
ls -l /dev/net/tun
ip route
ip rule
ip -6 route配置文件中的 TUN 示例字段应以当前内核支持为准,项目 README 展示的核心方向是:
tun:
enable: true
stack: mixed
dns-hijack:
- "any:53"
auto-route: true
auto-redirect: true
auto-detect-interface: true这段配置不是适用于所有网络拓扑的完整配置文件。导入前必须补齐 DNS、代理组、规则和日志设置,并确认没有与 OpenClash、PassWall 或其他透明代理服务同时运行。
订阅格式怎么选:不要把不同配置直接混用
| 账户中看到的内容 | 优先选择 | 不能直接做的事 |
|---|---|---|
| Clash 或 Clash Meta 配置 URL/YAML | OpenClash 或兼容 Mihomo 的客户端 | 不要当作 sing-box JSON 直接导入 |
| sing-box JSON 配置或订阅 | 支持 sing-box 的客户端或原生配置方式 | 不要只改文件后缀冒充 Clash YAML |
| WireGuard 配置 | WireGuard 客户端或 OpenWrt WireGuard 网络接口 | 不要粘贴到 OpenClash 订阅框 |
| 只有一段编码文本、返回空白或 HTML | 先回到账户页面核验 | 不要公开解码、转发或继续导入 |
OpenClash 项目列出多订阅管理、在线转换和多种协议兼容能力,但这不等于任意账户订阅都能直接导入;AyuCloud 当前帮助中心目录仅能确认存在路由器配置分类,具体格式需登录当前账户核实。OpenClash 项目说明 AyuCloud 帮助中心
主路由与旁路由:网关、DHCP、DNS 如何避免冲突
- 主路由:让 OpenWrt 负责 LAN 网关、DHCP 和 DNS,先只让一个服务分配地址。透明代理启动后,用一台有线设备验证,再逐步加入无线设备。
- 旁路由:保留主路由的 DHCP,给 OpenWrt 设置固定 LAN 地址;终端需要把网关或 DNS 指向旁路由时,必须确认主路由不会覆盖这些设置。
- 按设备分流:先用一台测试设备的 IP 或 MAC 做白名单/绕过规则,不要一开始把所有设备都纳入透明代理。
- IPv6:如果 IPv4 测试正常但部分网站或应用仍直连,检查 IPv6 默认路由、DNS 和代理客户端的 IPv6 处理方式。无法确认客户端是否接管 IPv6 时,可先在测试网络中关闭 IPv6 做对照,但不要把临时关闭当成最终方案。
每次只改一个变量:先确认网关,再确认 DNS,最后确认运行模式。这样才能判断是订阅、路由表还是 DNS 导致问题。
验证闭环:什么结果才算配置成功
- 订阅层:配置文件更新时间变化,节点或代理组出现,日志没有持续的解析错误。
- 内核层:内核状态显示运行,TUN 模式下确认
/dev/net/tun存在,规则模式下确认防火墙规则能够加载。 - 路由层:测试设备获得正确的局域网地址、网关和 DNS;旁路由模式下确认流量确实经过旁路由。
- 解析层:分别测试普通域名、内网设备名和需要特殊解析的域名,避免只看一个网站。
- 连接层:使用同一台设备分别测试网页、办公平台、视频会议或文件传输,记录延迟、丢包和是否出现间歇性断连。本文没有实测测速数据,不把一次访问成功写成性能保证。
- 回退层:关闭 OpenClash/Mihomo 服务后,测试设备应恢复普通网络;若无法恢复,检查残留 DNS 劫持、默认路由和防火墙规则。
建议保存一份配置前后的对照记录:设备 IP、网关、DNS、IPv4/IPv6 状态、配置文件名称、启动时间和日志中的第一条错误。
分层排错:按现象定位,不要反复重装
| 现象 | 优先检查 | 回退动作 |
|---|---|---|
| 节点为空或订阅更新失败 | 订阅是否过期、返回内容是否为 HTML、路由器时间和 DNS 是否正确 | 删除该订阅条目,重新从账户页面复制,不公开粘贴链接 |
| 安装包无法安装 | opkg/apk 是否匹配、架构、固件分支、磁盘空间、依赖错误 | 删除错误包,恢复备份,不要强制覆盖不匹配的系统包 |
| 内核启动失败 | 内核文件架构、TUN 模块、权限、日志首个错误 | 先切回规则模式,关闭 TUN 和其他透明代理服务 |
| 路由器能用但部分设备直连 | 设备网关、DNS、IPv6、旁路由 DHCP 和绕过列表 | 只保留一台测试设备,临时取消该设备绕过规则 |
| 所有设备打不开网页 | DNS 劫持、默认路由、Firewall4/iptables 规则冲突 | 停止代理服务,恢复普通 DNS 和网关,再逐项启用 |
| 配置后路由器变卡 | 内存、存储、日志规模、规则数量和是否同时运行多个客户端 | 停用一个客户端,删除无用配置,必要时恢复备份 |
边界与延伸:哪些信息目前仍需核实
截至 2026-11-01,本文可以核实 OpenWrt 24.10 与 25.12 的包管理器分支、OpenClash 的安装方式与功能范围,以及 Mihomo-OpenWrt 项目给出的 25.12.2+ 前提;但以下内容不能仅凭公开目录页确定:你的账户实际提供哪一种订阅格式、当前账户是否有专用路由器配置入口、某个安装包是否适配你的设备、某个节点是否可用,以及配置后的延迟、丢包和吞吐表现。
因此,最稳妥的顺序是:备份 OpenWrt 配置 → 记录固件和架构 → 登录账户复制订阅 → 判断格式 → 只选一条客户端路线 → 单设备验证 → 再扩大到局域网。若失败,先关闭透明代理并恢复普通 DNS,再根据日志定位。
如果你需要处理的是跨网络办公中的 DNS、丢包、MTU 或连接不稳定问题,建议另行记录时间、设备、出口网络、IPv4/IPv6、域名解析结果和路由路径,不要只用“能不能打开网页”判断线路质量。
常见问题
AyuCloud OpenWrt 配置应该选 OpenClash 还是 Mihomo 原生?
如果希望通过 LuCI 管理订阅、内核和运行模式,优先考虑 OpenClash;如果使用 OpenWrt 25.12.2 及以上并熟悉 SSH、YAML、TUN 和路由规则,可评估 Mihomo 原生方案。最终仍要以订阅格式和设备架构是否匹配为准。
OpenWrt 25.12 还能安装 IPK 吗?
不要把 25.12 的 apk 环境与旧版 IPK 安装流程混用。OpenWrt 官方资料显示,25.12 使用 apk;OpenClash 项目也分别提供 IPK 与 APK 资产,应按固件分支选择对应文件。
订阅导入 OpenClash 后没有节点怎么办?
先确认订阅 URL 没有复制错误、账户仍有效,并检查返回内容是否为配置文件而不是登录页或 HTML。然后检查路由器时间、DNS 和出站网络;不要直接把 sing-box 或 WireGuard 配置粘贴到 Clash 订阅框。
OpenClash 启动后部分手机或电脑仍然直连,怎么排查?
先查看该设备的网关和 DNS 是否指向正确的 OpenWrt,再检查 IPv6 是否绕过、设备是否在绕过列表,以及旁路由是否错误开启 DHCP。建议只保留一台测试设备,逐项恢复设置。
配置失败后如何恢复普通网络?
先在 OpenClash 或 Mihomo 页面停止服务,关闭透明代理或 TUN,再恢复原来的网关和 DNS。若仍无法联网,检查默认路由、DNS 劫持和防火墙规则;安装前生成的 LuCI 配置备份可用于回滚。