> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 连接自定义域名

> 使用您自己的子域名（例如 qr.yourbrand.com）提供二维码链接，而不是共享的 GetQR 短域名。

连接您拥有的子域名（例如 `qr.yourbrand.com`），让新二维码使用您的域名，而不是共享的 GetQR 短域名。用户扫描时会看到您的品牌，GetQR 还会为您签发并续期 HTTPS 证书。

> [!NOTE]
>
> 自定义域名目前处于测试阶段，可能尚未在所有工作区中提供。如果您在账户设置中看不到 **Domains** 选项卡，则说明您的工作区尚未启用此功能。

## 开始之前

* 您需要拥有 **Admin** 或 **Editor** 角色\*\*。Viewer\*\* 可以查看域名列表，但无法进行任何更改。
* 您需要能够访问域名的 DNS 设置，即您的域名注册商或 DNS 服务商（例如 Cloudflare、GoDaddy、Namecheap 或 Squarespace）。如果 DNS 由其他人管理，您可以在设置过程中为他们下载确切的配置值。
* 每个工作区最多可以连接 3 个域名。
* 您需要连接的是**子域名**，而不是根域名。`qr.yourbrand.com` 可以使用；`yourbrand.com` 和 `www.yourbrand.com` 不可以。根域名上的网站和电子邮件不会受到影响。

## 连接您的域名

**1. 打开 Domains 选项卡**

在侧边栏中打开个人资料菜单并点击 **My Account**。然后选择 **Domains** 选项卡。

**2. 开始设置**

点击 **Connect a domain**。

> [!TIP]
>
> 您也可以从二维码生成器开始：在 **Custom short link** 字段中打开域名下拉菜单，然后点击 **Connect a domain**。

**3. 选择子域名**

在 **Choose a subdomain** 中选择一个前缀：**qr**、**go**、**scan** 或 **link**。如需使用自己的前缀，请点击 **Custom** 并在 **Subdomain** 字段中输入。

**4. 输入根域名**

在 **Your domain** 中只输入根域名，例如 `yourbrand.com`。GetQR 会自动检查完整的主机名，并显示 **Checking availability…**。

**5. 确认主机名可用**

等待显示主机名可用的消息。**Your codes will look like** 下方的预览会显示您的链接外观。点击 **Continue**。

**6. 复制 DNS 记录**

在 **Add one DNS record** 中，使用复制按钮复制 **Name** 和 **Target** 的值。记录类型始终为 **CNAME**，**Proxy** 必须设置为 **DNS only — grey cloud**。

> [!TIP]
>
> 不自己管理 DNS？点击 **Download instructions**，即可获取一个包含确切配置值的文件，交给您的开发人员或 IT 团队。

**7. 在 DNS 服务商处添加 CNAME 记录**

在新标签页中打开您的 DNS 服务商，使用复制的 **Name** 和 **Target** 添加一条 CNAME 记录。将 TTL 设置为 Auto（默认）。请参阅下方的[服务商提示](#provider-tips)。

**8. 如果 GetQR 要求，添加 CAA 记录**

如果设置界面显示 CAA 警告，说明您的根域名有一条 CAA 记录阻止了 GetQR 的证书颁发机构。请添加警告中显示的额外记录，格式如下：

```text theme={null}
yourbrand.com. CAA 0 issue "letsencrypt.org"
```

如果没有警告，请跳过此步骤。

**9. 告知 GetQR 记录已添加**

返回 GetQR，点击 **I've added the record**。GetQR 会立即检查您的 DNS 并进入验证界面。

**10. 等待验证**

GetQR 会自动检查并设置 HTTPS。验证通常最多需要 1 小时，具体取决于您的 DNS 服务商和所在地区。您可以关闭窗口：GetQR 会持续检查，并在域名上线后通过电子邮件通知您。

如需提前检查，请点击 **Check now**。

**11. 测试您的域名**

域名上线后，您会看到它已通过 HTTPS 上线。打开测试链接（`your-subdomain/test`）确认它在您的设备上正常工作，然后点击 **Done**。

## 服务商提示

每个服务商使用的标签略有不同，但记录始终相同：一条使用 GetQR 中显示的 **Name** 和 **Target** 的 **CNAME** 记录。

**Cloudflare**

1. 打开根域名的 DNS 记录。
2. 添加一条 **CNAME** 类型的记录。
3. 粘贴 GetQR 中的 **Name**（例如 `qr`）和 **Target**。
4. 关闭橙色云朵，使代理状态显示为 **DNS only**。
5. 保存记录。

> [!WARNING]
>
> Cloudflare 默认会代理新记录。当记录处于代理状态（橙色云朵）时，证书无法签发，扫描也会失败。

**GoDaddy**

1. 打开根域名的 DNS 设置。
2. 添加一条 **CNAME** 类型的新记录。
3. 在名称（主机）字段中输入 GetQR 中的 **Name**，例如 `qr`。
4. 将 GetQR 中的 **Target** 粘贴到值（指向）字段中。
5. 保持 TTL 为默认值并保存。

**Namecheap**

1. 打开根域名的 DNS 设置。
2. 添加一条 **CNAME** 类型的新记录。
3. 在主机字段中输入 GetQR 中的 **Name**，例如 `qr`。
4. 将 GetQR 中的 **Target** 粘贴到值（目标）字段中。
5. 保持 TTL 为 Automatic 并保存。

**Google / Squarespace**

在 Google Domains 注册的域名现在由 Squarespace 管理。

1. 打开根域名的 DNS 设置。
2. 添加一条 **CNAME** 类型的自定义记录。
3. 在主机字段中输入 GetQR 中的 **Name**，例如 `qr`。
4. 将 GetQR 中的 **Target** 粘贴到数据（值）字段中。
5. 保存记录。

> [!TIP]
>
> 大多数服务商会自动在名称后添加根域名。只需输入子域名部分（`qr`），而不是 `qr.yourbrand.com`，否则可能会变成 `qr.yourbrand.com.yourbrand.com`。

## 在二维码中使用您的域名

域名上线后，您可以在生成器中为每个二维码选择它。在 **Custom short link** 字段中打开域名下拉菜单并选择您的域名。仍在设置中的域名会在列表中显示 **Setting up** 标签，暂时无法选择。请参阅[创建自定义短链接](/zh/short-links/create-short-link)。

> [!WARNING]
>
> 二维码会保留创建时使用的域名。现有二维码不会迁移到新域名，而移除某个域名会导致该域名上的所有二维码都无法扫描。

## 设置

| 设置 | 作用 |
| - | - |
| **Subdomain** | 主机名的前缀，例如 `qr`。只能包含字母、数字和连字符。不允许使用 `www`。 |
| **Your domain** | 您的根域名，例如 `yourbrand.com`。此处不要包含子域名。 |
| **Type** | 始终为 **CNAME**。 |
| **Name** | 需要在 DNS 服务商处输入的子域名标签。 |
| **Target** | 您的记录所指向的 GetQR 主机名。它对您的域名是唯一的，因此请始终从应用中复制。 |
| **Proxy** | 必须为 **DNS only — grey cloud**。处于代理状态的记录会阻止证书签发。 |

## 使用场景

* **品牌信任**。用户扫描时，在链接预览中看到的是 `qr.yourbrand.com`，而不是第三方域名。
* **营销活动**。将您的域名与自定义短链接结合使用，例如 `qr.yourbrand.com/summer-menu`。
* **小尺寸印刷**。较短的主机名可以生成密度更低的二维码，在小尺寸下扫描更可靠。

## 常见问题

> **我看不到 Domains 选项卡**
>
> 自定义域名处于测试阶段，并按工作区启用。如果您的账户设置中没有该选项卡，则说明您的工作区暂不支持此功能。

> **Connect a domain 按钮不可用**
>
> 您的工作区已有 3 个域名，已达上限。请移除一个域名后再连接新的域名。如果您完全看不到该按钮，说明您的角色是 **Viewer**；请联系 Admin 或 Editor。

> **“Use a subdomain such as qr.yourbrand.com”**
>
> 您输入的是根域名。根域名需要不同的记录，并且会影响您的网站和电子邮件。请选择一个子域名前缀，并在 **Your domain** 中只输入根域名。

> **“www is reserved for your website”**
>
> `www` 指向您的网站，因此 GetQR 无法使用它。请选择其他前缀，例如 `qr`。

> **“already includes a subdomain”**
>
> 您在 **Your domain** 中输入了子域名，例如 `qr.yourbrand.com`。请只输入根域名（`yourbrand.com`），并在 **Subdomain** 中选择前缀。

> **“This domain is already connected to another GetQR account”**
>
> 另一个 GetQR 工作区已在使用此主机名。请选择其他子域名；如果您认为这是错误，请联系 [help@getqr.com](mailto:help@getqr.com)。

> **“That domain can't be connected”**
>
> 该主机名已被保留或不允许使用。请选择其他子域名。

> **验证花费了很长时间**
>
> DNS 更改可能需要一段时间才能传播。请检查记录类型、名称和目标是否与应用中的完全一致，并确认记录未处于代理状态。有关各状态的含义，请参阅[验证您的域名](/zh/custom-domains/verify-and-troubleshoot)。

## 后续步骤

> **[验证您的域名](/zh/custom-domains/verify-and-troubleshoot)**
>
> 查看状态并修复 DNS 或证书问题。

> **[创建自定义短链接](/zh/short-links/create-short-link)**
>
> 在二维码上使用您的域名和自定义路径。

> **[角色和权限](/zh/members/roles-and-permissions)**
>
> 了解谁可以连接和移除域名。

> **[打印二维码](/zh/downloads/printing)**
>
> 请在域名上线后再打印。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.