# Configuration réseau sous Debian 13

## Configuration générale

Debian 13 (Trixie) utilise généralement ifupdown pour gérer la configuration réseau sur les installations serveur traditionnelles.

La configuration se fait principalement dans le fichier `/etc/network/interfaces`. Il est également possible de répartir les configurations dans plusieurs fichiers situés dans `/etc/network/interfaces.d/`.

Pour vérifier le nom des interfaces réseau :

```
ip link show
```

Pour afficher les adresses IP et les routes :

```
ip addr show
ip route show
ip -6 route show
```

Pour vérifier que le service réseau est actif :

```
systemctl status networking
```

### Application des modifications

Les interfaces peuvent être activées et désactivées avec `ifup` et `ifdown`.

Par exemple, pour appliquer une modification à l'interface `enp3s0` :

```
sudo ifdown enp3s0
sudo ifup enp3s0
```

Pour redémarrer l'ensemble du service réseau :

```
sudo systemctl restart networking
```

Attention : ces commandes peuvent interrompre une connexion SSH. Il est préférable de disposer d'un accès console ou hors bande avant de modifier la configuration réseau à distance.

## Usage courant

La configuration de base se trouve dans `/etc/network/interfaces`.

Voici un exemple de configuration classique :

```
# Interface loopback
auto lo
iface lo inet loopback

# Configuration réseau
allow-hotplug enp3s0
iface enp3s0 inet dhcp
```

La directive `allow-hotplug` permet d'activer l'interface lorsqu'elle est détectée par le système.

Pour une interface qui doit impérativement être activée au démarrage, on peut utiliser `auto` à la place.

### Configuration IPv4 statique

Exemple de configuration avec une adresse IPv4 statique :

```
auto enp3s0
iface enp3s0 inet static
    address 10.10.10.2/24
    gateway 10.10.10.1
    dns-nameservers 10.10.10.1 1.1.1.1
    dns-search mydomain otherdomain
```

Les directives principales :

<div id="bkmrk-address-%3A-adresse-ip"><div><div>

- `address` : adresse IP et masque de sous-réseau (notation CIDR).
- `gateway` : passerelle par défaut.
- `dns-nameservers` : serveurs DNS.
- `dns-search` : domaines de recherche DNS.

</div></div></div>Attention concernant le DNS : les directives <code>dns&#45;nameservers</code> et <code>dns&#45;search</code> nécessitent généralement le paquet <code>resolvconf</code> pour être prises en compte par ifupdown. Sans celui-ci, il faut gérer <code>&#47;etc&#47;resolv&#46;conf</code> avec le gestionnaire DNS utilisé sur le système.

Installation éventuelle :

```
sudo apt install resolvconf
```

### Configuration IPv4 via DHCP et IPv6 statique

Exemple avec une adresse IPv4 obtenue par DHCP et une adresse IPv6 statique :

```
auto enp3s0
iface enp3s0 inet dhcp

iface enp3s0 inet6 static
    address 2a01:9093:fd2e:5a0e:7714:59ce:0f8a:4/64
    gateway fe80::7e2b:1302:814a:ea68
```

La configuration IPv4 et IPv6 peut être définie indépendamment sur une même interface.

Dans cet exemple, la passerelle IPv6 utilise une adresse link-local (`fe80::`). Ce type d'adresse est limité au lien réseau local et nécessite que la passerelle soit accessible sur l'interface concernée.

Pour consulter les routes IPv6 :

```
ip -6 route show
```

<div id="bkmrk-"><div><div><div></div><div>  
</div></div></div></div>## Usage avancé

### LACP (Link Aggregation)

Il est possible de regrouper plusieurs interfaces physiques dans une interface logique grâce au mécanisme de bonding du noyau Linux.

Pour utiliser le bonding avec ifupdown, installer le paquet `ifenslave` :

```
sudo apt install ifenslave
```

Exemple de configuration pour agréger deux interfaces physiques (`eno1` et `eno2`) en utilisant LACP :

```
auto eno1
iface eno1 inet manual

auto eno2
iface eno2 inet manual

auto bond0
iface bond0 inet static
    address 192.168.2.2/24
    gateway 192.168.2.1

    bond-slaves eno1 eno2
    bond-mode 802.3ad
    bond-miimon 100
    bond-lacp-rate 1
    bond-xmit-hash-policy layer3+4

    dns-nameservers 8.8.8.8 9.9.9.9
```

#### Paramètres du bond

<div id="bkmrk-bond-slaves-eno1-eno"><div><div>

- `bond-slaves eno1 eno2` : définit les interfaces physiques qui constituent le bond.
- `bond-mode 802.3ad` : active le mode d'agrégation LACP, conforme à la norme IEEE 802.3ad.
- `bond-miimon 100` : vérifie l'état des interfaces membres toutes les 100 ms. Une interface défaillante est retirée du bond.
- `bond-lacp-rate 1` : demande une émission rapide des paquets LACP (intervalle nominal d'une seconde).
- `bond-xmit-hash-policy layer3+4` : utilise les adresses IP et les ports TCP/UDP pour déterminer la répartition du trafic entre les interfaces.

</div></div></div>Attention : le commutateur réseau doit également être configuré pour utiliser LACP sur les ports concernés (généralement dans un même agrégat ou port-channel).

Pour vérifier l'état du bond :

```
cat /proc/net/bonding/bond0
```

On y retrouve notamment le mode d'agrégation, l'état des interfaces membres et l'état de la négociation LACP.

### VLAN

#### Prérequis

Pour gérer les VLAN 802.1Q avec ifupdown, installer le paquet `vlan` :

```
sudo apt install vlan
```

Le module noyau `8021q` est généralement chargé automatiquement lorsque nécessaire.

Pour vérifier s'il est chargé :

```
lsmod | grep 8021q
```

Pour le charger manuellement :

```
sudo modprobe 8021q
```

Pour le charger automatiquement au démarrage :

```
echo '8021q' | sudo tee -a /etc/modules
```

#### Exemples de configurations

Exemple de configuration d'une interface physique et d'une interface VLAN :

```
auto enp3s0
iface enp3s0 inet manual

auto enp3s0.10
iface enp3s0.10 inet static
    address 192.168.10.2/24
    vlan-raw-device enp3s0
```

Dans cet exemple :

<div id="bkmrk-enp3s0-est-l%27interfa"><div><div>

- `enp3s0` est l'interface physique.
- `enp3s0.10` est l'interface virtuelle associée au VLAN 10.
- `vlan-raw-device` indique l'interface physique sur laquelle les trames VLAN sont transportées.

</div></div></div>Il est également possible de configurer une interface VLAN avec DHCP :

```
auto enp3s0.20
iface enp3s0.20 inet dhcp
    vlan-raw-device enp3s0
```

Remarque : le nommage `interface.VLAN_ID` est une convention courante sous Linux. Il est également possible d'utiliser d'autres noms d'interfaces.

### VLAN sur un bond LACP

Il est possible de combiner le bonding et les VLAN. Dans ce cas, les VLAN sont créés sur l'interface logique `bond0`, et non directement sur les interfaces physiques.

Exemple avec un bond LACP et un VLAN 10 :

```
auto eno1
iface eno1 inet manual

auto eno2
iface eno2 inet manual

auto bond0
iface bond0 inet manual
    bond-slaves eno1 eno2
    bond-mode 802.3ad
    bond-miimon 100
    bond-lacp-rate 1
    bond-xmit-hash-policy layer3+4

auto bond0.10
iface bond0.10 inet static
    address 192.168.10.2/24
    gateway 192.168.10.1
    vlan-raw-device bond0
```

Cette configuration permet de transporter plusieurs VLAN sur un même agrégat réseau.

Le commutateur doit être configuré en conséquence :

<div id="bkmrk-les-ports-physiques-"><div><div>

- Les ports physiques doivent appartenir au même agrégat LACP.
- Le port-channel doit être configuré en trunk.
- Les VLAN nécessaires doivent être autorisés sur ce trunk.

<div>  
</div></div></div></div>## Outils de diagnostic

Quelques commandes utiles pour diagnostiquer la configuration réseau :

<div id="bkmrk-commande-description"><div><div><div><div><table><tbody><tr><th>Commande

</th><th>Description

</th></tr><tr><td><code>ip link show</code>

</td><td>Liste les interfaces réseau

</td></tr><tr><td><code>ip addr show</code>

</td><td>Affiche les adresses IP

</td></tr><tr><td><code>ip route show</code>

</td><td>Affiche les routes IPv4

</td></tr><tr><td><code>ip &#45;6 route show</code>

</td><td>Affiche les routes IPv6

</td></tr><tr><td><code>ip &#45;d link show</code>

</td><td>Affiche les détails des interfaces VLAN et bonds

</td></tr><tr><td><code>bridge vlan show</code>

</td><td>Affiche les VLAN configurés sur les bridges

</td></tr><tr><td><code>cat &#47;proc&#47;net&#47;bonding&#47;bond0</code>

</td><td>Affiche l'état du bond

</td></tr><tr><td><code>ethtool enp3s0</code>

</td><td>Affiche les informations de liaison Ethernet

</td></tr><tr><td><code>journalctl &#45;u networking</code>

</td><td>Consulte les journaux du service réseau

</td></tr></tbody></table>

</div></div></div></div></div>Pour vérifier les interfaces configurées par ifupdown :

```
ifquery --list
```

Pour afficher la configuration d'une interface :

```
ifquery enp3s0
```

<div id="bkmrk--1"><div><div><div></div><div>  
</div></div></div></div>## Remarques

Debian propose plusieurs gestionnaires réseau. Il est important de ne pas faire gérer une même interface simultanément par plusieurs gestionnaires.

<div id="bkmrk-gestionnaire-configu"><div><div><div><div><table><tbody><tr><th>Gestionnaire

</th><th>Configuration

</th></tr><tr><td>ifupdown

</td><td><code>&#47;etc&#47;network&#47;interfaces</code>

</td></tr><tr><td>systemd-networkd

</td><td><code>&#47;etc&#47;systemd&#47;network&#47;</code>

</td></tr><tr><td>NetworkManager

</td><td><code>&#47;etc&#47;NetworkManager&#47;</code>

</td></tr><tr><td>Netplan

</td><td><code>&#47;etc&#47;netplan&#47;</code>

</td></tr></tbody></table>

</div></div></div></div></div>Sur Debian 13, Netplan peut notamment être présent sur certaines images cloud. NetworkManager est également courant sur les installations Desktop. Les exemples de cette page concernent exclusivement ifupdown.

Pour davantage d'informations :

<div id="bkmrk-documentation-debian"><div><div>

- [Documentation Debian – Configuration réseau](https://wiki.debian.org/fr/NetworkConfiguration?utm_source=chatgpt.com).
- [Manuel interfaces(5) – ifupdown](https://manpages.debian.org/trixie/ifupdown/interfaces.5.en.html?utm_source=chatgpt.com).
- [Documentation Debian – Bonding](https://wiki.debian.org/Bonding?utm_source=chatgpt.com).
- [Documentation du noyau Linux – Ethernet Bonding](https://docs.kernel.org/networking/bonding.html?utm_source=chatgpt.com).

<div>  
</div></div></div></div>Note technique : contrairement à Netplan, ifupdown utilise une syntaxe déclarative proche de celle d'un fichier INI, avec des blocs <code>iface</code> et des directives indentées. Il n'y a donc pas de commande équivalente à <code>netplan apply</code> : les interfaces doivent être activées ou désactivées pour prendre en compte les changements.