Geliştiriciler → CLI

nameocean CLI

macOS, Linux ve Windows için, Intel ve ARM üzerinde çalışan tek bir statik ikili dosya. DNS'i, SSL'i, alan adlarını, uygulama sunucularını ve portları terminalinizden veya betiklerinizden yönetin, yapay zekâ istemcilerinizi tek bir komutla NameOcean'a bağlayın.

Kurulum

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

Betik, indirilen dosyayı checksums.txt ile doğrular ve /usr/local/bin dizinine, bu dizine yazma izni yoksa ~/.local/bin dizinine kurar.

İkili dosyayı indirin

Tek dosya, kurulum gerektirmez. Bu bağlantılar her zaman en son sürümü sunar.

macOS, Linux
$ chmod +x nameocean-darwin-arm64
$ xattr -d com.apple.quarantine nameocean-darwin-arm64   # macOS'ta tarayıcıdan indirdiyseniz
$ sudo mv nameocean-darwin-arm64 /usr/local/bin/nameocean

Windows'ta dosyanın adını nameocean.exe olarak değiştirin ve PATH'inizdeki bir klasöre koyun. İkili dosyalar henüz imzalı olmadığından macOS Gatekeeper ve Windows SmartScreen ilk çalıştırmada uyarı gösterebilir. İndirdiğiniz dosyayı checksums.txt ile doğrulayın; eski sürümler ve arşivler GitHub Releases sayfasındadır.

Giriş Yap

Bilgisayarın
$ nameocean login
$ nameocean account

login komutu, CLI'ı onaylamanız için tarayıcıyı açar (PKCE ile OAuth). Token'lar işletim sisteminin anahtar zincirinde saklanır ve otomatik olarak yenilenir; nameocean logout bunları iptal eder. Linux sunucusu gibi anahtar zinciri olmayan bir makinede ise yalnızca sizin okuyabileceğiniz ~/.config/nameocean/credentials.json dosyasına kaydedilir.

Sunucular ve CI
$ export NAMEOCEAN_API_KEY=<API key>
$ nameocean dns ls example.com

Anahtarı Panel → API Anahtarı'ndan al. NAMEOCEAN_API_KEY her zaman kayıtlı kimlik bilgilerinin önüne geçer ve diske hiçbir şey yazılmaz.

AI'ını bağla

MCP
$ nameocean mcp install

Bilgisayarındaki Claude Code, Cursor ve OpenCode'u bulur ve her birine NameOcean MCP sunucusunu ekler. Mevcut ayarların korunur. İstemci bir NameOcean aracını ilk kullandığında tarayıcıda giriş yapar.

Komutlar

accountE-posta, bakiye, alan adı ve bölge sayıları
domains lsAlan adların; bitiş tarihi, otomatik yenileme ve kilit durumuyla
domains check <domain> [--years N]Uygunluk ve fiyat
dns ls [zone]Bölgelerin ya da bir bölgenin kayıtları
dns add <zone> <type> <hostname> <value> [--ttl 1h] [--priority N]Kayıt ekle: A, AAAA, CNAME, MX, TXT, SRV, PTR veya HTTP yönlendirme
dns rm <zone> <type> <id>Kaydı silin
ssl status <zone>Sertifika durumu ve bitiş tarihi
ssl issue <zone> [--wait]Wildcard Let's Encrypt sertifikası al
servers lsUygulama sunucuların
servers info <server>Bir sunucunun SSH, git remote, port ve alan adı bilgileri
ports ls|open|close <server> <port> [-p udp]TCP/UDP port aç ve kapat; dış port otomatik atanır
bind <domain> <server>Bir alan adını sunucudan yayınla: DNS, SSL ve yük dengeleyici
unbind <domain> <server>Bir alan adının sunucudan yayınını durdur
email domains ls|info <domain>Posta alan adları, posta kutuları, takma adlar, listeler ve posta uygulaması ayarları
email check <domain>Bir posta alan adının NS, MX, SPF, DKIM ve DMARC kayıtları, canlı
email mailboxes ls|add|set|passwd|rm <domain> <username>Posta kutusu oluşturun, kotayı değiştirin, parola belirleyin veya oluşturun, silin
email aliases ls|add|rm <domain> <alias> [mailbox]Bir posta kutusuna teslim edilen ek adresler
email lists ls|add|members|rm <domain> <address> [member…]Alan adının posta kutularına ait e-posta listeleri
email forwards ls|on|off|add|rm|targets|verify|log|releaseNameOcean'da kayıtlı alan adları için ücretsiz yönlendirme ve posta günlüğü
email inbound ls|add|rotate|rm <domain> <localpart> [url]Bir adrese gelen postaları imzalı JSON olarak uç noktanıza gönderin
mcp install [--client claude-code,cursor,opencode]AI istemcilerini MCP sunucusuna bağla
login | logoutTarayıcıyla ya da --token ile giriş yap; çıkış yap ve iptal et
completion bash|zsh|fish|powershellKabuk tamamlama (Homebrew senin için kurar)

, sunucunun kimliği ya da varsayılan alan adıdır; örneğin 3f9a1c2e veya 3f9a1c2e.nameocean.org.

Örnekler

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'

Betikler ve ajanlar

Her komut --json alır ve API'nin JSON'unu olduğu gibi basar; hatalar stdout'a bir error nesnesi olarak gelir. Başarısız bir komut sıfırdan farklı bir çıkış koduyla biter.

CLI asla para harcamaz. Alan adlarını nameocean.net'te ya da REST API ile kaydet ve yenile.

Hatalar ve sürümler

Sürüm notları GitHub Releases'ta; hataları Issues'a bildir. Güncellemek için brew upgrade nameocean çalıştır ya da kurulum betiğini yeniden çalıştır.