Technical Reference · 2026 Edition

default._bimi TXT 记录格式

Last updated min read

default._bimi TXT 记录格式

要完成 Brand Indicators for Message Identification (BIMI) 部署,您需要发布一条 DNS TXT 记录。该记录告知接收邮件服务器从何处获取您的 SVG 徽标和标志证书。

本文档详细说明 BIMI TXT 记录所需的语法、标签和格式规则 [1]。

主机名(选择器)

在您域名的 DNS 区域中发布 BIMI 记录作为 TXT 记录。主机名(选择器)必须使用以下格式:

[selector]._bimi.[domain]

默认选择器为 default。以域名 example.com 为例,TXT 记录应发布在以下主机名:

default._bimi.example.com

注意:该协议支持为子域名或业务部门使用自定义选择器,但大多数部署使用 default 选择器。当邮件头中未指定其他选择器时,邮件客户端会查询 default._bimi

记录值语法

TXT 记录值是一个以分号分隔的标签列表,与 DMARC 记录的结构相同。

1. 版本标签 (v=)

此标签为必填项,且必须放在首位。它用于标识协议版本。 语法: v=BIMI1;

2. 位置标签 (l=)

此标签为必填项。它指定邮件客户端获取您的 W3C SVG Tiny P/S 徽标文件的 HTTPS URL。 语法: l=https://example.com/logo.svg; 约束条件: URL 必须使用 HTTPS。HTTP URL 将导致验证失败。

3. 授权标签 (a=)

此标签在基础规范中为可选,但在实际应用中,若要在 Gmail 和 Apple Mail 中显示徽标则为必填。它指定邮件客户端获取您的验证标志证书(VMC)或通用标志证书(CMC)的 HTTPS URL,文件格式为 .pem语法: a=https://example.com/certificate.pem; 自声明回退方案: 对于自声明部署(仅 Yahoo 和 AOL 支持),需包含该标签但值为空:a=;

完整记录示例

示例 A:认证部署(适用于 Gmail 和 Apple Mail)

使用此格式可在 Gmail 和 Apple Mail 中显示您的徽标,并获得 Gmail 蓝色认证标记。

text
Type:  TXT

Host: default._bimi Value: v=BIMI1; l=https://example.com/logo.svg; a=https://example.com/cert.pem;

示例 B:自声明部署(仅适用于 Yahoo)

在获取 VMC 之前,可使用此格式进行测试或针对 Yahoo Mail 进行部署。

text
Type:  TXT

Host: default._bimi Value: v=BIMI1; l=https://example.com/logo.svg; a=;

常见语法错误

以下错误会导致验证失败:

  1. 缺少分号。 每个标签之间必须用分号分隔。
  2. 使用 HTTP URL。 l=a= 标签都必须引用 https:// 端点。
  3. 无效的 SVG 文件。 l= 标签必须引用 W3C SVG Tiny P/S 文件。标准 SVG、PNG 或 JPG 文件会导致邮件客户端跳过徽标显示,且不会报错。
  4. 省略 a= 标签。 对于自声明记录,必须包含 a= 标签并将值留空(a=;)。某些解析器会拒绝完全省略该标签的记录。

自动化记录生成

手动构建记录容易引入语法错误。要根据您的域名参数生成 SVG 文件和 DNS TXT 字符串,请使用 makeBIMI,它提供一键复制界面。

生成记录后,将其部署到您的 DNS 区域。如果您需要 VMC 来填充 a= 标签以实现 Gmail 兼容性,可使用 veriBIMI 等证书代理服务来处理证书申请。

参考文献

[1] M. Blank 等人。"Brand Indicators for Message Identification (BIMI)。" IETF Datatracker,RFC 9091,https://datatracker.ietf.org/doc/html/rfc9091