为每位客户设置单独的存储空间上限

转售邮件服务时，所有客户都在使用你账户的存储空间。一位用量很大的客户可能占掉另一位客户原本指望的空间，而每位客户的管理员看到的都是你整个账户的总容量，仿佛那是他们自己的。

存储空间上限为客户的域名划出一块专属空间，例如 50 GB。这些域名中的邮件和 Drive 都计入这个上限，客户的管理员在自己的邮箱之间分配它，就像你分配自己的账户一样。

为什么要设置上限

• 可以出售的容量。 客户分配出去的邮箱大小加起来永远不会超过上限。
• 减少你的工作。 客户的管理员自己管理邮箱大小。需要更多空间时，控制面板会请他们联系管理员，不会提到你的公司名称。
• 你的总量保持私密。 他们的概览显示的是他们的上限，而不是你的账户。
• 多个域名一个数字。 一个上限覆盖客户的所有域名。

设置上限

账户所有者可以更改上限，管理成员且能访问全部域名的团队成员也可以。只能访问部分域名的人，例如客户自己的管理员，永远看不到这项设置。

1. 打开团队与客户。
2. 在客户所在行选择编辑访问权限，如果是新成员则选择邀请成员。
3. 选择对方的域名。只要对方被限定到至少一个域名，就会出现存储空间部分。
4. 选择单独上限，然后输入以 GB 为单位的大小，或点击 10、25、50 或 100 GB。
5. 保存。

上限覆盖此人列表中的全部域名。如果团队中还有其他人拥有其中某个域名，他会显示在同样适用于中，因为他们共用同一个上限。

一条进度条显示这些域名已经占用了多少。上限不能低于这些域名中已固定分配的大小和待接受邀请的大小，也不能低于这些域名已经存储的数据量。对话框会在输入框下方说明是哪一项限制了最小值，太小的快捷大小会显示为灰色。

只有当你点击某个卡片、输入大小或点击快捷大小时，存储空间设置才会被保存。之后修改某人的角色或权限，不会影响其上限。

如果你选择的域名有一部分在上限内、另一部分不在，两个卡片都不会被选中，并会显示一条提示说明这种情况。选择单独上限可以把这些域名全部纳入该上限，选择账户存储空间则会取消上限。

当你取消勾选一个在上限内的域名时，对话框会说明保存后的结果：该域名会离开这个上限，或者因为还有其他人拥有它而继续留在上限内。

要取消上限，请选择账户存储空间并保存。保存前，对话框会列出受影响的域名和人员。邮箱保留各自的固定大小，使用共享存储空间的邮箱会重新使用你账户的可用空间。

团队与客户列表会显示存储空间一栏：已用量与上限的对比，例如“3.4 GB / 50 GB”；没有上限时显示账户存储空间；某人的域名设置各不相同时显示按域名。在这里所做的存储空间变更会记录在团队时间线中。

如果某个上限的域名不在团队中任何人的列表里，例如在邀请客户之前通过 API 设置的上限，或移除客户后保留下来的上限，它会显示在列表下方的没有对应客户的存储空间上限中，你可以在那里更改大小或移除上限。

客户管理员看到的内容

当某人的全部域名共用一个上限，且该上限不覆盖其他域名时：

• 概览。 存储卡片的副标题是你的存储空间上限，按这个上限统计其域名中的邮件和 Drive。用量达到 75% 时显示正在填满，达到 90% 时显示即将满，并建议释放空间或联系管理员获取更多空间。
• 邮箱大小。 在编辑存储空间中，以及创建邮箱或邀请成员时，显示的可用空间是上限中剩余的空间，且不会超过你账户的剩余空间。
• 过大。 大小放不下时会显示“超出了你的存储空间上限。如需更多空间，请联系管理员。”
• Drive。 客户角色不再包含账户 Drive，所以其控制面板菜单中没有 Drive。每个邮箱在网页邮箱中仍有自己的 Drive。

如果某人的域名分属不同上限、部分域名没有上限，或者其上限还覆盖了此人并未拥有的域名，其概览会像以前一样显示账户的存储空间。请把一位客户的所有域名放在同一个上限中，并让该客户的管理员拥有所有这些域名。

当你或其他可以更改上限的人选择了放不下的大小时，提示会说明上限还剩多少，并告诉你可以在团队与客户中提高上限。

上限逐渐用满时的邮件

上限用量达到 75%、90% 和 100% 时，客户方管理邮箱的人员会收到一封邮件。达到 90% 和 100% 时，你也会收到一封。前两个节点与客户概览中显示正在填满和即将满的节点相同。

客户方哪些人会收到。 客户方的人员，即只能访问该客户域名、拥有该上限下全部域名、并且可以管理邮箱的人：客户和邮箱管理员角色，以及可以管理邮箱的自定义角色。拥有域名管理员、只读或仅网页邮箱角色的人、尚未接受邀请的人，以及访问权限已被暂停的人不会收到。你自己团队中能访问全部域名的人不会收到这封邮件；如果他们可以更改上限，会改为收到发给你的邮件。

邮件内容。 邮件主题为“存储空间已用 75%”“存储空间即将用满”或“存储空间已满”。邮件会：

• 说明已用多少，例如“38 GB / 50 GB”，以及哪些域名共用这部分空间；
• 列出占用空间最多的邮箱，最多三个，并附上各自的大小；
• 在 90% 时提醒：空间用完后，部分邮箱将无法接收新邮件；在 100% 时提醒：在释放空间之前，部分邮箱可能收不到新邮件；
• 说明如何释放空间：删除旧邮件和大附件、清空回收站，并删除不再需要的 Drive 文件；
• 建议在需要更多空间时联系管理员，不会提到你的公司名称；
• 提供打开邮箱按钮，打开其控制面板中的邮箱页面。

使用哪个品牌。 邮件的外观与它所指向的控制面板一致。如果客户的域名有已生效的品牌控制面板地址，邮件会显示你的品牌名称、徽标和颜色；如果你设置了发件人地址，邮件会从该地址发出，回复会发送到你的回复地址。按钮会打开你的品牌控制面板。如果域名没有品牌，就是一封普通的 TrekMail 邮件，与他们的控制面板一样。每个人都会收到自己语言的邮件；如果没有选择语言，则使用账户所有者的语言。

发给你的邮件。 账户所有者，以及你的团队中可以更改上限的人，会在 90% 和 100% 时收到一封邮件。这是一封 TrekMail 邮件，与你账户的其他邮件一样。主题为“客户的存储空间即将用满”或“客户的存储空间已满”，后面跟着客户的域名。邮件会列出该上限下的域名、上限的用量，例如“47 GB / 50 GB”，以及已通知客户方的哪些人。点击打开团队与客户按钮，即可前往可以提高上限的位置。

发送频率。

• 用量每越过一次 75%、90% 或 100%，就发送一封邮件。不会每周提醒。
• 如果两次检查之间用量一次越过多个节点，只发送一封邮件，针对最高的那个节点。
• 只有当用量降到该节点以下至少 5 个百分点、然后再次上升时，同一封邮件才会再次发送。例如，收到 90% 的邮件后，客户释放空间降到 80%；之后用量再次达到 90% 时，会收到一封新邮件。
• 用量每天检查几次，在重新统计邮件占用的空间之后进行。这项统计可能滞后几个小时，因此邮件可能在用量到达节点几个小时后才送达。
• 无法退订这些邮件。

上限内的共享存储空间和固定大小

在上限内，邮箱的工作方式与在你的账户中相同，相当于在账户之下又分出一层：

• 固定大小。 有自己大小的邮箱会在上限中预留这部分空间，用于自己的邮件和 Drive 文件。固定大小和待接受的邀请加起来永远不会超过上限。
• 共享存储空间。 勾选了共享存储空间的邮箱使用上限中的可用空间：上限减去固定大小，且不会超过你账户的剩余空间。

这里有两条更严格的规则。邮箱不能改得比已经存放的数据还小；只要上限还有空间，调大就没有问题。另外，放不进上限的固定大小对所有人都会被拒绝，包括你。

和在你的账户中一样，每个使用共享存储空间的邮箱各自最多只能用到上限的可用空间。如果多个这样的邮箱同时增长，它们的总量可能超过上限，存储空间一栏会显示出来。要给某个邮箱设置硬性上限，请给它固定大小。邮件用量每隔几小时重新统计一次，因此数字可能略有滞后。

上限内的 Drive

有上限的域名中，邮箱的 Drive 文件计入上限。此外，这些邮箱：

• 看不到你与所有邮箱共享的文件夹，因为其中可能有其他客户的文件；
• 不能把自己的文件夹与所有邮箱共享；
• 空间用满后，无法通过同步应用（WebDAV）上传。删除仍然可用，因此空间已满的客户可以直接在应用中腾出空间。

你自己的账户 Drive 计入你的账户，不计入任何客户的上限。

API 和 MCP

你也可以通过 REST API 和 MCP 服务器读取和设置客户的存储空间上限，以及更改邮箱大小。规则相同：只有管理成员且能访问全部域名的调用方才能更改上限。请参阅通过 API 和 MCP 管理 White Label 团队和 REST API 概览。

REST 端点位于 /api/v1 下。大小以 MB 为单位，每次写入都需要 Idempotency-Key 请求头：

• GET /white-label/client-limits 和 GET /white-label/client-limits/{id}：列出上限或读取单个上限，包括已预留、共享和已用的空间（members:read）。
• POST /white-label/client-limits：为 domain_ids 设置 storage_limit_mb 的上限，或修改它们已共用的上限（members:write）。
• PATCH /white-label/client-limits/{id}：修改大小、完整的域名集合，或两者（members:write）。
• DELETE /white-label/client-limits/{id}：取消上限，其域名重新使用你账户的存储空间（members:write）。
• PATCH /mailboxes/{id}/storage：将 storage_allocation_mb 设为固定大小，或设为 null 以使用共享存储空间（mailboxes:write）。

MCP 工具：White Label 工具集中的 list_client_limits、set_client_limit 和 remove_client_limit，以及 set_mailbox_storage。在自托管服务器上，三个会做出更改的工具需要 TREKMAIL_ALLOW_DESTRUCTIVE=true，remove_client_limit 还需要 confirm_remove=true。

可能遇到的错误：

• client_storage_limit_exceeded（422）：固定大小超出上限剩余的空间；details.available_mb 给出可用的大小。
• client_storage_below_usage（422）：邮箱会小于其已存储的数据量；请查看 details.used_mb。
• client_storage_limit_too_low（422）：上限会低于其域名已预留或已存储的数据量；请查看 details.minimum_mb。
• client_storage_domains_conflict（409）：这些域名分属不同的上限。

常见问题

如何把一个域名从一位客户转给另一位客户？ 先从第一位客户的列表中移除该域名并保存。对话框会告诉你，该域名是会离开这位客户的上限，还是因为还有其他人拥有它而继续留在上限内。然后把它添加给第二位客户。如果这位客户设有上限，请选择单独上限并保存，把该域名纳入这个上限；否则直接保存即可。请按这个顺序操作，因为分属两个不同上限的域名无法合并到同一个上限。

可以降低上限吗？ 可以，最低降到以下两者中较大的那个：其域名中的固定大小和待接受邀请，或这些域名已经存储的数据量。要降得更低，客户需要先删除邮件或文件，或把固定大小的邮箱改为共享存储空间。

上限用满后会怎样？ 使用共享存储空间的邮箱在自身占满上限的全部可用空间后不再接收邮件，固定大小的邮箱在自身用满后不再接收邮件。发件人会收到退信，Drive 上传会被拒绝。读取、下载和删除仍然可用。如上文所述，客户方管理邮箱的人员会在 75%、90% 和 100% 时收到邮件提醒，你会在 90% 和 100% 时收到。

客户自己添加的域名呢？ 这些域名会加入客户的域名列表，并纳入其域名共用的上限。

需要 White Label Lite 吗？ 上限在你保存后立即生效。White Label Lite 启用后，你的客户才能登录你的控制面板。

客户上限的总和可以超过我的账户容量吗？ 可以。上限是一个封顶值，不是预留空间，任何客户都不会获得超过你账户剩余空间的容量。