Desarrolladores → CLI

La CLI de nameocean

Un único binario estático para macOS, Linux y Windows, en Intel y ARM. Gestione DNS, SSL, dominios, servidores de aplicaciones y puertos desde su terminal o sus scripts, y conecte sus clientes de IA a NameOcean con un solo comando.

Instalar

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

El script verifica la descarga con checksums.txt y la instala en /usr/local/bin, o en ~/.local/bin si no se tienen permisos de escritura.

Descargar el binario

Un solo archivo, sin instalación. Estos enlaces siempre ofrecen la versión más reciente.

macOS, Linux
$ chmod +x nameocean-darwin-arm64
$ xattr -d com.apple.quarantine nameocean-darwin-arm64   # macOS, descargado desde el navegador
$ sudo mv nameocean-darwin-arm64 /usr/local/bin/nameocean

En Windows, cambie el nombre del archivo a nameocean.exe y colóquelo en una carpeta incluida en su PATH. Los binarios aún no están firmados, por lo que macOS Gatekeeper y Windows SmartScreen pueden mostrar una advertencia la primera vez. Verifique la descarga con checksums.txt; las versiones y archivos anteriores están disponibles en GitHub Releases.

Iniciar sesión

Su ordenador
$ nameocean login
$ nameocean account

login abre el navegador para autorizar la CLI (OAuth con PKCE). Los tokens se guardan en el llavero del sistema operativo y se renuevan automáticamente; nameocean logout los revoca. En un equipo sin llavero, como un servidor Linux, se guardan en ~/.config/nameocean/credentials.json, legible solo por usted.

Servidores y CI
$ export NAMEOCEAN_API_KEY=<API key>
$ nameocean dns ls example.com

Obtenga la clave en Panel → Clave de API. NAMEOCEAN_API_KEY siempre tiene prioridad sobre las credenciales guardadas y no se escribe nada en disco.

Conecte sus clientes de IA

MCP
$ nameocean mcp install

Encuentra Claude Code, Cursor y OpenCode en su ordenador y añade el servidor MCP de NameOcean a cada cliente. Se conserva su configuración actual. El cliente inicia sesión en el navegador la primera vez que utiliza una herramienta de NameOcean.

Comandos

accountRecuentos de correos electrónicos, créditos, dominios y zonas
domains lsSus dominios con vencimiento, renovación automática y bloqueo
domains check <domain> [--years N]Disponibilidad y precio
dns ls [zone]Sus zonas o los registros de una zona
dns add <zone> <type> <hostname> <value> [--ttl 1h] [--priority N]Añada un registro: A, AAAA, CNAME, MX, TXT, SRV, PTR o una redirección HTTP
dns rm <zone> <type> <id>Eliminar un registro
ssl status <zone>Estado y vencimiento del certificado
ssl issue <zone> [--wait]Emita un certificado wildcard de Let's Encrypt
servers lsSus servidores de aplicaciones
servers info <server>SSH, git remote, puertos y dominios de un servidor
ports ls|open|close <server> <port> [-p udp]Abra y cierre puertos TCP/UDP; el puerto externo se asigna
bind <domain> <server>Sirva un dominio desde un servidor: DNS, SSL y balanceador de carga
unbind <domain> <server>Deje de servir un dominio desde un servidor
email domains ls|info <domain>Dominios de correo, sus buzones, alias, listas y configuración de aplicaciones de correo
email check <domain>NS, MX, SPF, DKIM y DMARC de un dominio de correo, en tiempo real
email mailboxes ls|add|set|passwd|rm <domain> <username>Cree buzones, cambie la cuota, establezca o genere contraseñas, elimine
email aliases ls|add|rm <domain> <alias> [mailbox]Direcciones adicionales que se entregan a un buzón
email lists ls|add|members|rm <domain> <address> [member…]Listas de correo de los buzones del dominio
email forwards ls|on|off|add|rm|targets|verify|log|releaseReenvío gratuito para dominios registrados en NameOcean y su registro de correo
email inbound ls|add|rotate|rm <domain> <localpart> [url]Envíe el correo entrante de una dirección a su endpoint como JSON firmado
mcp install [--client claude-code,cursor,opencode]Conecte clientes de IA al servidor MCP
login | logoutInicie sesión con el navegador o mediante --token; cierre la sesión y revoque los tokens
completion bash|zsh|fish|powershellAutocompletado del shell (Homebrew lo instala por usted)

es el ID del servidor o el dominio predeterminado, por ejemplo 3f9a1c2e o 3f9a1c2e.nameocean.org.

Ejemplos

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'

Scripts y agentes

Cada comando acepta --json y luego imprime el JSON de la API sin cambios; los errores se devuelven como un objeto de error en stdout. Un comando fallido sale con un código distinto de cero.

La CLI nunca gasta dinero. Registra y renueva dominios en nameocean.net o mediante la API REST.

Incidencias y versiones

Las notas de versión están en GitHub Releases; informa de errores en Issues. Ejecuta brew upgrade nameocean, o vuelve a ejecutar el script de instalación, para actualizar.