Ir al contenido

UCI: cómo OpenWrt guarda toda su configuración en /etc/config

Todos los servicios leen /etc/config. LuCI edita los mismos archivos.

UCI (Unified Configuration Interface) guarda la configuración de los servicios de OpenWrt en archivos de texto plano dentro de /etc/config/. LuCI y el comando uci editan esos mismos archivos.

  • Hay un archivo por subsistema, como network, wireless, dhcp, firewall y system.
  • uci set, uci add, uci rename y uci delete se preparan primero (staging). uci commit los escribe en la flash de una sola vez.
  • Un cambio confirmado solo surte efecto cuando el servicio se recarga o se reinicia mediante su script de init. El ejemplo oficial cambia el puerto de uhttpd, confirma y luego ejecuta /etc/init.d/uhttpd restart.
  • LuCI es una interfaz: sus páginas leen y escriben los mismos archivos UCI mediante API.

Estos comandos son de solo lectura:

Ventana de terminal
uci show network.lan
uci get network.lan.ipaddr
uci export dhcp
  • Un cambio que confirmas pero nunca recargas todavía no está activo. Surte efecto en el próximo reinicio del servicio o del equipo, lo que puede ocurrir mucho después de que lo hayas olvidado.
  • Copia /etc/config a un lugar seguro antes de editar a mano. Respaldo y restauración explica cómo hacer una copia completa.

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