Entwickler → CLI

Die nameocean CLI

Eine statische Binärdatei für macOS, Linux und Windows, auf Intel und ARM. Verwalten Sie DNS, SSL, Domains, App-Server und Ports über Ihr Terminal oder Ihre Skripte und verbinden Sie Ihre KI-Clients mit einem einzigen Befehl mit NameOcean.

Installieren

Homebrew (macOS, Linux)
$ brew install nameocean/tap/nameocean
Skript (macOS, Linux)
$ curl -fsSL https://nameocean.net/install.sh | sh

Das Skript prüft den Download anhand von checksums.txt und installiert nach /usr/local/bin oder nach ~/.local/bin, falls dort keine Schreibrechte bestehen.

Binärdatei herunterladen

Eine Datei, keine Installation nötig. Diese Links liefern immer die neueste Version.

macOS, Linux
$ chmod +x nameocean-darwin-arm64
$ xattr -d com.apple.quarantine nameocean-darwin-arm64   # macOS, im Browser heruntergeladen
$ sudo mv nameocean-darwin-arm64 /usr/local/bin/nameocean

Benennen Sie die Datei unter Windows in nameocean.exe um und legen Sie sie in einem Ordner ab, der in Ihrem PATH liegt. Die Binärdateien sind noch nicht signiert, daher können macOS Gatekeeper und Windows SmartScreen beim ersten Start eine Warnung anzeigen. Prüfen Sie einen Download anhand von checksums.txt; ältere Versionen und Archive finden Sie unter GitHub Releases.

Anmelden

Ihr Computer
$ nameocean login
$ nameocean account

login öffnet den Browser, um die CLI freizugeben (OAuth mit PKCE). Die Tokens werden im Schlüsselbund des Betriebssystems gespeichert und automatisch erneuert; nameocean logout widerruft sie. Auf Rechnern ohne Schlüsselbund, etwa einem Linux-Server, werden sie in ~/.config/nameocean/credentials.json gespeichert und sind nur für Sie lesbar.

Server und CI
$ export NAMEOCEAN_API_KEY=<API key>
$ nameocean dns ls example.com

Rufen Sie den Schlüssel unter Dashboard → API-Schlüssel ab. NAMEOCEAN_API_KEY hat immer Vorrang vor gespeicherten Zugangsdaten, und es wird nichts auf die Festplatte geschrieben.

Verbinden Sie Ihre KI

MCP
$ nameocean mcp install

Findet Claude Code, Cursor und OpenCode auf Ihrem Computer und fügt den NameOcean MCP-Server zu jedem hinzu. Ihre vorhandenen Einstellungen bleiben erhalten. Der Client meldet sich beim ersten Einsatz eines NameOcean-Tools im Browser an.

Befehle

accountAnzahlen von E-Mails, Guthaben, Domains und Zonen
domains lsIhre Domains mit Ablaufdatum, automatischer Verlängerung und Sperre
domains check <domain> [--years N]Verfügbarkeit und Preis
dns ls [zone]Ihre Zonen oder die Einträge einer Zone
dns add <zone> <type> <hostname> <value> [--ttl 1h] [--priority N]Eintrag hinzufügen: A, AAAA, CNAME, MX, TXT, SRV, PTR oder eine HTTP-Weiterleitung
dns rm <zone> <type> <id>Datensatz löschen
ssl status <zone>Zertifikatsstatus und Ablaufdatum
ssl issue <zone> [--wait]Wildcard-Zertifikat von Let's Encrypt ausstellen
servers lsIhre App-Server
servers info <server>SSH, git remote, Ports und Domains eines Servers
ports ls|open|close <server> <port> [-p udp]TCP/UDP-Ports öffnen und schließen; der externe Port wird zugewiesen
bind <domain> <server>Eine Domain mit einem Server bereitstellen: DNS, SSL und Load Balancer
unbind <domain> <server>Die Bereitstellung einer Domain über einen Server beenden
email domains ls|info <domain>Mail-Domains mit ihren Postfächern, Aliassen, Listen und Einstellungen für Mail-Apps
email check <domain>NS, MX, SPF, DKIM und DMARC einer Mail-Domain, live
email mailboxes ls|add|set|passwd|rm <domain> <username>Postfächer anlegen, Speicherkontingent ändern, Passwörter festlegen oder generieren, löschen
email aliases ls|add|rm <domain> <alias> [mailbox]Zusätzliche Adressen, die in ein Postfach zugestellt werden
email lists ls|add|members|rm <domain> <address> [member…]Mailinglisten der Postfächer der Domain
email forwards ls|on|off|add|rm|targets|verify|log|releaseKostenlose Weiterleitung für bei NameOcean registrierte Domains, inklusive Mail-Log
email inbound ls|add|rotate|rm <domain> <localpart> [url]Eingehende E-Mails einer Adresse als signiertes JSON an Ihren Endpunkt senden
mcp install [--client claude-code,cursor,opencode]KI-Clients mit dem MCP-Server verbinden
login | logoutMit dem Browser oder --token anmelden; abmelden und den Token widerrufen
completion bash|zsh|fish|powershellShell-Autovervollständigung (Homebrew installiert sie für Sie)

ist die Server-ID oder die Standarddomain, beispielsweise 3f9a1c2e oder 3f9a1c2e.nameocean.org.

Beispiele

nameocean
$ nameocean dns add example.com A @ 203.0.113.10 --ttl 5m
$ nameocean dns add example.com CNAME www @
$ nameocean dns add example.com MX @ mail.example.com --priority 10
$ nameocean dns add example.com TXT @ "v=spf1 include:_spf.google.com ~all"
$ nameocean ssl issue example.com --wait
$ nameocean bind example.com 3f9a1c2e
$ nameocean servers ls --json | jq '.servers[].default_domain'

Skripte und Agenten

Jeder Befehl akzeptiert --json und gibt anschließend das JSON der API unverändert aus; Fehler werden als Fehlerobjekt auf stdout ausgegeben. Ein fehlgeschlagener Befehl endet mit einem Exit-Code ungleich null.

Die CLI gibt niemals Geld aus. Registrieren und erneuern Sie Domains auf nameocean.net oder über die REST API.

Issues und Releases

Die Versionshinweise finden Sie unter GitHub Releases; melden Sie Fehler in Issues. Führen Sie brew upgrade nameocean aus oder starten Sie das Installationsskript erneut, um die CLI zu aktualisieren.