Hetzner Cloud Netzwerk Konfiguration

Last change on 2026-05-18 • Created on 2020-07-02 • ID: NE-4C86A

Alias-IPs müssen manuell konfiguriert werden. Eine Anleitung dazu findest du in "Manuelle Konfiguration von Alias-IPs".

In den von uns bereit gestellten Images werden private Netzwerk-Schnittstellen automatisch konfiguriert. Dies erfolgt entweder via cloud-init (ab Version 25.3) oder über das hc-utils Paket. In beiden Fällen wird ein DHCP Client gestartet (dhclient oder dhcdpcd je nach Distribution), wenn eine neue private Netzwerk-Schnittstelle erkannt wird.

Wenn das Paket hc-utils installiert ist, stellt es einen hc-net-ifup@.service systemd Service für jede private Netzwerk-Schnittstelle bereit. Falls du eine manuelle Konfigurations-Option nutzen willst, sollte dieser Dienst in Gänze oder für die entsprechende Netzwerk-Schnittstelle deaktiviert werden, damit der DHCP-Client nicht mehrfach gestartet wird. Die Vorgehensweise wird im Kapitel Auto-Konfigurationspaket deinstallieren oder deaktivieren beschrieben.

Installation des auto-configuration Pakets

Lade die neueste Version von hc-utils für dein Betriebssystem und deine Architektur herunter: https://packages.hetzner.com/hcloud/

Debian-basierte Distributionen (Ubuntu, Debian):

  • Ubuntu 22.04 oder neuer

Ubuntu unterstützt nativ die automatische Konfiguration via cloud-init. Es ist keine zusätzliche Software nötig.

  • Debian 13 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)

  • Alma/CentOS/Rocky 8/9/10

    dnf install https://packages.hetzner.com/hcloud/rpm/hc-utils-0.0.9-1.el$(rpm -E %rhel).noarch.rpm

  • Fedora 44 oder neuer

Fedora unterstützt nativ die automatische Konfiguration via cloud-init. Es ist keine zusätzliche Software nötig.

OpenSUSE Distributionen

  • OpenSUSE Leap 16 
    curl https://packages.hetzner.com/hcloud/rpm/hc-utils-0.0.9-1.suse.lp160.noarch.rpm -o /tmp/hc-utils-0.0.9-1.suse.lp160.noarch.rpm -s
zypper install /tmp/hc-utils-0.0.9-1.suse.lp160.noarch.rpm

Auto-Konfigurationspaket deinstallieren oder deaktivieren

Wenn du die automatische Konfiguration nicht nutzen willst, deinstalliere das hc-utils-Paket oder deaktiviere 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

Du kannst die automatische Konfiguration für eine Netzwerkschnittstelle deaktivieren, indem du den hc-net-ifup Service für diese Schnittstelle deaktivierst und maskierst. Ersetze dafür schnittstelle durch die Werte deines 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, stoppe und maskiere 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, stoppe und maskiere 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 du die automatische Konfiguration nicht nutzen willst, deinstalliere das hc-utils-Paket oder deaktiviere 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. Öffne die Konfigurationsdatei mit einem Editor:

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

  2. Füge 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 solltest du dein Netzwerk neu starten. Vorsicht: Dadurch wird deine Netzwerkverbindung zurückgesetzt.

    sudo service networking restart

Ubuntu (netplan)

  1. Öffne die Konfigurationsdatei mit einem Editor:

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

  2. Füge 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 solltest du dein Netzwerk neu starten. Vorsicht: Dadurch wird deine 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. Öffne die Konfigurationsdatei mit einem Editor:

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

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

    DEVICE=ens10
BOOTPROTO=dhcp
ONBOOT=yes

  3. Nun solltest du dein Netzwerk neu starten. Vorsicht: Dadurch wird deine 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. Öffne die Konfigurationsdatei mit einem Editor:

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

  2. Füge 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 solltest du dein Netzwerk neu starten. Vorsicht: Dadurch wird deine 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. Öffne die Konfigurationsdatei mit einem Editor:

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

  2. Füge die folgende Konfiguration in den Editor ein und ersetze your.ali.as.IP durch eine der Alias-IPs. Denk daran, die Kennung um eins zu erhöhen, wenn du mehrere Alias-IPs verwendest.

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

  3. Nun solltest du dein Netzwerk neu starten. Vorsicht: Dadurch wird deine Netzwerkverbindung zurückgesetzt.

    sudo service networking restart

Ubuntu (netplan)

Wir empfehlen dir, 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. Öffne die Konfigurationsdatei mit einem Editor:

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

  2. Füge 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 solltest du dein Netzwerk neu starten. Vorsicht: Dadurch wird deine 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. Öffne die Konfigurationsdatei mit einem Editor:

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

  2. Füge die folgende Konfiguration in den Editor ein und ersetze your.ali.as.IP durch eine der Alias-IPs. Denk daran, die Kennung um eins zu erhöhen, wenn du mehrere Alias-IPs verwendest.

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

  3. Nun solltest du dein Netzwerk neu starten. Vorsicht: Dadurch wird deine Netzwerkverbindung zurückgesetzt.

    systemctl restart network

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

Wir empfehlen dir, 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. Öffne die Konfigurationsdatei mit einem Editor:

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

  2. Füge die folgende Konfiguration in den Editor ein und ändere 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 solltest du dein Netzwerk neu starten. Vorsicht: Dadurch wird deine 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. Achte daher bei einer manuellen Konfiguration bitte darauf, die in der Hetzner Console/API angezeigte IP-Adresse des Servers zu verwenden.

Wir empfehlen dir, 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. Öffne die Konfigurationsdatei mit einem Editor:

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

  2. Füge die folgende Konfiguration in den Editor ein und ersetze private.address.ofThe.CloudServer, gateway.of.the.network und net.work.ip.range durch die Werte deines 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 solltest du dein Netzwerk neu starten. Vorsicht: Dadurch wird deine Netzwerkverbindung zurückgesetzt.

    sudo service networking restart

Ubuntu (netplan)

  1. Öffne die Konfigurationsdatei mit einem Editor:

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

  2. Füge 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 solltest du dein Netzwerk neu starten. Vorsicht: Dadurch wird deine 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. Öffne die Konfigurationsdatei mit einem Editor:

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

  2. Füge die folgende Konfiguration in den Editor ein und ersetze die private.address.ofThe.CloudServer durch die private Netzwerk-IP deines Servers.

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

  3. Öffne die Konfigurationsdatei mit einem Editor:

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

  4. Füge die folgende Konfiguration in den Editor ein und ersetze gateway.of.the.network und net.work.ip.range mit den Werten deines 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 solltest du dein Netzwerk neu starten. Vorsicht: Dadurch wird deine Netzwerkverbindung zurückgesetzt.

    systemctl restart network

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

  1. Öffne die Konfigurationsdatei mit einem Editor:

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

  2. Füge die folgende Konfiguration in den Editor ein und ändere sie nach deinen 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 solltest du dein Netzwerk neu starten. Vorsicht: Dadurch wird deine Netzwerkverbindung zurückgesetzt.

    systemctl restart NetworkManager

Manuelle Konfiguration auf Windows-basierten Systemen

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

  2. Öffne eine Powershell oder CMD als Administrator.

  3. Gib die Schnittstellenliste aus und ermittel 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üge die statischen Routen zur Schnittstelle hinzu, indem du mask.of.network.range, gateway.of.the.network und net.work.ip.range durch die Werte deines Netzwerks ersetzt.

    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üf 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. Leg 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