FR

Applications

Créer un réseau privé entre VM avec NAT sur Proxmox VE

Créer un pont privé sur Proxmox VE, relier les VM entre elles, leur donner un accès Internet sortant en NAT et publier un service, sans couper l'accès au serveur.

9 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Vos valeurs

Renseignez-les une fois, les commandes du guide se mettent à jour.

Ce guide crée un réseau privé sur un serveur Proxmox VE : vos machines virtuelles communiquent entre elles et accèdent à Internet en NAT, derrière l'adresse publique du serveur. Il explique aussi comment publier un service précis et comment créer un réseau totalement isolé.

Élément Valeur utilisée dans ce guide
Interface publique de l'hôte vmbr0 (installation par l'ISO)
Pont privé avec NAT vmbr1
Réseau privé 10.10.10.0/24
Passerelle des VM (l'hôte) 10.10.10.1
Première VM 10.10.10.10
Pont isolé, sans Internet vmbr2

Le trafic sortant des VM est réécrit par l'hôte et part avec son adresse IP. Depuis Internet, les VM ne sont pas joignables tant que vous ne créez pas de redirection de port.

Ce que ce guide ne couvre pas

Ce guide n'attribue pas d'adresse IP publique supplémentaire à une VM. Cette configuration dépend du réseau de l'hébergeur (adresses MAC virtuelles, routage, passerelle à utiliser). Pour ce besoin, contactez le support depuis votre espace client avant de modifier quoi que ce soit.

Le guide Configurer une IP Failover décrit l'ajout d'une adresse directement sur un système Linux. Il ne traite pas du raccordement d'une VM Proxmox.

Prérequis

  • Proxmox VE installé, par exemple avec le guide Installer et configurer Proxmox VE
  • Un accès root en SSH
  • Le KVM IP accessible depuis votre espace client
  • Une plage privée qui n'est pas déjà utilisée sur le serveur

Étape 1 : observer la configuration actuelle

Terminal
ip -br addr
ip route show default
cat /etc/network/interfaces

Repérez l'interface qui porte l'adresse publique et la route par défaut :

  • Sur une installation par l'ISO, il s'agit normalement de vmbr0.
  • Sur une installation au-dessus de Debian, il peut s'agir de la carte physique, par exemple eno1.

Dans la suite, remplacez vmbr0 par le nom réellement affiché si besoin. Une erreur à cet endroit empêche le NAT de fonctionner.

Étape 2 : se préparer à une erreur

Conservez une copie du fichier, puis programmez sa restauration automatique dans 10 minutes :

Terminal
cp /etc/network/interfaces /root/interfaces.avant-nat
systemd-run --on-active=10min --unit=net-rollback /bin/sh -c 'cp /root/interfaces.avant-nat /etc/network/interfaces && ifreload -a'

Si vous perdez l'accès, le fichier d'origine sera rétabli à l'échéance. Vous annulerez cette restauration à l'étape 4 si tout fonctionne.

Étape 3 : créer le pont privé avec NAT

Ouvrez le fichier :

Terminal
nano /etc/network/interfaces

Ajoutez ce bloc à la fin, sans toucher au reste :

Texte
auto vmbr1
iface vmbr1 inet static
        address 10.10.10.1/24
        bridge-ports none
        bridge-stp off
        bridge-fd 0
        post-up   echo 1 > /proc/sys/net/ipv4/ip_forward
        post-up   iptables -t nat -A POSTROUTING -s '10.10.10.0/24' -o vmbr0 -j MASQUERADE
        post-down iptables -t nat -D POSTROUTING -s '10.10.10.0/24' -o vmbr0 -j MASQUERADE
        post-up   iptables -t raw -I PREROUTING -i fwbr+ -j CT --zone 1
        post-down iptables -t raw -D PREROUTING -i fwbr+ -j CT --zone 1
Ligne Rôle
address 10.10.10.1/24 Adresse de l'hôte sur le réseau privé, qui sert de passerelle aux VM
bridge-ports none Le pont n'est relié à aucune carte physique
ip_forward Autorise l'hôte à router les paquets
MASQUERADE Remplace l'adresse privée des VM par l'adresse publique en sortie
CT --zone 1 Évite que le pare-feu bloque le trafic sortant des VM dont l'interface a l'option Firewall active

Étape 4 : appliquer et vérifier

Contrôlez la syntaxe, puis appliquez la configuration :

Terminal
ifreload -a -s
ifreload -a

Vérifiez le résultat :

Terminal
ip -br addr show vmbr1
cat /proc/sys/net/ipv4/ip_forward
iptables -t nat -S POSTROUTING

Vous devez voir vmbr1 avec 10.10.10.1/24, la valeur 1, et la règle MASQUERADE.

Depuis votre poste, ouvrez une nouvelle session SSH et rechargez l'interface web. Si les deux fonctionnent, annulez la restauration programmée :

Terminal
systemctl stop net-rollback.timer

Étape 5 : raccorder une VM

Dans VM → Hardware → Network Device → Edit, choisissez le Bridge vmbr1. En ligne de commande, affichez d'abord la configuration actuelle de l'interface :

Terminal
qm config 100 | grep ^net0

Reprenez ensuite la valeur affichée en ne changeant que bridge=, afin de conserver l'adresse MAC et les autres options :

Terminal
qm set 100 --net0 virtio=BC:24:11:00:00:01,bridge=vmbr1,firewall=1

Remplacez BC:24:11:00:00:01 par votre adresse, et retirez firewall=1 si cette option n'apparaissait pas.

Étape 6 : configurer le réseau dans la VM

Il n'y a pas de serveur DHCP sur ce réseau : attribuez une adresse fixe à chaque VM. Trouvez d'abord le nom de l'interface, souvent ens18 :

Terminal
ip -br link

Debian

Texte
auto ens18
iface ens18 inet static
        address 10.10.10.10/24
        gateway 10.10.10.1
Terminal
printf 'nameserver 1.1.1.1\nnameserver 9.9.9.9\n' > /etc/resolv.conf
systemctl restart networking

Ubuntu

YAML
network:
  version: 2
  ethernets:
    ens18:
      addresses:
        - 10.10.10.11/24
      routes:
        - to: default
          via: 10.10.10.1
      nameservers:
        addresses: [1.1.1.1, 9.9.9.9]
Terminal
chmod 600 /etc/netplan/60-prive.yaml
netplan try

netplan try annule le changement si vous ne le confirmez pas. Si une autre configuration netplan gère déjà cette interface, adaptez-la au lieu d'en ajouter une seconde.

Étape 7 : vérifier depuis la VM

Terminal
ip -br addr
ping -c 3 10.10.10.1
ping -c 3 10.10.10.11
ping -c 3 1.1.1.1
getent hosts deb.debian.org
curl -I https://deb.debian.org
Test Ce qu'il valide
Ping de 10.10.10.1 La VM est bien sur le pont privé
Ping d'une autre VM Les VM communiquent entre elles
Ping de 1.1.1.1 Le routage et le NAT fonctionnent
getent hosts La résolution DNS fonctionne
curl -I L'accès HTTPS sortant fonctionne

Publier un service d'une VM

Pour rendre un service accessible depuis Internet, redirigez un port de l'adresse publique vers la VM. Ajoutez ces lignes au bloc vmbr1, ici pour envoyer le port 8443 vers le port 443 de la VM :

Texte
        post-up   iptables -t nat -A PREROUTING -i vmbr0 -p tcp --dport 8443 -j DNAT --to-destination 10.10.10.10:443
        post-down iptables -t nat -D PREROUTING -i vmbr0 -p tcp --dport 8443 -j DNAT --to-destination 10.10.10.10:443

Pour un service d'administration, limitez la source avec -s VOTRE_IP :

Texte
        post-up   iptables -t nat -A PREROUTING -i vmbr0 -s VOTRE_IP -p tcp --dport 2222 -j DNAT --to-destination 10.10.10.10:22
        post-down iptables -t nat -D PREROUTING -i vmbr0 -s VOTRE_IP -p tcp --dport 2222 -j DNAT --to-destination 10.10.10.10:22

Reprenez ensuite les protections de l'étape 2, puis appliquez avec ifreload -a et contrôlez :

Terminal
iptables -t nat -S PREROUTING

Testez depuis une machine extérieure au serveur : une redirection PREROUTING ne s'applique pas aux connexions lancées depuis l'hôte lui-même.

Créer un réseau totalement isolé

Un second pont, sans adresse sur l'hôte et sans NAT, relie des VM sans leur donner d'accès à Internet. C'est utile pour une base de données ou un réseau de stockage entre VM.

Texte
auto vmbr2
iface vmbr2 inet manual
        bridge-ports none
        bridge-stp off
        bridge-fd 0

Appliquez avec ifreload -a, puis ajoutez à la VM une seconde interface :

Terminal
qm set 100 --net1 virtio,bridge=vmbr2

Attribuez dans chaque VM une adresse de type 10.20.20.10/24, sans passerelle.

Alternative : les zones SDN

Proxmox VE propose aussi des zones SDN dans Datacenter → SDN. Une zone Simple crée un pont isolé par nœud, peut activer le SNAT sur un sous-réseau et, avec dnsmasq, distribuer des adresses par DHCP. Consultez la documentation SDN si vous voulez gérer ces réseaux depuis l'interface web.

Mises à jour et sauvegarde

Les mises à jour de Proxmox VE ne nécessitent aucune action sur cette configuration. Après un redémarrage, vérifiez que le NAT est bien revenu :

Terminal
iptables -t nat -S POSTROUTING
cat /proc/sys/net/ipv4/ip_forward

/etc/network/interfaces n'est pas inclus dans les sauvegardes de VM. Copiez-le à l'extérieur du serveur avec le reste de la configuration de l'hôte. Pour les données des VM, consultez les guides Proxmox Backup Server.

En cas de problème

Plus d'accès SSH ni à l'interface web après une modification

Attendez la restauration automatique si elle est programmée. Sinon, ouvrez le KVM IP, connectez-vous en root et rétablissez le fichier :

Terminal
cp /root/interfaces.avant-nat /etc/network/interfaces
ifreload -a
ip -br addr
ip route show default

Si l'accès ne revient pas, contactez le support depuis votre espace client en indiquant les modifications effectuées.

ifreload signale une erreur

Relancez la vérification avec ifreload -a -s, puis contrôlez la ligne indiquée. Les erreurs fréquentes sont un pont déclaré deux fois, une adresse sans préfixe ou une ligne post-up placée hors du bloc vmbr1.

La VM ne joint pas 10.10.10.1

Terminal
qm config 100 | grep ^net
ip -br addr show vmbr1
bridge link show

Vérifiez que l'interface de la VM utilise vmbr1, que l'adresse est bien dans 10.10.10.0/24 et que le pare-feu de la VM n'est pas en cause.

La VM joint la passerelle, mais pas Internet

Terminal
cat /proc/sys/net/ipv4/ip_forward
iptables -t nat -L POSTROUTING -n -v
ip route show default
  • La valeur doit être 1.
  • L'interface après -o doit être celle de la route par défaut.
  • Les compteurs de la règle MASQUERADE doivent augmenter pendant un ping. Sinon, vérifiez la passerelle de la VM.

Le ping vers 1.1.1.1 fonctionne, mais pas les noms de domaine

Le DNS de la VM est absent ou incorrect. Contrôlez /etc/resolv.conf ou resolvectl status.

Les règles apparaissent en double

ifreload -a peut rejouer les lignes post-up. Listez les règles avec iptables -t nat -S, puis supprimez les doublons en reprenant la règle avec -D à la place de -A. C'est important après un changement de destination : l'ancienne redirection resterait active.

La redirection de port ne fonctionne pas

  • Le service écoute-t-il dans la VM ? Vérifiez avec ss -tlnp.
  • La passerelle de la VM est-elle bien 10.10.10.1 ?
  • Le pare-feu de la VM autorise-t-il le port ?
  • Testez-vous depuis l'extérieur du serveur ?
  • Le compteur de la règle augmente-t-il dans iptables -t nat -L PREROUTING -n -v ?

Le serveur perd le réseau quand une VM démarre

Une VM est probablement connectée à vmbr0. Depuis le KVM IP, arrêtez-la avec qm stop ID, déplacez son interface sur vmbr1, puis contactez le support si le réseau ne revient pas.

Références