{{tag>dev netadmin sysadmin réseau connexion }}


====== Gérer les connexions via nmcli et le service NetworkManager ======


**nmcli** signifie **N**etwork **M**anager **C**ommand **L**ine **I**nterface, c'est le client en ligne de commande qui permet de dialoguer avec le service (daemon) **NetworkManager** pour gérer le paramétrage des interfaces réseaux de l'hôte.

Pour vérifier l'état du service :

<code bash>
systemclt status NetworkManager
</code>


''nmcli'' fonctionne en espace utilisateur, il est particulièrement utile sur des postes nomades amenés à changer régulièrement de réseaux.

Avec ''nmcli'', l'utilisateur peut définir des "profils de connexion" qu'il peut ensuite associer aux périphériques réseaux.


===== Lister les périphériques et profils =====

Afficher les périphériques réseaux et leur statut
<code bash>
nmcli device status
</code>

Afficher les profils de connexion existants :
<code bash>
nmcli connection show
</code>


===== Modifier un profil =====

Les modifications des profils peuvent être faites en immédiat via les paramètres de la ligne de commande ou en utilisant le mode interactif :

<code bash>
# Modification directe d'un paramètre du profil "home"
nmcli connection modify home ipv4.ignore-auto-routes no

# Modification en immédiat de plusieurs paramètres
nmcli connection modify home ipv4.ignore-auto-dns no ipv4.dns-search "home.internal"
</code>

<code>
# Modification interactive du profil "home" 
nmcli connection edit home
</code>

<note>
Depuis le prompt on peut afficher l'aide (''help'') afficher les descriptions des propriétés (''describe''), leurs valeurs (''print'') et les modifier avec la syntaxe ''conf.propertie value''. On sauvegardera enfin les modification apportées (''save'')
</note>

Si le profil modifié était en cours d'utilisation, recharger le profil pour que les modifications apportées soient prises en compte :


<code bash>
# Recharge le profil "home-wifi" sur le périphérique réseau "wlp0s20f3"
nmcli connection up home-wifi ifname wlp0s20f3
</code>


==== Renommer un profil ====

La commande ci dessous renomme le profil "home" en "home-wifi" :

<code bash>
nmcli connection modify id home con-name home-wifi

# Equivalent
nmcli connection modify id home connection.id home-wifi
</code>


==== Ajouter des serveurs DNS ====

On peut vouloir compléter la liste des serveurs DNS fournie par le DHCP par exemple :

<code bash>
# Ajoute les DNS Google et Cloudflare au profil "home"
nmcli connection modify home +ipv4.dns "8.8.8.8 1.1.1.1"
</code>

==== Remplacer les serveurs DNS ====

Si on souhaite définir/remplacer les serveur DNS du profil "home":
<code bash>
nmcli connection modify home ipv4.ignore-auto-dns yes
nmcli connection modify home-wifi ipv4.dns "8.8.8.8 1.1.1.1"
</code>


==== Configurer des routes statiques ====

Pour définir des routes statiques sur le profil "home" :

<code bash>
# Atteindre le réseau 192.168.10.0/24 via la passerelle 10.10.10.1
nmcli connection modify home +ipv4.routes "192.168.10.0/24 10.10.10.1"
</code>



===== Les types de profils =====

:TODO_DOCUPDATE:

===== Ajouter des profils =====

:TODO_DOCUPDATE:


===== Connexions Wifi =====

==== État de l'interface ====

Vérifier l'état de l'interface matérielle :
<code bash>
nmcli radio wifi
</code>

==== Activer / désactiver l'interface ====

Pour activer l'interface matérielle Wifi 
<code bash>
# Activer l'interface wifi
nmcli radio wifi on

# Désactiver l'interface wifi
nmcli radio wifi off
</code>

==== Lister les réseaux à portée ====

<code bash>
nmcli device wifi rescan
nmcli device wifi list

# Equivalent
nmcli device wifi list --rescan yes

# N'afficher que les SSID
nmcli --fields SSID device wifi
</code>


==== Connexion à un réseau ====

<code bash>
nmcli --ask dev wifi connect aNetworkSSID
</code>

==== Vérifier l'état de la connexion ====

Pour vérifier l'état des interfaces et leur connexion associée :

<code bash>
nmcli device status

# équivalent
nmcli device
</code>


==== Déconnecter l'interface ====

Déconnecter l'interface nommée ''wifi0'' :
<code bash>
nmcli device down wifi0
</code>

===== Références =====

  * https://fr.linux-console.net/?p=16039
  * https://www.linuxtricks.fr/wiki/networkmanager-se-connecter-en-wi-fi-en-cli-avec-nmcli
  * https://sysreseau.net/networkmanager-nmcli-nmtui/
  * [[https://docs.redhat.com/fr/documentation/red_hat_enterprise_linux/7/html/networking_guide/sec-using_the_networkmanager_command_line_tool_nmcli|Usages de nmcli (docs.redhat.com)]]