Les bases de LuCI

Installation de l'interface LuCI sur uHTTPd Cette procédure installe les éléments essentiels de l'interface utilisateur Web LuCI. Pour connaître l'ensemble des paquets disponibles pour administrer OpenWrt via LuCI : “opkg update && opkg list luci-*”

Dans le cas où vous ne seriez pas encore familier avec la ligne de commande, consultez l'aide et/ou opkg de ligne de commande CLI, check out command-line HELP et / ou opkg

1. Commencez par récupérer la liste des paquets disponibles :

   opkg update

• Pour une installation complète de LuCI sans support du HTTPS :

  opkg install luci

• Pour une installation complète de LuCI avec support du HTTPS (recommandée) :

  opkg install luci-ssl

L'interface LuCI est activement traduite dans de nombreuses langues par de nombreux volontaires. Jetez un oeil ici http://i18n.luci.subsignal.org/pootle/ et impliquez-vous aussi ! Pour accédez à la liste des paquets disponibles, faîtes

opkg list | grep luci-i18n-

Pour installer votre langue native faîtes pour l'interface de base (dans cet exemple, c'est la langue française est configurée):

opkg install luci-i18n-base-fr

Pour installer votre langue native faîtes, par exemple pour les pages dédiées au firewall (dans cet exemple, c'est la langue française est configurée):

opkg install luci-i18n-firewall-fr

Vous pouvez également installer des modules linguistiques en utilisant l'interface web et installer plusieurs packs de langue Luci en même temps (et basculer entre eux via l'interface web LuCI ou en éditant le fichier) → /etc/config/luci

Le serveur web uHTTPd est une dépendance du paquet LuCI et est automatiquement installé sur votre système OpenWRT avec LuCI (ou LuCI-ssl). Après installation, le serveur web n'est pas démarré, il faut donc le lancer manuellement via la commande suivante :

/etc/init.d/uhttpd start

À partir de maintenant, vous pouvez vous connecter à LuCI à l'adresse : http://192.168.1.1. Pour LuCI-SSL : https://192.168.1.1.

Pour faire en sorte que le serveur web démarre automatiquement après chaque redémarrage d'OpenWRT, il est nécessaire de le configurer sur enable dans le script de démarrage, via la commande suivante :

/etc/init.d/uhttpd enable

LuCI est installé en tant que “méta paquet” qui installe plusieurs autres paquets en les ayant définis en tant que dépendances. Surtout, il installe le serveur web uHTTPd, configuré pour fonctionner avec LuCI. Les paquets dépendants sont les suivants (voir la référence technique de LuCI pour plus d'information) :

• uhttpd
• uhttpd-mod-ubus
• luci-mod-admin-full
• luci-theme-bootstrap
• luci-app-firewall
• luci-proto-core
• luci-proto-ppp
• libiwinfo-lua

In case you want to use uHTTPd for the web interface there is little configuration necessary as uHTTPd is configured with CGI to make LuCI work with the Lua interpreter. By default this is organised as follows. By default /www is the standard document root. Thus, by requesting this docroot (by pointing your browser to the devices IP address) an index file such as index.html is searched for (per uHTTPd settings). The file /www/index.html (installed with LuCI) is prepared such that when requested, it redirects you to /cgi-bin/luci, which is the default CGI gateway for LuCI. This is just a script, which basically calls Lua at /usr/bin/lua. uhttpd is configured by default to load pages as CGI in the /cgi-bin path, and thus starts serving these pages with the /cgi-bin/luci script.

Il est aussi possible de lancer LuCI avec Lua en tant que processus embarqué. uHTTPd suporte cela, voyez la section correspondante de l'article uHTTPd Web Server Configuration sur la configuration UCI de uHTTPd.

Le serveur web par défaut uhttpd est configuré dans le fichier /etc/config/uhttpd.
L'interface web LuCI est configurée dans le fichier /etc/config/luci

→webserver

→luci.on.lighttpd

• Luci on nginx is not possible as nginx does not support plain cgi.
• https://forum.openwrt.org/viewtopic.php?id=65760

Téléchargez et transférez (par exemple en utilisant SCP) les paquets listés ci-dessous sur votre routeur OpenWrt sur le RAM disk dans /tmp/luci-offline-packages

mkdir -p /tmp/luci-offline-packages; cd /tmp/luci-offline-packages

• liblua
• lua
• libuci-lua
• libubus-lua
• uhttpd
• luci-lib-ipkg
• luci-i18n-english
• luci-sgi-cgi
• luci-lib-core
• luci-lib-nixio
• luci-lib-sys
• luci-lib-web
• luci-proto-core
• luci-theme-base
• luci-theme-openwrt
• luci-mod-admin-core
• luci-mod-admin-full

et installez-les avec :

for pkg in liblua lua libuci-lua libubus-lua uhttpd luci-lib-ipkg luci-i18n-english luci-sgi-cgi luci-lib-core luci-lib-nixio luci-lib-sys luci-lib-web luci-proto-core luci-theme-base luci-theme-openwrt luci-mod-admin-core luci-mod-admin-full; do opkg install /tmp/luci-offline-packages/$pkg*.ipk; done

En outre, les paquets suivants sont nécessaires pour de la configuration basique sans-fil : libiw, libiwinfo, libiwinfo-lua.

Si vous voulez configurer le serveur web LuCI pour un accès sécurisé, lisez les explications ici.

• LuCI has its own web-presence. Please file LuCI specific bugs at the LuCI website

LuCI Technical Reference