iStoreOS 25.12 里最容易被低估的变化，其实不是界面。
不少人刷完 25.12 测试固件，第一反应是打开后台看一眼——还是熟悉的 QuickStart，还是熟悉的主页，于是放心了。直到 SSH 进去想装个插件，才发现不对劲：敲 `opkg install`，没这个命令了。包管理器整个换掉了。发布视频底下评论区各种懵：有人说点了升级却收到 24.10.8，有人说装不上包，还有人卡在"架构不兼容"。这些其实都指向同一件事，今天一次说清楚。
为什么换：不是 iStoreOS 折腾，是上游先动的手
iStoreOS 25.12 基于 OpenWrt 25.12.5 适配，而 OpenWrt 上游在这一代正式把包管理器从 opkg 换成了 apk（Alpine Package Keeper）。注意，这不是简单的改名，OpenWrt 自己维护的 opkg 分支已经停止维护了，apk 才是长期主力。GitHub
刷进 25.12 后第一次登录终端，系统提示信息里就会直接贴出一份 opkg 到 apk 的命令对照，等于官方也在提醒你：老习惯该更新了。
这个变化也解释了 24.10 用户最关心的问题：为什么 25.12 不支持保留配置升级。iStoreOS 官方给的原因很直白——它的"保留配置升级"实际上连软件包一起保留，而 ipk 和 apk 两套包互不兼容，保留也就没了意义。酷友社论坛所以官方推荐的路径是：先在 24.10 的"系统 - 备份与更新"里备份配置文件，然后不保留配置重刷到 25.12（官方也标注了这是建议方式），刷完再回同一界面恢复备份。配置能原样回来，但软件要重新装一遍，这就是这次升级的主要迁移成本。
命令备忘单：opkg 老用户直接平移
之前 opkg 用得熟的，记下面这张表就够了。apk 的风格更接近 Alpine Linux，平时折腾 Docker、玩过 Alpine 的会觉得眼熟：
用途 | opkg（24.10） | apk（25.12） |
|---|---|---|
刷新软件源 | opkg update | apk update |
安装软件包 | opkg install 包名 | apk add 包名 |
卸载软件包 | opkg remove 包名 | apk del 包名 |
升级软件包 | opkg upgrade | apk upgrade |
查看已安装 | opkg list-installed | apk info |
列出/搜索软件包 | opkg list | apk list / apk search |
查看包详情 | opkg info 包名 | apk info 包名 |
修复/重新配置 | opkg configure | apk fix |
软件源配置文件的位置也跟着变了：从 `/etc/opkg/distfeeds.conf` 挪到了 `/etc/apk/repositories.d/` 目录下。之前写过脚本自动换源（比如切国内镜像）的，刷完 25.12 记得把脚本改一遍。OpenWrt 上游还准备了一份官方的 opkg 转 apk 速查表，碰到冷门命令可以去翻。
坑一：aarch64 架构选择，方向反了
这是 ARM 设备用户最容易栽的地方。有 E20C 用户在 GitHub 上反馈：24.10 时代系统架构显示 aarch64_cortex-a53，升到 25.12 后变成 aarch64_generic，之前囤的 a53 apk 包直接装不上，报架构不兼容。官方维护者回复得很干脆：这不是 bug，25.12 上方向反过来了，是 aarch64_cortex-a53 的机器去兼容 aarch64_generic 的包。GitHub结论很简单：ARM 设备选包，认准 aarch64_generic 就行。树莓派 4/5 在 8 月 20 日的构建里已经在编译期配好了 apk 兼容，就算之前从没通过 iStore 装软件，也能直接装 generic 架构的包。拿不准自己设备架构的，先敲一条命令确认：
`source /etc/os-release; echo $OPENWRT_ARCH`
iStoreOS 后台"状态 - 概览"里也能直接看到型号、架构、固件版本这些信息，刷机前后对一眼，心里有数。
坑二：别拿旧构建的固件刷
如果你手滑刷了 8 月 8 日甚至更早的构建，可能会撞上两个现在已经修掉的问题：一个是软件仓库列表为空，装不了 openwrt 仓库里的软件，8 月 8 日已修复；另一个是 x86 部分机型网卡不自动配置、直接报 no interfaces found，维护者解释是上游把配置生成提前、驱动还没加载就扫了网卡，8 月 20 日的构建已修复。GitHub所以现在要刷，一定去官方测试固件目录（fw.koolcenter.com/iStoreOS/alpha/25.12/）下最新构建。截至 8 月 22 日，x86 EFI 目录下最新的是 25.12.5-2026082020。KoolCenter固件服务器官方测试版基本保持每周一更的节奏，每个构建都在修具体问题，镜像站里的老版本就别碰了。
坑三：老 ipk 包和老脚本全失效，但生态跟得比想象快
24.10 时代的 ipk 包，在 25.12 上一个都装不了。有囤包习惯的、写过 opkg 批量安装脚本的，这部分资产要清零重来。
好消息是生态补位很快。iStore 商店本身已经完成了 APK 架构适配，走图形界面装卸插件的体验没变；从 iStore 装过的插件，可以在商店"维护"页下载已安装列表，刷完新系统一键恢复，只有手动装的包要自己一个个补。酷友社论坛
第三方编译也跟上了：像 Are-u-ok 这类社区项目，8 月 8 日就放出了面向 iStoreOS 25.12 的 .run 安装包，PassWall、OpenClash、HomeProxy、MosDNS、bandix 这些常驻插件都有，还按 x86_64、aarch64_generic、a53、a72 分了架构，对号入座下载即可。GitHub
几个小变化，顺手记一下
Docker 从一级菜单挪进了"服务"菜单，第一时间找不到不是 bug。酷友社论坛
用 nginx 做后台 Web 服务的，恢复备份后 Web 服务不会自动起来，后台会打不开。救急路线：访问 `http://istoreos.lan:7681/` 进 ttyd 网页终端，执行 `/etc/init.d/uhttpd start` 临时把 Web 服务拉起来，再进后台重装 nginx 插件。
x86 和 armsr 设备只在首次启动时自动配置网卡，后加的网卡不会自动识别，可以跑新增的 rescan_nic 命令重扫，或者干脆 `firstboot -y -r` 恢复出厂。GitHub
最后，按人群给两句建议
如果你的插件基本都走 iStore 商店装，这次变化对你影响很小：图形界面照用，装完还能一键恢复列表，可以放心刷。如果你是手动装包的重度用户、脚本一堆，先花半天把包清单理出来，再刷。
N1 这类 Amlogic 设备的用户，先别急着上：25.12 还没适配 Amlogic 平台，Intel 核显 SR-IOV、RK35xx 的 GPU/NPU 驱动也都在待开发清单里。酷友社论坛安心留在 24.10 稳定版，倒是稳定版 24.10.8 七月底刚更新，内核升到 6.6.144，还修了 DHCP、LuCI 等多个安全问题，建议先把这个补丁打上。酷友社论坛
至于 25.12 什么时候转正，官方维护者在讨论区的说法是暂时肯定不会正式发布。GitHub所以主力路由先别动，拿虚拟机或备机跑两周，盯一下 GitHub 官方测试反馈帖里的修复进度，再决定什么时候切主力。
