nameocean CLI

一个静态二进制文件，支持 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。

下载二进制文件

单个文件，无需安装。这些链接始终提供最新版本。

	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

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（使用 PKCE 的 OAuth）。令牌保存在操作系统钥匙串中并自动刷新；nameocean logout 会撤销这些令牌。在没有钥匙串的机器上（例如 Linux 服务器），令牌将保存到 ~/.config/nameocean/credentials.json，且仅您本人可读取。

服务器和 CI

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

请从控制台 → API 密钥获取密钥。NAMEOCEAN_API_KEY 始终优先于已保存的凭据,且不会向磁盘写入任何内容。

连接您的 AI

MCP

$ nameocean mcp install

在您的电脑上查找 Claude Code、Cursor 和 OpenCode,并为每个客户端添加 NameOcean MCP 服务器。您现有的设置将被保留。客户端首次使用 NameOcean 工具时,会在浏览器中登录。

命令

account	邮箱、余额、域名和 DNS 区域数量
domains ls	您的域名,含到期时间、自动续费和锁定状态
domains check <domain> [--years N]	可用性和价格
dns ls [zone]	您的 DNS 区域,或某个区域的记录
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]	签发 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]	将某个地址收到的邮件以签名 JSON 形式推送到您的端点
mcp install [--client claude-code,cursor,opencode]	将 AI 客户端连接到 MCP 服务器
login \| logout	通过浏览器或 --token 登录;退出登录并撤销授权
completion bash\|zsh\|fish\|powershell	Shell 自动补全(Homebrew 会为您自动安装)

是服务器的 ID 或默认域名,例如 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,并会原样输出 API 返回的 JSON;错误会以 error 对象的形式输出到标准输出。命令执行失败时会返回非零退出码。

CLI 绝不会产生任何费用。请在 nameocean.net 或通过 REST API 注册和续费域名。

问题与版本发布

发行说明请见 GitHub Releases;如需报告错误,请前往 Issues。运行 brew upgrade nameocean,或重新运行安装脚本即可更新。