MIT License

项目介绍

slobys/openclash-auto-installer 是一个托管在 GitHub 上的开源项目,主要使用 Shell 编写,采用 MIT License 许可证,目前获得 461 个 Star、193 次 Fork。

仓库全名
slobys/openclash-auto-installer
开源许可证
MIT License
Star 数
461
Fork 数
193
未关闭 Issue
31

README 摘要

OpenClash Auto Installer 适用于 OpenWrt / iStoreOS / ImmortalWrt 的代理插件安装、更新、卸载与检查脚本集合。 已集成: OpenClash PassWall PassWall2 Nikki SmartDNS MosDNS daed 一键使用 推荐直接使用菜单模式,安装、更新、检查版本和卸载都在菜单里: 国内访问 GitHub 较慢时,可使用 Gitee 入口: 如果系统已安装 curl,也可以使用: 完整项目方式: 菜单结构: 支持范围 截至 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 |…

完整内容见 GitHub 原始 README 或本页 。

常见问题

openclash-auto-installer 用什么语言开发?

主要使用 Shell 编写,采用 MIT License 许可证,目前有 461 个 Star。

openclash-auto-installer 可以免费商用吗?

仓库采用 MIT License 许可证,可免费使用与修改,商业使用请遵守许可证条款(例如保留版权声明与许可声明)。

如何获取 openclash-auto-installer 的源码?

可以直接克隆仓库:git clone https://github.com/slobys/openclash-auto-installer.git,默认分支为 main;安装与运行步骤见仓库 README。

openclash-auto-installer 最近还在维护吗?

仓库最近一次更新为 2 周前,当前有 31 个未关闭 Issue;Star 数为 461,可作为社区活跃度的参考。

关于

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

描述取自 GitHub 官方 API,中文内容由 GitRead 中文社区 编辑团队整理。

简要分析

热度分
850
价值分
333
活跃状态
活跃

语言占比

Python
Shell

贡献者

README

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

致谢

评论

暂无评论