← RFC Reference

RFC 8058：电子邮件一键退订

为什么存在这个功能

RFC 2369 的 List-Unsubscribe 标头存在根本问题：电子邮件客户端无法安全地自动处理该 URL。HTTPS URL 可能导向带有验证码、登录表单、确认步骤甚至恶意网站的页面。客户端必须打开浏览器让用户处理——增加了阻力，阻止了使用。

RFC 8058 通过引入 List-Unsubscribe-Post 标头来解决此问题。当与 HTTPS List-Unsubscribe URL 一起出现时，它表示电子邮件客户端可以直接向其发送 HTTP POST 请求以取消订阅用户——无需浏览器、无需确认、一键完成。

自 2024 年 2 月以来，Gmail 和 Yahoo 要求大批量发件人（每天向其用户发送超过 5000 条消息的人）符合 RFC 8058。这对商业电子邮件不再是可选的。

工作原理

该机制需要两个标头协同工作：

必需标头

List-Unsubscribe: <https://example.com/unsub?id=abc123>,
    <mailto:unsub-abc123@example.com>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

当电子邮件客户端看到两个标头时：

1. 它在 UI 中显示突出的"取消订阅"按钮。
2. 当用户点击它时，客户端向 List-Unsubscribe 中的 HTTPS URL 发送 HTTP POST。
3. POST 主体恰好是：List-Unsubscribe=One-Click
4. 发件人的服务器处理 POST 并取消订阅用户。

HTTP POST 请求

POST /unsub?id=abc123 HTTP/1.1
Host: example.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 26

List-Unsubscribe=One-Click

服务器响应

服务器应返回 200 OK 状态以确认取消订阅成功。任何 2xx 响应表示成功。响应正文不会显示给用户，因此可以为空或包含简单确认。

关键技术细节

标头要求

• List-Unsubscribe-Post 标头值必须恰好是 List-Unsubscribe=One-Click——无变体。
• List-Unsubscribe 标头必须至少包含一个 HTTPS URL（不是 HTTP）。mailto URI 是可选的，但建议作为备选方案。
• 两个标头必须在同一消息上。没有 List-Unsubscribe 的 List-Unsubscribe-Post 毫无意义。

DKIM 要求

消息必须通过 DKIM 身份验证，并且 DKIM 签名必须覆盖 List-Unsubscribe 和 List-Unsubscribe-Post 标头。这可防止攻击者在传输过程中注入或修改取消订阅 URL。Gmail 明确检查此项。

端点实现

; 最小服务器端处理程序（伪代码）
function handleUnsubscribe(request):
    if request.method != "POST":
        return 405 Method Not Allowed

    if request.body != "List-Unsubscribe=One-Click":
        return 400 Bad Request

    subscriberId = request.queryParams["id"]
    suppressRecipient(subscriberId)
    return 200 OK

完整消息标头示例

From: newsletter@example.com
To: user@gmail.com
Subject: Your Weekly Update
MIME-Version: 1.0
DKIM-Signature: v=1; a=rsa-sha256; d=example.com; s=sel1;
    h=from:to:subject:list-unsubscribe:list-unsubscribe-post;
    b=...
List-Unsubscribe: <https://example.com/unsub?id=abc123>,
    <mailto:unsub-abc123@example.com>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
Content-Type: text/html; charset=utf-8

常见错误

• 使用 HTTP 而不是 HTTPS。List-Unsubscribe 中的 URL 必须使用 HTTPS。电子邮件客户端不会向纯 HTTP 端点发送 POST 请求。
• POST 后需要确认。一键取消的要点是一键。POST 本身必须完成取消订阅。不要发送确认电子邮件要求用户"点击确认"——这违反了目的。
• DKIM 签名中不覆盖标头。如果你的 DKIM 签名在 h= 标签中不包括 list-unsubscribe 和 list-unsubscribe-post，Gmail 将不信任这些标头并不会显示一键按钮。
• 返回错误或重定向。端点必须返回 2xx 状态代码。返回 301/302 重定向、403 禁止或 500 错误将导致取消订阅失败，并可能触发用户改为报告垃圾邮件。
• URL 过期。一些发件人使用具有短期过期时间的签名 URL。如果 URL 在用户点击"取消订阅"之前过期（这可能是收到消息后数周），取消订阅失败。使用长期或不过期的令牌。
• 基于 GET 的取消订阅。端点必须处理 POST，而不是 GET。基于 GET 的取消订阅 URL 可能被电子邮件链接扫描器、预览机器人或安全工具触发——取消订阅从未点击任何内容的用户。
• 省略 mailto 备选方案。虽然 HTTPS URL 处理一键操作，但 mailto: URI 为不支持 RFC 8058 的电子邮件客户端提供备选方案。两者都包括。

可交付性影响

• Gmail/Yahoo 强制。大批量发件人（5000+ 条消息/天）必须实施 RFC 8058。不符合将导致增加垃圾邮件过滤和潜在拒绝。这是近年来引入的最具影响力的可交付性要求。
• 减少垃圾邮件投诉。一键取消订阅提供了"报告垃圾邮件"的无摩擦替代方案。能够轻松退出的用户不需要投诉，直接降低你的投诉率。
• 正面声誉信号。正确实施的一键取消订阅告诉邮箱提供商你是尊重用户偏好的负责任发件人。这有助于正面发件人声誉。
• 用户体验。收件人在 Gmail、Yahoo Mail 和 Apple Mail 中看到清晰、突出的"取消订阅"链接。这建立信任——当用户知道他们可以轻松停止时，他们更有可能与电子邮件互动。
• 处理速度很重要。Gmail 可能通过测试 POST 端点来验证其实际工作。如果你的端点缓慢或不可靠，一键按钮可能不会出现。将响应时间保持在 1 秒以下。

Related RFCs