Разработчикам → CLI

CLI nameocean

Один статический бинарный файл для macOS, Linux и Windows на Intel и ARM. Управляйте DNS, SSL, доменами, серверами приложений и портами из терминала или своих скриптов и подключайте AI-клиенты к NameOcean одной командой.

Установка

Homebrew (macOS, Linux)
$ brew install nameocean/tap/nameocean
Скрипт (macOS, Linux)
$ curl -fsSL https://nameocean.net/install.sh | sh

Скрипт проверяет загруженный файл по checksums.txt и устанавливает его в /usr/local/bin или в ~/.local/bin, если запись в первый каталог недоступна.

Скачать бинарный файл

Один файл, ничего не нужно устанавливать. По этим ссылкам всегда доступна последняя версия.

macOS, Linux
$ chmod +x nameocean-darwin-arm64
$ xattr -d com.apple.quarantine nameocean-darwin-arm64   # macOS, загрузка через браузер
$ sudo mv nameocean-darwin-arm64 /usr/local/bin/nameocean

В Windows переименуйте файл в nameocean.exe и поместите его в папку, указанную в PATH. Бинарные файлы пока не подписаны, поэтому при первом запуске macOS Gatekeeper и Windows SmartScreen могут показать предупреждение. Проверьте загруженный файл по checksums.txt; предыдущие версии и архивы доступны на GitHub Releases.

Войти

Ваш компьютер
$ nameocean login
$ nameocean account

Команда login открывает браузер, чтобы Вы подтвердили доступ для CLI (OAuth с PKCE). Токены хранятся в связке ключей ОС и обновляются автоматически; команда nameocean logout отзывает их. На машине без связки ключей, например на Linux-сервере, они сохраняются в ~/.config/nameocean/credentials.json и доступны для чтения только Вам.

Серверы и CI
$ export NAMEOCEAN_API_KEY=<API key>
$ nameocean dns ls example.com

Получите ключ в разделе Панель управления → API-ключ. Переменная NAMEOCEAN_API_KEY всегда имеет приоритет над сохранёнными учётными данными, и на диск ничего не записывается.

Подключите свой ИИ

MCP
$ nameocean mcp install

Находит на Вашем компьютере Claude Code, Cursor и OpenCode и добавляет в каждый MCP-сервер NameOcean. Ваши текущие настройки сохраняются. При первом использовании инструмента NameOcean клиент выполнит вход в браузере.

Команды

accountКоличество адресов email, средств на счёте, доменов и зон
domains lsВаши домены со сроком действия, автопродлением и блокировкой
domains check <domain> [--years N]Доступность и цена
dns ls [zone]Ваши зоны или записи одной зоны
dns add <zone> <type> <hostname> <value> [--ttl 1h] [--priority N]Добавить запись: A, AAAA, CNAME, MX, TXT, SRV, PTR или HTTP-перенаправление
dns rm <zone> <type> <id>Удаление записи
ssl status <zone>Состояние сертификата и срок действия
ssl issue <zone> [--wait]Выпустить wildcard-сертификат Let's Encrypt
servers lsВаши серверы приложений
servers info <server>SSH, git remote, порты и домены сервера
ports ls|open|close <server> <port> [-p udp]Открыть и закрыть TCP/UDP-порты; внешний порт назначается автоматически
bind <domain> <server>Обслуживать домен с сервера: DNS, SSL и балансировщик нагрузки
unbind <domain> <server>Прекратить обслуживание домена с сервера
email domains ls|info <domain>Почтовые домены, их почтовые ящики, псевдонимы, списки рассылки и настройки почтовых приложений
email check <domain>NS, MX, SPF, DKIM и DMARC почтового домена в реальном времени
email mailboxes ls|add|set|passwd|rm <domain> <username>Создание почтовых ящиков, изменение квоты, установка или генерация паролей, удаление
email aliases ls|add|rm <domain> <alias> [mailbox]Дополнительные адреса, письма на которые доставляются в почтовый ящик
email lists ls|add|members|rm <domain> <address> [member…]Списки рассылки почтовых ящиков домена
email forwards ls|on|off|add|rm|targets|verify|log|releaseБесплатная переадресация для доменов, зарегистрированных в NameOcean, и её почтовый журнал
email inbound ls|add|rotate|rm <domain> <localpart> [url]Отправка входящей почты адреса на Ваш endpoint в виде подписанного JSON
mcp install [--client claude-code,cursor,opencode]Подключить ИИ-клиенты к MCP-серверу
login | logoutВойти через браузер или с помощью --token; выйти и отозвать доступ
completion bash|zsh|fish|powershellАвтодополнение в оболочке (Homebrew устанавливает его автоматически)

— это идентификатор сервера или его домен по умолчанию, например 3f9a1c2e или 3f9a1c2e.nameocean.org.

Примеры

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'

Скрипты и агенты

Каждая команда принимает --json и тогда выводит JSON API без изменений; ошибки выводятся в stdout в виде объекта error. Неудачная команда завершается с ненулевым кодом.

CLI никогда не тратит деньги. Регистрируйте и продлевайте домены на nameocean.net или через REST API.

Проблемы и релизы

Примечания к релизам доступны на GitHub Releases; о найденных ошибках сообщайте в Issues. Для обновления выполните brew upgrade nameocean или снова запустите установочный скрипт.