zeabur-domain-register

Zeabur 域名注册与管理

始终使用 npx zeabur@latest 调用 Zeabur CLI。 切勿直接使用 zeabur 或通过其他方式安装。如果无法使用 npx，请先安装 Node.js。

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

搜索域名是否可用

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

返回域名是否可用及价格（以 USD 计）。每次仅检查一个域名。

支持的 TLD： .com、.net、.org、.io、.dev、.app、.co、.me、.xyz

购买域名

1. 创建注册人资料（如果尚无资料）

注册人资料是域名注册所需的 WHOIS 联系信息。

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

如果为空，请创建一份：

npx zeabur@latest domain registrant create \
  --first-name John \
  --last-name Doe \
  --email [email protected] \
  --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. 购买

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

• 购买可能需要最多 60 秒（向 OpenSRS 注册并创建 Cloudflare DNS 区域）
• 需要 Developer Plan 或更高级别的方案
• 价格以 USD 计

购买后，使用 zeabur-domain-dns 技能管理 DNS 记录，或使用 zeabur-domain-url 技能将域名绑定到 Zeabur 服务。

付款错误

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

操作： 引导用户前往 https://zeabur.com/account/billing

列出已购买的域名

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

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

获取域名详情

显示域名信息及关联的注册人资料（姓名、电子邮件、电话、国家/地区）：

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

使用 --json 获取结构化输出，其中包含完整的注册人资料。

续费域名

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

切换自动续费

# 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 registrant update --id <profile-id> --email [email protected] -i=false

仅更改提供的字段。

删除资料

无法删除正在被已注册域名使用的资料。

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

重要提示：资料与 WHOIS 联系人

更新注册人资料不会更新使用该资料购买的现有域名上的 WHOIS 联系人。若要更新域名上的实际 WHOIS 联系人，请使用 domain verification update-contact（见下文）。

---

ICANN 验证

购买域名后，ICANN 要求验证注册人的电子邮件地址。系统会自动发送验证邮件。如果 15 天内未完成验证，域名可能会被暂停。

检查验证状态

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

状态	含义
verified	电子邮件已验证，域名状态正常
pending	已发送验证邮件，等待用户操作
suspended	未能及时完成验证，域名已暂停
unknown	状态不可用（新域名或不支持的 TLD）

重新发送验证邮件

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

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

查找验证邮件的收件地址

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

“注册人资料”部分会显示电子邮件地址。

更新 WHOIS 联系人（修正错误的电子邮件地址）

如果注册人的电子邮件地址有误，请直接更新域名上的 WHOIS 联系人：

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

更改电子邮件地址会触发新的 ICANN 验证流程。

在交互模式下，命令会预填当前值，用户只需修改所需内容。

故障排除：域名已暂停

1. 检查状态：npx zeabur@latest domain verification status --id <id> -i=false
2. 如有需要，更新电子邮件地址：npx zeabur@latest domain verification update-contact --id <id>
3. 重新发送验证邮件：npx zeabur@latest domain verification resend --id <id> -i=false
4. 用户点击邮件中的链接
5. 几分钟后重新检查状态

故障排除：验证一直停留在“pending”

• 检查垃圾邮件文件夹
• 电子邮件服务商可能会拦截 OpenSRS/Tucows 的邮件
• 尝试重新发送：npx zeabur@latest domain verification resend --id <domain-id> -i=false
• 如果仍未收到，请改用其他电子邮件地址：npx zeabur@latest domain verification update-contact --id <domain-id>

---