刷完固件,SSH 进去,照着教程敲下第一句 `opkg update`。
回车,屏幕甩你一行 `opkg: command not found`。
那一瞬间的血压,玩软路由的都懂:是不是刷坏了?固件包下错了?要不要开始救砖?
都不用。你的路由器好好的,是教程过期了。
opkg 退休,接班的是 apk
OpenWrt 在 2024 年 11 月官宣:包管理器从 opkg 换成 apk,opkg 已被弃用、不再是 OpenWrt 的一部分。顺便说清楚,这个 apk 跟安卓那个安装包没关系,全称 Alpine Package Keeper,是 Alpine Linux 那套包管理器。真正让老教程集体失效的,是它跟着大版本走:25.x 认 apk,24.x 还认 opkg。知乎专栏知乎哔哩哔哩
但换血不是一刀切。24.10 这条线的包管理器仍然是 OPKG,APK 包当时还不支持,官方的说法是要等下个版本才切过去。25.12 才是真正换上 apk 的那一代,有台 MT7986 的机器实测记录写得明白:固件 OpenWrt 25.12.5,包管理器是 apk。更要命的是两代的包格式互不兼容:opkg 时代是 `.ipk`,apk 时代是 `.apk`,第三方插件没适配就得等开发者动手。你硬盘里囤的那一堆离线插件包,在 25.12 上一个都装不上。知乎专栏知乎专栏知乎专栏

先搞清楚自己站在哪一代
三个办法,任选:LuCI 首页概览写着版本号;SSH 里 `cat /etc/openwrt_release`;实在懒得看,直接敲一下 `apk`,有反应就是新一代。
ImmortalWrt 这类分支同理,跟着大版本走——24 代认 opkg / ipk,25 代认 apk。至于 iStoreOS 和各种带后缀的整合固件,看它自己声明的基础版本,别猜。知乎专栏

命令对照,抄走就行
老教程里那套 opkg 命令,在 25.12 上要整体换一遍——有插件教程直接标注了“在 openwrt25.12 以上版本中,命令行和插件不同”。知乎专栏
更新软件列表:`opkg update` → `apk update`
装插件:`opkg install luci-app-sqm sqm-scripts` → `apk add luci-app-sqm sqm-scripts`
卸载:`opkg remove` → `apk del`
看装了什么:`opkg list-installed` → `apk info`
装本地包:`opkg install /tmp/x.ipk` → `apk add --allow-untrusted /tmp/x.apk`
`–allow-untrusted` 不是在开后门。自己下载的离线包没有仓库签名,过不了校验,教程里管这一步叫“跳过证书命令”,从官方源在线装的包不用加。知乎
三个真会卡住你的坑
一、换国内源的老脚本失效了。 网上流传的一键换源,本质是打开 LuCI 的“配置 opkg”,把 `/etc/opkg/distfeeds.conf` 里的官方地址替换成中科大、清华或阿里云的镜像。25.12 上 opkg 那套目录整个不在了,apk 的源配置搬到了 `/etc/apk/` 底下,写法也不再是 `src/gz` 那一行。照着老脚本敲,只会拿到一行 No such file。知乎专栏
二、路由器时间不对,apk update 直接失败。 新刷的机器、断电放久的机器,系统时间可能还停在出厂那天,SSL 证书校验当场挂掉,报 `wget: exited with error 5`——这不是源的问题,得先把时间校正了再更新。知乎专栏

三、离线包下错目录,一样装不上。 同一个插件的 release 页里,22.03.7 那种老版本目录放的是 ipk 安装包,SNAPSHOT 目录放的才是 apk 安装包,拿错目录就是格式不认。下对了再用 `scp` 传到路由器的 `/tmp` 里安装。知乎
AI 也在给你发老命令
这不是陈年旧事。2026 年 11 月的知乎专栏里,还有人在教 `opkg install nlbwmon luci-app-nlbwmon`。同期不少刷机教程的一键脚本,装的也还是 opkg 那一套流程。知乎专栏
所以现在让 AI 帮你配路由器,开场先把两件事喂给它:机型、固件版本。不然它背的还是三年前的命令,你按下去,报错的仍然是你。

插件适配到哪一步了
好消息是生态跟得比想象中快。新版 iStore 商店已经适配 OpenWrt 25.12,支持 APK 架构和新的软件安装机制,常用插件还是能在图形界面里点着装卸,不用自己处理依赖。主流插件也基本都出了 apk 版,有固件作者的说法是“大部分插件都已经支持 apk 格式了的”,没适配的只能等开发者动手。但你手上那个小众插件适配了没有,只能去项目的 Release 页翻一眼有没有 `.apk`——这件事没有一个统一答案,别默认“都有”。哔哩哔哩知乎专栏

要不要退回 24.10
能退,24.10 仍在维护。有 UP 主上手编译过 25.12 之后给的建议很直接:这一版可能是个比较坎坷的中间版本,建议先留守 24.10 等一等,过几个小版本再升级也不晚。但另一头,第三方固件已经开始往 25.12 单边走了:FanchmWrt 从 1.0.3 起基础代码切到 25.12.4,并且不再发布 24.10 版本,要老版本得自己编译。退回去是缓兵之计,不是长久之计——真依赖某个还没适配的插件,再退;只是懒得学新命令,那就一次学会。哔哩哔哩知乎专栏
一句话记住
25.x 认 apk,24.x 认 opkg。先看版本,再敲命令——这次不是谁在折腾你,是 opkg 真的退休了。
当前文章无评论,是时候发表评论了