1. Création site Internet
  2. > Articles Techniques
  3. > Ubuntu, Debian, Linux
  4. > Configuration du wifi sous Linux/Debian en ligne de commande
Configuration du wifi sous Linux/Debian en ligne de commande

Configuration du wifi sous Linux/Debian en ligne de commande

lundi 4 août 2014, par Guillaume Orsal

Configurer et connecter le WiFi sous Debian en ligne de commande : guide pratique avec wpa_supplicant (approche traditionnelle) et nmcli (méthode moderne).

Nouvelle installation serveur, sous Debian cette fois-ci. Comme d’habitude sur un système Linux minimal, il faut tout reconfigurer à la main, et j’ai encore oublié comment configurer le réseau wifi sous Linux en ligne de commande. :-(

Voici donc un petit article qui résume les étapes essentielles de la configuration manuelle du wifi sous Linux, sans interface graphique, directement en ligne de commande. Cette approche est particulièrement adaptée aux serveurs Debian ou aux installations légères, où l’on recherche simplicité, stabilité et reproductibilité.

Comme il s’agit d’un réseau domestique, je souhaite :

  • forcer le SSID du réseau wifi
  • configurer une clé WPA (PSK)
  • définir une adresse IP fixe

Cette méthode permet d’éviter toute dépendance à un outil graphique ou à un gestionnaire de réseau, ce qui est souvent préférable sur un serveur.

Méthode traditionnelle : wpa_supplicant (configuration manuelle)

  • Passer root :
su -
  • Vérifier que wpa_supplicant est installé :
apt-get update
apt-get install wpasupplicant
  • Éditer la configuration réseau :
vi /etc/network/interfaces

NB : vous pouvez utiliser tout autre éditeur à votre convenance.

  • Ajouter les lignes suivantes, puis sauvegarder :
auto wlan0
iface wlan0 inet static
  wpa-ssid NomDuReseau
  wpa-psk MotDePasseWifi
  address 192.168.1.100
  netmask 255.255.255.0
  gateway 192.168.1.1
  dns-nameservers 192.168.1.1

L’adresse IP 192.168.1.100 est un exemple d’adresse privée sur un réseau local domestique. Elle doit être choisie dans la plage du réseau local, en dehors de la plage DHCP du routeur, et ne pas être utilisée par un autre équipement.

Le champ gateway correspond à l’adresse IP du routeur (souvent 192.168.1.1), qui permet l’accès à Internet. Le serveur DNS est ici volontairement défini sur le routeur, mais peut être remplacé par un DNS public si nécessaire.

NB : Sous vi, pour insérer des modifications, il faut taper i. La touche Echap ou Esc permet de quitter le mode insertion. Pour enregistrer et quitter : :wq puis valider.

  • Démarrer l’interface wifi :
ifup wlan0

Si l’interface est déjà active :

ifdown wlan0

Ces commandes permettent également d’activer, désactiver ou redémarrer la connexion WiFi sous Debian en ligne de commande.

  • Vérifier l’état de la connexion réseau :
ifconfig
iwconfig
  • Lister les réseaux wifi disponibles à portée :
iwlist scan | grep ESSID

Cette commande permet de scanner les réseaux WiFi sous Debian et de vérifier que l’interface WLAN est correctement détectée avant la connexion.

Mise à jour : configuration wifi avec nmcli (Debian récents)

L’article initial date de 2014, à l’époque de Debian Wheezy, et repose sur une configuration réseau entièrement manuelle.

Les versions plus récentes de Debian utilisent généralement NetworkManager, qui permet de configurer le wifi directement en ligne de commande via l’outil nmcli.

Cette méthode est plus simple et mieux intégrée, mais reste moins adaptée aux serveurs très minimalistes ou aux installations sans NetworkManager.

  • Passer root :
su -
  • Vérifier que NetworkManager est installé :
nmcli --version

Si nécessaire :

apt-get update
apt-get install network-manager
systemctl restart NetworkManager
  • Identifier le nom de l’interface WiFi :

L’interface WiFi (souvent appelée interface WLAN) peut porter différents noms selon le matériel et la version de Debian.

Sur les systèmes récents, l’interface WiFi (souvent appelée interface WLAN) ne s’appelle plus toujours wlan0, mais peut porter différents noms comme wlp2s0, wlan1, etc. selon le matériel et la version de Debian.

nmcli device status

La colonne DEVICE indique le nom exact de l’interface à utiliser dans les commandes suivantes.

Dans les exemples ci-dessous, l’interface WiFi utilisée est wlp2s0.

  • Connexion wifi simple (DHCP) :
nmcli device wifi connect "NomDuReseau" password "MotDePasseWifi"
  • Connexion wifi avec IP fixe (ou IP statique) :
nmcli connection add type wifi ifname wlp2s0 con-name MaConnexion ssid NomDuReseau
nmcli connection modify MaConnexion wifi-sec.key-mgmt wpa-psk
nmcli connection modify MaConnexion wifi-sec.psk MotDePasseWifi
nmcli connection modify MaConnexion ipv4.method manual
nmcli connection modify MaConnexion ipv4.addresses 192.168.1.100/24
nmcli connection modify MaConnexion ipv4.gateway 192.168.1.1
nmcli connection modify MaConnexion ipv4.dns 192.168.1.1
nmcli connection up MaConnexion

Selon la configuration du point d’accès WiFi, la clé peut être utilisée en WPA2-PSK ou en WPA3-SAE. NetworkManager, comme wpa_supplicant, sélectionnent automatiquement le mode de sécurité compatible.

Sur un réseau configuré exclusivement en WPA3, il est possible de remplacer wpa-psk par sae pour forcer l’utilisation de WPA3.

La notation /24 correspond au masque de sous-réseau 255.255.255.0. Elle indique que les 24 premiers bits définissent le réseau, ce qui est le cas le plus courant sur un réseau domestique en 192.168.x.x.

  • Vérifier l’état de la connexion :
nmcli device status
nmcli connection show
  • Désactiver la connexion wifi pour une interface :
nmcli device disconnect wlp2s0

Le nom du périphérique est obtenu via la commande nmcli device status.

  • Désactiver le wifi globalement :
nmcli radio wifi off

Cette approche moderne complète efficacement la configuration traditionnelle basée sur wpa_supplicant.

Ressources et documentation

Pour écrire cet article, je me suis appuyé sur la documentation officielle :

En espérant que ce résumé vous fasse gagner du temps lors de vos prochaines installations Linux.