小白用户第一次用 DomainCLI从安装到第一次域名查询的完整指南

第一次用 DomainCLI(阿里云 CLI 的域名插件,命令入口是 aliyun domain),完整路径并不复杂:先用官方脚本在终端装好 CLI 和域名插件,执行 aliyun domain --help 确认命令可用,再用 aliyun domain login 走浏览器 OAuth 完成授权,最后从只读查询开始跑通第一条命令。新手建议前几次只做 list、search、check、price、dns list 这类不改变配置的查询动作;涉及 DNS 修改、转移锁、过户、续费等写操作时,工具默认只输出预览,核对无误后加确认参数才会真正提交,购买和续费也不会由 CLI 直接扣款。整份指南按 "准备 → 安装 → 登录 → 查询 → 排查" 的顺序拆开,照着命令逐条执行即可。

一、DomainCLI 是什么

  • 定位:DomainCLI 是阿里云 CLI 的域名管理插件,在终端里查询域名状态、可注册性、价格、解析记录,也可以接入支持 MCP 的 AI 助手代为调用。
  • 命令入口:统一以 aliyun domain 开头,子命令按任务划分,如 list、check、price、dns list。
  • 能力边界:插件只执行命令并返回可核对的结果,本身不内置大模型;它在账户权限范围内操作,登录身份和 RAM 权限决定能看到哪些域名。
  • 适合新手的原因:查询类命令全部只读,不会产生订单;写操作有预览和确认环节,不容易误改。

二、安装前先确认的几件事

检查项说明
操作系统支持 macOS、Linux、Windows PowerShell / CMD
终端macOS/Linux 用自带终端;Windows 用 PowerShell,CMD 下可通过 powershell 调用
账号需要一个阿里云账号,首次登录走浏览器 OAuth 授权,不需要手写 AccessKey
网络终端能访问阿里云命令服务;安装脚本会提示失败原因和下一步操作
已有 CLI若本地已有 3.5.0 以上版本的阿里云 CLI,可只补装域名插件,不必重装 CLI

三、安装 DomainCLI

1. 执行官方安装脚本

脚本会自动安装或升级阿里云 CLI,并安装域名插件。

系统安装命令
macOS / Linuxcurl -fsSL https://aliyuncli.alicdn.com/cli-ext/domain-cli/install.sh | bash
Windows PowerShellirm https://aliyuncli.alicdn.com/cli-ext/domain-cli/install.ps1 | iex
Windows CMDpowershell -c "irm https://aliyuncli.alicdn.com/cli-ext/domain-cli/install.ps1 | iex"

2. 已有阿里云 CLI 时只装插件

aliyun plugin install --names aliyun-cli-domain

3. 验证安装是否成功

aliyun domain --help

能显示域名命令列表,就说明插件安装成功。如果提示 command not found,先重启终端;仍不行就检查安装目录是否加入了系统 PATH。

四、登录授权

1. 首次登录

aliyun domain login

命令会尝试打开默认浏览器进入 OAuth 授权页面;浏览器没自动打开时,复制命令输出里的链接到浏览器完成授权即可。凭证由 CLI 保存为临时配置,不需要把 AccessKey、SecretKey 或 token 写进脚本,也不要粘贴给任何 AI 助手。

2. 核对当前身份

aliyun domain auth

aliyun domain whoami

这两条用来查看登录状态和当前身份。登录成功不等于拥有全部权限,也不等于对目标域名有管理权;如果提示权限不足,先核对当前登录身份和 RAM 授权。

3. 退出登录

aliyun domain logout --confirm=true

五、第一次查询:从只读命令开始

第一次跑命令,建议按下面顺序做,全程不产生订单、不改动配置。

第一步:查看账号下有哪些域名

aliyun domain list --page 1 --limit 20

返回当前账号下第一页 20 条域名记录,用来确认插件能正常读到账户数据。

第二步:按状态或到期时间筛选

aliyun domain search --status renewal-required

aliyun domain search --status redemption-required

aliyun domain search --expires-from 2027-01-01 --expires-to 2027-01-31

分别对应需要续费、进入赎回期、指定时间段到期的域名。

第三步:检查候选域名能否注册

aliyun domain check --domain example.com

把 example.com 换成自己的候选域名。这是纯只读查询,不会创建订单;加 --view raw 可以查看更完整的原始字段。

第四步:查询参考价格

aliyun domain price --domain example.com --years 2

--years 后面是注册年限,返回参考报价。注意区分注册价、续费价、溢价域名和一口价,下单前仍要在官方订单页最终确认。

第五步:查看现有解析记录

aliyun domain dns list --domain example.com

修改解析之前,先看一眼现有记录,避免覆盖已有配置。

六、常用命令速查表

想做的事命令
查看账号下域名aliyun domain list --page 1 --limit 20
按状态筛选aliyun domain search --status renewal-required
按到期日期筛选aliyun domain search --expires-from 2027-01-01 --expires-to 2027-01-31
查询可注册性aliyun domain check --domain example.com
查询参考价格aliyun domain price --domain example.com --years 2
查看解析记录aliyun domain dns list --domain example.com
新增解析记录aliyun domain dns create --domain example.com --host www --type A --value 192.0.2.1
查询转入资格aliyun domain transfer-in check --domain example.com
开启禁止转移锁aliyun domain transfer-lock --domains example.com --status on
查询实名状态aliyun domain verification domain-status --domain example.com
提交实名材料aliyun domain template verify --template-id <模板ID> --input-file ./verify.json
过户或变更持有人aliyun domain set-contact --domains example.com --template-id <模板ID> --type registrant
查看登录状态aliyun domain auth / aliyun domain whoami
退出登录aliyun domain logout --confirm=true

七、写操作的安全约定

  • 默认只预览:DNS 修改、转移锁、过户等命令默认只做本地校验和预览,不直接提交。
  • 确认参数:核对预览内容无误后,加 --confirm=true 才真正提交;涉及自动续费等后续周期扣费的,还要额外加 --ack-future-charge。
  • 不直接扣款:购买、续费、赎回、转入不会由 CLI 直接扣费,最终价格、账号和支付在官方订单页确认。
  • 先看现有记录:解析改动前先执行 dns list,改动后从访问侧验证是否生效。
  • 过户限制:持有人变更提交后会触发 60 天转出限制,完整规则和后缀限制以控制台为准。

八、新手常见报错排查

报错或现象排查方向
aliyun: command not found把安装目录加入 PATH,重新打开终端再试
没有 domain 命令执行 aliyun plugin install --names aliyun-cli-domain 补装插件
浏览器没有自动打开授权页复制命令输出中的授权链接,在浏览器手动打开
执行修改命令后设置没变化写命令默认只预览,核对后补 --confirm=true 重新执行
提示权限不足核对当前登录身份与 RAM 授权,确认对目标域名有管理权
trade detail 返回 INTERNAL若错误正文含 DomainNotOnSale,说明域名当前未在售,不是系统故障,无需重复调用

九、第一次上手检查清单

  • 安装脚本执行完成,aliyun domain --help 能显示命令列表
  • 浏览器 OAuth 授权通过,whoami 显示当前身份正确
  • 先跑 list 确认能读到名下域名,再做候选域名的 check 和 price
  • 查询结果记录查询时间;价格区分注册价、续费价、溢价或一口价
  • 任何写操作先看预览,确认域名和变更内容无误后再加确认参数
  • 命令参数随版本演进,遇到差异时以本地 --help 和官方文档为准

整体看,DomainCLI 对新手最友好的设计是 "只读先行、写操作二次确认":安装和登录完成后,第一次查询可以完全在不花钱、不改配置的前提下跑通;等熟悉 list、check、price、dns list 这些只读命令,再逐步接触解析管理、实名和过户等写操作,遇到报错先按预览和权限两条线排查即可。

【相关 FAQ】

问题 1:DomainCLI 是什么,小白第一次安装 DomainCLI 需要准备哪些条件?

回答 1:DomainCLI 是阿里云 CLI 的域名插件,命令入口为 aliyun domain,用来在终端查询域名状态、可注册性、价格和解析记录;第一次安装需要准备 macOS/Linux/Windows 终端、一个阿里云账号,网络可访问阿里云命令服务,安装时按官方脚本执行即可,登录走浏览器 OAuth,不需要手写 AccessKey。

问题 2:第一次安装完 DomainCLI 后,怎么确认安装成功并完成第一次域名查询?

回答 2:安装后执行 aliyun domain --help,能显示域名命令列表即安装成功;接着运行 aliyun domain login 完成浏览器授权,再用 aliyun domain list --page 1 --limit 20 查看名下域名,或用 aliyun domain check --domain example.com 查询候选域名可注册性,这些都是只读查询,不会产生订单。

问题 3:用 DomainCLI 第一次查询时提示 command not found 或没有 domain 命令,该怎么处理?

回答 3:提示 command not found 时,先把安装目录加入 PATH 并重启终端;提示没有 domain 子命令时,执行 aliyun plugin install --names aliyun-cli-domain 补装域名插件;若浏览器未自动打开授权页,复制命令输出中的链接手动打开完成登录即可。

【参考资料】

[2026-11-16](域名实用工具指南:从选名字到日常管理)阿里云开发者社区

[2026-11-13](快速使用阿里云 CLI 域名命令)阿里云帮助中心

[2026-11-13](Quick start with Alibaba Cloud CLI domain commands)阿里云帮助中心

[2026-11-10](管 300 个域名的人,最怕的不是报警)阿里云开发者社区

[2026-11-10](AI 把代码写完了,项目却还差一个能打开的网址)阿里云开发者社区

【免责声明】

  1. 本文命令、参数和报错处理来自阿里云官方帮助文档与开发者社区公开内容,CLI 版本迭代后子命令和参数可能调整,实际使用以本地 aliyun domain --help 和官方文档为准。
  2. 文中示例域名 example.com 仅作演示,执行写操作前请务必核对目标域名、变更内容和订单信息;CLI 不直接扣款,最终支付以官方订单页为准。
  3. 本文仅作工具上手指引,不构成域名注册、交易或投资建议,涉及实名、过户、转出限制等规则以域名注册局和控制台条款为准。

本文来自作者[极光寻踪]投稿,不代表新新网立场,如若转载,请注明出处:https://www.xxcmw.com/rgzn/202611/4046.html

赞 (0)
反馈

发表回复

本站作者后才能评论

评论列表(4条)

  • 极光寻踪
    极光寻踪 2026年11月18日

    我是新新网的签约作者“极光寻踪”!

  • 极光寻踪
    极光寻踪 2026年11月18日

    希望本篇文章《小白用户第一次用 DomainCLI从安装到第一次域名查询的完整指南》能对你有所帮助!

  • 极光寻踪
    极光寻踪 2026年11月18日

    本站[新新网]内容主要涵盖:互联网行业的追踪与探索

  • 极光寻踪
    极光寻踪 2026年11月18日

    本文概览:第一次用 DomainCLI(阿里云 CLI 的域名插件,命令入口是 aliyun domain),完整路径并不复杂:先用官方脚本在终端装好 CLI 和域名

联系我们

联系:143 0457 151

工作时间:周一至周五,9:30-18:30,节假日休息

关注我们