Changer l’adresse du serveur
Si votre hébergeur a remplacé l’adresse IPv4 publique du serveur, vous pouvez faire basculer le panneau BeAdmin sur la nouvelle adresse avec une seule commande, beadmin newip, dans la console web du serveur. La commande reconfigure le réseau du système d’exploitation et vérifie la connexion, puis le panneau reporte sur la nouvelle adresse le VPN, les sites servis par adresse IP et son propre certificat SSL. Ce que le panneau ne peut pas corriger (les configurations des utilisateurs VPN et les enregistrements DNS), il le liste dans une notification à votre prochaine connexion.
Quand cette commande est nécessaire
L’hébergeur a remplacé l’adresse IPv4 publique du serveur et le panneau ne s’ouvre plus : les paramètres réseau du système d’exploitation contiennent toujours l’ancienne adresse. La connexion SSH à l’ancienne adresse échoue elle aussi. Vous lancez donc la commande dans la console web du serveur, que votre hébergeur met à disposition dans son espace client.
Ce qu’il vous faut
- La nouvelle adresse IPv4 publique du serveur et l’adresse de la passerelle. Votre hébergeur les indique dans votre espace client. La commande refuse une adresse privée.
- L’accès à la console web du serveur dans l’espace client de votre hébergeur, et les droits
root. - Debian 13, Ubuntu 24.04 ou Ubuntu 26.04, avec l’adresse du serveur définie de façon statique dans netplan (fichiers
/etc/netplan/*.yaml) ou dans ifupdown (/etc/network/interfaceset le répertoire/etc/network/interfaces.d/). Si le serveur obtient son adresse automatiquement ou si les paramètres se trouvent ailleurs, la commande ne les trouve pas : changez alors l’adresse manuellement.
Étape 1. Ouvrez la console web
Ouvrez la console web du serveur dans l’espace client de votre hébergeur et connectez-vous en tant que root. Si vous vous connectez avec un utilisateur ordinaire disposant des droits sudo, faites précéder la commande de sudo.
Étape 2. Lancez la commande
Lancez la commande avec la nouvelle adresse IPv4 du serveur :
beadmin newip 130.17.10.145La commande trouve l’adresse statique du serveur dans les paramètres réseau, affiche ce qu’elle s’apprête à modifier, puis demande la passerelle :
Current address: 213.239.156.37/24, gateway 213.239.156.1
New address: 130.17.10.145/24
Gateway [130.17.10.1]:La première ligne indique l’adresse et la passerelle actuelles tirées des paramètres réseau, la deuxième la nouvelle adresse. Le masque réseau reste le même (/24 dans l’exemple) : la commande ne le modifie pas.
Étape 3. Confirmez la passerelle
Entre crochets, la commande propose une passerelle par défaut, la première adresse du sous-réseau de la nouvelle adresse. Comparez-la avec la passerelle indiquée dans l’espace client de votre hébergeur :
- elle est identique : appuyez sur Entrée ;
- elle diffère : saisissez la passerelle de votre hébergeur, puis appuyez sur Entrée.
Si la valeur saisie ne ressemble pas à une adresse IPv4, la commande redemande la passerelle. Tant que vous n’avez pas confirmé la passerelle, la commande ne modifie rien.
Ce qui se passe après la saisie de la passerelle
À partir de là, la commande travaille sans votre intervention. Elle enregistre des copies des fichiers qu’elle modifie, inscrit la nouvelle adresse et la passerelle dans les paramètres réseau, les applique et vérifie que le serveur est bien connecté au réseau. Elle redémarre ensuite le panneau et attend qu’il ait reporté sur la nouvelle adresse tout ce qu’il conservait sous l’ancienne. Le résultat ressemble à ceci :
✓ Network reconfigured, connection is up
✓ VPN, sites and the panel certificate now use the new address
! Some modules need your attention: https://130.17.10.145:8080Le réseau du système d’exploitation
La ligne Network reconfigured, connection is up signifie que le serveur fonctionne sur la nouvelle adresse. Dans les paramètres réseau, seuls l’adresse et la passerelle de l’interface par laquelle passe la route par défaut changent ; l’IPv6 et les serveurs DNS restent tels quels.
Si les paramètres réseau se trouvent dans un fichier 50-cloud-init.yaml créé par cloud-init, la commande crée en plus le fichier /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg contenant network: {config: disabled}. Sans lui, cloud-init réécrirait l’ancienne adresse après un redémarrage. Si ce fichier existe déjà, la commande n’y touche pas.
VPN, sites et certificat du panneau
La ligne VPN, sites and the panel certificate now use the new address signifie que le panneau a redémarré et qu’il a reporté sur la nouvelle adresse :
- le paramètre « Adresse du serveur » des modules VPN, si l’ancienne adresse IP y figure. Un domaine ou une autre adresse saisie par vous reste inchangé ;
- le champ « Adresse du panneau » dans les paramètres de récupération du mot de passe, si l’ancienne adresse IP y figure. Un domaine reste inchangé ;
- les sites servis par l’adresse IP du serveur : l’adresse du site, l’hôte virtuel et, pour WordPress, les adresses de ses paramètres, si elles contiennent l’ancienne adresse IP ;
- le certificat SSL du panneau : le panneau demande un certificat pour la nouvelle adresse et supprime celui de l’ancienne.
L’adresse de connexion au panneau
La dernière ligne contient l’adresse à laquelle le panneau s’ouvre désormais. Le port qui s’y trouve est celui du panneau, 8080 par défaut. Le signe ! signifie qu’après la connexion, une liste de ce qu’il reste à faire manuellement vous attend.
Étape 4. Connectez-vous au panneau
Ouvrez l’adresse de la dernière ligne de la sortie de la commande et connectez-vous comme d’habitude. Un administrateur voit la notification « Adresse du serveur modifiée. Certains modules nécessitent votre attention. » Cliquez sur « Détails » pour ouvrir la fenêtre qui liste ce qu’il reste à faire manuellement.
Exemple de fenêtre :
Adresse du serveur modifiée : 213.239.156.37 → 130.17.10.145
Le VPN, les sites et le certificat du panneau utilisent déjà la nouvelle adresse.
Reste à faire manuellement :
1. Transmettez de nouvelles configurations à vos utilisateurs VPN : les
anciennes pointent encore vers l’ancienne adresse et ne permettent
pas de se connecter.
Mimicry — 7 utilisateurs, WireGuard — 3 utilisateurs.
2. Générez de nouveaux liens pour les nœuds d’entrée de vos cascades
et transmettez-les aux serveurs de ces nœuds d’entrée.
Amnezia — 2 utilisateurs en mode nœud de sortie.
3. Faites pointer les enregistrements A de example.com, shop.example.com
vers 130.17.10.145.
4. Remplacez l’ancienne adresse par la nouvelle dans l’enregistrement SPF
de example.com et demandez à votre hébergeur de définir un
enregistrement PTR pour 130.17.10.145.La fenêtre ne contient que les points qui concernent votre serveur, et la numérotation se suit. La liste est reconstruite à chaque connexion : le point sur les enregistrements A disparaît donc dès que les domaines pointent vers la nouvelle adresse.
⚠️ Ne fermez la notification qu’une fois la liste traitée
La notification reste à l’écran tant que vous ne la fermez pas avec la croix. Une fois fermée, le panneau ne l’affiche plus, ni à vous ni aux autres administrateurs, et il est impossible de retrouver la liste dans le panneau. Les utilisateurs ayant un autre rôle ne voient pas la notification.
Ce qu’il reste à faire manuellement
Le panneau ne peut pas corriger ce qui est stocké en dehors de lui : chez vos utilisateurs VPN, sur d’autres serveurs et dans le DNS. La fenêtre « Détails » ne liste que ce qui concerne votre serveur.
Transmettez de nouvelles configurations aux utilisateurs VPN
Les configurations, liens et codes QR que vous avez distribués auparavant contiennent l’ancienne adresse du serveur et ne permettent plus de se connecter. Les nouvelles configurations, liens et codes QR du module contiennent déjà la nouvelle adresse si le paramètre « Adresse du serveur » est réglé sur « Automatique » ou contenait l’ancienne adresse IP. Transmettez-les à nouveau aux utilisateurs. La fenêtre indique quels modules et combien d’utilisateurs sont concernés.
💡 Un domaine plutôt qu’une adresse IP
Si le paramètre « Adresse du serveur » d’un module est réglé sur « Adresse personnalisée » avec un domaine, inutile de redistribuer les configurations de ses utilisateurs : faites pointer l’enregistrement A de ce domaine vers la nouvelle adresse. La fenêtre « Détails » liste malgré tout les utilisateurs d’un tel module, et elle n’affiche pas l’enregistrement A d’un domaine absent de « Sites et domaines » : vérifiez-le vous-même. Avec un domaine plutôt qu’une adresse IP, les configurations survivent aussi au prochain changement d’adresse.
Générez de nouveaux liens pour les nœuds d’entrée
Le mode cascade est un mode du module VPN dans lequel le trafic traverse une chaîne de serveurs. Si ce serveur y joue le rôle de nœud de sortie, les nœuds d’entrée situés sur d’autres serveurs l’atteignent par l’ancienne adresse. La fenêtre indique les modules et le nombre d’utilisateurs en mode nœud de sortie. Générez de nouveaux liens pour les nœuds d’entrée et transmettez-les aux serveurs de ces nœuds d’entrée.
Faites pointer les enregistrements A vers la nouvelle adresse
Les domaines de « Sites et domaines » dont les enregistrements A pointent vers l’ancienne adresse ne mènent plus à ce serveur. Indiquez la nouvelle adresse dans les enregistrements A de ces domaines chez votre registraire ou dans le service qui gère la zone DNS du domaine. La création d’un enregistrement A est décrite dans l’article Configurer les enregistrements DNS de la messagerie.
Mettez à jour le SPF et demandez un enregistrement PTR
Si le module de messagerie est installé sur le serveur, la fenêtre vous invite à corriger les enregistrements DNS des domaines de messagerie :
- Dans l’enregistrement SPF de chaque domaine, remplacez l’ancienne adresse par la nouvelle : à la place de
ip4:213.239.156.37doit figurerip4:130.17.10.145. - Demandez à votre hébergeur de créer un enregistrement PTR pour la nouvelle adresse : il se rattache à l’adresse IP, et seul l’hébergeur peut donc le créer.
Vous pouvez vérifier le résultat dans la boîte de dialogue « DNS de messagerie » du domaine, dans « Sites et domaines ».
Si la commande échoue
Aucune connexion sur la nouvelle adresse
✗ No connection on the new address — previous network settings restored.
Check the address and gateway with your hosting provider and run the command again.Le serveur n’a pas retrouvé le réseau avec la nouvelle adresse, et la commande a rétabli les paramètres réseau précédents. Le panneau et ses paramètres n’ont pas été modifiés.
Une ligne newip: … indiquant la cause peut figurer au-dessus du message : the gateway … does not answer signifie que la passerelle ne répond pas ; nothing outside answers signifie que la passerelle répond, mais que les adresses extérieures sont injoignables. Comparez l’adresse et la passerelle avec les informations de votre hébergeur, puis relancez la commande. La commande conserve le masque réseau actuel : si la nouvelle adresse en a un autre, changez l’adresse manuellement.
Les anciens paramètres n’ont pas pu être rétablis
✗ No connection on the new address, and the previous network settings couldn't be restored.
Restore the files manually from /var/lib/beadmin/newip-backup/1762958412/Le serveur reste sans connexion. Le répertoire indiqué dans le message contient des copies des fichiers modifiés par la commande ; l’arborescence du système y est reproduite, par exemple etc/netplan/50-cloud-init.yaml. Recopiez les fichiers à leur place en utilisant le chemin de votre message :
cp -a /var/lib/beadmin/newip-backup/1762958412/etc/. /etc/Appliquez ensuite les paramètres : netplan apply pour netplan ou systemctl restart networking pour ifupdown. Une fois la connexion rétablie, comparez l’adresse et la passerelle avec les informations de votre hébergeur, puis relancez la commande.
Le panneau n’a pas terminé le basculement
✗ The network is up, but the panel didn't finish moving to the new address.
See the panel log: journalctl -u beadminLe réseau fonctionne déjà sur la nouvelle adresse, mais le panneau n’a pas reporté tout ce qu’il conservait sous l’ancienne. Relancez la même commande avec la même adresse :
beadmin newip 130.17.10.145La commande ne demande pas la passerelle et ne modifie pas le réseau : elle ne répète que le basculement du panneau. En cas de succès, elle affiche les lignes relatives au VPN avec les sites et à l’adresse du panneau :
✓ VPN, sites and the panel certificate now use the new address
! Some modules need your attention: https://130.17.10.145:8080Si le panneau s’ouvre, la fenêtre « Détails » signale elle aussi le basculement inachevé : « Le passage à la nouvelle adresse n’est pas terminé. Relancez beadmin newip 130.17.10.145 dans la console du serveur. » Si la seconde exécution se termine par la même erreur, cherchez la cause dans le journal du panneau : journalctl -u beadmin. Une ligne newip: … indiquant la cause peut figurer au-dessus du message.
Configuration réseau introuvable
✗ Couldn't find the network configuration. Supported: netplan and /etc/network/interfaces.
Change the address manually — see the documentation.La commande n’a rien modifié. Elle cherche l’adresse IPv4 statique du serveur dans netplan et dans /etc/network/interfaces ; si l’adresse est obtenue automatiquement ou si les paramètres se trouvent ailleurs, elle ne les trouve pas. Changez l’adresse manuellement : la fin de cette section explique comment faire basculer ensuite le panneau.
Le panneau contient plusieurs anciennes adresses
✗ The panel uses several old addresses: 213.239.156.37, 198.51.100.7.
Fix the panel address and the sites opened by IP manually.Les anciennes adresses du champ « Adresse du panneau » et celles des sites servis par adresse IP diffèrent. La commande ne peut pas choisir laquelle remplacer et ne modifie rien. Indiquez manuellement la nouvelle adresse dans le champ « Adresse du panneau » des paramètres de récupération du mot de passe, et corrigez l’adresse des sites servis par adresse IP.
La commande refuse de démarrer
Dans ces cas, la commande ne modifie rien :
| Message | Que faire |
|---|---|
✗ Run the command as root: sudo beadmin newip 130.17.10.145 | La commande n’a pas été lancée en tant que root. Relancez-la avec sudo, comme l’indique le message. |
Usage: beadmin newip <new IPv4 address> | L’adresse est absente, ou plusieurs valeurs ont été indiquées. Indiquez une seule nouvelle adresse IPv4. |
✗ 130.17.10 isn't an IPv4 address. | L’adresse est mal écrite : une adresse IPv4 se compose de quatre nombres séparés par des points. |
✗ 10.0.0.5 is a private address. Enter the public address from your hosting provider. | Une adresse privée a été saisie. Indiquez l’adresse publique attribuée par votre hébergeur. |
The server already uses 130.17.10.145 — nothing to change. | Le réseau fonctionne déjà sur cette adresse et le panneau ne conserve aucune autre adresse : il n’y a rien à faire basculer. Comparez l’adresse avec les informations de votre hébergeur. |
✗ No gateway entered — nothing changed. | Aucune passerelle n’a été saisie. Relancez la commande et indiquez la passerelle. |
Changer l’adresse manuellement
Si la commande ne trouve pas les paramètres réseau, changez l’adresse manuellement. C’est le cas lorsque le serveur obtient son adresse automatiquement, ou que le réseau est configuré par systemd-networkd ou NetworkManager plutôt que par netplan et ifupdown.
Repérez l’interface par laquelle passe la route par défaut :
baship -4 route show defaultLe nom de l’interface suit
dev, par exempleeth0.Trouvez le fichier dans lequel le système stocke l’adresse de cette interface, faites-en une copie, puis remplacez-y l’adresse et la passerelle par les nouvelles. Si le réseau est configuré par cloud-init (fichier
50-cloud-init.yaml), créez en plus le fichier/etc/cloud/cloud.cfg.d/99-disable-network-config.cfgcontenantnetwork: {config: disabled}: sinon, cloud-init réécrira l’ancienne adresse après un redémarrage.Appliquez les paramètres de la manière prévue par votre système et vérifiez la connexion :
bashping -c 3 8.8.8.8
Dès que le réseau fonctionne sur la nouvelle adresse, relancez la commande avec cette adresse. Elle ne touche pas aux paramètres réseau :
beadmin newip 130.17.10.145La commande trouve l’ancienne adresse dans le panneau (dans le champ « Adresse du panneau », parmi les sites servis par adresse IP et dans le certificat SSL du panneau) et fait basculer le panneau sur la nouvelle. En cas de succès, elle affiche :
The network already uses 130.17.10.145. Moving the panel from 213.239.156.37…
✓ VPN, sites and the panel certificate now use the new address
! Some modules need your attention: https://130.17.10.145:8080Poursuivez ensuite comme après un lancement ordinaire : connectez-vous au panneau à l’adresse de la dernière ligne et parcourez la liste de la section Ce qu’il reste à faire manuellement.