第三方插件安装
FanchmWrt和OpenWrt官方固件是同源的,默认采用OpenWrt软件源,支持安装插件,内核插件无法安装,常用的内核插件已经默认集成。
FanchmWrt也可以使用同版本的ImmortalWrt的软件源,支持更多国内的插件。
如何更新immortalwrt软件源
系统默认采用openwrt官方的软件源,如果想要使用更多国内的插件,可以使用immortalwrt的软件源
替换为immortalwrt软件源的方法很简单,只需要在软件源配置中将openwrt域名替换为immortalwrt即可

注意OpenWrt25.12之后的版本开始采用apk包管理,但是修改软件源的方法类似,也同样是在软件源链接中替换openwrt为immortalwrt,只是配置界面和链接路径有区别。
由于immortalwrt目前还没有发布25.12版本,所以25.12版本固件不支持切换为immortalwrt的软件源,需要等版本发布后才支持。
切换国内镜像源
注意25.12版本之后采用了apk包管理,切换为非openwrt官方软件源会导致签名校验失败,目前还没有增加忽略处理,只能通过apk命令手动安装,无法通过页面安装,apk安装教程在最下方有写。为什么要切换为国内镜像源?
可能部分网络访问openwrt.org或者immortalwrt.org网站比较慢,会导致软件源更新失败,或者软件安装过程中非常慢。 为了加快安装速度,建议将软件源切换为国内镜像源,推荐使用中科大镜像站,该镜像站包含了immortalwrt。
镜像站地址:
- openwrt
https://mirrors.ustc.edu.cn/openwrt - immortalwrt
https://mirrors.ustc.edu.cn/immortalwrt
如何切换?
切换方法很简单,在软件源的各个链接中,将前面的https://downloads.openwrt.org地址切换为https://mirrors.ustc.edu.cn/openwrt即可,
如果是切换为immortalwrt,则替换为https://mirrors.ustc.edu.cn/immortalwrt。
由于镜像站包含了各种不同系统,所以mirrors.ustc.edu.cn后面要指定系统名称。
以25.12.0 apk软件源的链接为例:
替换之前的链接为:
https://downloads.openwrt.org/releases/25.12.0/targets/mediatek/filogic/packages/packages.adb
替换后的链接为:
https://mirrors.ustc.edu.cn/openwrt/releases/25.12.0/targets/mediatek/filogic/packages/packages.adb
为了测试链接是否正常,可以通过浏览器访问新链接查看是否能够访问成功。
snapshot版本如何切换软件源
部分设备可能目前没集成到OpenWrt稳定版本中,只能基于OpenWrt最新代码编译,相当于为snapshot版本,snapshot版本软件源切换也和上面的一样,保持版本为snapshot即可,只用替换openwrt为immortalwrt,
但是部分镜像站可能没有同步immortalwrt的snapshot相关插件,也可以使用相近正式版本或者rc版本的软件源。如果出现部分目录链接更新失败,可能是immortalwrt并没有该目录链接导致,保持那个链接地址为openwrt即可,比如video相关。
如何安装插件
安装插件直接搜索luci-app-开头的即可,安装luci-app插件会自动安装依赖 比如如果你想要安装xxx插件则搜索 luci-app-xxx,然后点击安装,注意有些比较大的插件(比如docker)安装时间过长可能最后报网络错误,可能实际已经安装成功,可以刷新页面查看实际结果 或者重新登录再查看。
注意事项
1. 建议大家使用国内的镜像软件源,下载速度会快一些,有些网络根本无法访问openwrt.org。2. 一些大型的插件可能出现页面安装出错,有时候并不是安装错误,而是因为页面获取状态超时导致,可以等一段时间刷新试试。
3. 如果提示安装成功没有看到菜单,可以重新登录页面再查看或者清除下浏览器缓存。
4. 如果知道命令行安装建议用命令行,通过web操作有时候会出现以下奇怪的报错。
5. immortalwrt目前还没有25.12版本,需要等版本发布后才支持切换为immortalwrt软件源。
通过apk命令安装第三方软件包
首先需要保证在web页面中切换了软件源地址,比如immortalwrt,然后再按照以下方式更新和安装。
- 更新插件列表
apk update --allow-untrusted
- 查看可用插件列表
apk list --full --allow-untrusted
- 安装指定插件
apk add 插件名称 --allow-untrusted
比如安装acl插件,app名称对应为luci-app-acl,则安装命令为
apk add luci-app-acl --allow-untrusted
说明
由于fanchmwrt没有自建软件源,一些和系统匹配的内核模块无法安装,因为kmod插件是严格依赖版本和配置的,目前采取的策略是默认集成一些常用插件依赖的内核模块,目前一些常用的插件安装没有问题,等系统功能逐步完善后会考虑自建软件源。