Question 1

如何注册和登录 YYDS Mail 账号？

Accepted Answer

点击右上角「登录」后，可以使用邮箱或账号配合密码登录；如果还没有账号，也可以在同一页面完成注册。当前支持三种方式：
• 邮箱、账号和密码注册
• GitHub OAuth 授权注册或登录
• LinuxDo OAuth 授权注册或登录
注册后即可创建持久邮箱、API Key、自定义域名等进阶功能。

Question 2

不注册可以使用吗？

Accepted Answer

可以！首页直接提供免费临时邮箱，无需注册。系统自动生成邮箱地址，实时接收邮件。临时邮箱会在一段时间后自动过期。如果需要持久邮箱、API 调用、自定义域名等功能，则需要注册账号。

Question 3

如何绑定 GitHub / LinuxDo 账号？

Accepted Answer

登录后进入「个人设置」页面，在第三方账号绑定区域点击对应平台的「绑定」按钮，完成 OAuth 授权后即可绑定。绑定后可以用该平台一键登录。

Question 4

忘记密码怎么办？

Accepted Answer

支持。登录页点击「忘记密码」后，输入注册邮箱，系统会发送密码重置链接。打开邮件中的链接即可设置新密码；链接默认 30 分钟内有效。如果暂时没有收到邮件，请一并检查垃圾邮件目录。

Question 5

如何注销账号？

Accepted Answer

进入个人设置 → 滚动到页面底部 → 点击「注销我的账号」。需要输入确认文字。账号将立即停用（API Key 作废、所有会话退出）。有 30 天冷静期——在此期间登录可恢复账号。30 天后所有数据将永久脱敏，无法恢复。

Question 6

临时邮箱和持久邮箱有什么区别？

Accepted Answer

• 临时邮箱：首页自动生成，无需注册，有过期时间（通常 24 小时），适合一次性使用。
• 持久邮箱：注册用户在「邮箱管理」中创建，不会自动过期，可以长期使用，支持自定义前缀和域名。

Question 7

如何创建自定义前缀的邮箱？

Accepted Answer

登录后进入「邮箱管理」→ 点击「创建邮箱」→ 输入自定义前缀（如 myname）→ 选择域名 → 创建。最终得到 myname@选择的域名 这样的地址。留空前缀则系统自动生成随机地址。

Question 8

如何查看邮件详情？

Accepted Answer

在「邮箱管理」页面，点击邮箱展开邮件列表，再点击某封邮件即可弹出详情窗口，查看完整的 HTML 或纯文本内容、发件人、收件人等信息。

Question 9

邮件保留多久？

Accepted Answer

邮件保留时间取决于您的套餐：
• Free：1 天
• Basic：7 天
• Pro：30 天
• 域名进阶版：90 天
过期后邮件会被系统自动清理。持久邮箱本身不会过期，但其中的邮件仍受保留期限制。

Question 10

支持接收附件吗？

Accepted Answer

支持。邮件中的附件会随邮件一起保存，可以在邮件详情中查看和下载。附件大小限制取决于您的套餐配额。

Question 11

什么是共享域名？

Accepted Answer

共享域名是 YYDS Mail 提供的公共域名（如 215.im、xiaolajiao.de 等），所有用户都可以使用这些域名创建邮箱。共享域名的特点：
• 无需配置 DNS，开箱即用
• 所有用户共享，不能保证邮箱地址唯一性
• 适合临时使用和快速测试
• 部分网站可能屏蔽常见临时邮箱域名

Question 12

共享域名和自定义域名有什么区别？

Accepted Answer

• 共享域名：系统提供，所有用户共用，无需 DNS 配置，但可能被某些网站识别为临时邮箱并拒收。
• 自定义域名：您自己的域名（如 mail.yourcompany.com），只有您能使用，不会被识别为临时邮箱，适合正式业务场景。需要配置 DNS TXT 和 MX 记录并完成验证。

Question 13

如何添加自定义域名？

Accepted Answer

1. 登录后进入「域名管理」→ 点击「添加域名」
2. 输入您的域名（如 mail.example.com），并决定是否同时准备通配子域能力
3. 按照页面提示完成 DNS 配置：
   • TXT 记录：用于验证域名所有权
   • MX 记录：将邮件指向 YYDS Mail 服务器
   • 如启用通配子域能力，还需额外补一条通配 MX 记录
   • 默认流程不需要额外配置 CNAME
4. 如果您已配置 DNS 自动化服务连接（当前支持 Cloudflare），也可以直接让系统自动同步这些记录
5. DNS 生效后（通常 5-30 分钟），点击「验证」完成配置
6. 只有 TXT 与 MX 同时通过后，域名才会进入「可收信」状态，之后才能稳定创建邮箱、启用通配子域能力或继续公开共享

Question 14

自定义域名验证失败怎么办？

Accepted Answer

常见原因：
• DNS 记录尚未生效——DNS 传播通常需要 5-30 分钟，部分运营商可能需要更长时间，请稍后重试
• TXT 记录值不正确——请确保完整复制验证码，不要遗漏前缀
• MX 记录未配置或仍指向旧邮件服务——除了 TXT 验证记录，还需要添加 MX 记录指向我们的邮件服务器
• 域名管理面板缓存——尝试清除浏览器缓存后重新检查
请注意：TXT 通过只代表归属验证通过；如果 MX 还没通过，域名仍不会进入「可收信」状态。域名页顶部现在可以直接点击「验证通过 / 待处理 / DNS 未通过 / 24 小时内新建」快速筛选，卡片里的 TXT、MX、通配 MX 也会分别用对号或叉号显示当前状态。

Question 15

我可以将域名设为公共共享吗？

Accepted Answer

可以，但前提是域名已经处于「可收信」状态。在域名管理中将域名设为「公开」后，其他用户也可以使用这个父域名创建邮箱，域名所有者会获得奖励调用次数。父域名是否公开，只影响父域名本身是否进入共享池；同域名下的泛子域名仍按私有能力单独管理。若域名后续 MX 失效，共享会自动暂停，直到 DNS 修复完成。

Question 16

域名共享如何获得奖励调用次数？

Accepted Answer

当你将处于「可收信」状态的域名设为「公开」后，其他用户可以在上面创建邮箱。系统每日自动结算使用量，根据管理后台配置的兑换比例换算为奖励调用次数，奖励会在有效期结束后失效。
共享的域名越多、使用量越大，获得的奖励调用次数就越多。若域名后续 MX 失效，共享会暂停，新的公开创建也会被拦住；修复后再继续累计。可在仪表盘查看域名使用统计和奖励调用次数。

Question 17

泛子域名怎么配置？

Accepted Answer

泛子域名建立在已经接入的精确域名之下，不是单独再添加一个 `*.example.com` 域名。推荐流程：
1. 先添加并验证精确域名
2. 如需同时准备泛子域名，可在添加域名时一并勾选
3. 在 DNS 记录里额外补一条通配 MX 记录
4. 大多数平台记录名称填写 `*`，如果平台要求完整主机名，再填写 `*.example.com`
5. 默认流程仍然不需要额外添加 CNAME
6. 规则真正启用前，还需要满足：父域名归当前账号所有、TXT 验证通过、根域 MX 生效、通配 MX 生效
7. 启用后，系统会在这个域名下分配真实子域；省略子域标签时，会自动生成 5 位短标签
8. 如果固定了某个真实子域，例如 `team-a.example.com`，这个真实子域下可以继续创建多个不同本地前缀的邮箱，只要完整地址不重复即可
9. 不需要继续使用时，可以直接在域名卡片里暂停使用；后续 DNS 修好或重新需要时，再恢复即可
10. 泛子域名本身始终按私有能力管理，不进入共享池，也不能设成公开共享

Question 18

如何获取 Cloudflare API 令牌并启用 DNS 自动化？

Accepted Answer

1. 进入「域名管理」→ 打开「DNS 自动化设置」
2. 登录 Cloudflare 控制台，打开“我的个人资料” → “API 令牌”
3. 创建一个自定义令牌，并授予至少 Zone:Read 与 DNS:Edit 权限
4. 把需要管理的域名纳入令牌可访问范围
5. 将令牌粘贴到 YYDS Mail 的 DNS 自动化设置中，点击“测试连接”并保存
6. 保存后，添加域名时即可勾选“自动同步 DNS 记录”；如果你选择从服务商导入域名，系统也会直接读取当前令牌可访问的域名列表
7. 如果没有配置 Cloudflare 令牌，仍然可以继续手动配置 TXT / MX / 通配 MX 记录，功能不会受限，只是步骤更多一些

Question 19

如何创建 API Key？

Accepted Answer

登录后进入「API Keys」页面 → 点击「创建 API Key」→ 输入名称 → 选择域名权限范围 → 创建。创建后会立即显示完整的 API Key（AC- 开头），请先复制保存；如果之后还需要，登录用户仍可在 API Key 管理页面再次显示完整密钥。

Question 20

API Key 的域名权限范围是什么意思？

Accepted Answer

域名权限范围（Domain Scope）控制 API Key 可以访问哪些域名下的邮箱：
• all：访问当前账号实际可用的全部域名
• public：只访问公共共享域名
• own：只访问当前账号自己的自定义域名
• specific：只访问明确指定的域名列表
建议为不同业务创建不同权限的 API Key，遵循最小权限原则。

Question 21

API 支持哪些认证方式？

Accepted Answer

两种方式：
• X-API-Key 请求头：X-API-Key: AC-your-key-here
• Bearer JWT：Authorization: Bearer <access_token>
其中 API Key 适合自动化调用；Bearer JWT 适合已登录用户访问只接受登录态的管理接口，例如域名、泛子域名和 Webhook 管理。

Question 22

WebSocket 实时推送怎么接入？

Accepted Answer

1. 先调用 GET /v1/auth/ws-ticket 获取短期 ticket
2. 连接 WebSocket：wss://api-domain/v1/ws?token=ticket
3. 服务端会自动推送您名下邮箱的新邮件事件
4. 消息格式：{type: "message.new", mailbox: "xxx", data: {id, from, subject, date}}
适合需要实时感知新邮件的场景，比轮询更高效。

Question 23

API 的速率限制是多少？

Accepted Answer

API 使用令牌桶算法限流，基线速率来自当前订阅套餐，并会在已验证共享域名带来的 RPM 奖励后继续上浮。公开文档里的速率说明属于运行时数据，不建议把某一组固定数值当成长期合同。超限返回 429 状态码，`Retry-After` 头会给出建议等待时间：短等待通常是瞬时速率桶，长等待通常是日、周、月 API 配额耗尽。`/v1/pricing` 展示的是额外购买池和公开速率元数据，不是套餐目录；购买池也不会改写订阅套餐的基础速率。精确值以 `/v1/plans`、`/v1/pricing` 和登录后的 `/v1/me/quota` 为准。

Question 24

什么是 Webhook？如何设置？

Accepted Answer

Webhook 可以让你的应用在事件发生时（例如收到新邮件）实时接收 HTTP 通知。设置方式：
1. 进入「Webhooks」页面 → 点击「创建 Webhook」
2. 输入回调 URL 并选择要订阅的事件
3. 保存 — 系统会生成用于签名验证的密钥（仅显示一次，请立即保存）
4. 你的服务器将收到包含事件数据的 POST 请求
Webhook 非常适合自动化流程。你可以在 Webhook 管理页面测试、编辑和重新生成密钥。

Question 25

哪些行为会计入 API 调用次数？

Accepted Answer

不是所有已登录请求都会扣 API 次数。当前规则是：
• 会计入：受保护接口在使用 API Key 时，基本按一请求一计次；以及已登录用户从首页点击创建临时邮箱（这条链按 API 语义处理，会归入 API 邮箱分组）
• 不计入：公开接口和普通网页浏览/管理请求，例如打开仪表盘、查看邮箱列表、查看域名、查看消息、打开设置等 JWT 页面请求
• 匿名首页创建：不走用户 API 配额，但有单独的匿名创建限流。短时间可连续创建最多 10 次；超过后会按恢复速度返回建议等待时间，通常约 5 秒
例子：
• 会计入：用 API Key 调用 `POST /v1/accounts` 创建临时邮箱、调用 `GET /v1/messages?address=...` 拉取邮件、调用 `GET /v1/messages/'{'id'}'` 查看详情，这些都按一次请求记一次
• 不计入：直接访问 `GET /v1/plans`、`GET /v1/pricing`、`GET /v1/stats` 这类公开接口；或者登录后在网页里打开仪表盘、设置、域名管理页面
如果你是第三方程序直接调用接口，请默认按 API 调用理解，并使用 API Key 或 Bearer JWT。

Question 26

API Key 可以使用泛子域名吗？

Accepted Answer

可以，而且现在推荐把它当成“固定域名 + 可选子域”来理解。
1. 固定域名：传 `localPart + domain`
2. 泛子域名：继续传 `localPart + domain`，需要固定真实子域时再额外传 `subdomain`
如果你直接调 `POST /v1/accounts/wildcard`，系统会优先使用默认泛域名；如果没有默认值，就从当前 key 可用的泛域名里随机选一个父域，再自动生成真实子域。普通脚本不再需要显式感知 `wildcardRuleId`；只有兼容旧脚本或高级排障时，才需要关注它。创建成功后，后续查询邮件与验证码时，必须使用接口返回的最终 `address` 或对应 `temp token`，不能只用前缀或主域名。

Question 27

如何充值余额？

Accepted Answer

登录后进入「余额」页面 → 输入充值金额（最低 1 元）→ 点击「余额充值」→ 跳转支付页面完成支付。支付成功后余额自动到账。

Question 28

如何购买 API 调用次数？

Accepted Answer

在「余额」页面下方购买额外 API 调用池，并使用余额直接结算。它是独立购买、独立消耗的资源池，不等于升级套餐，也不会改写当前套餐基线。购买池规格属于运行时配置，余额页和 `/v1/pricing` 会显示当前最新档位。购买后额度立即生效，可在仪表盘查看剩余次数。

Question 29

兑换码怎么使用？

Accepted Answer

登录后进入「兑换码」页面 → 输入兑换码 → 点击兑换。兑换码可以获得 API 调用额度或套餐时间。兑换码来源：官方活动、管理员发放、域名共享奖励等。

Question 30

各套餐有什么区别？

Accepted Answer

YYDS Mail 现在按两组来理解订阅套餐：基础套餐组（免费版、基础版）面向日常收信与轻量自动化；进阶套餐组（专业版、域名进阶版）面向更高频 API、更高稳定性和更强域名治理能力。实际差异主要体现在邮箱数、API Key、日/周/月 API 调用基线、速率和保留期。精确数值以「定价」页面、`/v1/plans` 和登录后的 `/v1/me/quota` 为准；奖励增益与已购调用池会单独展示，不应与订阅套餐混读。

Question 31

套餐有哪些时长选择？有折扣吗？

Accepted Answer

套餐提供 4 种时长：月付（30天）、季付（90天，9折）、半年付（180天，8折）、年付（365天，7折）。时长越长折扣越大。价格精确计算，支付前可以看到准确金额。

Question 32

套餐到期前会通知我吗？

Accepted Answer

会！系统会在到期前 7 天、3 天、1 天和到期当天发送提醒。提醒方式包括仪表盘顶部横幅（含续费按钮）、弹窗通知和通知铃铛。到期后账号自动降为免费套餐。

Question 33

什么是奖励调用次数？如何获取？

Accepted Answer

奖励调用次数来自公开共享且已验证的域名，是独立于订阅套餐的收益线。当其他用户在你的共享域名上创建邮箱时，系统会按规则结算奖励。获取方式：
1. 添加并验证你的自定义域名
2. 在域名管理中将其设为「公开」
3. 其他用户使用你的域名时奖励自动累积
奖励调用次数会先进入你的调用池，可用于支持调用池消耗的购买等场景；它不属于套餐内建保证，也不会直接改写当前套餐基线。你可以在仪表盘查看奖励余额与相关记录。

Question 34

什么是调用池消耗优先级？如何修改？

Accepted Answer

调用池消耗优先级决定购买时优先消耗哪种调用池：
• 自动（默认）：系统自动优化消耗顺序
• 优先消耗奖励调用次数：先使用域名共享获得的奖励调用次数，再消耗充值获得的调用池
• 优先消耗购买调用池：先使用购买得到的调用池，再保留奖励调用次数
在「设置」→「调用池优先」中修改。更改立即对后续所有交易生效。

Question 35

每日调用额度和邮件保留时间是怎么计算的？

Accepted Answer

两类规则需要分开理解：
• 每日 API 调用：按 UTC 自然日统计，当前会在每天 00:00 UTC 重置；换算到北京时间是每天 08:00。
• 每周 / 每月 API 调用：采用滚动窗口统计，不是按周一或每月 1 日统一清零。最近 7 天和最近 30 天内的调用会持续参与计算。
• 邮件保留：按当前套餐的保留天数计算，例如 7 天、30 天或 90 天，不是每天重置。邮件超过保留期后会自动清理，持久邮箱本身仍然保留。
• 套餐到期：到期后会回落到免费套餐，对应配额与保留时间也会按新的生效套餐重新计算。
当前规则以已登录后的套餐页、配额页和 `/v1/me/quota` 为准。

Question 36

为什么收不到邮件？

Accepted Answer

请按以下步骤排查：
1. 确认邮箱地址复制正确，没有多余空格
2. 检查发件方是否支持临时邮箱域名（部分网站屏蔽临时邮箱）
3. 等待几秒钟——邮件通常在 5 秒内到达，但某些发件服务器可能有延迟
4. 如果使用自定义域名，确认 MX 记录已正确配置并通过验证
5. 刷新页面或检查「邮箱管理」中的邮件列表
如果问题持续，可能是发件服务器的反垃圾策略阻止了投递。

Question 37

为什么邮箱突然过期了？

Accepted Answer

临时邮箱有自动过期机制。首页创建的匿名临时邮箱通常在 24 小时后过期。如果需要长期使用的邮箱，请注册账号后在「邮箱管理」中创建持久邮箱（不会自动过期）。

Question 38

API 返回 429 (Too Many Requests) 怎么办？

Accepted Answer

429 表示超出了速率限制。处理方式：
1. 查看响应头 Retry-After 获取建议等待秒数
2. 实现指数退避重试（1s → 2s → 4s）
3. 减少并发请求数，使用队列控制发送速率
4. 考虑升级到更高套餐获得更大速率
5. 如果是轮询场景，建议改用 WebSocket 实时推送

Question 39

页面加载很慢或功能异常怎么办？

Accepted Answer

尝试以下步骤：
1. 清除浏览器缓存并刷新页面（Ctrl+Shift+R）
2. 检查网络连接是否正常
3. 尝试切换浏览器
4. 如果使用了 VPN 或代理，尝试关闭后重试
如果问题持续，请通过页面反馈入口联系管理员。

Question 40

为什么自动退出登录了？

Accepted Answer

可能的原因：
• 登录令牌（Access Token）已过期——系统每 10 分钟自动刷新，但如果网络中断可能导致刷新失败
• 在多个标签页中同时操作——令牌刷新有互斥保护，但极端情况下可能冲突
• 浏览器清除了 Cookie
解决方法：重新登录即可。如果频繁出现，请检查浏览器是否设置了自动清除 Cookie。

Question 41

如何联系管理员？

Accepted Answer

三种方式：
1. 使用页面反馈入口直接给管理员留言
2. 在 GitHub 上提交 Issue
3. 发邮件至 xiaolajiaoyyds@gmail.com

Question 42

什么是临时邮箱？

Accepted Answer

临时邮箱（也称一次性邮箱或匿名邮箱）是一种短期使用的电子邮件地址。它可以正常接收邮件，但不需要您提供任何个人信息进行注册。YYDS Mail 提供免费、即时、无需注册的临时邮箱服务，帮助您在互联网上保护隐私。

Question 43

YYDS Mail 是完全免费的吗？

Accepted Answer

是的，基础功能完全免费。无需注册、无需付款，打开网页即可使用。自定义域名、更高 API 额度等高级功能可通过付费套餐获取。

Question 44

可以用 YYDS Mail 发送邮件吗？

Accepted Answer

YYDS Mail 目前是纯接收服务，专注于帮助用户接收验证码和确认邮件。我们专注于让临时邮件接收快速、可靠、私密。

Question 45

我的邮件内容是否会被保存或查看？

Accepted Answer

邮件内容仅根据您的套餐保留期临时存储，过期后由系统自动清除。我们拥有自建的后端基础设施，不会主动查阅用户邮件，仅您本人可通过认证访问自己的收件箱。

Question 46

YYDS Mail 安全吗？

Accepted Answer

YYDS Mail 使用多层安全措施：
• TLS 加密连接
• bcrypt 密码哈希
• JWT 签名令牌 + HttpOnly Cookie
• 每用户速率限制 + 全局并发保护
• iframe 沙盒渲染邮件 HTML，防止 XSS
• API Key 域名权限范围控制
我们不存储 IP 地址或个人信息。

帮助中心 & 常见问题

临时邮箱的常见使用场景

三步开始使用

获取邮箱

复制并使用

实时接收邮件

账号与登录

邮箱使用指南

域名相关

API 与开发者

余额、购买池与套餐

问题排查

其他常见问题