apk de 25.12 frente a opkg de 24.10: comandos, formato de paquete y límites de migración

En una línea

25.12+: apk, los paquetes son .apk;
24.10 y anteriores: opkg, los paquetes son .ipk;
No se relacionan por cambio de nombre; no renombres .ipk a .apk;
Tras actualizar a 25.12, reinstala los plugins desde los feeds de apk; la configuración se puede respaldar y restaurar.

Comprueba en qué lado estás

cat /etc/openwrt_release
command -v apk
command -v opkg

Este laboratorio: 25.12.6, apk existe, opkg no.

Comparación

Elemento	`apk` de 25.12	`opkg` de 24.10
Formato	`.apk`	`.ipk`
Archivo de feeds	`/etc/apk/repositories.d/distfeeds.list`	`/etc/opkg/distfeeds.conf`
Actualizar índice	`apk update`	`opkg update`
Instalar	`apk add <pkg>`	`opkg install <pkg>`
Eliminar	`apk del <pkg>`	`opkg remove <pkg>`
Buscar	`apk search <term>`	`opkg list \| grep <term>`
Instalados	`apk list --installed`	`opkg list-installed`
Información del paquete	`apk info -a <pkg>`	`opkg info <pkg>`
Limpiar caché	`apk cache clean`	`opkg clean`

Feeds y arquitectura

25.12:

https://downloads.openwrt.org/releases/25.12.6/targets/x86/64/packages/packages.adb
https://downloads.openwrt.org/releases/25.12.6/packages/x86_64/base/packages.adb
https://downloads.openwrt.org/releases/25.12.6/targets/x86/64/kmods/<kernel-hash>/packages.adb

24.10:

src/gz openwrt_core https://downloads.openwrt.org/releases/24.10.8/targets/x86/64/packages
src/gz openwrt_base https://downloads.openwrt.org/releases/24.10.8/packages/x86_64/base

release, target, arch y el hash de los kmods deben coincidir;
Mezclar feeds oficiales/ImmortalWrt/iStoreOS puede romper la ABI, las firmas o los nombres;
Un mirror de China cambia solo el host y el prefijo de la ruta; no cambies el target ni la arquitectura.

Operaciones comunes

Shell del routerInstala un paquete en 25.12

apk update
apk search -x sqm-scripts
apk add sqm-scripts
apk info -e sqm-scripts
apk list --installed | wc -l

Este laboratorio: oficial y TUNA con 11220 paquetes cada uno; se instaló sqm-scripts 1.7.2-r1.

EsperadoActualizar, buscar, instalar y verificar usan apk.

Shell del routerEquivalente en 24.10

opkg update
opkg list | grep sqm-scripts
opkg install sqm-scripts
opkg list-installed | grep sqm-scripts

Son los comandos equivalentes oficiales, no ejecutados aquí (sin dispositivo 24.10); no los presentes como salida medida.

EsperadoLos comandos y el formato son opkg/ipk; no mezcles apk.

Al actualizar a 25.12

Respalda /etc/config y la lista de paquetes (ver 018);
Anota opkg list-installed de 24.10;
Actualiza/reinstala 25.12 (ver 019);
Reinstala los plugins desde los feeds de apk;
Restaura la configuración y verifica LuCI/servicios/DNS;
No conviertas .ipk en .apk ni copies directorios de paquetes antiguos.

El sysupgrade a 25.12 de este laboratorio conservó la configuración pero perdió paquetes (239→182); SQM/OpenClash necesitaron reinstalación.

Fallos comunes

`apk: not found`

El firmware es 24.10 o anterior; usa opkg;
“Instalar un gestor de paquetes apk” no es la solución; comprueba primero la versión.

`opkg: not found`

El firmware es 25.12+; usa apk;
Los tutoriales o scripts antiguos que usan opkg no se aplican directamente.

El `.ipk` no se instala

25.12 usa .apk;
Renombrar no cambia el formato;
Busca el .apk para la versión/target/arquitectura o recompila.

Errores 404/firma/dependencias

no coinciden versión/target/arquitectura/hash de los kmods;
feeds mezclados;
hora o certificados del sistema;
no uses --allow-untrusted como solución habitual.

No hay menú de LuCI tras actualizar

se instaló el programa principal sin luci-app-*;
no se reinstaló el plugin antiguo;
caché del navegador/volver a iniciar sesión;
ver 017.

Prueba E2 en laboratorio (2026-10-20)

Entorno: VM 200 x86 con OpenWrt 25.12.6; apk; feeds oficial/TUNA.
apk update oficial/TUNA: ambos 11220 paquetes; apk add sqm-scripts tuvo éxito.
Tras sysupgrade a 25.12: paquetes 239→182; SQM/OpenClash desaparecieron y necesitaron reinstalación.
No ejecutado: update/install/list de opkg en 24.10, migración real de 24.10→25.12, paquetes de otras arquitecturas.
Receta: tests/recipes/apk-vs-opkg.md.

Fuentes y revisión

Esto es E2 parcial: se probó apk de 25.12; opkg de 24.10 es una referencia oficial de comandos, no ejecutada aquí.
No conviertas una comparación de comandos en “migración verificada”; respalda y prueba primero en una VM.
No hay revisor independiente; las conclusiones se limitan a este entorno x86 con 25.12.

Fuentes

Router.Homes

Notas independientes sobre OpenWrt. Cada página indica el firmware, el dispositivo, el gestor de paquetes y la vía de retorno.

Iconos: Solar by 480 Design, CC BY 4.0