alicloud-network-dns-cli

Category: 工具

阿里云 DNS（Alidns）命令行工具

目标

• 通过 aliyun-cli 查询和管理阿里云 DNS 记录。
• 快速为 Function Compute 自定义域名配置 CNAME。

适用场景

• 需要在阿里云 DNS 中添加或更新 DNS 记录时。
• 需要为 FC 自定义域名配置 CNAME 时。

安装 aliyun-cli（无需 sudo）

curl -fsSL https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz -o /tmp/aliyun-cli.tgz
mkdir -p ~/.local/bin
 tar -xzf /tmp/aliyun-cli.tgz -C /tmp
mv /tmp/aliyun ~/.local/bin/aliyun
chmod +x ~/.local/bin/aliyun

配置凭证

~/.local/bin/aliyun configure set \
  --profile default \
  --access-key-id <AK> \
  --access-key-secret <SK> \
  --region cn-hangzhou

将区域配置为默认值；如果不确定最佳区域，请询问用户。

查询 DNS 记录

查询子域名记录：

~/.local/bin/aliyun alidns DescribeSubDomainRecords \
  --SubDomain news.example.com

添加 CNAME 记录

~/.local/bin/aliyun alidns AddDomainRecord \
  --DomainName example.com \
  --RR news \
  --Type CNAME \
  --Value <TARGET>

FC 自定义域名 CNAME 目标

自定义域名应指向 FC 公共 CNAME：

<account_id>.<region_id>.fc.aliyuncs.com

示例（杭州）：

1629965279769872.cn-hangzhou.fc.aliyuncs.com

常见问题

• 如果不支持顶级域名的 CNAME，请使用 www 等子域名，或使用 ALIAS/ANAME 记录。
• DNS 传播完成后再创建 FC 自定义域名，否则可能出现 DomainNameNotResolved。

参考资料

• aliyun-cli 安装

  • https://help.aliyun.com/zh/cli/install-cli-on-linux

• Alidns API（AddDomainRecord / DescribeSubDomainRecords）

  • https://help.aliyun.com/zh/dns/api-alidns-2015-01-09-adddomainrecord
  • https://help.aliyun.com/zh/dns/api-alidns-2015-01-09-describesubdomainrecords

• FC 自定义域名配置和 CNAME 指南

  • https://www.alibabacloud.com/help/en/functioncompute/fc/user-guide/configure-custom-domain-names

• 官方来源列表：references/sources.md

验证

mkdir -p output/alicloud-network-dns-cli
echo "validation_placeholder" > output/alicloud-network-dns-cli/validate.txt

通过标准：命令以 0 退出，且已生成 output/alicloud-network-dns-cli/validate.txt。

输出与证据

• 将产物、命令输出和 API 响应摘要保存在 output/alicloud-network-dns-cli/ 下。
• 在证据文件中包含关键参数（区域/资源 ID/时间范围），以便复现。

前置条件

• 执行前配置遵循最小权限原则的阿里云凭证。
• 优先使用环境变量：ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET，以及可选的 ALICLOUD_REGION_ID。
• 如果不确定区域，请在运行会更改数据的操作前询问用户。

工作流

1. 确认用户意图、区域、标识符，以及操作是只读还是会更改数据。
2. 首先运行一个最小化的只读查询，以验证连接和权限。
3. 使用明确参数和有限范围执行目标操作。
4. 验证结果并保存输出/证据文件。