Sviluppatori → CLI

La CLI di nameocean

Un unico binario statico per macOS, Linux e Windows, su Intel e ARM. Gestisca DNS, SSL, domini, server applicativi e porte dal Suo terminale o dai Suoi script, e colleghi i Suoi client AI a NameOcean con un solo comando.

Installazione

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

Lo script verifica il download tramite checksums.txt e lo installa in /usr/local/bin, oppure in ~/.local/bin se la prima cartella non è scrivibile.

Scarica il binario

Un solo file, nessuna installazione. Questi link forniscono sempre l'ultima versione.

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

Su Windows, rinomini il file in nameocean.exe e lo inserisca in una cartella presente nel PATH. I binari non sono ancora firmati, quindi macOS Gatekeeper e Windows SmartScreen potrebbero mostrare un avviso al primo avvio. Verifichi il download con checksums.txt; le versioni precedenti e gli archivi sono disponibili su GitHub Releases.

Accedi

Il vostro computer
$ nameocean login
$ nameocean account

login apre il browser per autorizzare la CLI (OAuth con PKCE). I token vengono conservati nel portachiavi del sistema operativo e rinnovati automaticamente; nameocean logout li revoca. Su una macchina senza portachiavi, come un server Linux, vengono salvati in ~/.config/nameocean/credentials.json, leggibile solo da Lei.

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

Ottenete la chiave da Dashboard → API Key. NAMEOCEAN_API_KEY ha sempre la precedenza sulle credenziali salvate e non viene scritto nulla su disco.

Collegate la vostra AI

MCP
$ nameocean mcp install

Individua Claude Code, Cursor e OpenCode sul vostro computer e aggiunge a ciascuno il server MCP di NameOcean. Le impostazioni esistenti vengono mantenute. Il client esegue l'accesso nel browser la prima volta che usa uno strumento di NameOcean.

Comandi

accountNumero di email, credito, domini e zone
domains lsI vostri domini con scadenza, rinnovo automatico e blocco
domains check <domain> [--years N]Disponibilità e prezzo
dns ls [zone]Le vostre zone, oppure i record di una zona
dns add <zone> <type> <hostname> <value> [--ttl 1h] [--priority N]Aggiungi un record: A, AAAA, CNAME, MX, TXT, SRV, PTR o un redirect HTTP
dns rm <zone> <type> <id>Eliminare un record
ssl status <zone>Stato e scadenza del certificato
ssl issue <zone> [--wait]Emetti un certificato wildcard Let's Encrypt
servers lsI vostri server applicativi
servers info <server>SSH, git remote, porte e domini di un server
ports ls|open|close <server> <port> [-p udp]Apri e chiudi porte TCP/UDP; la porta esterna viene assegnata
bind <domain> <server>Servi un dominio da un server: DNS, SSL e load balancer
unbind <domain> <server>Interrompi la fornitura di un dominio da un server
email domains ls|info <domain>Domini di posta, relative caselle, alias, liste e impostazioni delle app di posta
email check <domain>NS, MX, SPF, DKIM e DMARC di un dominio di posta, in tempo reale
email mailboxes ls|add|set|passwd|rm <domain> <username>Creare caselle, modificare la quota, impostare o generare password, eliminare
email aliases ls|add|rm <domain> <alias> [mailbox]Indirizzi aggiuntivi recapitati a una casella
email lists ls|add|members|rm <domain> <address> [member…]Mailing list delle caselle del dominio
email forwards ls|on|off|add|rm|targets|verify|log|releaseInoltro gratuito per i domini registrati su NameOcean e relativo log della posta
email inbound ls|add|rotate|rm <domain> <localpart> [url]Inviare la posta in arrivo di un indirizzo al Suo endpoint come JSON firmato
mcp install [--client claude-code,cursor,opencode]Collega i client AI al server MCP
login | logoutAccedi con il browser o con --token; esci e revoca
completion bash|zsh|fish|powershellCompletamento della shell (Homebrew lo installa per Lei)

è l'ID del server o il dominio predefinito, ad esempio 3f9a1c2e o 3f9a1c2e.nameocean.org.

Esempi

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'

Script e agenti

Ogni comando accetta --json e stampa il JSON dell'API invariato; gli errori vengono restituiti come oggetto error su stdout. Un comando non riuscito termina con un codice diverso da zero.

La CLI non spende mai denaro. Registri e rinnovi i domini su nameocean.net o con l'API REST.

Problemi e release

Le note di rilascio sono su GitHub Releases; segnali i bug in Issues. Per aggiornare, esegua brew upgrade nameocean oppure lanci di nuovo lo script di installazione.