Vývojáři → CLI

Nástroj nameocean CLI

Jeden statický binární soubor pro macOS, Linux a Windows, pro Intel i ARM. Spravujte DNS, SSL, domény, aplikační servery a porty z terminálu nebo ze svých skriptů a jedním příkazem připojte své AI klienty k NameOcean.

Nainstalovat

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

Skript ověří stažený soubor podle checksums.txt a nainstaluje jej do /usr/local/bin, případně do ~/.local/bin, pokud do první složky nelze zapisovat.

Stáhnout binární soubor

Jeden soubor, nic se neinstaluje. Tyto odkazy vždy vedou na nejnovější verzi.

macOS, Linux
$ chmod +x nameocean-darwin-arm64
$ xattr -d com.apple.quarantine nameocean-darwin-arm64   # macOS, stažení v prohlížeči
$ sudo mv nameocean-darwin-arm64 /usr/local/bin/nameocean

Ve Windows soubor přejmenujte na nameocean.exe a umístěte jej do složky, která je v PATH. Binární soubory zatím nejsou podepsané, takže macOS Gatekeeper a Windows SmartScreen mohou při prvním spuštění zobrazit varování. Stažený soubor si ověřte podle checksums.txt; starší verze a archivy najdete na GitHub Releases.

Přihlášení

Váš počítač
$ nameocean login
$ nameocean account

login otevře prohlížeč pro schválení CLI (OAuth s PKCE). Tokeny se ukládají do klíčenky operačního systému a automaticky se obnovují; nameocean logout je zneplatní. Na počítači bez klíčenky, například na linuxovém serveru, se ukládají do ~/.config/nameocean/credentials.json, který můžete číst pouze vy.

Servery a CI
$ export NAMEOCEAN_API_KEY=<API key>
$ nameocean dns ls example.com

Klíč získáte v Ovládací panel → API klíč. NAMEOCEAN_API_KEY má vždy přednost před uloženými přihlašovacími údaji a na disk se nic nezapisuje.

Připojte svou AI

MCP
$ nameocean mcp install

Najde na vašem počítači Claude Code, Cursor a OpenCode a do každého z nich přidá NameOcean MCP server. Vaše stávající nastavení zůstane zachováno. Klient se při prvním použití nástroje NameOcean přihlásí v prohlížeči.

Příkazy

accountPočty e-mailů, kreditů, domén a zón
domains lsVaše domény s termínem vypršení, automatickým obnovením a zámkem
domains check <domain> [--years N]Dostupnost a cena
dns ls [zone]Vaše zóny nebo záznamy jedné zóny
dns add <zone> <type> <hostname> <value> [--ttl 1h] [--priority N]Přidat záznam: A, AAAA, CNAME, MX, TXT, SRV, PTR nebo přesměrování HTTP
dns rm <zone> <type> <id>Smazat záznam
ssl status <zone>Stav certifikátu a vypršení platnosti
ssl issue <zone> [--wait]Vydat certifikát Let's Encrypt s wildcardem
servers lsVaše aplikační servery
servers info <server>SSH, git remote, porty a domény serveru
ports ls|open|close <server> <port> [-p udp]Otevřít a zavřít porty TCP/UDP; externí port je přidělen
bind <domain> <server>Obsluhovat doménu ze serveru: DNS, SSL a vyvažovač zátěže
unbind <domain> <server>Přestat obsluhovat doménu ze serveru
email domains ls|info <domain>Poštovní domény, jejich schránky, aliasy, konference a nastavení poštovních aplikací
email check <domain>NS, MX, SPF, DKIM a DMARC poštovní domény v reálném čase
email mailboxes ls|add|set|passwd|rm <domain> <username>Vytváření schránek, změna kvóty, nastavení nebo generování hesel, mazání
email aliases ls|add|rm <domain> <alias> [mailbox]Další adresy doručované do schránky
email lists ls|add|members|rm <domain> <address> [member…]E-mailové konference ze schránek domény
email forwards ls|on|off|add|rm|targets|verify|log|releaseBezplatné přeposílání pro domény registrované u NameOcean a jeho poštovní log
email inbound ls|add|rotate|rm <domain> <localpart> [url]Odesílejte příchozí poštu adresy na váš endpoint jako podepsaný JSON
mcp install [--client claude-code,cursor,opencode]Připojit klienty AI k serveru MCP
login | logoutPřihlásit se v prohlížeči nebo pomocí --token; odhlásit se a zrušit platnost tokenu
completion bash|zsh|fish|powershellDokončování příkazů v shellu (Homebrew vám je nainstaluje)

je ID serveru nebo výchozí doména, například 3f9a1c2e nebo 3f9a1c2e.nameocean.org.

Příklady

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'

Skripty a agenti

Každý příkaz přijímá přepínač --json a poté vypíše JSON z API beze změny; chyby se vrací jako objekt chyby na stdout. Neúspěšný příkaz skončí nenulovým návratovým kódem.

CLI nikdy nevynakládá peníze. Registrujte a obnovujte domény na nameocean.net nebo pomocí REST API.

Problémy a vydání

Poznámky k vydání najdete v sekci GitHub Releases; chyby hláste v sekci Issues. Pro aktualizaci spusťte brew upgrade nameocean nebo znovu spusťte instalační skript.