Programadores → CLI
Um único binário estático para macOS, Linux e Windows, em Intel e ARM. Gerencie DNS, SSL, domínios, servidores de aplicação e portas a partir do seu terminal ou dos seus scripts, e conecte seus clientes de IA à NameOcean com um único comando.
$ brew install nameocean/tap/nameocean
$ curl -fsSL https://nameocean.net/install.sh | sh
O script verifica o download com o checksums.txt e instala em /usr/local/bin, ou em ~/.local/bin quando não há permissão de escrita.
Um único arquivo, nada para instalar. Estes links sempre fornecem a versão mais recente.
| Intel / AMD (x86-64) | ARM | |
|---|---|---|
| macOS | nameocean-darwin-amd64 | nameocean-darwin-arm64 (Apple silicon) |
| Linux | nameocean-linux-amd64 | nameocean-linux-arm64 |
| Windows | nameocean-windows-amd64.exe | nameocean-windows-arm64.exe |
$ chmod +x nameocean-darwin-arm64 $ xattr -d com.apple.quarantine nameocean-darwin-arm64 # macOS, baixado pelo navegador $ sudo mv nameocean-darwin-arm64 /usr/local/bin/nameocean
No Windows, renomeie o arquivo para nameocean.exe e coloque-o em uma pasta do seu PATH. Os binários ainda não são assinados, por isso o Gatekeeper do macOS e o SmartScreen do Windows podem exibir um aviso na primeira vez. Verifique o download com o checksums.txt; versões e arquivos anteriores estão disponíveis no GitHub Releases.
$ nameocean login $ nameocean account
O login abre o navegador para aprovar a CLI (OAuth com PKCE). Os tokens são guardados no chaveiro do sistema operacional e renovados automaticamente; nameocean logout os revoga. Em uma máquina sem chaveiro, como um servidor Linux, eles são salvos em ~/.config/nameocean/credentials.json, com leitura permitida apenas para você.
$ export NAMEOCEAN_API_KEY=<API key> $ nameocean dns ls example.com
Obtenha a chave em Painel → Chave de API. NAMEOCEAN_API_KEY tem sempre prioridade sobre as credenciais guardadas, e nada é gravado no disco.
$ nameocean mcp install
Encontra o Claude Code, o Cursor e o OpenCode no seu computador e adiciona o servidor MCP da NameOcean a cada um. As suas configurações existentes são mantidas. O cliente inicia sessão no navegador na primeira vez que utiliza uma ferramenta da NameOcean.
| account | Número de e-mails, créditos, domínios e zonas |
| domains ls | Os seus domínios com expiração, renovação automática e bloqueio |
| domains check <domain> [--years N] | Disponibilidade e preço |
| dns ls [zone] | As suas zonas, ou os registos de uma zona |
| dns add <zone> <type> <hostname> <value> [--ttl 1h] [--priority N] | Adicionar um registo: A, AAAA, CNAME, MX, TXT, SRV, PTR ou um redirecionamento HTTP |
| dns rm <zone> <type> <id> | Eliminar um registo |
| ssl status <zone> | Estado e expiração do certificado |
| ssl issue <zone> [--wait] | Emitir um certificado wildcard Let's Encrypt |
| servers ls | Os seus servidores de aplicações |
| servers info <server> | SSH, git remote, portas e domínios de um servidor |
| ports ls|open|close <server> <port> [-p udp] | Abrir e fechar portas TCP/UDP; a porta externa é atribuída automaticamente |
| bind <domain> <server> | Servir um domínio a partir de um servidor: DNS, SSL e balanceador de carga |
| unbind <domain> <server> | Parar de servir um domínio a partir de um servidor |
| email domains ls|info <domain> | Domínios de e-mail, as suas caixas de correio, aliases, listas e definições das aplicações de e-mail |
| email check <domain> | NS, MX, SPF, DKIM e DMARC de um domínio de e-mail, em tempo real |
| email mailboxes ls|add|set|passwd|rm <domain> <username> | Criar caixas de correio, alterar a quota, definir ou gerar palavras-passe, eliminar |
| email aliases ls|add|rm <domain> <alias> [mailbox] | Endereços adicionais entregues numa caixa de correio |
| email lists ls|add|members|rm <domain> <address> [member…] | Listas de distribuição das caixas de correio do domínio |
| email forwards ls|on|off|add|rm|targets|verify|log|release | Reencaminhamento gratuito para domínios registados na NameOcean e o respetivo registo de e-mail |
| email inbound ls|add|rotate|rm <domain> <localpart> [url] | Envie o e-mail recebido num endereço para o seu endpoint como JSON assinado |
| mcp install [--client claude-code,cursor,opencode] | Ligar clientes de IA ao servidor MCP |
| login | logout | Iniciar sessão com o navegador ou --token; terminar sessão e revogar |
| completion bash|zsh|fish|powershell | Autocompletar do shell (o Homebrew instala-o por si) |
$ 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'
Todos os comandos aceitam --json e então apresentam o JSON da API sem alterações; os erros surgem como um objeto error na saída padrão. Um comando que falha termina com um código diferente de zero.
A CLI nunca gasta dinheiro. Registe e renove domínios em nameocean.net ou com a API REST.
As notas de versão estão em GitHub Releases; reporte erros em Issues. Para atualizar, execute brew upgrade nameocean ou execute novamente o script de instalação.