> ## 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.

# 验证您的域名

> 查看自定义域名的状态，并修复 DNS 和证书问题。

添加 DNS 记录后，GetQR 会自动验证您的域名并签发 HTTPS 证书。本页介绍 **Domains** 选项卡中的各种状态，以及如何处理需要您介入的状态。

> [!NOTE]
>
> 自定义域名目前处于测试阶段，可能尚未在所有工作区中提供。

## 开始之前

* 您已开始连接域名。请参阅[连接自定义域名](/zh/custom-domains/connect-domain.md)。
* 要执行 **Check now**、重试证书或移除域名，您需要拥有 **Admin** 或 **Editor** 角色。**Viewer** 可以查看状态，但无法执行任何操作。

## 查看域名状态

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

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

**2. 查看状态及主机名下方的说明**

每个域名都会显示一个状态标签和一行详细说明。如果出现问题，详细说明会指出具体原因，例如“Record not found yet.”。对于已上线的域名，会显示有多少个二维码在使用它以及证书的续期时间。

**3. 打开操作菜单**

点击 **More actions**（行末的菜单），即可看到该域名的 **View DNS record**、**Check now** 及其他操作。

**4. 执行检查**

修复记录后点击 **Check now**。GetQR 会立即检查 DNS 和证书，而无需等待下一次自动检查。

> [!TIP]
>
> 当域名处于 **Waiting for DNS** 或 **Issuing certificate** 状态时，点击状态标签即可打开验证界面，查看 **Last checked** 和 **Next automatic check** 时间。

## 状态

| 状态 | 含义 | 处理方法 |
| - | - | - |
| **Waiting for DNS** | GetQR 尚未找到正确的 CNAME 记录。 | 添加或修复记录，然后点击 **Check now**。 |
| **Issuing certificate** | DNS 记录正确，正在签发 HTTPS 证书。通常需要几分钟。 | 无需操作。等待变为 **Live**。 |
| **Live** | 您的域名正在通过 HTTPS 提供二维码服务。 | 无需操作。您可以在二维码生成器中选择它。 |
| **Certificate failed** | 证书无法签发或续期。详细说明会给出原因。 | 修复问题原因，然后点击 **Retry certificate**。 |
| **Not resolving** | 曾经上线的域名不再指向 GetQR。该域名上的二维码无法扫描。 | 恢复 DNS 记录，然后点击 **Check now**。 |
| **Setup incomplete** | 设置在 7 天内没有任何进展，因此自动检查已停止。 | 修复记录，然后点击 **Check now** 重新开始设置。 |
| **Paused** | 工作区订阅未生效，因此域名已暂停。 | 恢复订阅。请参阅[帮助中心](https://getqr.com/help)。 |

### GetQR 的检查频率

* **Waiting for DNS**、**Issuing certificate** 和 **Live** 状态的域名大约每小时检查一次。
* **Certificate failed** 和 **Not resolving** 状态的域名大约每 15 分钟检查一次，因此修复后的记录会很快被识别。
* **Setup incomplete** 状态的域名在您点击 **Check now** 之前不会被检查。
* **Check now** 会立即执行检查。如果点击过于频繁，请等待一分钟后再试。

### 电子邮件通知

当域名上线、证书失败、停止解析、恢复正常以及设置被标记为未完成时，GetQR 会通过电子邮件通知工作区成员。

## 修复问题

根据主机名下方的详细说明，找到下面对应的修复方法。

> **“Record not found yet.”**
>
> GetQR 尚未找到您子域名的 CNAME 记录。
>
> 1. 点击 **More actions**，然后点击 **View DNS record**，并与您 DNS 服务商处的值进行比较。
> 2. 确保记录类型为 **CNAME**，且名称只包含子域名部分（例如 `qr`）。
> 3. DNS 更改可能需要一段时间才能传播。稍后再点击 **Check now**。

> **“The record points to … — it should be …”**
>
> 您的 CNAME 记录存在，但指向了错误的目标。
>
> 1. 点击 **More actions**，然后点击 **View DNS record**，并复制 **Target**。
> 2. 在 DNS 服务商处编辑 CNAME 记录，将其值替换为该目标。
> 3. 点击 **Check now**。

> **“The record is proxied, so the certificate can't be issued.”**
>
> 您的 DNS 服务商对该记录启用了代理，因此 GetQR 无法签发证书。
>
> 1. 在 DNS 服务商处将记录切换为 **DNS only**。在 Cloudflare 上，点击橙色云朵直到它变为灰色。
> 2. 返回 GetQR，点击 **More actions**，然后点击 **Retry certificate**。

> **“A CAA record is blocking our certificate authority.”**
>
> 您的根域名有 CAA 记录不允许 Let's Encrypt，而 GetQR 使用它来签发证书。
>
> 1. 在根域名上添加以下 CAA 记录（将 `yourbrand.com` 替换为您的域名）：
>
>    ```text theme={null}
>    yourbrand.com. CAA 0 issue "letsencrypt.org"
>    ```
>
> 2. 保留现有的 CAA 记录。您是在添加一条记录，而不是替换它们。
>
> 3. 点击 **More actions**，然后点击 **Retry certificate**。

> **“DNS is correct but the certificate hasn't been issued yet.”**
>
> 您的记录已正确超过 2 小时，但证书仍未签发。点击 **More actions**，然后点击 **Retry certificate**。如果再次失败，请联系 [help@getqr.com](mailto:help@getqr.com)。

> **“The certificate expired and couldn't be renewed.”**
>
> 该域名曾经上线，但其证书无法续期。请检查 CNAME 记录是否仍指向 **View DNS record** 中显示的 **Target**、是否未启用代理，以及是否没有 CAA 记录阻止 `letsencrypt.org`。然后点击 **Retry certificate**。

> **“Too many retries for this domain”**
>
> 每个域名每小时最多可以重试 5 次证书。请先修复问题原因，稍等片刻后再试。

> **我的域名显示 Not resolving，二维码也无法扫描了**
>
> 当已上线的域名连续两次检查失败时，就会变为 **Not resolving**，通常是因为 CNAME 记录被删除或更改。在修复之前，二维码列表会显示一条警告横幅。请按照 **View DNS record** 中显示的内容准确恢复记录，然后点击 **Check now**。使用共享 GetQR 短域名的二维码不受影响。

> **我的域名显示 Setup incomplete**
>
> 该域名在 7 天内没有任何进展，因此 GetQR 停止了检查。修复 DNS 记录后点击 **Check now**。设置会从 **Waiting for DNS** 重新开始，并有新的 7 天期限。

> **我的域名显示 Paused**
>
> 工作区订阅未生效。扫描该域名时会显示停用页面，而不是您的内容。订阅恢复生效后，域名会自动恢复，无需更改任何 DNS。有关账单问题，请参阅[帮助中心](https://getqr.com/help)。

> **下载二维码时显示“isn't live yet”**
>
> 该二维码使用的域名尚未完成设置，或者该域名已被移除。您现在打印的任何内容都无法扫描。请点击 **Open domain settings**，在下载之前完成设置。

## 移除域名

> [!WARNING]
>
> 对于已印刷的二维码，移除域名是永久性的。一旦移除，该域名上的所有二维码都会立即停止工作，且已印刷的二维码无法恢复。

**1. 打开操作菜单**

在 **Domains** 选项卡中，点击该域名所在行的 **More actions**。

**2. 选择 Remove domain**

点击 **Remove domain**。对话框会显示有多少个二维码在使用该域名。

**3. 确认**

勾选复选框，确认该域名上的所有二维码都将停止工作。然后点击 **Remove domain**。

## 后续步骤

> **[连接自定义域名](/zh/custom-domains/connect-domain.md)**
>
> 设置新的子域名。

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

> **[故障排除](/zh/faq/troubleshooting.md)**
>
> 修复其他扫描问题。

> **[帮助中心](https://getqr.com/help)**
>
> 账单和账户问题。


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