# Google AI Studio 自定义域名

在 Google AI Studio 构建模式下发布的 Web 应用程序可免费获得 `ai.studio`
子域。您还可以购买并连接您自己的自定义域，例如 `example.com`，从 **发布** 面板。

AI Studio 通过以下方式注册您的域名 [云域](https://cloud.google.com/domains) 并配置 [云域名解析](https://cloud.google.com/dns) 在您的 Google Cloud 项目中进行路由。然后它会为您创建一个托管 SSL 证书 [云跑](https://cloud.google.com/run) 服务。

{% button href="https://aistudio.google.com/apps" variant="ais" %}在 AI Studio 中打开构建{% /button %}

## 前提条件  {% #prerequisites %}

在购买或附加自定义域之前，请确认您的项目满足以下三个要求：

1. **付费Google Cloud项目**：自定义域需要 [付费Google Cloud项目](/docs/aistudio-deploying#standard-deployment)
   拥有有效的 Cloud Billing 帐户。自定义域不可用 [Google Cloud 入门级](/docs/aistudio-deploying#about-the-starter-tier)。如果您的应用程序使用 Starter Tier，请单击 **升级以继续** 于 **自定义域** 卡在 **发布** 附加计费帐户的面板。
1. **IAM权限**：您的 Google 帐户需要 **业主** (`roles/owner`）或 **编辑** (`roles/editor`）关于项目。或者，授予 **云域管理员** (`roles/domains.admin`), **DNS管理员**
   (`roles/dns.admin`），以及 **云运行管理** (`roles/run.admin`）。如果未启用 Cloud Domains、Cloud DNS 和 Cloud Run API，请授予 **服务使用管理** (`roles/serviceusage.serviceUsageAdmin`）或 `serviceusage.services.enable`.
1. **可用域名注册配额**：每个 Google Cloud 项目对活动域注册都有默认限制，该限制因项目历史记录而异。如果您达到了项目限制， [请求额外的域名配额](/docs/aistudio-custom-domains#request-additional-domains).

{% callout type="note" %}
附加 Cloud Billing 帐户会将入门级项目升级为标准付费 Google Cloud 项目。升级后，您的帐户不再符合 Google Cloud 入门级的资格。
{% /callout %}

## 定价和计费  {% #pricing %}

Google 将向与您的 Google Cloud 项目关联的 Cloud Billing 帐号收取自定义域费用。总成本包括年度域名注册价格和持续的 Cloud DNS 托管费用。

| 充电             | 价格                                                                           | 计费时间表               |
| -------------- | ---------------------------------------------------------------------------- | ------------------- |
| **域名注册**       | 从 $12.00/年开始（因顶级域名而异，例如 `.com`, `.net`, `.app`, 或 `.cloud`)                  | 1 年预付费用。每年续订，除非取消   |
| **云 DNS 托管区域** | 起价为 $2.40/年（每个管理区域 $0.20/月），加上 [查询使用费](https://cloud.google.com/dns/pricing) | 根据活动区域和 DNS 查询量按月计费 |

{% callout type="warning" %}
AI Studio 在您的 Google Cloud 项目中创建一个 Cloud DNS 托管区域，以将流量从您的域路由到 Cloud Run。连接自定义域时请保持此托管区域完好无损，否则访问者将无法访问您的应用程序。域名购买一经注册就不可退款。
{% /callout %}

## 购买并连接域名  {% #buy-domain %}

您可以在首次发布应用程序时购买新域，或将一个域添加到已发布的应用程序中。以下部分还介绍了电子邮件验证和 SSL 配置。

1. 打开您的网络应用程序 [构建模式](https://aistudio.google.com/apps) 然后单击 **发布** 在右上角。
1. 启动自定义域流程：* **未发布的应用程序**：确认您的Google Cloud项目和计费账户，点击 **继续**，然后单击 **购买域名** 于 **自定义域** 卡。

* **已发布的应用程序**: 旁边 **应用程序网址**，点击 **+** (**添加自定义域**）并选择 **购买新域名**。要替换连接的域，请打开三点 **自定义域选项** 菜单并选择 **更改自定义域 > 购买域**.

3. 输入您想要的域名 **搜索域名** 并按 **输入**
   或单击搜索按钮。 AI Studio 显示可用域名及其年度注册价格。
1. 点击 **选择** 在您想要的域名旁边。点击 **成本明细** 查看域名注册成本和基本 Cloud DNS 费用。
1. 勾选确认框 [Squarespace 服务条款](https://www.squarespace.com/terms-of-service)
   和 [Google Cloud 条款](https://cloud.google.com/terms) （在项目中第一次购买域名时显示），然后单击 **继续**.
1. 填写您的注册人联系方式。输入您的姓名、电子邮件、电话号码（例如， `+1 888 555 0123`）和邮寄地址。默认情况下，您的联系信息是私密的，并且不会被公开的 WHOIS 查找。
1. 点击 **购买域名用于 `<price>`+ /年** （例如， **购买域名 $14.40+ /年**）。某些 Cloud Run 区域不支持域映射。如果需要，AI Studio 会在将您的服务移至受支持的区域之前进行询问。
1. 出现确认横幅后，单击 **继续** （和 **发布您的应用程序** 如果您是第一次发布）以连接域。

### 邮箱验证  {% #verify-email %}

购买域名后，您必须在以下时间内验证您的注册人电子邮件地址 **15天** 或者注册商暂停该域名。查找来自以下地址的电子邮件 `no-reply@squarespace.com` （Cloud Domains 的注册商合作伙伴），然后单击内部的验证链接。

当验证等待期间，AI Studio 会在您的域旁边显示一个警告图标 **发布** 面板。验证电子邮件可能需要几分钟才能到达。如果找不到电子邮件，请单击三点 **自定义域选项** 您的域旁边的菜单，选择 **管理订阅**，并从Google Cloud控制台重新发送验证邮件。

### SSL 证书配置  {% #ssl-provisioning %}

购买后，AI Studio 会分三个阶段连接您的域，如您域下方的状态微调器所示 **应用程序网址**:

1. **采购域名**：在 Cloud Domains 中注册域名。
1. **将域连接到您的应用程序**：创建 Cloud DNS 托管区域、设置 DNS 记录并将域映射到您的 Cloud Run 服务。
1. **配置 SSL 证书**：颁发 Google 管理的 SSL 证书，以便您的域提供 HTTPS 流量。

DNS 和 SSL 设置需要 15 到 30 分钟。 DNS 更改可能需要更长的时间才能传播。您的应用程序仍可在其 `ai.studio` 设置完成时的 URL。如果域附件遇到临时错误，请单击 **重试**
域行旁边。

## 重用拥有的域  {% #reuse-domain %}

您可以在同一 Google Cloud 项目中连接您之前通过 Google AI Studio 购买的任何域，无论它是在您的投资组合中未分配还是附加到另一个 AI Studio 应用程序。

1. 打开 **发布** 目标应用程序上的面板。
1. 选择 **使用我拥有的域** 于 **自定义域** 卡（或点击 **+**
   旁边 **应用程序网址** 并选择 **使用您拥有的域** 在已发布的应用程序上）。
1. 从列表中选择域。如果它附加到另一个应用程序，请确认 **移动域** 提示。
1. 点击 **继续**。然后点击 **发布您的应用程序** （首次发布时）或 **完成** （替换域时）。

AI Studio 将移动的域与之前的应用程序分离，并将流量路由到新应用程序。以前的应用程序仍可在其位置访问 `ai.studio` 网址。

## 管理或取消订阅  {% #manage-domain %}

要管理连接的自定义域，请打开已发布的应用程序的 **发布** 面板并单击三点 **自定义域选项** 域旁边的菜单 **应用程序网址**:

* **管理订阅**：打开您的域名注册 [云域控制台](https://console.cloud.google.com/net-services/domains/registrations/list)。使用此页面可以编辑您的联系信息、重新发送验证电子邮件、检查 DNS 设置或更改年度自动续订设置。
* **更改自定义域**：通过购买新域来替换应用程序的自定义域（**购买域名**）或从您的项目中选择另一个域（**使用我拥有的域**）。 AI Studio 询问是否保留或取消对被替换域名的订阅。
* **删除自定义域**：分离自定义域，以便您的应用程序使用其内置域 `ai.studio` URL，然后提示您选择域计费的方式：* **取消域名订阅**：关闭年度自动续订。该域名将一直属于您，直到其当前的 1 年期限结束，然后到期而无需续订。取消不会删除域的 [云 DNS 托管区域](https://console.cloud.google.com/net-services/dns/zones)。如果您不重复使用该域名，请在 Cloud DNS 中删除该托管区域，以停止收取 $0.20/月的费用。
  * **保留域名订阅**：保持年度自动续订处于活动状态，并将域保留在您的项目组合中，以便您稍后可以将其附加到另一个应用程序。

取消发布应用程序或将其从应用程序中删除 [应用程序页面](https://aistudio.google.com/apps) 如果附加了自定义域，则会显示相同的提示。您可以在取消发布或删除应用程序之前取消或保留域订阅。

## 请求额外的域  {% #request-additional-domains %}

每个 Google Cloud 项目都有一个默认值 **域名注册** 基于帐户和账单历史记录的配额。如果达到限制，请在 Google Cloud 控制台中请求更高的配额。

{% button href="https://console.cloud.google.com/iam-admin/quotas?service=domains.googleapis.com&metric=domain-registrations" icon="north_east" variant="secondary" %}开放域名注册配额{% /button %}

在提交请求之前，请确认您的项目有一个有效的 Cloud Billing 帐号。您的 Google 帐户还需要 `serviceusage.quotas.update` 或 `cloudquotas.quotas.update`。具有此权限的预定义角色包括 **业主**, **编辑**, **云配额管理** (`roles/cloudquotas.admin`），以及 **配额管理员** (`roles/servicemanagement.quotaAdmin`).

请求更高的域名限制：

1. 打开 [域名注册配额](https://console.cloud.google.com/iam-admin/quotas?service=domains.googleapis.com&metric=domain-registrations)
   Google Cloud 控制台中的页面。
1. 在控制台顶部的项目选择器中，选择链接到您的 AI Studio 应用程序的 Google Cloud 项目。
1. 选中旁边的框 **域名注册** （根据 **云域 API**），然后单击 **编辑** （铅笔图标）。如果出现提示，请单击 **申请更高配额**.
1. 输入所需的总域数 **新价值**，描述您的用例 **请求说明**，然后单击 **完成**.
1. 点击 **下一步**，如果出现提示，请确认您的联系方式，然后单击 **提交请求**.

对较新的 Google Cloud 项目的请求需要经过人工审核，并需要 1 至 2 个工作日。 Google Cloud 支持人员在审核您的请求后向您发送电子邮件。检查待处理的请求 [增加请求选项卡](https://console.cloud.google.com/iam-admin/quotas/qirs).

从 AI Studio 中的应用程序中删除域名将使注册保持活动状态，直到其付费 1 年期限结束。即使与 **取消域名订阅**，该域名将计入您的限制，直至过期。要提前释放配额，请将域名转移到另一个注册商并在 [云域](https://console.cloud.google.com/net-services/domains/registrations/list).

## 问题排查  {% #troubleshooting %}

| 症状                   | 原因及解决方法                                                                                                      |
| -------------------- | ------------------------------------------------------------------------------------------------------------ |
| **域名注册配额超出**         | 您的项目已达到其活跃域名注册限制。重用现有域 **使用我拥有的域**, 或 [请求额外的域名配额](/docs/aistudio-custom-domains#request-additional-domains). |
| **警告图标：需要电子邮件验证**    | 注册人的电子邮件尚未经过验证。打开来自的电子邮件 `no-reply@squarespace.com`，或单击 **自定义域选项 > 管理订阅** 从 Google Cloud 控制台重新发送它。           |
| **失败状态为 `Retry` 按钮** | 域设置或 DNS 传播超时。点击 **重试** 域行旁边。                                                                                |
| **应用程序要求移动到新区域**     | Cloud Run 域映射仅在受支持的区域中可用。确认会将您的应用程序重新部署到支持的区域。你的 `ai.studio` URL 和自定义域继续工作，而底层 `run.app` 服务 URL 更改。          |

## 限制  {% #limitations %}

* **在 AI Studio 外部注册的域名**：仅在同一 Google Cloud 项目内的 Google AI Studio 中购买的域出现在 **使用我拥有的域**。我们计划将来支持从外部注册商转移或连接域名。
* **仅适用于付费项目的 Web 应用**：自定义域适用于在付费 Google Cloud 项目上发布的 Web 应用程序，而不是 Android 应用程序或入门级应用程序。
* **支持的顶级域名和长度**：搜索结果仅包含支持私人 WHOIS 保护的顶级域。域名的长度最多为 63 个字符。
* **每个应用程序一个自定义域**：将新的自定义域连接到应用程序会替换已附加到该应用程序的任何自定义域。

## 后续步骤  {% #whats-next %}

* 了解更多关于 [在 Google AI Studio 中发布应用](/docs/aistudio-deploying).
* 评论 [结算](/docs/billing) 对于付费 Google Cloud 项目。
* 阅读 [Google Cloud 配额文档](https://docs.cloud.google.com/docs/quotas/view-manage)
  用于一般项目配额管理。
