Skip to content

So ändern Sie die Adresse des Servers ​

Hat Ihr Hoster die öffentliche IPv4-Adresse des Servers ausgetauscht, können Sie das Panel BeAdmin mit einem einzigen Befehl auf die neue Adresse umstellen: beadmin newip in der Webkonsole des Servers. Der Befehl konfiguriert das Netzwerk des Betriebssystems neu und prüft die Verbindung; anschließend stellt das Panel VPN, per IP-Adresse erreichbare Websites und sein eigenes SSL-Zertifikat auf die neue Adresse um. Was das Panel nicht korrigieren kann — die Konfigurationen Ihrer VPN-Benutzer und die DNS-Einträge —, listet es bei Ihrer nächsten Anmeldung in einer Benachrichtigung auf.

Wann Sie das brauchen ​

Der Hoster hat die öffentliche IPv4-Adresse des Servers ausgetauscht, und das Panel lässt sich nicht mehr öffnen: In den Netzwerkeinstellungen des Betriebssystems steht noch die alte Adresse. Auch per SSH ist der Server unter der alten Adresse nicht erreichbar. Deshalb führen Sie den Befehl in der Webkonsole des Servers aus, die Ihr Hoster in seinem Kundenbereich bereitstellt.

Was Sie benötigen ​

  • Die neue öffentliche IPv4-Adresse des Servers und die Adresse des Gateways. Beides finden Sie im Kundenbereich Ihres Hosters. Eine private Adresse lehnt der Befehl ab.
  • Zugriff auf die Webkonsole des Servers im Kundenbereich Ihres Hosters sowie root-Rechte.
  • Debian 13, Ubuntu 24.04 oder Ubuntu 26.04, bei denen die Serveradresse statisch festgelegt ist: in netplan (Dateien /etc/netplan/*.yaml) oder in ifupdown (/etc/network/interfaces und das Verzeichnis /etc/network/interfaces.d/). Bezieht der Server seine Adresse automatisch oder liegen die Einstellungen woanders, findet der Befehl sie nicht — ändern Sie die Adresse dann manuell.

Schritt 1. Webkonsole öffnen ​

Öffnen Sie die Webkonsole des Servers im Kundenbereich Ihres Hosters und melden Sie sich als root an. Sind Sie als normaler Benutzer mit sudo-Rechten angemeldet, stellen Sie dem Befehl sudo voran.

Schritt 2. Befehl ausführen ​

Führen Sie den Befehl mit der neuen IPv4-Adresse des Servers aus:

bash
beadmin newip 130.17.10.145

Der Befehl findet in den Netzwerkeinstellungen die statische Adresse des Servers, zeigt an, was er ändern will, und fragt das Gateway ab:

text
Current address: 213.239.156.37/24, gateway 213.239.156.1
New address:     130.17.10.145/24
Gateway [130.17.10.1]:

Die erste Zeile zeigt die aktuelle Adresse und das Gateway aus den Netzwerkeinstellungen, die zweite die neue Adresse. Die Netzmaske bleibt unverändert (im Beispiel /24): Der Befehl ändert sie nicht.

Schritt 3. Gateway bestätigen ​

In eckigen Klammern schlägt der Befehl ein Standard-Gateway vor — die erste Adresse des Subnetzes der neuen Adresse. Vergleichen Sie es mit dem Gateway aus dem Kundenbereich Ihres Hosters:

  • Stimmt es überein, drücken Sie die Eingabetaste.
  • Weicht es ab, geben Sie das Gateway Ihres Hosters ein und drücken Sie die Eingabetaste.

Sieht die Eingabe nicht nach einer IPv4-Adresse aus, fragt der Befehl das Gateway erneut ab. Solange Sie das Gateway nicht bestätigt haben, ändert der Befehl nichts.

Was nach der Gateway-Eingabe passiert ​

Ab hier arbeitet der Befehl ohne Ihr Zutun. Er sichert Kopien der Dateien, die er ändert, trägt die neue Adresse und das Gateway in die Netzwerkeinstellungen ein, wendet sie an und prüft, ob der Server im Netz erreichbar ist. Danach startet er das Panel neu und wartet, bis das Panel alles, was es unter der alten Adresse gespeichert hatte, auf die neue umgestellt hat. Das Ergebnis sieht so aus:

text
✓ 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:8080

Netzwerk des Betriebssystems ​

Die Zeile Network reconfigured, connection is up bedeutet, dass der Server unter der neuen Adresse läuft. In den Netzwerkeinstellungen ändern sich nur die Adresse und das Gateway der Schnittstelle, über die die Standardroute läuft; IPv6 und DNS-Server bleiben unverändert.

Liegen die Netzwerkeinstellungen in der Datei 50-cloud-init.yaml, die cloud-init erzeugt, legt der Befehl zusätzlich die Datei /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg mit dem Inhalt network: {config: disabled} an. Ohne sie würde cloud-init nach einem Neustart die alte Adresse wieder eintragen. Existiert die Datei bereits, lässt der Befehl sie unverändert.

VPN, Websites und Panel-Zertifikat ​

Die Zeile VPN, sites and the panel certificate now use the new address bedeutet, dass das Panel neu gestartet wurde und Folgendes auf die neue Adresse umgestellt hat:

  • die Einstellung „Serveradresse“ der VPN-Module — wenn dort die alte IP-Adresse steht. Eine Domain oder eine andere Adresse, die Sie selbst eingetragen haben, bleibt unverändert;
  • das Feld „Panel-Adresse“ in den Einstellungen der Passwortwiederherstellung — wenn dort die alte IP-Adresse steht. Eine Domain bleibt unverändert;
  • Websites, die über die IP-Adresse des Servers erreichbar sind: die Adresse der Website, der virtuelle Host und bei WordPress die Adressen in dessen Einstellungen, sofern dort die alte IP-Adresse steht;
  • das SSL-Zertifikat des Panels: Das Panel fordert ein Zertifikat für die neue Adresse an und löscht das für die alte.

Adresse für die Anmeldung am Panel ​

In der letzten Zeile steht die Adresse, unter der das Panel jetzt erreichbar ist. Der Port darin ist der Panel-Port, standardmäßig 8080. Das Zeichen ! heißt: Nach der Anmeldung wartet eine Liste mit dem, was Sie manuell erledigen müssen.

Schritt 4. Am Panel anmelden ​

Öffnen Sie die Adresse aus der letzten Zeile der Befehlsausgabe und melden Sie sich wie gewohnt an. Ein Administrator sieht die Benachrichtigung „Serveradresse geändert. Einige Module erfordern Ihre Aufmerksamkeit.“ Klicken Sie auf „Mehr“, um das Fenster mit der Liste dessen zu öffnen, was noch manuell zu erledigen ist.

Beispiel für das Fenster:

text
Serveradresse geändert: 213.239.156.37 → 130.17.10.145

VPN, Websites und das Panel-Zertifikat nutzen bereits die neue Adresse.
Noch manuell zu erledigen:

1. Verteilen Sie neue Konfigurationen an Ihre VPN-Benutzer — die
   alten verweisen noch auf die alte Adresse und stellen keine
   Verbindung her.
   Mimicry — 7 Benutzer, WireGuard — 3 Benutzer.

2. Generieren Sie neue Links für die Eingangs-Hops Ihrer
   Multi-Hop-Ketten und übergeben Sie sie an die Server dieser
   Eingangs-Hops.
   Amnezia — 2 Benutzer im Ausgangs-Hop-Modus.

3. Setzen Sie die A-Einträge von example.com, shop.example.com
   auf 130.17.10.145.

4. Ersetzen Sie im SPF-Eintrag von example.com die alte Adresse
   durch die neue und bitten Sie Ihren Hoster, einen PTR-Eintrag
   für 130.17.10.145 festzulegen.

Das Fenster enthält nur die Punkte, die Ihren Server betreffen, und die Nummerierung läuft durch. Die Liste wird bei jeder Anmeldung neu aufgebaut, deshalb verschwindet der Punkt zu den A-Einträgen, sobald die Domains auf die neue Adresse zeigen.

⚠️ Benachrichtigung erst schließen, wenn die Liste abgearbeitet ist

Die Benachrichtigung bleibt auf dem Bildschirm, bis Sie sie mit dem Kreuz schließen. Nach dem Schließen zeigt das Panel sie nicht mehr an — weder Ihnen noch anderen Administratoren —, und die Liste lässt sich im Panel nicht wiederherstellen. Benutzer mit anderen Rollen sehen die Benachrichtigung nicht.

Was noch manuell zu erledigen ist ​

Das Panel kann nicht korrigieren, was außerhalb von ihm gespeichert ist: bei Ihren VPN-Benutzern, auf anderen Servern und im DNS. Das Fenster „Mehr“ listet nur auf, was Ihren Server betrifft.

Neue Konfigurationen an VPN-Benutzer verteilen ​

Konfigurationen, Links und QR-Codes, die Sie früher ausgegeben haben, enthalten die alte Serveradresse und stellen keine Verbindung mehr her. Neue Konfigurationen, Links und QR-Codes aus dem Modul enthalten bereits die neue Adresse, wenn bei „Serveradresse“ der Wert „Automatisch“ gewählt ist oder die alte IP-Adresse eingetragen war. Geben Sie sie den Benutzern erneut aus. Das Fenster nennt, bei welchen Modulen und wie vielen Benutzern das nötig ist.

💡 Domain statt IP-Adresse

Ist bei einem Modul unter „Serveradresse“ der Wert „Eigene Adresse“ mit einer Domain eingestellt, müssen Sie die Konfigurationen seiner Benutzer nicht erneut verteilen: Richten Sie den A-Eintrag dieser Domain auf die neue Adresse. Das Fenster „Mehr“ nennt trotzdem die Benutzer eines solchen Moduls und zeigt den A-Eintrag einer Domain nicht an, die nicht unter „Websites & Domains“ steht — prüfen Sie ihn selbst. Mit einer Domain statt einer IP-Adresse überstehen die Konfigurationen auch den nächsten Adresswechsel.

Der Multi-Hop-Modus ist ein Modus des VPN-Moduls, in dem der Traffic über eine Kette von Servern läuft. Arbeitet dieser Server darin als Ausgangs-Hop, erreichen ihn die Eingangs-Hops auf anderen Servern unter der alten Adresse. Das Fenster nennt die Module und die Zahl der Benutzer im Ausgangs-Hop-Modus. Generieren Sie neue Links für die Eingangs-Hops und übergeben Sie sie an die Server dieser Eingangs-Hops.

A-Einträge der Domains auf die neue Adresse setzen ​

Domains unter „Websites & Domains“, deren A-Einträge auf die alte Adresse zeigen, führen nicht mehr zu diesem Server. Tragen Sie die neue Adresse in die A-Einträge dieser Domains beim Registrar oder bei dem Dienst ein, der die DNS-Zone der Domain verwaltet. Wie Sie einen A-Eintrag anlegen, steht in So konfigurieren Sie DNS-Einträge für einen Mailserver.

SPF aktualisieren und PTR-Eintrag anfordern ​

Ist auf dem Server das Mail-Modul installiert, fordert Sie das Fenster auf, die DNS-Einträge der Maildomains anzupassen:

  • Ersetzen Sie im SPF-Eintrag jeder Domain die alte Adresse durch die neue: Statt ip4:213.239.156.37 muss ip4:130.17.10.145 stehen.
  • Bitten Sie Ihren Hoster, einen PTR-Eintrag für die neue Adresse anzulegen: Er gehört zur IP-Adresse, deshalb kann nur der Hoster ihn anlegen.

Das Ergebnis können Sie im Fenster „Mail-DNS“ der Domain unter „Websites & Domains“ prüfen.

Wenn der Befehl fehlschlägt ​

Keine Verbindung unter der neuen Adresse ​

text
✗ No connection on the new address — previous network settings restored.
  Check the address and gateway with your hosting provider and run the command again.

Der Server ist mit der neuen Adresse nicht ins Netz gekommen, und der Befehl hat die bisherigen Netzwerkeinstellungen wiederhergestellt. Das Panel und seine Einstellungen wurden dabei nicht geändert.

Über der Meldung kann eine Zeile newip: … mit der Ursache stehen: the gateway … does not answer — das Gateway antwortet nicht; nothing outside answers — das Gateway antwortet, aber äußere Adressen sind nicht erreichbar. Vergleichen Sie Adresse und Gateway mit den Angaben Ihres Hosters und führen Sie den Befehl erneut aus. Der Befehl behält die bisherige Netzmaske bei: Hat die neue Adresse eine andere, ändern Sie die Adresse manuell.

Bisherige Einstellungen ließen sich nicht wiederherstellen ​

text
✗ 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/

Der Server ist ohne Verbindung geblieben. Im genannten Verzeichnis liegen Kopien der Dateien, die der Befehl geändert hat; darin wiederholt sich die Verzeichnisstruktur des Systems, zum Beispiel etc/netplan/50-cloud-init.yaml. Kopieren Sie die Dateien an ihre ursprünglichen Plätze und setzen Sie dabei den Pfad aus Ihrer Meldung ein:

bash
cp -a /var/lib/beadmin/newip-backup/1762958412/etc/. /etc/

Wenden Sie danach die Einstellungen an: netplan apply bei netplan oder systemctl restart networking bei ifupdown. Sobald die Verbindung wieder steht, vergleichen Sie Adresse und Gateway mit den Angaben Ihres Hosters und führen Sie den Befehl erneut aus.

Das Panel hat den Wechsel nicht abgeschlossen ​

text
✗ The network is up, but the panel didn't finish moving to the new address.
  See the panel log: journalctl -u beadmin

Das Netzwerk läuft bereits unter der neuen Adresse, aber das Panel hat nicht alles, was es unter der alten Adresse gespeichert hatte, darauf umgestellt. Führen Sie denselben Befehl mit derselben Adresse noch einmal aus:

bash
beadmin newip 130.17.10.145

Das Gateway fragt der Befehl dabei nicht ab und das Netzwerk ändert er nicht: Er wiederholt nur den Wechsel des Panels. Bei Erfolg gibt er die Zeilen zu VPN mit Websites und zur Panel-Adresse aus:

text
✓ VPN, sites and the panel certificate now use the new address
! Some modules need your attention: https://130.17.10.145:8080

Lässt sich das Panel öffnen, weist auch das Fenster „Mehr“ auf den unvollständigen Wechsel hin: „Der Wechsel zur neuen Adresse ist nicht abgeschlossen. Führen Sie beadmin newip 130.17.10.145 erneut in der Serverkonsole aus.“ Endet auch der zweite Lauf mit demselben Fehler, suchen Sie die Ursache im Panel-Log: journalctl -u beadmin. Über der Meldung kann eine Zeile newip: … mit der Ursache stehen.

Netzwerkkonfiguration nicht gefunden ​

text
✗ Couldn't find the network configuration. Supported: netplan and /etc/network/interfaces.
  Change the address manually — see the documentation.

Der Befehl hat nichts geändert. Er sucht die statische IPv4-Adresse des Servers in netplan und in /etc/network/interfaces; wurde die Adresse automatisch bezogen oder liegen die Einstellungen woanders, findet er sie nicht. Ändern Sie die Adresse manuell: Am Ende dieses Abschnitts steht, wie Sie danach das Panel umstellen.

Das Panel enthält mehrere alte Adressen ​

text
✗ 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.

Die alten Adressen im Feld „Panel-Adresse“ und bei den über die IP-Adresse erreichbaren Websites unterscheiden sich. Der Befehl kann nicht wählen, welche er ersetzen soll, und ändert nichts. Tragen Sie die neue Adresse manuell im Feld „Panel-Adresse“ in den Einstellungen der Passwortwiederherstellung ein und korrigieren Sie die Adresse der über die IP-Adresse erreichbaren Websites.

Der Befehl lehnt den Start sofort ab ​

In diesen Fällen ändert der Befehl nichts:

MeldungWas zu tun ist
✗ Run the command as root: sudo beadmin newip 130.17.10.145Der Befehl wurde nicht als root ausgeführt. Wiederholen Sie ihn mit sudo, wie in der Meldung.
Usage: beadmin newip <new IPv4 address>Die Adresse fehlt, oder es wurden mehrere Werte angegeben. Geben Sie genau eine neue IPv4-Adresse an.
✗ 130.17.10 isn't an IPv4 address.Die Adresse ist falsch geschrieben: Eine IPv4-Adresse besteht aus vier Zahlen, die durch Punkte getrennt sind.
✗ 10.0.0.5 is a private address. Enter the public address from your hosting provider.Es wurde eine private Adresse eingegeben. Geben Sie die öffentliche Adresse an, die Ihr Hoster vergeben hat.
The server already uses 130.17.10.145 — nothing to change.Das Netzwerk läuft bereits unter dieser Adresse, und das Panel kennt keine andere Adresse: Es gibt nichts umzustellen. Vergleichen Sie die Adresse mit den Angaben Ihres Hosters.
✗ No gateway entered — nothing changed.Es wurde kein Gateway eingegeben. Führen Sie den Befehl erneut aus und geben Sie das Gateway an.

Adresse manuell ändern ​

Findet der Befehl die Netzwerkeinstellungen nicht, ändern Sie die Adresse manuell. Das kommt vor, wenn der Server seine Adresse automatisch bezieht oder das Netzwerk von systemd-networkd oder NetworkManager statt von netplan und ifupdown eingerichtet wird.

  1. Ermitteln Sie die Schnittstelle, über die die Standardroute läuft:

    bash
    ip -4 route show default

    Der Name der Schnittstelle steht hinter dev, zum Beispiel eth0.

  2. Suchen Sie die Datei, in der das System die Adresse dieser Schnittstelle speichert, sichern Sie eine Kopie und ersetzen Sie darin Adresse und Gateway durch die neuen. Wird das Netzwerk von cloud-init eingerichtet (Datei 50-cloud-init.yaml), legen Sie zusätzlich die Datei /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg mit dem Inhalt network: {config: disabled} an: Sonst trägt cloud-init nach einem Neustart die alte Adresse wieder ein.

  3. Wenden Sie die Einstellungen so an, wie es Ihr System vorsieht, und prüfen Sie die Verbindung:

    bash
    ping -c 3 8.8.8.8

Sobald das Netzwerk unter der neuen Adresse läuft, führen Sie den Befehl mit dieser Adresse erneut aus. Die Netzwerkeinstellungen fasst er dabei nicht an:

bash
beadmin newip 130.17.10.145

Der Befehl findet die alte Adresse im Panel — im Feld „Panel-Adresse“, bei den über die IP-Adresse erreichbaren Websites und im SSL-Zertifikat des Panels — und stellt das Panel auf die neue um. Bei Erfolg gibt er aus:

text
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:8080

Gehen Sie danach vor wie nach einem normalen Lauf: Melden Sie sich unter der Adresse aus der letzten Zeile am Panel an und arbeiten Sie die Liste aus dem Abschnitt Was noch manuell zu erledigen ist ab.

BeAdmin © 2025. Alle Rechte vorbehalten.