如何通过Azure CLI为Azure静态Web应用添加AWS托管的自定义域名

步骤1：触发域名绑定并获取验证信息 #

先执行CLI命令触发域名绑定流程，Azure会返回域名所有权验证所需的TXT记录：

az staticwebapp hostname set --name <你的静态应用名称> --hostname <你的自定义域名>

执行后如果域名非Azure托管，会返回类似如下的错误提示（同时包含关键验证信息）：

验证失败：需要添加TXT记录，主机名为 asuid.<你的自定义域名>，值为 <随机生成的验证字符串>

步骤2：在AWS Route 53中配置验证TXT记录 #

登录AWS Route 53控制台，找到对应域名的托管区域：

• 新建一条TXT类型的DNS记录：
  • 主机记录：填写asuid.<你的自定义域名>（例如你的域名是bar.com，就填asuid.bar.com）
  • 记录值：粘贴Azure返回的验证字符串
  • TTL保持默认（推荐300秒）
• 保存记录后，等待DNS全球生效（一般需要5-30分钟）

步骤3：完成域名绑定 #

等TXT记录生效后，重新执行第一步的CLI命令：

az staticwebapp hostname set --name <你的静态应用名称> --hostname <你的自定义域名>

这次Azure会成功验证域名所有权，完成绑定。

步骤4：配置业务解析记录 #

绑定成功后，还需要在AWS Route 53中添加解析记录，让用户访问你的自定义域名时指向Azure静态Web应用：

• 根域名（如bar.com）：添加A类型记录，记录值为Azure静态Web应用的IP地址（可通过解析你的静态应用默认域名<应用名>.azurestaticapps.net获取对应IP）
• 子域名（如www.bar.com）：添加CNAME类型记录，记录值直接填你的静态应用默认域名<应用名>.azurestaticapps.net

排查要点 #

• 权限问题：确保执行CLI命令的Azure账号拥有静态Web应用的所有者权限
• DNS生效验证：用nslookup asuid.<你的自定义域名>命令检查TXT记录是否已全网可查
• 根域名绑定限制：根域名无法使用CNAME记录，必须用A记录指向静态应用IP，若后续Azure IP变动，需手动更新A记录

内容的提问来源于stack exchange，提问作者Wayne Griffin