> ## Content Index
> Fetch the complete content index at: https://blog.rgb-schnitzel.de/llms.txt
> Use this file to discover other available public pages before exploring further.

# netcup-cli: Netcup-Server und DNS direkt im Terminal verwalten
- URL: https://blog.rgb-schnitzel.de/netcup-cli-netcup-server-und-dns-direkt-im-terminal-verwalten/
- Published: 2026-11-10T15:38:26.000Z
- Updated: 2026-11-10T15:38:26.000Z
- Author: Max Sander
- Tags: Software-Projekte

Wer mehrere Server betreibt, kennt den Ablauf: ins Control Panel einloggen, den richtigen VPS suchen, eine Aktion ausführen, später DNS-Einträge anpassen – und für wiederkehrende Aufgaben alles noch einmal von vorn. **netcup-cli** bringt viele dieser Handgriffe ins Terminal. Das Open-Source-Projekt von Maxsander123 verbindet die Netcup Server Control Panel (SCP) REST API mit den DNS-Schnittstellen des Customer Control Panel (CCP).

## Ein Terminal als Schaltzentrale

Nach dem Login lassen sich Server auflisten, Details anzeigen und grundlegende Aktionen ausführen:

```
netcup-cli login
netcup-cli list
netcup-cli info test
netcup-cli start test
netcup-cli stop test
```

Server können über ID, Nickname, Hostname oder internen Namen angesprochen werden. Auch die VNC-Konsole lässt sich mit `netcup-cli vnc test` im Browser öffnen.

Der Login für SCP läuft über einen Browser und einen Gerätecode. Das CLI verlangt dabei kein Kontopasswort im Terminal; es speichert lokal ein Refresh-Token. Mit `whoami` lässt sich der Status prüfen, `logout` entfernt das lokal gespeicherte Token.

## Mehr als Start und Stopp

Das Projekt deckt eine ganze Reihe typischer Betriebsaufgaben ab:

- Snapshots prüfen, erstellen, auflisten, exportieren und wiederherstellen
- Betriebssystem-Installationen interaktiv oder mit Skriptoptionen starten
- SSH-Schlüssel, ISO-Abbilder und Rescue-Modus verwalten
- CPU-, Disk- und Netzwerkmetriken sowie Server-Logs abrufen
- Reverse-DNS-Einträge setzen
- asynchrone Aufgaben verfolgen und bei Bedarf ohne Warten starten

Ein Snapshot vor einem Wartungsfenster lässt sich zum Beispiel so anlegen:

```
netcup-cli snapshot check test
netcup-cli snapshot create test --name vor-update
```

Bei einer Wiederherstellung fragt das CLI vor dem Überschreiben nach. Für unbeaufsichtigte Abläufe gibt es zudem explizite Bestätigungsoptionen; destruktive Befehle verlangen in nicht-interaktiven Skripten ein `--yes` beziehungsweise `-y`.

## DNS: getrennte APIs, getrennte Zugangsdaten

Besonders praktisch ist, dass netcup-cli neben dem SCP auch DNS-Funktionen des CCP anspricht. Das umfasst klassische DNS-Zonen und Records, CloudDNS-Funktionen wie ACME-Challenges und Changesets sowie Dynamic DNS. Je nach Befehl kommen unterschiedliche Netcup-APIs und Zugangsdaten zum Einsatz.

```
netcup-cli dns auth set rest
netcup-cli dns domains list
netcup-cli dns acme list example.com
netcup-cli dns ddns update home.example.com --ipv4 192.0.2.10 --yes
```

SCP-Login und CCP-DNS-Zugang sind voneinander unabhängig. Secrets für DNS können interaktiv hinterlegt oder über Umgebungsvariablen für Skripte bereitgestellt werden. Gespeicherte CCP-Zugangsdaten legt das Tool in einer separaten Datei mit restriktiven Dateirechten ab. Schreibende DNS-Kommandos fragen standardmäßig nach Bestätigung; für Automatisierung kann `--yes` verwendet werden.

## Für Shell-Skripte und Automatisierung

Mit `--json` lässt sich die Ausgabe weiterverarbeiten, etwa mit `jq`:

```
netcup-cli --json list | jq '.[].id'
```

Länger laufende Vorgänge sind standardmäßig mit einer Fortschrittsanzeige verbunden. Wer den nächsten Schritt parallel vorbereiten möchte, kann `--no-wait` verwenden und den Aufgabenstatus später abfragen:

```
netcup-cli --no-wait stop test
netcup-cli tasks list --limit 5 --state RUNNING
```

Das macht das CLI interessant für Admins, die wiederkehrende Abläufe skripten oder Serverzustände direkt in bestehende Shell-Workflows einbauen möchten.

## Installation

Voraussetzung ist `uv`. Auf Linux oder macOS kann das Tool anschließend direkt vom GitHub-Projekt installiert werden:

```
curl -LsSf https://astral.sh/uv/install.sh | sh
curl -fsSL https://raw.githubusercontent.com/Maxsander123/netcup-cli/main/scripts/install-netcup-cli.sh | bash
netcup-cli --version
```

Updates lassen sich anschließend mit `netcup-cli update` einspielen. Wer lieber aus einem lokalen Checkout installiert, findet dafür ebenfalls eine Anleitung im Repository.

## Für wen lohnt sich ein Blick?

netcup-cli ist vor allem dann spannend, wenn du Netcup-Server regelmäßig verwaltest, Shell-Skripte nutzt oder SCP- und DNS-Arbeiten an einem Ort bündeln möchtest. Die breite Befehlsauswahl reicht von einfachen Statusabfragen bis zu Installationen, Snapshots und DNS-Änderungen. Für den Einstieg sind `netcup-cli --help` und die Dokumentation im Repository die besten Anlaufstellen.

Wie bei jedem Werkzeug für Infrastruktur gilt: Vor produktiven Änderungen die Auswirkungen prüfen, besonders bei Neuinstallationen, Snapshot-Wiederherstellungen und DNS-Schreibvorgängen. Das CLI bietet dafür unter anderem interaktive Bestätigungen, Prüfkommandos und eine JSON-Ausgabe.

**Projekt ansehen:** [github.com/Maxsander123/netcup-cli](https://github.com/Maxsander123/netcup-cli?ref=blog.rgb-schnitzel.de)