Développeurs → CLI

Le CLI nameocean

Un seul binaire statique pour macOS, Linux et Windows, sur Intel et ARM. Gérez DNS, SSL, domaines, serveurs d'applications et ports depuis votre terminal ou vos scripts, et connectez vos clients IA à NameOcean en une seule commande.

Installation

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

Le script vérifie le téléchargement à l'aide de checksums.txt et l'installe dans /usr/local/bin, ou dans ~/.local/bin si ce dossier n'est pas accessible en écriture.

Télécharger le binaire

Un seul fichier, rien à installer. Ces liens pointent toujours vers la dernière version.

macOS, Linux
$ chmod +x nameocean-darwin-arm64
$ xattr -d com.apple.quarantine nameocean-darwin-arm64   # macOS, téléchargé dans le navigateur
$ sudo mv nameocean-darwin-arm64 /usr/local/bin/nameocean

Sous Windows, renommez le fichier en nameocean.exe et placez-le dans un dossier de votre PATH. Les binaires ne sont pas encore signés : macOS Gatekeeper et Windows SmartScreen peuvent donc afficher un avertissement la première fois. Vérifiez un téléchargement avec checksums.txt ; les versions antérieures et les archives sont disponibles sur GitHub Releases.

Se connecter

Votre ordinateur
$ nameocean login
$ nameocean account

login ouvre le navigateur pour autoriser la CLI (OAuth avec PKCE). Les jetons sont conservés dans le trousseau du système d'exploitation et renouvelés automatiquement ; nameocean logout les révoque. Sur une machine sans trousseau, comme un serveur Linux, ils sont enregistrés dans ~/.config/nameocean/credentials.json, lisible par vous seul.

Serveurs et CI
$ export NAMEOCEAN_API_KEY=<API key>
$ nameocean dns ls example.com

Récupérez la clé dans Tableau de bord → Clé API. NAMEOCEAN_API_KEY est toujours prioritaire sur les identifiants enregistrés, et rien n'est écrit sur le disque.

Connectez votre IA

MCP
$ nameocean mcp install

Détecte Claude Code, Cursor et OpenCode sur votre ordinateur et ajoute le serveur MCP NameOcean à chacun. Vos paramètres existants sont conservés. Le client se connecte dans le navigateur la première fois qu'il utilise un outil NameOcean.

Commandes

accountNombre d'e-mails, de crédits, de domaines et de zones
domains lsVos domaines avec expiration, renouvellement automatique et verrouillage
domains check <domain> [--years N]Disponibilité et prix
dns ls [zone]Vos zones, ou les enregistrements d'une zone
dns add <zone> <type> <hostname> <value> [--ttl 1h] [--priority N]Ajouter un enregistrement : A, AAAA, CNAME, MX, TXT, SRV, PTR ou une redirection HTTP
dns rm <zone> <type> <id>Supprimer un enregistrement
ssl status <zone>État et expiration du certificat
ssl issue <zone> [--wait]Émettre un certificat Let's Encrypt wildcard
servers lsVos serveurs d'applications
servers info <server>SSH, dépôt git distant, ports et domaines d'un serveur
ports ls|open|close <server> <port> [-p udp]Ouvrir et fermer des ports TCP/UDP ; le port externe est attribué automatiquement
bind <domain> <server>Servir un domaine depuis un serveur : DNS, SSL et répartiteur de charge
unbind <domain> <server>Arrêter de servir un domaine depuis un serveur
email domains ls|info <domain>Domaines de messagerie, leurs boîtes mail, alias, listes et paramètres des applications de messagerie
email check <domain>NS, MX, SPF, DKIM et DMARC d'un domaine de messagerie, en temps réel
email mailboxes ls|add|set|passwd|rm <domain> <username>Créer des boîtes mail, modifier le quota, définir ou générer des mots de passe, supprimer
email aliases ls|add|rm <domain> <alias> [mailbox]Adresses supplémentaires distribuées dans une boîte mail
email lists ls|add|members|rm <domain> <address> [member…]Listes de diffusion des boîtes mail du domaine
email forwards ls|on|off|add|rm|targets|verify|log|releaseRedirection gratuite pour les domaines enregistrés chez NameOcean, et son journal de messagerie
email inbound ls|add|rotate|rm <domain> <localpart> [url]Envoyer les e-mails entrants d'une adresse vers votre endpoint au format JSON signé
mcp install [--client claude-code,cursor,opencode]Connecter des clients IA au serveur MCP
login | logoutSe connecter via le navigateur ou --token ; se déconnecter et révoquer l'accès
completion bash|zsh|fish|powershellComplétion du shell (Homebrew l'installe pour vous)

est l'identifiant du serveur ou son domaine par défaut, par exemple 3f9a1c2e ou 3f9a1c2e.nameocean.org.

Exemples

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 et agents

Chaque commande accepte --json et affiche alors le JSON de l'API tel quel ; les erreurs sont renvoyées sous forme d'objet error sur la sortie standard. Une commande en échec se termine avec un code non nul.

La CLI ne dépense jamais d'argent. Enregistrez et renouvelez vos domaines sur nameocean.net ou via l'API REST.

Problèmes et versions

Les notes de version sont disponibles sur GitHub Releases ; signalez les bugs dans Issues. Exécutez brew upgrade nameocean, ou relancez le script d'installation, pour mettre à jour.