OpenWrt 25.12 把软件包管理器从 opkg 换成了 apk。如果你希望在 LuCI 后台用图形界面查找、安装和卸载插件，可以安装 iStore 软件中心。本文结合视频演示和 iStore 项目文档，整理官方 OpenWrt 25.12 的基本做法。

视频演示

下面的视频演示了 iStore 在 OpenWrt 25.12 中安装、卸载插件的界面操作。视频发布于 2026 年 6 月；实际软件包和设备支持情况请以当前 iStore 项目说明为准。

如果播放器无法加载，也可以直接在 YouTube 观看。

先确认设备是否受支持

iStore 是独立的软件中心，不代表其中每个插件都适用于所有路由器。安装前先确认：

  • 设备运行的是 OpenWrt 官方版。iStoreOS、ImmortalWrt 和其他定制固件要按照各自项目的说明操作。
  • 设备架构符合 iStore 官方安装脚本支持范围。iStore 项目目前列出 x86_64 和 arm64。
  • 设备能访问软件源，并留有足够空间安装软件包。
  • 已备份路由器配置。路由器上有正在使用的网络或代理服务时，安装或卸载相关插件可能影响服务。

OpenWrt 25.12 官方版使用 apk；旧版 24.10 及更早版本使用 opkg。有些第三方固件会自行修改包管理器，所以不要只凭版本号判断：以当前系统实际提供的软件包管理器和固件文档为准。

安装 iStore

请从 iStore 官方项目 README 获取最新安装命令。官方说明列出的命令如下：

apk update || opkg update || exit 1
cd /tmp
wget https://github.com/linkease/openwrt-app-actions/raw/main/applications/luci-app-systools/root/usr/share/systools/istore-reinstall.run
chmod 755 istore-reinstall.run
./istore-reinstall.run

通过 SSH 登录路由器后逐行执行。安装过程需要访问官方仓库；如果下载失败，先检查路由器本身能否联网、DNS 和系统时间是否正常，不要随意换成来源不明的安装脚本。

安装结束后重新加载 LuCI 页面，必要时退出并重新登录，然后在后台菜单中查找 iStore。若菜单仍未出现，先查看安装命令输出和系统日志；不同 LuCI 主题的菜单位置可能不同。

在 iStore 中安装和卸载插件

  1. 打开 LuCI 后台中的 iStore 软件中心。
  2. 搜索需要的插件，先查看简介、适用固件和依赖，再点安装。
  3. 等待安装完成后，按插件说明从 LuCI 菜单进入配置页面。
  4. 不再需要时，在 iStore 的已安装列表中找到插件并执行卸载；卸载前先确认是否需要保留配置或数据。

不同版本的 iStore 界面可能略有差异，视频可以帮助对照按钮位置。遇到安装失败时，先记录错误信息，不要连续尝试来源不同的软件包。

插件搜得到，为什么还是装不上？

软件中心提供图形界面，但不会自动解决所有兼容问题。常见原因包括：

  • 设备架构不匹配：插件没有为当前 CPU 架构提供可用软件包。
  • 软件源不匹配：软件包面向另一个 OpenWrt 版本或其他固件分支。
  • 依赖缺失：插件需要的软件源或依赖没有安装。
  • 内核模块版本不符：kmod 类软件包通常需要和当前固件的内核版本匹配。
  • 固件空间不足：闪存或可写空间有限，软件包及其依赖无法安装。

安装前查看插件说明中的固件版本、架构和依赖要求。若软件源明确不支持当前系统，不要通过混用其他分支的软件源强行安装；这可能造成依赖冲突或系统服务异常。

小结

iStore 可以让受支持设备上的插件安装和卸载更直观，但它不是所有固件的通用兼容层。先确认官方固件、架构和软件源，再从 iStore 项目文档安装。安装插件前检查版本与依赖，出现兼容错误时优先按错误信息排查。

参考资料