UCI: wie OpenWrt jede Einstellung in /etc/config ablegt

Jeder Dienst liest /etc/config. LuCI bearbeitet dieselben Dateien.

In einem Satz

UCI (Unified Configuration Interface) speichert die Konfiguration der OpenWrt-Dienste in Klartextdateien unter /etc/config/. LuCI und der Befehl uci bearbeiten dieselben Dateien.

So funktioniert es

Es gibt eine Datei pro Subsystem, etwa network, wireless, dhcp, firewall und system.
uci set, uci add, uci rename und uci delete werden zunächst nur vorgemerkt. uci commit schreibt sie in einem Zug in den Flash.
Eine übernommene Änderung wirkt erst, nachdem der Dienst über sein Init-Skript neu geladen oder neu gestartet wurde. Das offizielle Beispiel ändert den uhttpd-Port, führt commit aus und startet dann /etc/init.d/uhttpd restart.
LuCI ist ein Frontend: Seine Seiten lesen und schreiben dieselben UCI-Dateien über APIs.

Auf Ihrem Router ansehen

Diese Befehle lesen nur:

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

Achtung

Eine Änderung, die Sie übernehmen, aber nie neu laden, ist noch nicht aktiv. Sie wirkt erst beim nächsten Neustart des Dienstes oder des Geräts, möglicherweise erst lange, nachdem Sie sie vergessen haben.
Kopieren Sie /etc/config an einen sicheren Ort, bevor Sie von Hand bearbeiten. Backup und Wiederherstellung beschreibt ein vollständiges Backup.

Quellen

Router.Homes

Unabhängige OpenWrt-Notizen. Jede Seite nennt Firmware, Gerät, Paketmanager und den Rückweg.

Symbole: Solar by 480 Design, CC BY 4.0