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.
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
rooten 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
ip -br addr
ip route show default
cat /etc/network/interfacesRepé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 :
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 :
nano /etc/network/interfacesAjoutez ce bloc à la fin, sans toucher au reste :
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 :
ifreload -a -s
ifreload -aVérifiez le résultat :
ip -br addr show vmbr1
cat /proc/sys/net/ipv4/ip_forward
iptables -t nat -S POSTROUTINGVous 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 :
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 :
qm config 100 | grep ^net0Reprenez ensuite la valeur affichée en ne changeant que bridge=, afin de conserver l'adresse MAC et les autres options :
qm set 100 --net0 virtio=BC:24:11:00:00:01,bridge=vmbr1,firewall=1Remplacez 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 :
ip -br linkDebian
auto ens18
iface ens18 inet static
address 10.10.10.10/24
gateway 10.10.10.1printf 'nameserver 1.1.1.1\nnameserver 9.9.9.9\n' > /etc/resolv.conf
systemctl restart networkingUbuntu
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]chmod 600 /etc/netplan/60-prive.yaml
netplan trynetplan 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
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 :
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:443Pour un service d'administration, limitez la source avec -s VOTRE_IP :
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:22Reprenez ensuite les protections de l'étape 2, puis appliquez avec ifreload -a et contrôlez :
iptables -t nat -S PREROUTINGTestez 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.
auto vmbr2
iface vmbr2 inet manual
bridge-ports none
bridge-stp off
bridge-fd 0Appliquez avec ifreload -a, puis ajoutez à la VM une seconde interface :
qm set 100 --net1 virtio,bridge=vmbr2Attribuez 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 :
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 :
cp /root/interfaces.avant-nat /etc/network/interfaces
ifreload -a
ip -br addr
ip route show defaultSi 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
qm config 100 | grep ^net
ip -br addr show vmbr1
bridge link showVé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
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
-odoit être celle de la route par défaut. - Les compteurs de la règle
MASQUERADEdoivent augmenter pendant unping. 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.