Comment configurer une IP supplémentaire sur son VPS ?

Contexte

Par défaut, chaque VPS Winheberg dispose d'une adresse IPv4. Si votre projet a besoin de plusieurs adresses, par exemple pour isoler plusieurs services, gérer des certificats TLS distincts ou séparer du trafic, vous pouvez commander une ou plusieurs IP supplémentaires depuis votre espace client.

Sur nos VPS, une IP supplémentaire est ajoutée dans le même réseau que votre IP principale, en /25 pour l'IPv4 et en /64 pour l'IPv6. Contrairement à une adresse totalement isolée, elle n'a pas besoin de passerelle dédiée ni de règle de routage particulière, la route par défaut déjà présente sur votre VPS suffit pour qu'elle réponde correctement depuis l'extérieur. Il vous suffit donc d'ajouter l'adresse sur votre interface réseau existante.

Le symptôme typique d'une IP ajoutée avec un mauvais préfixe, ou pas ajoutée du tout, est une absence de réponse au ping depuis l'extérieur.

$ ping 82.153.202.X
Request timeout for icmp_seq 0
Request timeout for icmp_seq 1
Request timeout for icmp_seq 2

Prérequis

• Un VPS Winheberg en service avec un accès root en SSH
• Une IP supplémentaire déjà commandée sur votre produit et visible dans la section IP Address de votre espace client
• L'accès à votre espace client sur https://billing.winheberg.com
• Une sauvegarde récente de votre VPS

1. Récupérer les paramètres de votre IP supplémentaire

Une IP supplémentaire se commande depuis votre espace client, sur la page du produit concerné, via les Options de mise à niveau ou de rétrogradation. Une fois l'adresse provisionnée, elle apparaît dans la section IP Address de votre page de produit. Notez cette valeur, les exemples de ce guide utilisent des adresses de démonstration.

2. Identifier la méthode adaptée à votre VPS

La persistance au redémarrage ne dépend pas de la distribution en tant que telle, mais de l'outil qui gère votre réseau. Le tableau ci-dessous résume le sous-onglet à suivre.

En cas de doute sur l'outil actif, les commandes ci-dessous vous renseignent, dans cet ordre de priorité.

# netplan présent ?
ls /etc/netplan/ 2>/dev/null

# NetworkManager actif ?
systemctl is-active NetworkManager 2>/dev/null

# Alpine ?
cat /etc/alpine-release 2>/dev/null

Si aucune des trois commandes ne renvoie de résultat positif mais que systemctl fonctionne, votre système utilise systemd seul, c'est le cas de Debian 11 sur nos images.

3. Configurer l'IP supplémentaire

Un script automatique est en préparation, il détectera votre outil réseau et proposera un menu pour ajouter ou retirer une IP supplémentaire, en IPv4 comme en IPv6, sans jamais toucher à votre IP principale. En attendant sa mise à disposition, suivez la configuration manuelle ci-dessous, elle applique exactement les méthodes que le script automatisera une fois publié.

Script automatique (bientôt disponible)

Nous préparons un script qui détecte automatiquement votre outil réseau et applique la bonne configuration via un menu, avec gestion de la persistance au redémarrage. Cette section sera complétée dès sa mise à disposition.

Configuration manuelle

Choisissez la méthode adaptée à votre outil réseau. Chaque onglet couvre à la fois l'IPv4 et l'IPv6, et se contente d'ajouter l'adresse sur l'interface existante, dans le même réseau que votre IP principale, sans passerelle ni table de routage dédiée. Si vous n'avez besoin que d'une seule famille d'adresse, ne reprenez que la ligne correspondante.

network:
  version: 2
  ethernets:
    eth0:
      addresses:
        - 82.153.202.X/25
        - "2001:db8:1::X/64"

sudo chmod 600 /etc/netplan/70-additional.yaml

sudo netplan try
sudo netplan apply

ip -br link

sudo tee /etc/NetworkManager/dispatcher.d/50-additional-ip << 'EOF'
#!/bin/sh
[ "$1" = "eth0" ] || exit 0
case "$2" in up|dhcp4-change|dhcp6-change|connectivity-change) ;; *) exit 0 ;; esac
ip addr replace 82.153.202.X/25 dev eth0
ip -6 addr replace 2001:db8:1::X/64 dev eth0
EOF
sudo chmod +x /etc/NetworkManager/dispatcher.d/50-additional-ip

sudo ip addr replace 82.153.202.X/25 dev eth0
sudo ip -6 addr replace 2001:db8:1::X/64 dev eth0

sudo tee /usr/local/sbin/winheberg-additional-ip-apply.sh << 'EOF'
#!/bin/sh
ip addr replace 82.153.202.X/25 dev eth0
ip -6 addr replace 2001:db8:1::X/64 dev eth0
EOF
sudo chmod +x /usr/local/sbin/winheberg-additional-ip-apply.sh

sudo tee /etc/systemd/system/winheberg-additional-ip.service << 'EOF'
[Unit]
Description=Winheberg - IP supplementaire
After=network-online.target
Wants=network-online.target

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/usr/local/sbin/winheberg-additional-ip-apply.sh

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable winheberg-additional-ip.service
sudo ip addr replace 82.153.202.X/25 dev eth0
sudo ip -6 addr replace 2001:db8:1::X/64 dev eth0

apk add iproute2

cat > /etc/local.d/additional-ip.start << 'EOF'
#!/bin/sh
ip addr replace 82.153.202.X/25 dev eth0
ip -6 addr replace 2001:db8:1::X/64 dev eth0
EOF
chmod +x /etc/local.d/additional-ip.start

rc-update add local default
rc-service local start

4. Vérifier que l'IP répond

Contrôlez que l'adresse est bien présente sur l'interface.

ip -br addr show eth0

Vous devez voir votre IP supplémentaire dans la liste des adresses, avec le bon préfixe (/25 en IPv4, /64 en IPv6). Depuis une autre machine, un ping vers l'IP supplémentaire doit maintenant répondre.

ping 82.153.202.X
ping -6 2001:db8:1::X

En cas de problème

❌ L'IP supplémentaire ne répond pas au ping

• Vérifiez que l'adresse apparaît bien dans ip -br addr show eth0 avec le bon préfixe
• Assurez-vous de ne pas avoir utilisé un préfixe /32 ou /128 par erreur, l'IP supplémentaire doit rester dans le même réseau que votre IP principale, en /25 pour l'IPv4 et /64 pour l'IPv6
• Contrôlez que votre pare-feu (ufw, firewalld ou iptables) n'interdit pas le trafic ICMP ou les services concernés sur la nouvelle adresse
• Confirmez que l'interface visée est la bonne, eth0 sur certaines images, ens3 ou autre sur d'autres
• Comparez l'adresse configurée avec la valeur exacte affichée dans la section IP Address

❌ La configuration disparaît après un redémarrage

• netplan, le fichier doit se trouver dans /etc/netplan/ avec l'extension .yaml
• NetworkManager, le script dispatcher doit exister dans /etc/NetworkManager/dispatcher.d/ et être exécutable, vérifiez avec ls -l
• Debian 11, le service doit être activé, vérifiez avec systemctl is-enabled winheberg-additional-ip.service et systemctl status winheberg-additional-ip.service
• Alpine, contrôlez que rc-update add local default a été exécuté et que le script .start est bien exécutable

❌ L'IP répond mais certains services distants la rejettent

• Vérifiez que le service écoute bien sur cette adresse et pas uniquement sur l'IP principale, notamment si votre application se bind sur une adresse précise
• Contrôlez qu'aucune règle de pare-feu ne cible spécifiquement l'IP principale et exclut de fait la nouvelle adresse

Bonnes pratiques

• Le script automatique appliquera exactement les méthodes décrites dans ce guide une fois disponible, il gèrera la détection de votre outil réseau à votre place
• Sur les systèmes netplan (Debian 12+ et Ubuntu), testez avec netplan try, il restaure la configuration précédente si vous perdez l'accès
• Gardez vos changements additifs et ne modifiez jamais la configuration de l'IP principale
• Respectez toujours le préfixe fourni, /25 en IPv4 et /64 en IPv6, un préfixe /32 ou /128 isolerait l'adresse et l'empêcherait de répondre correctement
• Documentez pour chaque IP supplémentaire son adresse et la méthode utilisée pour l'appliquer
• Vérifiez votre pare-feu après l'ajout et ouvrez uniquement les services voulus sur la nouvelle adresse
• Sauvegardez vos fichiers de configuration réseau avant toute modification

Besoin d'aide ?

Pour commander une IP supplémentaire, rendez-vous sur la page du produit concerné dans votre espace client https://billing.winheberg.com et utilisez les Options de mise à niveau ou de rétrogradation. L'adresse attribuée apparaît ensuite dans la section IP Address de la page du produit.

Si votre IP supplémentaire ne répond toujours pas après configuration, ouvrez un ticket auprès de notre support. Choisissez le département Technique et renseignez le champ Produit lié avec le VPS concerné. Précisez l'adresse configurée, l'outil réseau utilisé et le résultat des commandes de vérification, cela permet à notre équipe de diagnostiquer plus vite.

Votre VPS peut désormais exposer plusieurs adresses proprement, chacune ajoutée sur le même réseau que votre IP principale 🐧