iStoreOS 版本怎么选：25 与 24 插件兼容对比

iStoreOS 的版本号跟着 OpenWrt 基座走：早几年的 22.03、现在主流的 24.10，以及新一代的 25.12。25 系最大的变化不在界面，而是底层包管理器从 opkg 换成了 apk——这对插件安装、依赖解析和升级迁移都有直接影响。

如果你装 iStoreOS 的主要目的是跑插件，那么版本选择的第一原则应该是插件兼容性优先。这篇文章把 22.03、24.10、25.12 三个分支的差异、插件适配度和升级路径讲清楚，并给出按需求选版的建议。

地址可以来这里下载安装，点击 997笔记istroeos-passwall科学插件

一、先对齐版本号

简单说：22.03 胜在稳定，24.10 胜在平衡，25.12 胜在新。而“新”在插件场景里往往意味着“还没适配完”。

二、25.12 的核心变化：opkg 换成 apk

OpenWrt 25.12 系列切换到了 apk 包管理架构，iStoreOS 25.12 也跟进了。这带来几个直接影响：

• 不能从 24.10 保留配置升级：因为 iStoreOS 的“保留配置升级”实际上也会保留已安装的软件包，包管理架构变了之后不再兼容。
• 已装插件需要重装：从 iStore 安装的插件可以在维护页下载已安装列表后一键恢复，但手动安装的插件不在这个范围内。
• apk 语法与 opkg 不同：习惯用 opkg 命令和 shell 脚本的用户需要重新适应。

正确的迁移顺序是：先在 24.10 备份配置文件 → 不保留配置升级（或重刷）到 25.12 → 在相同界面恢复备份 → 重新安装插件。

另外两个容易被忽略的坑：

• nginx 用户：恢复备份后可能没有 Web 服务，后台打不开。此时可以用 7681 端口的 ttyd 终端登录，执行 /etc/init.d/uhttpd start 临时启动 Web 服务，再进后台安装 nginx 插件。
• Docker 菜单位置变了：25.12 里 Docker 移到了“服务”菜单下。
• 网卡自动配置只发生在首次启动：后加入的网卡不会自动配置，需要恢复出厂设置重新扫描，命令是 firstboot -y -r。

三、插件兼容度对比

为什么 24 或更早版本的插件兼容性更好？一个重要原因是：社区里大量 .run 插件包是按 22.03 SDK 编译的，依赖 libopenssl1.1，不要求 libopenssl3，在 22.03 和 24.10 上都能更好地工作。到了 25.12，包管理器和依赖体系都变了，这些老包不能直接沿用，需要作者重新构建。

四、为什么建议以 24 或更早版本为主

1. 插件优先：24.10 仍然是 opkg 体系，主流 .run 包和 iStore 插件都能正常安装，踩坑最少。
2. 老设备更稳：22.03 经过长时间验证，社区资料丰富，bug 最少，是旧硬件的可靠选择。
3. 25.12 还处于 alpha：官方把它放在单独的尝鲜目录，插件生态还在适配，部分插件没有 25 版本。
4. 24.10 分支本身也有小版本差异：有用户反馈 24.10.8 出现过 dnsmasq 崩溃或反复重启的情况。升级前建议先看社区反馈、做好备份，选择口碑稳定的小版本。

五、按需求选版

六、升级到 25.12 的检查清单

如果你确实要升到 25.12，按这个清单走可以少踩坑：

• 在 24.10 里导出完整配置文件，单独保存一份
• 在 iStore 维护页导出已安装插件列表
• 记录所有“手动安装”的插件和来源，确认它们有 25 适配版
• 准备 ttyd 终端或串口访问方式，防止升级后 Web 后台打不开
• 选择“不保留配置”升级或重刷，不要尝试从 24.10 直接保留配置升级
• 恢复备份后，检查 Web 服务、Docker、nginx 是否正常
• 逐项重装插件，装完一个验证一个

总结

插件兼容性优先的话，24.10 是当前最稳妥的主力版本，22.03 是老设备的稳定备选，25.12 更适合尝鲜和测试。除非你有明确的新硬件或新功能需求，否则不建议在主力设备上追 25 系 alpha。版本选择没有绝对的对错，关键是匹配你的硬件、插件清单和折腾意愿。