第一次用 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 / Linux | curl -fsSL https://aliyuncli.alicdn.com/cli-ext/domain-cli/install.sh | bash |
| Windows PowerShell | irm https://aliyuncli.alicdn.com/cli-ext/domain-cli/install.ps1 | iex |
| Windows CMD | powershell -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 把代码写完了,项目却还差一个能打开的网址)阿里云开发者社区
【免责声明】
- 本文命令、参数和报错处理来自阿里云官方帮助文档与开发者社区公开内容,CLI 版本迭代后子命令和参数可能调整,实际使用以本地 aliyun domain --help 和官方文档为准。
- 文中示例域名 example.com 仅作演示,执行写操作前请务必核对目标域名、变更内容和订单信息;CLI 不直接扣款,最终支付以官方订单页为准。
- 本文仅作工具上手指引,不构成域名注册、交易或投资建议,涉及实名、过户、转出限制等规则以域名注册局和控制台条款为准。
本文来自作者[极光寻踪]投稿,不代表新新网立场,如若转载,请注明出处:https://www.xxcmw.com/rgzn/202611/4046.html
评论列表(4条)
我是新新网的签约作者“极光寻踪”!
希望本篇文章《小白用户第一次用 DomainCLI从安装到第一次域名查询的完整指南》能对你有所帮助!
本站[新新网]内容主要涵盖:互联网行业的追踪与探索
本文概览:第一次用 DomainCLI(阿里云 CLI 的域名插件,命令入口是 aliyun domain),完整路径并不复杂:先用官方脚本在终端装好 CLI 和域名