Dla programistów → CLI

nameocean CLI

Jeden statyczny plik binarny dla macOS, Linux i Windows, na Intel i ARM. Zarządzaj DNS, SSL, domenami, serwerami aplikacji i portami z terminala lub skryptów oraz połącz swoich klientów AI z NameOcean jednym poleceniem.

Instalacja

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

Skrypt weryfikuje pobrany plik z checksums.txt i instaluje go w /usr/local/bin lub w ~/.local/bin, gdy brak uprawnień do zapisu.

Pobierz plik binarny

Jeden plik, nic do instalowania. Te linki zawsze prowadzą do najnowszego wydania.

macOS, Linux
$ chmod +x nameocean-darwin-arm64
$ xattr -d com.apple.quarantine nameocean-darwin-arm64   # macOS, pobrany w przeglądarce
$ sudo mv nameocean-darwin-arm64 /usr/local/bin/nameocean

W systemie Windows zmień nazwę pliku na nameocean.exe i umieść go w folderze znajdującym się w zmiennej PATH. Pliki binarne nie są jeszcze podpisane, więc macOS Gatekeeper i Windows SmartScreen mogą przy pierwszym uruchomieniu wyświetlić ostrzeżenie. Zweryfikuj pobrany plik z checksums.txt; starsze wersje i archiwa znajdziesz w GitHub Releases.

Zaloguj się

Twój komputer
$ nameocean login
$ nameocean account

login otwiera przeglądarkę, aby zatwierdzić dostęp CLI (OAuth z PKCE). Tokeny są przechowywane w pęku kluczy systemu operacyjnego i odświeżane automatycznie; nameocean logout je unieważnia. Na komputerze bez pęku kluczy, np. na serwerze z systemem Linux, są zapisywane w ~/.config/nameocean/credentials.json z prawem odczytu tylko dla Ciebie.

Serwery i CI
$ export NAMEOCEAN_API_KEY=<API key>
$ nameocean dns ls example.com

Klucz znajdą Państwo w Panelu → Klucz API. Zmienna NAMEOCEAN_API_KEY zawsze ma pierwszeństwo przed zapisanymi danymi logowania i nic nie jest zapisywane na dysku.

Połącz swoją sztuczną inteligencję

MCP
$ nameocean mcp install

Wyszukuje na komputerze Claude Code, Cursor i OpenCode i dodaje do każdego serwer NameOcean MCP. Dotychczasowe ustawienia zostają zachowane. Klient loguje się w przeglądarce przy pierwszym użyciu narzędzia NameOcean.

Polecenia

accountLiczba adresów e-mail, środków, domen i stref
domains lsPaństwa domeny z datą wygaśnięcia, automatycznym odnowieniem i blokadą
domains check <domain> [--years N]Dostępność i cena
dns ls [zone]Państwa strefy lub rekordy jednej strefy
dns add <zone> <type> <hostname> <value> [--ttl 1h] [--priority N]Dodaj rekord: A, AAAA, CNAME, MX, TXT, SRV, PTR lub przekierowanie HTTP
dns rm <zone> <type> <id>Usuń rekord
ssl status <zone>Stan i data wygaśnięcia certyfikatu
ssl issue <zone> [--wait]Wystaw certyfikat wildcard Let's Encrypt
servers lsPaństwa serwery aplikacji
servers info <server>SSH, zdalne repozytorium git, porty i domeny serwera
ports ls|open|close <server> <port> [-p udp]Otwieraj i zamykaj porty TCP/UDP; port zewnętrzny jest przydzielany automatycznie
bind <domain> <server>Obsługuj domenę z serwera: DNS, SSL i load balancer
unbind <domain> <server>Przestań obsługiwać domenę z serwera
email domains ls|info <domain>Domeny pocztowe, ich skrzynki, aliasy, listy i ustawienia aplikacji pocztowych
email check <domain>NS, MX, SPF, DKIM i DMARC domeny pocztowej na żywo
email mailboxes ls|add|set|passwd|rm <domain> <username>Tworzenie skrzynek, zmiana limitu, ustawianie lub generowanie haseł, usuwanie
email aliases ls|add|rm <domain> <alias> [mailbox]Dodatkowe adresy dostarczane do skrzynki
email lists ls|add|members|rm <domain> <address> [member…]Listy mailingowe skrzynek domeny
email forwards ls|on|off|add|rm|targets|verify|log|releaseBezpłatne przekierowanie poczty dla domen zarejestrowanych w NameOcean oraz jego dziennik poczty
email inbound ls|add|rotate|rm <domain> <localpart> [url]Przesyłanie poczty przychodzącej na dany adres do Państwa endpointu jako podpisany JSON
mcp install [--client claude-code,cursor,opencode]Połącz klientów AI z serwerem MCP
login | logoutZaloguj się przez przeglądarkę lub --token; wyloguj się i unieważnij dostęp
completion bash|zsh|fish|powershellUzupełnianie poleceń w powłoce (Homebrew instaluje je automatycznie)

to identyfikator serwera lub jego domyślna domena, na przykład 3f9a1c2e lub 3f9a1c2e.nameocean.org.

Przykłady

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'

Skrypty i agenci

Każde polecenie przyjmuje --json i wtedy wypisuje JSON z API bez zmian; błędy są zwracane jako obiekt error na standardowym wyjściu. Nieudane polecenie kończy się kodem różnym od zera.

CLI nigdy nie wydaje pieniędzy. Domeny można rejestrować i odnawiać na nameocean.net lub przez REST API.

Zgłoszenia i wydania

Informacje o wydaniach znajdą Państwo w GitHub Releases; błędy można zgłaszać w Issues. Aby zaktualizować, użyjcie Państwo brew upgrade nameocean lub ponownie uruchomcie skrypt instalacyjny.