zeabur-domain-register

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Zeabur Domain Registration & Management

Zeabur 域名注册与管理

Always use
npx zeabur@latest
to invoke Zeabur CLI. Never use
zeabur
directly or any other installation method. If
npx
is not available, install Node.js first.

Zeabur can register and manage domains directly — no need for GoDaddy, Namecheap, or other registrars.

请始终使用
npx zeabur@latest
调用 Zeabur CLI。切勿直接使用
zeabur
或其他安装方式。若未安装
npx
，请先安装 Node.js。

Zeabur 可直接注册和管理域名——无需使用 GoDaddy、Namecheap 或其他域名注册商。

Search Domain Availability

搜索域名可用性

bash

npx zeabur@latest domain search example.com -i=false

Returns availability and price (in USD). Only checks one domain at a time.

Supported TLDs: .com, .net, .org, .io, .dev, .app, .co, .me, .xyz

bash

npx zeabur@latest domain search example.com -i=false

返回域名可用性及价格（以美元计价）。每次仅查询一个域名。

支持的顶级域名： .com、.net、.org、.io、.dev、.app、.co、.me、.xyz

Purchase a Domain

购买域名

1. Create a registrant profile (if none exists)

1. 创建注册人档案（若尚未创建）

A registrant profile is the WHOIS contact info required for domain registration.

bash

npx zeabur@latest domain registrant list -i=false --json

If empty, create one:

bash

npx zeabur@latest domain registrant create \
  --first-name John \
  --last-name Doe \
  --email john@example.com \
  --phone "+1.5551234567" \
  --address1 "123 Main St" \
  --city "San Francisco" \
  --state CA \
  --country US \
  --postal-code 94105 \
  -i=false

Required fields:

--first-name

--last-name

--email

--phone

--address1

--city

--state

--country

(ISO 3166-1 alpha-2),

--postal-code

Optional:

--address2

--organization

注册人档案是域名注册所需的WHOIS联系信息。

bash

npx zeabur@latest domain registrant list -i=false --json

若档案为空，请创建一个：

bash

npx zeabur@latest domain registrant create \
  --first-name John \
  --last-name Doe \
  --email john@example.com \
  --phone "+1.5551234567" \
  --address1 "123 Main St" \
  --city "San Francisco" \
  --state CA \
  --country US \
  --postal-code 94105 \
  -i=false

必填字段：

--first-name

、

--last-name

、

--email

、

--phone

、

--address1

、

--city

、

--state

、

--country

（ISO 3166-1 alpha-2格式）、

--postal-code

可选字段：

--address2

、

--organization

2. Purchase

2. 购买域名

bash

npx zeabur@latest domain purchase example.com --registrant-id <profile-id> -y -i=false

Purchase may take up to 60 seconds (registers with OpenSRS + creates Cloudflare DNS zone)
Requires Developer Plan or above
Prices are in USD

After purchasing, use the

zeabur-domain-dns

skill to manage DNS records, or use the

zeabur-domain-url

skill to bind the domain to a Zeabur service.

bash

npx zeabur@latest domain purchase example.com --registrant-id <profile-id> -y -i=false

购买流程可能需要长达60秒（通过OpenSRS注册并创建Cloudflare DNS区域）
需要开发者计划或更高等级的套餐
价格以美元计价

购买完成后，可使用

zeabur-domain-dns

技能管理DNS记录，或使用

zeabur-domain-url

技能将域名绑定到Zeabur服务。

Payment Errors

支付错误

text

ERROR  Purchase failed: please bind a credit card or recharge credits first

Action: Direct the user to https://zeabur.com/account/billing

text

ERROR  Purchase failed: please bind a credit card or recharge credits first

操作指引： 引导用户访问 https://zeabur.com/account/billing

List Purchased Domains

列出已购买的域名

Shows ID, domain, status, ICANN verification status, auto-renew, expiry, and price:

bash

npx zeabur@latest domain list-registered -i=false

显示域名ID、域名、状态、ICANN验证状态、自动续费状态、到期时间及价格：

bash

npx zeabur@latest domain list-registered -i=false

Get Domain Details

获取域名详情

Shows domain info plus the associated registrant profile (name, email, phone, country):

bash

npx zeabur@latest domain get-registered --id <domain-id> -i=false

Use

--json

for structured output including the full registrant profile.

显示域名信息及关联的注册人档案（姓名、邮箱、电话、国家）：

bash

npx zeabur@latest domain get-registered --id <domain-id> -i=false

添加

--json

参数可获取包含完整注册人档案的结构化输出。

Renew a Domain

续费域名

bash

npx zeabur@latest domain renew --id <domain-id> -y -i=false

bash

npx zeabur@latest domain renew --id <domain-id> -y -i=false

Toggle Auto-Renew

切换自动续费状态

bash

undefined

bash

undefined

Enable

开启自动续费

npx zeabur@latest domain auto-renew --id <domain-id> --enable -i=false

Disable

关闭自动续费

npx zeabur@latest domain auto-renew --id <domain-id> --disable -i=false

---

npx zeabur@latest domain auto-renew --id <domain-id> --disable -i=false

---

Registrant Profile Management

注册人档案管理

Update a profile

更新档案

bash

npx zeabur@latest domain registrant update --id <profile-id> --email new@example.com -i=false

Only provided fields are changed.

bash

npx zeabur@latest domain registrant update --id <profile-id> --email new@example.com -i=false

仅更新提供的字段。

Delete a profile

删除档案

Cannot delete a profile in use by registered domains.

bash

npx zeabur@latest domain registrant delete --id <profile-id> -y -i=false

无法删除已被注册域名使用的档案。

bash

npx zeabur@latest domain registrant delete --id <profile-id> -y -i=false

Important: Profile vs WHOIS Contact

重要提示：档案与WHOIS联系人的区别

Updating a registrant profile does not update the WHOIS contact on domains already purchased with that profile. To update the actual WHOIS contact on a domain, use

domain verification update-contact

(see below).

更新注册人档案不会更新已使用该档案购买的域名上的WHOIS联系人信息。若要更新域名实际的WHOIS联系人信息，请使用

domain verification update-contact

（详见下文）。

ICANN Verification

ICANN验证

After purchasing a domain, ICANN requires the registrant email to be verified. A verification email is sent automatically. If not verified within 15 days, the domain may be suspended.

购买域名后，ICANN要求验证注册人邮箱。系统会自动发送验证邮件。若未在15天内完成验证，域名可能会被暂停。

Check verification status

检查验证状态

bash

npx zeabur@latest domain verification status --id <domain-id> -i=false

Status	Meaning
`verified`	Email verified, domain is good
`pending`	Verification email sent, waiting for user action
`suspended`	Not verified in time, domain suspended
`unknown`	Status not available (new domain or unsupported TLD)

bash

npx zeabur@latest domain verification status --id <domain-id> -i=false

状态	含义
`verified`	邮箱已验证，域名状态正常
`pending`	验证邮件已发送，等待用户操作
`suspended`	未及时验证，域名已被暂停
`unknown`	状态不可用（新域名或不支持的顶级域名）

Resend verification email

重新发送验证邮件

bash

npx zeabur@latest domain verification resend --id <domain-id> -i=false

The email is sent by OpenSRS/Tucows. Remind the user to check spam/junk folders.

bash

npx zeabur@latest domain verification resend --id <domain-id> -i=false

验证邮件由OpenSRS/Tucows发送。提醒用户检查垃圾邮件文件夹。

Find which email verification is sent to

查询验证邮件发送至哪个邮箱

bash

npx zeabur@latest domain get-registered --id <domain-id> -i=false

The "Registrant Profile" section shows the email.

bash

npx zeabur@latest domain get-registered --id <domain-id> -i=false

“注册人档案”部分会显示对应的邮箱。

Update WHOIS contact (fix wrong email)

更新WHOIS联系人（修正错误邮箱）

If the registrant email is wrong, update the WHOIS contact directly on the domain:

bash

npx zeabur@latest domain verification update-contact --id <domain-id> \
  --first-name John \
  --last-name Doe \
  --email correct@example.com \
  --phone "+1.5551234567" \
  --address1 "123 Main St" \
  --city "San Francisco" \
  --state CA \
  --country US \
  --postal-code 94105 \
  -i=false

Changing the email triggers a new ICANN verification flow.

In interactive mode, the command pre-fills current values so the user only changes what's needed.

若注册人邮箱有误，请直接更新域名上的WHOIS联系人信息：

bash

npx zeabur@latest domain verification update-contact --id <domain-id> \
  --first-name John \
  --last-name Doe \
  --email correct@example.com \
  --phone "+1.5551234567" \
  --address1 "123 Main St" \
  --city "San Francisco" \
  --state CA \
  --country US \
  --postal-code 94105 \
  -i=false

修改邮箱会触发新的ICANN验证流程。

在交互模式下，命令会预填充当前值，用户只需修改需要变更的内容即可。

Troubleshooting: domain suspended

故障排查：域名被暂停

Check status:

npx zeabur@latest domain verification status --id <id> -i=false

Update email if needed:

npx zeabur@latest domain verification update-contact --id <id>

Resend verification:

npx zeabur@latest domain verification resend --id <id> -i=false

User clicks the link in the email
Re-check status after a few minutes

检查状态：

npx zeabur@latest domain verification status --id <id> -i=false

若需要，更新邮箱：

npx zeabur@latest domain verification update-contact --id <id>

重新发送验证邮件：

npx zeabur@latest domain verification resend --id <id> -i=false

用户点击邮件中的链接
几分钟后重新检查状态

Troubleshooting: verification stuck on "pending"

故障排查：验证状态一直显示“pending”

Check spam/junk folder
Email provider may block OpenSRS/Tucows emails

Try resending:

npx zeabur@latest domain verification resend --id <domain-id> -i=false

If still not received, update to a different email:

npx zeabur@latest domain verification update-contact --id <domain-id>

检查垃圾邮件文件夹
邮件服务商可能拦截了OpenSRS/Tucows发送的邮件

尝试重新发送：

npx zeabur@latest domain verification resend --id <domain-id> -i=false

若仍未收到，更换为其他邮箱：

npx zeabur@latest domain verification update-contact --id <domain-id>