Skip to content

About

OpenClash one-click install/update/uninstall/repair scripts for OpenWrt, iStoreOS and ImmortalWrt

Topics

Resources

Stars

461 stars

Watchers

3 watching

Forks

Repository files navigation

OpenClash Auto Installer

Release License Workflow

适用于 OpenWrt / iStoreOS / ImmortalWrt 的代理插件安装、更新、卸载与检查脚本集合。

已集成:

  • OpenClash
  • PassWall
  • PassWall2
  • Nikki
  • SmartDNS
  • MosDNS
  • daed

一键使用

推荐直接使用菜单模式,安装、更新、检查版本和卸载都在菜单里:

wget -qO /usr/bin/openclash-menu https://raw.githubusercontent.com/slobys/openclash-auto-installer/main/menu.sh && chmod +x /usr/bin/openclash-menu && openclash-menu

国内访问 GitHub 较慢时,可使用 Gitee 入口:

wget -qO /usr/bin/openclash-menu https://gitee.com/naiyou88/openclash-auto-installer/raw/main/menu.sh && chmod +x /usr/bin/openclash-menu && OPENCLASH_AUTO_BASE_URL=https://gitee.com/naiyou88/openclash-auto-installer/raw/main openclash-menu

如果系统已安装 curl,也可以使用:

curl -fsSL https://raw.githubusercontent.com/slobys/openclash-auto-installer/main/menu.sh -o /usr/bin/openclash-menu && chmod +x /usr/bin/openclash-menu && openclash-menu

完整项目方式:

git clone https://github.com/slobys/openclash-auto-installer.git && cd openclash-auto-installer && sh menu.sh

菜单结构:

1. 检查插件更新
2. 安装插件
3. 卸载插件
0. 退出

支持范围

截至 2026-10-07,验证范围已扩展至全部官方 CPU/ABI 目录,而不只 x86:

系统 版本 覆盖范围
OpenWrt 25.12.5 / APK 35 个 CPU/ABI
OpenWrt 24.10 分支 24.10.8 / OPKG 36 个 CPU/ABI
iStoreOS 25.12.5-2026092410;seed-ac1 为 2026091716 x86_64、armsr、r4s、rpi4、rpi5、seed-ac1 六个原始镜像

共 77 个固件/ABI 环境、462 个六插件验证项。覆盖 ARM32/64、x86/64、MIPS32/64 大小端、PowerPC、RISC-V、LoongArch;全矩阵核查不等于全部兼容。上游缺包、核心不兼容及模拟器阻塞均单列,不计通过。24.10 Octeon 实装仍受模拟器阻塞,需要对应设备补验。

daed 单列验证:通用上游全部 8 种核心资产检查,以及 x86_64 / ARM64 iStoreOS 官方内核虚拟机中的启动、面板与升级。其余架构没有据此宣称 eBPF 服务可用。

完整逐架构结果、固件校验值及限制见 全架构验证报告 和 机器可读矩阵。这是代表性固件与用户态 ABI 验证,不是每款实体路由器实测;旧版和其他第三方固件需另验。


功能说明

插件 支持内容 说明
OpenClash 安装 / 更新 / 核心安装 / 卸载 / 更新检测 自动识别 Meta / Smart Meta 内核
PassWall 安装 / 更新 / 卸载 / 更新检测 支持 opkg;25.12 APK 使用上游签名源
PassWall2 安装 / 更新 / 卸载 / 更新检测 支持 opkg;25.12 APK 使用上游签名源
Nikki 安装 / 更新 / 卸载 / 更新检测 需要 firewall4/nftables
SmartDNS 安装 / 更新 / 卸载 / 更新检测 使用官方 GitHub Release 包
MosDNS 安装 / 更新 / 卸载 / 更新检测 使用 sbwml/luci-app-mosdns GitHub Release 包
daed 安装 / 更新 / LuCI 管理 / 卸载 / 更新检测 使用上游预编译核心,并集成 luci-app-daed,面板端口为 2023

OpenWrt 25.12+ / apk 说明

OpenWrt 25.12+ 使用 apk 包管理器,本项目已同步适配:

  • 安装 / 更新
  • 检查更新
  • 卸载

PassWall / PassWall2 在 25.12 APK 环境优先使用上游签名源,校验公钥摘要并保持包签名验证;先下载事务需要的软件包再安装。签名源与 GitHub Release 不一致时会明确提示,不强行切换到未验证签名的包。实际可用性仍取决于上游是否提供对应架构和依赖。


重要说明

  • 推荐 OpenWrt / iStoreOS / ImmortalWrt 24.x 及以上,整体更稳定。
  • 低版本、魔改固件、精简固件可能遇到依赖或软件源不兼容。
  • 同一 CPU 家族的位数、大小端、指令集及固件内核配置仍会影响兼容性,以逐项验证矩阵为准。
  • Nikki 不支持 iptables 防火墙栈,需要 firewall4/nftables;官方源仅支持 24.10、25.12 和纯 SNAPSHOT,不支持 23.05-SNAPSHOT。
  • OpenClash 当前 386 核心要求 SSE2;ARMv4、ARM 大端和 PowerPC 无匹配核心。核心运行检查失败时保留原 OpenClash / 通用 daed 核心。
  • SmartDNS 上游 ARM 包最低 ARMv5T;MIPS64 使用对应大小端的 32 位包,还要求固件内核支持 O32。安装后无法执行会报错,不再显示完成。
  • SmartDNS 只安装程序和 LuCI 界面,不自动接管或改写 DNS 配置。
  • MosDNS 只安装程序、LuCI 界面和上游 Release 包内的基础数据包,不自动接管或改写 DNS 配置。
  • daed 全新安装后,LuCI 中的“启用”选项默认不勾选,请在“服务 → DAED”中手动启用;脚本不会在安装结束时额外停止或禁用服务。启动后可查看日志和打开仪表板,也可直接访问 http://路由器IP:2023。
  • LuCI DAED 界面使用 QiuSimons/luci-app-daed 的 OpenWrt 24.10 ipk 或 25.12 apk;25.12 会完整使用匹配架构的上游 daed APK,避免通用静态核心覆盖 OpenWrt 专用核心与服务脚本。旧版或特殊固件若界面包不兼容,脚本仍会保留可独立使用的 daed 后端。
  • daed 依赖 eBPF/BTF,要求 Linux 5.17+ 且内核开启相关能力;许多裁剪过的 OpenWrt 固件无法运行。
  • OpenWrt 25.12 的 apk 与 LuCI 界面包已适配。官方原版固件缺少 BTF 时,脚本会从上游文档推荐的第三方软件源 opkg.cooluc.com,按当前 OpenWrt 大版本和 DISTRIB_ARCH 查找外置 vmlinux-btf。
  • 完整内核版本一致的 vmlinux-btf 会自动安装;只有主次版本一致时,脚本会显示风险并要求确认,不会静默安装。外置 BTF 安装后仍会检查其他 eBPF 能力。
  • 更新已启用的 daed 后,脚本会自动重启并确认服务能持续运行;若检测到旧核心的 local_tcp_sockops / bpf_get_current_task 不兼容错误,会取消启用并停止有限重试,避免持续崩溃刷日志。
  • OpenWrt 25.12 更新 daed 时会同时移除旧核心与 LuCI 依赖包后重新安装,并确认旧核心确实已从 apk 中移除,避免同版本包未被覆盖。
  • daed 安装后约占用 85MB,安装过程还要求 /tmp 至少有 130MB 可用空间。
  • daed 上游发布 arm64、MIPS32/64、RISC-V 64 和 x86 资产,但当前通用 MIPS 包依赖 glibc 加载器,不能视为原版 musl OpenWrt 可用;ARM32、PowerPC、LoongArch 无对应通用资产。
  • 卸载默认走安全卸载,只移除主包和对应配置,不做激进清理。

文件说明

文件 作用
menu.sh 统一菜单入口
install.sh OpenClash 安装 / 更新
update.sh OpenClash 快速更新入口
repair.sh OpenClash 基础修复
passwall.sh PassWall 安装 / 更新
passwall2.sh PassWall2 安装 / 更新
nikki.sh Nikki 安装 / 更新
smartdns.sh SmartDNS 安装 / 更新
mosdns.sh MosDNS 安装 / 更新
daed.sh daed 安装 / 更新
check-updates.sh 检查插件更新
uninstall.sh 安全卸载插件
auto-download-pro.sh 旧入口兼容包装器,已转交给 passwall.sh
test-auto-download.sh 旧测试入口兼容包装器,已转交给 passwall.sh

致谢

About

OpenClash one-click install/update/uninstall/repair scripts for OpenWrt, iStoreOS and ImmortalWrt

Topics

Resources

Stars

461 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors

Languages