25.12 apk 與 24.10 opkg：指令、套件格式與遷移邊界
- 25.12 以上：
apk，套件為.apk； - 24.10 及更早：
opkg，套件為.ipk； - 兩者無法靠改名轉換；不要把
.ipk改名為.apk； - 升級到 25.12 後，請從
apk套件來源重新安裝外掛；設定可以備份/還原。
檢查你屬於哪一邊
Section titled “檢查你屬於哪一邊”cat /etc/openwrt_releasecommand -v apkcommand -v opkg本實驗：25.12.6，有 apk，沒有 opkg。
| 項目 | 25.12 apk |
24.10 opkg |
|---|---|---|
| 格式 | .apk |
.ipk |
| 套件來源檔 | /etc/apk/repositories.d/distfeeds.list |
/etc/opkg/distfeeds.conf |
| 更新索引 | apk update |
opkg update |
| 安裝 | apk add <pkg> |
opkg install <pkg> |
| 移除 | apk del <pkg> |
opkg remove <pkg> |
| 搜尋 | apk search <term> |
opkg list | grep <term> |
| 已安裝 | apk list --installed |
opkg list-installed |
| 套件資訊 | apk info -a <pkg> |
opkg info <pkg> |
| 清除快取 | apk cache clean |
opkg clean |
套件來源與架構
Section titled “套件來源與架構”25.12：
https://downloads.openwrt.org/releases/25.12.6/targets/x86/64/packages/packages.adbhttps://downloads.openwrt.org/releases/25.12.6/packages/x86_64/base/packages.adbhttps://downloads.openwrt.org/releases/25.12.6/targets/x86/64/kmods/<kernel-hash>/packages.adb24.10：
src/gz openwrt_core https://downloads.openwrt.org/releases/24.10.8/targets/x86/64/packagessrc/gz openwrt_base https://downloads.openwrt.org/releases/24.10.8/packages/x86_64/baserelease、target、arch與 kmod 雜湊值必須相符；- 混用官方/ImmortalWrt/iStoreOS 套件來源可能破壞 ABI/簽章/名稱；
- 中國鏡像站只改變主機/路徑前綴；不要更動 target/arch。
路由器 Shell在 25.12 上安裝套件
apk updateapk search -x sqm-scriptsapk add sqm-scriptsapk info -e sqm-scriptsapk list --installed | wc -l本實驗：官方/TUNA 都是 11220 個套件；已安裝 sqm-scripts 1.7.2-r1。
預期更新、搜尋、安裝與驗證都使用 apk。
路由器 Shell24.10 上的對應做法
opkg updateopkg list | grep sqm-scriptsopkg install sqm-scriptsopkg list-installed | grep sqm-scripts這些是官方的對應指令，此處未執行（沒有 24.10 裝置）；請勿當作實測輸出呈現。
預期指令與格式是 opkg/ipk；不要混用 apk。
升級到 25.12 時
Section titled “升級到 25.12 時”- 備份
/etc/config與套件清單（見 018）； - 記錄 24.10 的
opkg list-installed； - 升級/重新刷入 25.12（見 019）；
- 從
apk套件來源重新安裝外掛； - 還原設定，驗證 LuCI/服務/DNS；
- 不要把
.ipk轉換成.apk，也不要複製舊的套件目錄。
本實驗的 25.12 sysupgrade 保留了設定，但套件從 239 個減少為 182 個；SQM/OpenClash 需要重新安裝。
apk: not found
Section titled “apk: not found”- 韌體是 24.10 或更舊；請使用
opkg； - 「安裝 apk 套件管理員」不是解法；請先檢查版本。
opkg: not found
Section titled “opkg: not found”- 韌體是 25.12 以上；請使用
apk； - 使用
opkg的舊教學/腳本不能直接套用。
.ipk 無法安裝
Section titled “.ipk 無法安裝”- 25.12 使用
.apk； - 改名不會改變格式；
- 請找出對應版本/target/架構的
.apk，或自行重新建置。
404/簽章/相依性錯誤
Section titled “404/簽章/相依性錯誤”- 版本/target/架構/kmod 雜湊值不符；
- 混用套件來源；
- 系統時間/憑證；
- 不要習慣性地用
--allow-untrusted繞過。
升級後沒有 LuCI 選單
Section titled “升級後沒有 LuCI 選單”- 安裝了主程式，但沒有
luci-app-*； - 舊外掛沒有重新安裝；
- 瀏覽器快取/重新登入；
- 見 017。
E2 實驗室測試（2026-10-20）
Section titled “E2 實驗室測試（2026-10-20）”- 環境：OpenWrt 25.12.6 x86 VM 200；
apk；官方/TUNA 套件來源。 - 官方/TUNA
apk update：兩者都是 11220 個套件；apk add sqm-scripts成功。 - 25.12
sysupgrade之後：套件從 239 個減少為 182 個；SQM/OpenClash 消失，需要重新安裝。 - 未執行：24.10
opkg的 update/install/list、真實的 24.10→25.12 遷移、跨架構套件。 - 測試配方：
tests/recipes/apk-vs-opkg.md。
- 這是 E2 部分驗證：已測試 25.12 apk；24.10 opkg 是官方指令參考，此處未執行。
- 不要把指令比較當成「遷移已驗證」；請先備份，並先在 VM 中測試。
- 沒有獨立審閱者；結論僅限於這個 25.12 x86 環境。