UCI : comment OpenWrt conserve tous ses réglages dans /etc/config

Chaque service lit /etc/config. LuCI modifie les mêmes fichiers.

En une phrase

UCI (Unified Configuration Interface) conserve la configuration des services d’OpenWrt dans des fichiers texte brut sous /etc/config/. LuCI et la commande uci modifient ces mêmes fichiers.

Comment cela fonctionne

Il y a un fichier par sous-système, tel que network, wireless, dhcp, firewall et system.
uci set, uci add, uci rename et uci delete sont d’abord mis en attente. uci commit les écrit en flash en une seule fois.
Une modification validée ne prend effet qu’après le rechargement ou le redémarrage du service via son script d’initialisation. L’exemple officiel change le port d’uhttpd, valide, puis exécute /etc/init.d/uhttpd restart.
LuCI est une interface frontale : ses pages lisent et écrivent les mêmes fichiers UCI via des API.

Voir cela sur votre routeur

Ces commandes ne font que lire :

uci show network.lan
uci get network.lan.ipaddr
uci export dhcp

Attention

Une modification que vous validez sans jamais la recharger n’est pas encore active. Elle prendra effet au prochain redémarrage du service ou de l’appareil, longtemps après que vous l’aurez oubliée.
Copiez /etc/config en lieu sûr avant de modifier à la main. Sauvegarde et restauration décrit une sauvegarde complète.

Guides associés

Sources

Router.Homes

Notes indépendantes sur OpenWrt. Chaque page précise le firmware, l’appareil, le gestionnaire de paquets et le retour arrière.

Icônes : Solar by 480 Design, CC BY 4.0