AyuCLouD-Services返回首页

AyuCloud OpenWrt 配置:从订阅核验到连接验证

更新于 2026-11-01 · ayu-ssr.buzz

简答: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 或更早、系统有 opkgOpenClash IPK匹配架构和防火墙后端,使用 opkg 安装依赖与插件
OpenWrt 25.12 或更新、系统有 apkOpenClash APK匹配架构,使用 apk 安装依赖和 APK
OpenWrt 25.12.2 及以上,愿意使用命令行Mihomo 原生 APK选择对应架构 APK,确认 TUN 与自动路由配置
订阅格式无法确认先回到账户或帮助中心核验不要把 sing-box、Clash、Base64 文本互相当作同一种配置

AyuCloud 帮助中心目前展示了“在路由器上配置”分类,但该目录页没有展开具体 OpenWrt 菜单、安装包或订阅字段,因此账户入口、订阅格式和可用转换方式仍应以当前登录页面为准。AyuCloud 帮助中心目录

前置条件:安装前必须拿到的 6 项信息

  1. 固件版本:从“状态 → 概览”或 cat /etc/openwrt_release 获取,不要只凭路由器型号判断。
  2. CPU 架构:执行 ubus call system board 和 uname -m;安装包文件名中的架构必须与设备匹配。
  3. 包管理器:有 opkg 就按 IPK 路线,有 apk 就按 APK 路线,不要交叉安装。
  4. 防火墙后端:确认设备使用 Firewall3/iptables 还是 Firewall4/nftables。OpenClash 项目分别列出了 iptables 与 nftables 的依赖,不能把两套依赖盲目混装。OpenClash 项目说明与依赖表
  5. 订阅类型:在账户页面或帮助中心确认是 Clash/Clash Meta、sing-box、WireGuard,还是其他格式。未知格式写给客服的询问模板可以是:“我的 OpenWrt 使用 OpenClash/Mihomo,需要哪一种订阅格式?是否支持直接复制 URL 导入?”
  6. 网络角色:确认 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-compat

OpenWrt 官方文档说明,25.12 使用 apk,外部或未签名 APK 可使用 --allow-untrusted;这不代表文件来源可信,仍要先核对发布页和架构。OpenWrt apk 包管理器说明

3. 进入 OpenClash 后按这个顺序设置

  1. 内核:进入“服务 → OpenClash”后,先查看内核管理或内核选择页面,选择与当前插件支持范围一致的 Mihomo/Meta 内核。首次使用通常需要下载内核;若下载失败,先检查路由器自身 DNS、时间和出站网络。
  2. 订阅管理:进入订阅管理页面,新增订阅 URL,粘贴个人账户中复制的链接,保存后执行更新。不要手动修改订阅 URL 中的参数,也不要把链接写入公开配置。
  3. 配置文件:更新成功后,确认配置文件列表出现新文件,选择它作为当前配置。若订阅返回 HTML、登录页或空内容,不要继续启动,应回到账户页面重新复制。
  4. 运行模式:先用规则模式完成验证。根据界面支持情况选择 Redir-Host、Fake-IP、混合模式或 TUN;OpenClash README 明确列出了这些模式,但实际字段名称会随版本变化。OpenClash 功能与模式说明
  5. DNS:先保持单一 DNS 管理链路,避免同时运行多个 DNS 重定向服务。若使用 Fake-IP 或 TUN,确认 DNS 劫持、局域网 DNS 转发和 IPv6 处理方式一致;配置后先测试普通域名和内网设备。
  6. 透明代理开关:完成配置文件、内核、运行模式和 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

安装步骤

  1. 在项目 Releases 页面选择与 uname -m、OpenWrt 版本和设备架构一致的 APK。
  2. 使用 SCP 将文件传到路由器的临时目录,例如 /tmp/。文件名以下方示例为占位,不要照抄版本号或架构。
  3. 执行安装命令:
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/YAMLOpenClash 或兼容 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 导致问题。

验证闭环:什么结果才算配置成功

  1. 订阅层:配置文件更新时间变化,节点或代理组出现,日志没有持续的解析错误。
  2. 内核层:内核状态显示运行,TUN 模式下确认 /dev/net/tun 存在,规则模式下确认防火墙规则能够加载。
  3. 路由层:测试设备获得正确的局域网地址、网关和 DNS;旁路由模式下确认流量确实经过旁路由。
  4. 解析层:分别测试普通域名、内网设备名和需要特殊解析的域名,避免只看一个网站。
  5. 连接层:使用同一台设备分别测试网页、办公平台、视频会议或文件传输,记录延迟、丢包和是否出现间歇性断连。本文没有实测测速数据,不把一次访问成功写成性能保证。
  6. 回退层:关闭 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 配置备份可用于回滚。

相关阅读

参考资料

  1. AyuCLoud-Documents 帮助中心目录
  2. OpenWrt:How do I install packages?
  3. OpenWrt:apk package manager
  4. OpenClash 官方 GitHub 项目与 README
  5. Mihomo-OpenWrt README