Linux 与 OpenWrt 软路由客户端全指南
直接结论:Linux 桌面环境直接用 Clash Verge Rev / FlClash / v2rayN 即可;无桌面服务器/NAS 推荐部署 v2rayA;而在 OpenWrt / ImmortalWrt 软路由 环境下,安装任何透明代理插件前都必须先核对 CPU 架构、固件版本号与防火墙后端(fw3 vs fw4)——尤其是 Nikki 明确要求 OpenWrt 24.10 及以上版本,切勿跨版本强行刷入。
OpenWrt / 软路由客户端 — 注意事项
面向路由器网关透明代理:OpenClash、PassWall2、Nikki 与 HomeProxy。
- 软路由安装插件前务必确认 OpenWrt 版本、CPU 架构(x86_64 / aarch64 / mips)、包管理器(opkg vs apk)以及防火墙后端(fw3 iptables vs fw4 nftables)。
- 例如 Nikki 明确要求 OpenWrt 24.10 及以上版本环境;切勿在不同架构或旧固件中强行跨版本刷入。
| 客户端名称 | 内核 / 架构 | 授权方式 | 核心定位与特点 | 官方获取渠道 | 教程 |
|---|---|---|---|---|---|
| v2rayA | Xray / v2ray-core | 开源免费 | 提供浏览器 Web GUI 界面,专门适用于无桌面 Linux 服务器、NAS 及旁路由透明代理场景。 | GitHub (v2rayA/v2rayA) ↗ | 查看教程 |
| OpenClash | Mihomo (Clash.Meta) | 开源免费 | OpenWrt 生态应用最广的 Clash/Mihomo 透明代理插件,支持 Fake-IP、Redir-Host、规则自动更新与访问控制。 | GitHub (vernesong/OpenClash) ↗ | 查看教程 |
| PassWall2 | Xray / sing-box | 开源免费 | 针对 OpenWrt 优化的轻量分流方案,全面转向 Xray/sing-box 规则分流,适合低内存路由器设备。 | GitHub (xiaorouji/openwrt-passwall2) ↗ | 查看教程 |
| Nikki 明确要求 OpenWrt 24.10 及以上版本,旧版本固件不兼容。 | Mihomo | 开源免费 | 基于 OpenWrt 24.10+ nftables/TPROXY 的现代化 Mihomo 透明代理管理插件,配置简洁且原生适配新固件。 | GitHub (nikkinikki-org/OpenWrt-nikki) ↗ | 查看教程 |
| HomeProxy | sing-box | 开源免费 | 由 ImmortalWrt 维护的纯 sing-box 原生透明代理 LuCI 插件,架构现代化且内存控制优秀。 | GitHub (immortalwrt/homeproxy) ↗ | 查看教程 |
一、部署前必做的 3 条 SSH 环境检查命令
登录软路由或 Linux 主机 SSH 后,先运行以下命令查清硬件与固件底座:
bash
# 1. 查看 OpenWrt 发行版本与目标平台架构(例如 x86/64 或 mediatek/filogic)
cat /etc/openwrt_release
# 2. 查看内核与 CPU 指令集(确认是 x86_64 还是 aarch64)
uname -m
# 3. 确认当前包管理器(旧版为 opkg,24.10+ 部分分支过渡到 apk)及剩余可用空间/内存
df -h && free -m二、OpenWrt 四大主流代理插件技术选型矩阵
| 插件名称 | 底层代理核心 | 防火墙与固件门槛 | 内存需求建议 | 适用人群与优缺点 |
|---|---|---|---|---|
| OpenClash | Mihomo (Clash.Meta) | 兼容 fw3 (iptables) 与 fw4 (nftables),生态最广 | 建议 ≥ 512MB RAM | 功能最全、面板直观、几乎支持所有机场 Clash 订阅;但体积较重且首次配置项较多 |
| Nikki | Mihomo | 明确要求 OpenWrt 24.10+(原生 nftables + TPROXY) | 建议 ≥ 256MB RAM | 架构干净现代、直接复用新版防火墙、维护规范;不兼容 23.05 及更早旧固件 |
| HomeProxy | sing-box | 原生适配 ImmortalWrt / OpenWrt 22.03+ fw4 | 128MB–256MB 均可流畅 | 极低内存占用、原生 nftables 转发高效;需机场支持 sing-box 配置或手动填入节点/订阅模板 |
| PassWall2 | Xray / sing-box | 全面转向 rules 分流,支持多架构 | 建议 ≥ 256MB RAM | 习惯传统节点分组+分流管理的老玩家适用,多协议灵活 |
三、无桌面 Linux / NAS 方案:v2rayA
如果您的设备上跑的是标准 Debian/Ubuntu Server、PVE 宿主机或群晖/飞牛等 NAS 系统,无需安装图形桌面即可直接部署 v2rayA:
- 提供完整的浏览器 Web 控制台(默认监听
2017端口); - 支持一键导入通用订阅与 Clash/V2Ray 订阅;
- 可在 Web 页面一键启用透明代理与分流规则,非常适合在局域网内充当轻量化旁路网关或为容器环境加速。
四、软路由透明代理排错延伸
遇到安装后局域网设备断网、DNS 环路或手机绕过路由器走运营商 IPv6 的故障,请参阅:OpenWrt 软路由常见断网与防火墙冲突排查。