Hetzner Cloud Netzwerk Konfiguration

Last change on 2025-10-16 • Created on 2020-07-02 • ID: NE-4C86A

In den von uns bereit gestellten Images ist automatisch das Paket hc-utils installiert, welches sicherstellt, dass private Netzwerk-Schnittstellen automatisch via DHCP konfiguriert werden. Es stellt einen hc-net-ifup@.service systemd Service bereit, der den DHCP-Client (aktuell dhcpcd) startet, sobald ein neues privates Interface gefunden wurde. Falls Sie eine manuelle Konfigurations-Option nutzen wollen, sollte dieser Dienst in Gänze oder für die entsprechende Netzwerk-Schnittstelle deaktiviert werden, damit der DHCP-Client nicht zusätzlich gestartet wird. Die Vorgehensweise wird im Kapitel Auto-Konfigurationspaket deinstallieren oder deaktivieren beschrieben.

Installation des auto-configuration Pakets

Laden Sie die neueste Version von hc-utils für Ihr Betriebssystem und Ihrer Architektur herunter: https://packages.hetzner.com/hcloud/

Debian-basierte Distributionen (Ubuntu, Debian):

  • Ubuntu 24.04
curl https://packages.hetzner.com/hcloud/deb/hc-utils_0.0.6-1_all.deb -o /tmp/hc-utils_0.0.6-1_all.deb -s
apt install /tmp/hc-utils_0.0.6-1_all.deb
  • Debian, Ubuntu 20.04 oder älter
curl https://packages.hetzner.com/hcloud/deb/hc-utils_0.0.5-1_all.deb -o /tmp/hc-utils_0.0.5-1_all.deb -s
apt install /tmp/hc-utils_0.0.5-1_all.deb

RHEL-basierte Distributionen (CentOS, Fedora, Rocky, Alma)

  • CentOS 7

    curl https://packages.hetzner.com/hcloud/rpm/hc-utils-0.0.3-1.el7.noarch.rpm -o /tmp/hc-utils-0.0.3-1.el7.noarch.rpm -s
yum install /tmp/hc-utils-0.0.3-1.el7.noarch.rpm

  • CentOS 8 / 9

    curl https://packages.hetzner.com/hcloud/rpm/hc-utils-0.0.4-1.el8.noarch.rpm -o /tmp/hc-utils-0.0.4-1.el8.noarch.rpm -s
yum install /tmp/hc-utils-0.0.4-1.el8.noarch.rpm

  • Fedora 37 oder höher

    dnf install https://packages.hetzner.com/hcloud/rpm/hc-utils-0.0.4-1.fc37.noarch.rpm

Auto-Konfigurationspaket deinstallieren oder deaktivieren

Wenn Sie die automatische Konfiguration nicht nutzen wollen, deinstallieren Sie das hc-utils-Paket oder deaktivieren Sie es für die entsprechende Netzwerkschnittstelle. Anderenfalls besteht das Risiko, dass zwei DHCP-Clients um die Konfiguration konkurrieren, was zu Seiteneffekten und Ausfällen führen kann.

Auto-Konfigurationspaket deinstallieren

  • Auf Debian-basierte Distributionen (Ubuntu, Debian):

    apt remove hc-utils

  • Auf RHEL-basierte Distributionen (CentOS, Fedora, Rocky, Alma):

    dnf remove hc-utils

Auto-Konfiguration deaktivieren

Sie können die automatische Konfiguration für eine Netzwerkschnittstelle deaktivieren, indem Sie den hc-net-ifup Service für diese Schnittstelle deaktivieren und maskieren. Ersetzen Sie dafür schnittstelle durch die Werte Ihres Netzwerks.

systemctl stop hc-net-ifup@schnittstelle.service
systemctl mask hc-net-ifup@schnittstelle.service

CentOS 7

Namen der Schnittstellen:

Netzwerk Name
Erstes angehängte Netzwerk eth1
Weitere Schnittstelle (zweite) eth2
Weitere Schnittstelle (dritte) eth3

Um z.B. die automatische Konfiguration der ersten privaten Netzwerkschnittstelle zu deaktivieren, stoppen und maskieren Sie den hc-net-ifup Service für diese Schnittstelle.

systemctl stop hc-net-ifup@eth1.service
systemctl mask hc-net-ifup@eth1.service

Debian / Ubuntu, Fedora, Alma/CentOS/Rocky 8 oder höher

Namen der Schnittstellen

Netzwerk CX*1, CCX*1 CX*2, CX*3, CPX, CAX, CCX*2, CCX*3
Erstes angehängte Netzwerk ens10 enp7s0
Weitere Schnittstelle (zweite) ens11 enp8s0
Weitere Schnittstelle (dritte) ens12 enp9s0

Um z.B. die automatische Konfiguration der ersten privaten Netzwerkschnittstelle eines CX22 Servers zu deaktivieren, stoppen und maskieren Sie den hc-net-ifup Service für diese Schnittstelle.

systemctl stop hc-net-ifup@enp7s0.service
systemctl mask hc-net-ifup@enp7s0.service

Manuelle Konfiguration über DHCP

Wenn Sie die automatische Konfiguration nicht nutzen wollen, deinstallieren Sie das hc-utils-Paket oder deaktivieren Sie es für die entsprechende Netzwerkschnittstelle (siehe vorheriger Abschnitt). Anderenfalls besteht das Risiko, dass zwei DHCP-Clients um die Konfiguration konkurrieren, was zu Seiteneffekten und Ausfällen führen kann.

Debian / Ubuntu

Namen der Schnittstellen:

Netzwerk CX*1, CCX*1 CX*2, CX*3, CPX, CAX, CCX*2, CCX*3
Erstes angehängte Netzwerk ens10 enp7s0
Weitere Schnittstelle (zweite) ens11 enp8s0
Weitere Schnittstelle (dritte) ens12 enp9s0

Debian (ifupdown)

  1. Öffnen Sie die Konfigurationsdatei mit einem Editor:

    vi /etc/network/interfaces.d/61-my-private-network.cfg

  2. Fügen Sie die folgende Konfiguration in den Editor ein:

    • CX*1 and CCX*1 (Intel)

      auto ens10
iface ens10 inet dhcp

    • CX*2 (Intel), CAX (ARM), CX*3 (Intel&AMD), CPX, CCX*2 and CCX*3 (AMD)

      auto enp7s0
iface enp7s0 inet dhcp

  3. Nun sollten Sie Ihr Netzwerk neu starten. Vorsicht: Dadurch wird Ihre Netzwerkverbindung zurückgesetzt.

    sudo service networking restart

Ubuntu (netplan)

  1. Öffnen Sie die Konfigurationsdatei mit einem Editor:

    vi /etc/netplan/60-my-private-network.yaml

  2. Fügen Sie die folgende Konfiguration in den Editor ein:

    • CX*1 and CCX*1 (Intel)

      network:
    version: 2
    renderer: networkd
    ethernets:
        ens10:
            dhcp4: true

    • CX*2 (Intel), CAX (ARM), CX*3 (Intel&AMD), CPX, CCX*2 and CCX*3 (AMD)

      network:
    version: 2
    renderer: networkd
    ethernets:
        enp7s0:
            dhcp4: true

  3. Nun sollten Sie Ihr Netzwerk neu starten. Vorsicht: Dadurch wird Ihre Netzwerkverbindung zurückgesetzt.

    sudo netplan generate
sudo netplan apply

Auf RHEL-basierte Distributionen (Alma, CentOS, Fedora, Rocky):

CentOS 7

Namen der Schnittstellen:

Netzwerk Name
Erstes angehängte Netzwerk eth1
Weitere Schnittstelle (zweite) eth2
Weitere Schnittstelle (dritte) eth3

  1. Öffnen Sie die Konfigurationsdatei mit einem Editor:

    vi /etc/sysconfig/network-scripts/ifcfg-ens10

  2. Fügen Sie die folgende Konfiguration in den Editor ein:

    DEVICE=ens10
BOOTPROTO=dhcp
ONBOOT=yes

  3. Nun sollten Sie Ihr Netzwerk neu starten. Vorsicht: Dadurch wird Ihre Netzwerkverbindung zurückgesetzt.

    systemctl restart network

Alma/CentOS/Rocky 8 oder höher, Fedora

Netzwerk CX*1, CCX*1 CX*2, CX*3, CAX, CPX, CCX*2, CCX*3
Erstes angehängte Netzwerk ens10 enp7s0
Weitere Schnittstelle (zweite) ens11 enp8s0
Weitere Schnittstelle (dritte) ens12 enp9s0

  1. Öffnen Sie die Konfigurationsdatei mit einem Editor:

    vi /etc/NetworkManager/system-connections/enp7s0.nmconnection:

  2. Fügen Sie die folgende Konfiguration in den Editor ein:

    [connection]
id=enp7s0
uuid=<insert a uuid!!>
type=ethernet

[ethernet]
mac-address=<insert the HWADDR of your private networks interface!!>

[ipv4]
method=auto
may-fail=false

  3. Nun sollten Sie Ihr Netzwerk neu starten. Vorsicht: Dadurch wird Ihre Netzwerkverbindung zurückgesetzt.

    systemctl restart NetworkManager

Manuelle Konfiguration von Alias-IPs

Debian / Ubuntu

Namen der Schnittstellen:

Netzwerk CX*1, CCX*1 CX*2, CX*3, CPX, CAX, CCX*2, CCX*3
Erstes angehängte Netzwerk ens10 enp7s0
Weitere Schnittstelle (zweite) ens11 enp8s0
Weitere Schnittstelle (dritte) ens12 enp9s0

Debian (ifupdown)

  1. Öffnen Sie die Konfigurationsdatei mit einem Editor:

    vi /etc/network/interfaces.d/61-my-private-network.cfg

  2. Fügen Sie die folgende Konfiguration in den Editor ein und ersetzen Sie your.ali.as.IP durch eine der Alias-IPs. Denken Sie daran, die Kennung um eins zu erhöhen, wenn Sie mehrere Alias-IPs verwenden.

    auto ens10:1
iface ens10:1 inet static
   address your.ali.as.IP
   netmask 32

  3. Nun sollten Sie Ihr Netzwerk neu starten. Vorsicht: Dadurch wird Ihre Netzwerkverbindung zurückgesetzt.

    sudo service networking restart

Ubuntu (netplan)

Wir empfehlen Ihnen, das hc-utils Paket zu deinstallieren, oder für die entsprechende Netzwerkschnittstelle zu deaktivieren (siehe Abschnitt Auto-Konfigurationspaket deinstallieren oder deaktivieren). Anderenfalls wird weiterhin automatisch ein DHCP-Client gestartet, was zu Seiteneffekten und Ausfällen führen kann.

  1. Öffnen Sie die Konfigurationsdatei mit einem Editor:

    vi /etc/netplan/60-my-private-network.yaml

  2. Fügen Sie die folgende Konfiguration in den Editor ein:

    • CX*1 and CCX*1 (Intel)

      network:
  version: 2
  renderer: networkd
  ethernets:
    ens10:
      dhcp4: true
      addresses:
        - your.ali.as.IP/32

    • CX*2 (Intel), CAX (ARM), CX*3 (Intel&AMD), CPX, CCX*2 and CCX*3 (AMD)

      network:
  version: 2
  renderer: networkd
  ethernets:
    enp7s0:
      dhcp4: true
      addresses:
        - your.ali.as.IP/32

  3. Nun sollten Sie Ihr Netzwerk neu starten. Vorsicht: Dadurch wird Ihre Netzwerkverbindung zurückgesetzt.

    sudo netplan generate
sudo netplan apply

Auf RHEL-basierte Distributionen (Alma, CentOS, Fedora, Rocky):

CentOS 7:

Namen der Schnittstellen:

Netzwerk Schnittstellen
Erstes angehängte Netzwerk eth1
Weitere Schnittstelle (zweite) eth2
Weitere Schnittstelle (dritte) eth3

  1. Öffnen Sie die Konfigurationsdatei mit einem Editor:

    vi /etc/sysconfig/network-scripts/ifcfg-eth1:0

  2. Fügen Sie die folgende Konfiguration in den Editor ein und ersetzen Sie your.ali.as.IP durch eine der Alias-IPs. Denken Sie daran, die Kennung um eins zu erhöhen, wenn Sie mehrere Alias-IPs verwenden.

    BOOTPROTO=static
DEVICE=eth1:0
IPADDR=your.ali.as.IP
PREFIX=32
TYPE=Ethernet
USERCTL=no
ONBOOT=yes

  3. Nun sollten Sie Ihr Netzwerk neu starten. Vorsicht: Dadurch wird Ihre Netzwerkverbindung zurückgesetzt.

    systemctl restart network

Alma/CentOS/Rocky 8 oder höher, Fedora

Wir empfehlen Ihnen, das hc-utils Paket zu deinstallieren, oder für die entsprechende Netzwerkschnittstelle zu deaktivieren (siehe Abschnitt Auto-Konfigurationspaket deinstallieren oder deaktivieren). Anderenfalls wird weiterhin automatisch ein DHCP-Client gestartet, was zu Seiteneffekten und Ausfällen führen kann.

  1. Öffnen Sie die Konfigurationsdatei mit einem Editor:

    vi /etc/NetworkManager/system-connections/enp7s0.nmconnection

  2. Fügen Sie die folgende Konfiguration in den Editor ein und ändern Sie die uuid, mac-address und IP.

    [connection]
id=enp7s0
uuid=<keep the UUID as is!!>
type=ethernet

[ethernet]
mac-address=<keep the HWADDR as is!!>

[ipv4]
method=auto
address2=<your alias ip>/32
may-fail=false

  3. Nun sollten Sie Ihr Netzwerk neu starten. Vorsicht: Dadurch wird Ihre Netzwerkverbindung zurückgesetzt.

    sudo service NetworkManager restart

Manuelle statische Konfiguration

Wichtiger Hinweis: Jeder privaten Netzwerk-Schnittstelle eines Cloud Servers wird automatisch eine IP-Adresse zugewiesen und Verbindungen zum privaten Netzwerk sind nur mit dieser zugewiesenen IP-Adresse möglich. Achten Sie daher bei einer manuellen Konfiguration bitte darauf, die in der Hetzner Console/API angezeigte IP-Adresse des Servers zu verwenden.

Wir empfehlen Ihnen, das hc-utils Paket zu deinstallieren, oder für die entsprechende Netzwerkschnittstelle zu deaktivieren (siehe Abschnitt Auto-Konfigurationspaket deinstallieren oder deaktivieren). Anderenfalls wird weiterhin automatisch ein DHCP-Client gestartet, was zu Seiteneffekten und Ausfällen führen kann.

Auf Debian-basierte Distributionen (Ubuntu, Debian):

Namen der Schnittstellen:

Netzwerk CX*1, CCX*1 CX*2, CX*3, CPX, CAX, CCX*2, CCX*3
Erstes angehängte Netzwerk ens10 enp7s0
Weitere Schnittstelle (zweite) ens11 enp8s0
Weitere Schnittstelle (dritte) ens12 enp9s0

Debian (ifupdown)

  1. Öffnen Sie die Konfigurationsdatei mit einem Editor:

    nano /etc/network/interfaces.d/61-my-private-network.cfg

  2. Fügen Sie die folgende Konfiguration in den Editor ein und ersetzen Sie private.address.ofThe.CloudServer, gateway.of.the.network und net.work.ip.range durch die Werte Ihres Netzwerks.

    auto ens10
iface ens10 inet static
   address private.address.ofThe.CloudServer
   netmask 255.255.255.255
   mtu 1450
   pointopoint gateway.of.the.network
   post-up ip route add net.work.ip.range via gateway.of.the.network dev ens10

  3. Nun sollten Sie Ihr Netzwerk neu starten. Vorsicht: Dadurch wird Ihre Netzwerkverbindung zurückgesetzt.

    sudo service networking restart

Ubuntu (netplan)

  1. Öffnen Sie die Konfigurationsdatei mit einem Editor:

    vi /etc/netplan/60-my-private-network.yaml

  2. Fügen Sie die folgende Konfiguration in den Editor ein:

    • CX*1 and CCX*1 (Intel)

      network:
  version: 2
  renderer: networkd
  ethernets:
    ens10:
      addresses:
        - private.IP/32
      routes:
        - to: net.work.ip.range
          via: gateway.of.the.network
          on-link: true

    • CX*2 (Intel), CAX (ARM), CX*3 (Intel&AMD), CPX, CCX*2 and CCX*3 (AMD)

      network:
  version: 2
  renderer: networkd
  ethernets:
    enp7s0:
      addresses:
        - private.IP/32
      routes:
        - to: net.work.ip.range
          via: gateway.of.the.network
          on-link: true

  3. Nun sollten Sie Ihr Netzwerk neu starten. Vorsicht: Dadurch wird Ihre Netzwerkverbindung zurückgesetzt.

    sudo netplan generate
sudo netplan apply

Auf RHEL-basierte Distributionen (Alma, CentOS, Fedora, Rocky):

CentOS 7

Namen der Schnittstellen:

Netzwerk Fedora CentOS
Erstes angehängte Netzwerk ens10 eth0
Weitere Schnittstelle (zweite) ens11 eth1
Weitere Schnittstelle (dritte) ens12 eth2

  1. Öffnen Sie die Konfigurationsdatei mit einem Editor:

    vi /etc/sysconfig/network-scripts/ifcfg-ens10

  2. Fügen Sie die folgende Konfiguration in den Editor ein und ersetzen Sie die private.address.ofThe.CloudServer durch die private Netzwerk-IP Ihres Servers.

    BOOTPROTO=static
DEVICE=ens10
MTU=1450
IPADDR=private.address.ofThe.CloudServer
PREFIX=32
TYPE=Ethernet
USERCTL=no
ONBOOT=yes

  3. Öffnen Sie die Konfigurationsdatei mit einem Editor:

    vi /etc/sysconfig/network-scripts/route-ens10

  4. Fügen Sie die folgende Konfiguration in den Editor ein und ersetzen Sie gateway.of.the.network und net.work.ip.range mit den Werten Ihres Netzwerks.

    gateway.of.the.network/32 via 0.0.0.0 dev ens10 scope link
net.work.ip.range via gateway.of.the.network dev ens10

  5. Nun sollten Sie Ihr Netzwerk neu starten. Vorsicht: Dadurch wird Ihre Netzwerkverbindung zurückgesetzt.

    systemctl restart network

Alma/CentOS/Rocky 8 oder höher, Fedora

  1. Öffnen Sie die Konfigurationsdatei mit einem Editor:

    vi /etc/NetworkManager/system-connections/enp7s0.nmconnection

  2. Fügen Sie die folgende Konfiguration in den Editor ein und ändern Sie sie nach Ihren Bedürfnissen:

    [connection]
id=enp7s0
uuid=<keep the UUID as is!!>
type=ethernet

[ethernet]
mac-address=<keep the HWADDR as is!!>

[ipv4]
address1=<your Private IPv4 address>/32,<your private networks gateway>
may-fail=false
method=manual

  3. Nun sollten Sie Ihr Netzwerk neu starten. Vorsicht: Dadurch wird Ihre Netzwerkverbindung zurückgesetzt.

    systemctl restart NetworkManager

Manuelle Konfiguration auf Windows-basierten Systemen

  1. Greifen Sie über RDP oder die HTML5-Konsole auf den Server zu.

  2. Öffnen sie eine Powershell oder CMD als Administrator.

  3. Geben sie die Schnittstellenliste aus und ermitteln Sie die Schnittstellen-ID der Schnittstelle Red Hat VirtIO Ethernet Adapter #2.

    route print ?

    Die Ausgabe sollte so aussehen:

    Interface List
3...xx xx xx xx xx xx ......Red Hat VirtIO Ethernet Adapter
5...xx xx xx xx xx xx ......Red Hat VirtIO Ethernet Adapter #2
1...........................Software Loopback Interface 1
2...00 00 00 00 00 00 00 e0 Microsoft ISATAP Adapter
4...00 00 00 00 00 00 00 e0 Teredo Tunneling Pseudo-Interface
7...00 00 00 00 00 00 00 e0 Microsoft ISATAP Adapter #2

  4. Fügen Sie die statischen Routen zur Schnittstelle hinzu, indem Sie mask.of.network.range, gateway.of.the.network und net.work.ip.range durch die Werte Ihres Netzwerks ersetzen.

    route add -p gateway.of.the.network 0.0.0.0 if 5
route add -p net.work.ip.range mask mask.of.network.range gateway.of.the.network if 5

  5. Überprüfen Sie den Schnittstellennamen für die statische Konfiguration:

    netsh interface ip show config

    Die Ausgabe sollte so aussehen:

    Configuration for interface "Ethernet"
   DHCP enabled:                         Yes
   IP Address:                           xxx.xxx.xxx.xxx
   Subnet Prefix:                        xxx.xxx.xxx.xxx/32 (mask 255.255.255.255)
   Default Gateway:                      172.31.1.1
   Gateway Metric:                       0
   InterfaceMetric:                      5
   DNS servers configured through DHCP:  185.12.64.1
                                         185.12.64.2
   Register with which suffix:           Primary only
   WINS servers configured through DHCP: None
Configuration for interface "Ethernet 2"
   DHCP enabled:                         Yes
   IP Address:                           private.address.ofThe.CloudServer
   Subnet Prefix:                        private.address.ofThe.CloudServer/32 (mask 255.255.255.255)
   Default Gateway:                      gateway.of.the.network
   Gateway Metric:                       0
   InterfaceMetric:                      5
   DNS servers configured through DHCP:  None
   Register with which suffix:           Primary only
   WINS servers configured through DHCP: None
Configuration for interface "Loopback Pseudo-Interface 1"
   DHCP enabled:                         No
   IP Address:                           127.0.0.1
   Subnet Prefix:                        127.0.0.0/8 (mask 255.0.0.0)
   InterfaceMetric:                      75
   Statically Configured DNS Servers:    None
   Register with which suffix:           None
   Statically Configured WINS Servers:   None

  6. Legen Sie die IP-Adresse der Schnittstelle fest:

    netsh interface ipv4 set address name="Ethernet 2" static private.address.ofThe.CloudServer 255.255.255.255 gateway.of.the.network 1
Table of Contents