DomainCLI 是阿里云推出的域名命令行管理工具,小白上手只需要完成安装、环境校验、登录授权三步,就能在终端里执行域名查询、域名状态核验、解析记录查看等操作,不用打开网页控制台,适合批量管理域名、写自动化脚本,整个首次查询流程属于只读操作,不会修改域名配置、不会产生扣费,新手可以放心跟着步骤跑通。
一、前置准备清单
- 操作系统:支持 Windows、macOS、Linux,Windows 推荐用 PowerShell,不要用普通 CMD
- 网络:可以正常访问阿里云官方服务,网络不通会导致脚本拉取失败
- 账号:提前准备好阿里云账号,账号需要开通域名服务权限
- 工具:系统自带终端,不需要额外提前安装复杂依赖,安装脚本会自动补齐阿里云 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"
说明:脚本会自动检测本地有没有阿里云 CLI,版本不够就升级,然后自动安装 aliyun-cli-domain 域名插件
三、安装验证步骤
- 安装完成之后,关闭当前终端,重新打开终端(避免环境变量没加载)
- 输入校验命令:
aliyun domain --help
- 正常结果:输出 DomainCLI 全部子命令列表;报错 command not found,优先重启终端,其次检查网络、权限
四、登录授权(首次必做)
执行登录命令:
aliyun domain login
终端会自动拉起浏览器,打开阿里云 OAuth 授权页面,扫码登录账号、确认授权;浏览器打不开的时候,终端会输出授权链接,复制到浏览器手动打开即可。
这套是临时 OAuth 凭证,不需要手动配置 AccessKey,对小白更友好,凭证自动保存在本地,不会明文展示。
五、第一次查询(3 种新手首选只读查询)
- 查询自己账号下所有域名(推荐第一条跑)
aliyun domain list --page 1 --limit 20
返回内容:域名名称、到期时间、域名状态、实名状态,纯查询,无修改风险
2. 查询某个域名是否可以注册、核验状态
aliyun domain check --domain test-example.com
- 查询域名解析记录
aliyun domain dns list --domain test-example.com
六、新手常见报错排查
- 报错权限不足:阿里云账号没有域名管理权限,去 RAM 控制台给账号开通域名相关权限
- 登录成功但是查询无数据:确认登录的账号,就是购买域名的阿里云账号,账号不要搞混
- 命令执行超时:检查网络,国内网络优先切换国内网络环境
- 插件缺失:手动执行插件安装命令 aliyun plugin install --names aliyun-cli-domain
七、新手使用重要提醒
- 上面 3 条都是只读查询,不会改动域名;修改解析、锁定域名、续费属于写操作,默认会预览,必须加--confirm=true才会提交
- 域名购买、续费不会直接在 CLI 扣款,会跳转官方订单页面确认,防止误扣费
- 适合场景:批量盘点域名到期时间、脚本自动化巡检、服务器环境无图形界面管理域名
【常见问题】
问题 1:小白第一次使用 DomainCLI,安装之后怎么验证 DomainCLI 是否装好?
回答 1:小白第一次使用 DomainCLI,安装完成重启终端,输入aliyun domain --help,正常输出命令列表就代表 DomainCLI 安装成功,提示 command not found 一般是终端没重启或者环境变量没加载。
问题 2:DomainCLI 登录的时候,必须配置 AccessKey 密钥吗?
回答 2:DomainCLI 支持 OAuth 浏览器扫码登录,小白入门不需要手动配置 AccessKey 密钥,执行aliyun domain login扫码授权即可,适合新手快速上手。
问题 3:DomainCLI 第一次查询,用哪条命令最安全,不会改动域名?
回答 3:DomainCLI 第一次查询优先使用aliyun domain list --page 1 --limit 20,这条属于只读查询,只会列出账号名下域名信息,不会修改域名配置、不会产生任何费用。
问题 4:DomainCLI 在 Windows 系统,用 CMD 还是 PowerShell 安装更稳定?
回答 4:DomainCLI 在 Windows 系统推荐使用 PowerShell 执行安装脚本,兼容性更好;CMD 也可以用兼容命令调用 PowerShell 脚本,但是稳定性不如直接 PowerShell。
【参考资料】
[2026-11-13](快速使用阿里云 CLI 域名命令)阿里云帮助中心
[2026-11-16](域名实用工具指南:从选名字到日常管理)阿里云开发者社区
[2026-11-10](管 300 个域名的人,最怕的不是报警)阿里云开发者社区
[2026-11-13](Quick start with Alibaba Cloud CLI domain commands)阿里云英文文档
【免责声明】
本文仅整理 DomainCLI 官方入门公开操作流程,DomainCLI 的权限、域名管控、扣费规则以阿里云域名官方文档为准;写操作命令存在域名变更风险,新手优先只读查询,执行修改类命令前务必预览确认,本文不构成线上域名生产环境操作建议。
