Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revisionBoth sides next revision
fr:doc:howto:luci.essentials [2015/04/18 21:41] – [Minimalistic offline installation] trad' bugmesnotfr:doc:howto:luci.essentials [2018/03/03 20:56] – ↷ Links adapted because of a move operation bobafetthotmail
Line 1: Line 1:
 +====== 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-*''**" 
  
 +| {{:meta:icons:tango:utilities-terminal.png?nolink}} | 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 [[wp>Command-line interface|CLI]], check out [[docs:guide-user:base-system:user.beginner.cli|command-line HELP]] et / ou [[docs:guide-user:additional-software:opkg]] |
 +
 +===== Installation =====
 +  - Commencez par récupérer la liste des paquets disponibles :<code bash>
 +opkg update
 +</code>
 +  * Pour une installation complète de LuCI //sans// support du HTTPS :<code bash>
 +opkg install luci</code>
 +  * Pour une installation complète de LuCI //avec// support du HTTPS (recommandée) :<code bash>
 +opkg install luci-ssl
 +</code>
 +
 +==== Configuration de la langue ====
 +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
 +<code bash>
 +opkg list | grep luci-i18n-
 +</code>
 +
 +Pour installer votre langue native faîtes pour l'interface de base (dans cet exemple, c'est la langue française est configurée):
 +<code bash>
 +opkg install luci-i18n-base-fr
 +</code>
 +
 +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):
 +<code bash>
 +opkg install luci-i18n-firewall-fr
 +</code>
 +
 +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) -> ''[[doc:uci:luci|/etc/config/luci]]''
 +
 +
 +==== Lancement du serveur web (uHTTPd) ====
 +Le serveur web [[http.uhttpd|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 :
 +<code bash>
 +/etc/init.d/uhttpd start
 +</code>
 +
 +À partir de maintenant, vous pouvez vous connecter à LuCI à l'adresse : [[http://192.168.1.1]].
 +Pour LuCI-SSL : [[https://192.168.1.1]].
 +
 +==== Activer définitivement le serveur web (uHTTPd) ====
 +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 :
 +
 +<code bash>
 +/etc/init.d/uhttpd enable
 +</code>
 +
 +==== Détails ====
 +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 [[docs:guide-user:services:webserver:http.uhttpd|uHTTPd]], configuré pour fonctionner avec LuCI. Les paquets dépendants sont les suivants (voir [[docs:techref:luci|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 [[docs:guide-user:services:uhttpd#embedded.lua|uHTTPd Web Server Configuration]] sur la configuration UCI de uHTTPd.
 +
 +===== Configuration =====
 +
 +Le serveur web par défaut uhttpd est configuré dans le fichier ''[[docs:guide-user:services:uhttpd|/etc/config/uhttpd]]''.\\
 +L'interface web LuCI est configurée dans le fichier ''[[doc:uci:luci|/etc/config/luci]]''
 +
 +
 +===== LuCI sur d'autres serveurs web =====
 +->[[docs:guide-user:services:http.overview]]
 +
 +==== LuCI sur lighttpd ====
 +->[[docs:guide-user:luci:luci.on.lighttpd]]
 +
 +==== LuCI sur nginx ====
 +  * [[https://forum.openwrt.org/viewtopic.php?id=42487|Luci on nginx is not possible as nginx does not support plain cgi.]]
 +  * [[https://forum.openwrt.org/viewtopic.php?id=65760]]
 +
 +==== LuCI sur... ====
 +
 +
 +===== Installation minimaliste hors ligne =====
 +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'' 
 +<code>mkdir -p /tmp/luci-offline-packages; cd /tmp/luci-offline-packages</code>
 +
 +  * 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 :
 +
 +<code bash>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</code>
 +
 +En outre, les paquets suivants sont nécessaires pour de la configuration basique sans-fil : libiw, libiwinfo, libiwinfo-lua.
 +
 +===== Divers =====
 +
 +=== Accès sécurisé au serveur web LuCI ===
 +
 +Si vous voulez configurer le serveur web LuCI pour un accès sécurisé, [[docs:guide-user:luci:luci.secure|lisez les explications ici]].
 +
 +
 +===== Troubleshooting =====
 +  * LuCI has its own web-presence. Please file LuCI specific bugs at the [[http://luci.subsignal.org|LuCI website]]
 +
 +
 +===== Notes =====
 +[[docs:techref:luci|LuCI Technical Reference]]
  • Last modified: 2019/04/04 07:11
  • by vgaetera