---
title: 域名
description: 验证发信域名，添加它的 DNS 记录，并配置追踪、收信和预热。
seo:
  title: 发信域名设置
ai:
  exclude: true
---

每封邮件都必须从你的团队已验证的域名发出。使用其他任何 `from` 地址都会被拒绝，返回 `422`。在控制台的 **域名** 中添加并验证域名，也可以通过 API 操作。

## 添加并验证域名

```bash
curl -X POST https://api.billionsend.com/domains \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "mail.example.com" }'
```

响应会列出需要在 DNS 服务商处添加的 DNS 记录。`mail.example.com` 这样的子域名很适合作为发信域名。记录生效后，在域名页面点击 **验证**，或调用 `POST /domains/{id}/verify`。

| 记录 | 用途 |
| --- | --- |
| DKIM（两条 CNAME：`bs1._domainkey` 和 `bs2._domainkey`） | 为邮件签名，让服务商确认邮件来自你。 |
| MAIL FROM（MX 和 TXT） | 在你自己的域名上设置退信地址，使 SPF 对齐。 |
| DMARC（TXT，推荐） | 告诉服务商如何处理未通过检查的邮件。它不会阻止发送。 |

发送之前，DKIM 和 MAIL FROM 必须通过验证。在 Cloudflare 上，这些记录要保持 **仅 DNS**（灰色云朵）。

域名页面会对照公共 DNS 实时检查每条记录，并显示为已找到、缺失或不匹配。`GET /domains/{id}` 在 `records[]` 中返回同样的信息。每条记录都有一个 `status`（`not_started`、`pending`、`verified` 或 `failed`）、表示公共 DNS 当前返回内容的 `live` 值，出问题时还有一条简短的 `detail`。

### DKIM 密钥自动轮换

BillionSend 为每个域名创建一把 DKIM 密钥，并每 180 天更换一次，在两条 CNAME 之间切换。记录只需添加一次，之后不用再动。可以在域名的 **设置** 标签页中关闭自动轮换。

### 区域

`POST /domains` 可以传一个可选的 `region`。一个域名只属于一个区域。要迁移，需先删除它，再在另一个区域重新添加，它的 DNS 记录也会随之改变。

### 套餐限制

| | Free | Starter | Pro 和 Scale |
| --- | --- | --- | --- |
| 每个团队的发信域名数 | 3 | 10 | 不限 |

超过上限后，`POST /domains` 返回 `403 plan_limit_reached`。如果域名已被其他团队占用，则返回 `409`。

## 新域名预热

新注册的域名在建立信誉期间，每日发送量有限制。上限取决于注册域名的年龄（`mail.example.com` 对应 `example.com`），并按 UTC 日计数：

| 域名年龄 | 每日邮件数 |
| --- | --- |
| 不足 1 天 | 100 |
| 1 天到不足 7 天 | 300 |
| 7 天到不足 30 天 | 2,000 |
| 30 天或更久 | 仅受套餐限制 |

- 发送质量良好（退信少、没有投诉）的域名，会更早升一档。
- 上限在套餐之外叠加生效。升级套餐不会解除它。
- 你的所有新域名共用一个每日发送量：再添加一个新域名不会增加发送量。
- 超出上限的邮件不会丢失。它们显示为 **等待中**，第二天按最早的先发出。如果已经有大量邮件在等待，发送会返回 `429 daily_quota_exceeded`，请在 UTC 日切换后重试。

存在上限期间，域名页面会显示「预热中：今日 N 封/天」。关于发送的所有保护措施，参见 [发送限制](/docs/zh-hans/concepts/sending-limits)。

## 设置

域名验证通过后，可使用以下设置：

- **打开与点击追踪。** 两者默认关闭。在域名的 **链接** 标签页中开启，或在 `PATCH /domains/{id}` 上使用 `open_tracking` 和 `click_tracking`。参见 [邮件追踪](/docs/zh-hans/concepts/tracking)。
- **自有追踪与退订子域名。** 用你自己的域名提供追踪链接和退订链接。需要付费套餐。参见 [邮件追踪](/docs/zh-hans/concepts/tracking)。
- **退订页面。** 收件人看到的页面外观：名称、Logo、颜色和文字。在域名的 **品牌** 标签页中设置，或在 `PATCH /domains/{id}` 上使用 `unsubscribe_page`。参见 [退订](/docs/zh-hans/concepts/unsubscribes)。
- **强制 TLS。** 只向支持 TLS 的服务器投递。在 **设置** 标签页中设置。
- **默认发件人名称、发件地址和回复地址。** 在 **设置** 标签页中设置。

## 收信

已验证的域名还可以 [接收邮件](/docs/zh-hans/receiving)。在域名页面点击 **开启收信**，或使用 `PATCH /domains/{id}`：

```json
{ "capabilities": { "receiving": "enabled" } }
```

- 只有已验证的域名才能开启收信。带 `"receiving": "enabled"` 的 `POST /domains` 会返回 `422`：先添加域名，验证通过后再开启收信。
- 开启后会添加两条 `Receiving` 记录：指向 `mx1.billionsend-dns.com` 和 `mx2.billionsend-dns.com` 的 MX 记录，优先级都是 `10`。两条都要发布，这样发件方发现其中一台不可用时，会改用另一台重试。它们不影响发送。如果该域名已在别处收信，请把 MX 记录放在 `inbound.example.com` 这样的子域名上，因为编号更小的 MX 记录会抢走邮件。
- 一个域名只能在一个团队中收信。如果该域名已被其他团队用于收信，则返回 `409`。
- 默认只有你的 [收件箱](/docs/zh-hans/inboxes) 的地址会收信。**全域收信（catch-all）** 会接收该域名下的所有地址。它需要付费套餐，可在控制台设置，或在 `PATCH /domains/{id}` 上使用 `receiving_catch_all`。

## 共享子域名

每个团队还会在 BillionSend 的共享域名下获得一个子域名，团队的共享 [收件箱](/docs/zh-hans/inboxes) 在这里获得地址。它出现在 `GET /domains` 列表的末尾，带有 `shared: true`。它已经验证通过且只读：`PATCH`、验证和 `DELETE` 都返回 `403 forbidden`，也不计入域名数量上限。它只能用你的收件箱自己的地址发信。

## 删除域名

`DELETE /domains/{id}`，或域名页面上的 **删除**，在两种情况下会被拒绝并返回 `409`：

- 有 [订阅主题](/docs/zh-hans/concepts/topics) 或 [分群](/docs/zh-hans/concepts/segments) 绑定在该域名上。请删除它，或把它的 `domain_id` 设为 `null`。
- 有已定时或正在发送的 [群发](/docs/zh-hans/concepts/broadcasts) 使用该域名。请取消它，或等它发完。

删除域名时，它的收件箱也会一并删除。收件人对该域名的 [退订](/docs/zh-hans/concepts/unsubscribes) 会保留，如果你再次添加同一个域名，这些退订会重新生效。

## API 密钥与域名

API 密钥可以限定在某一个域名。这样的密钥只能从该域名发送，使用其他 `from` 会返回 `403 restricted_api_key`。它只能读取该域名收到的邮件，在 `/domains` 下只能看到并修改该域名（其他域名返回 `404`），它创建的密钥也限定在同一个域名。Webhook、抑制列表、模板，以及其余属于整个团队的内容，都会返回 `403 restricted_api_key`，[API 密钥](/docs/zh-hans/api-keys) 页面列出了这些内容。密钥也可以限定在某一个 [收件箱](/docs/zh-hans/inboxes)。
