适合希望集中管理 iCloud 隐藏邮箱、自动补充地址库存，或为自己的工具接入收件与验证码 API 的用户。通过 Web 面板完成日常操作，也可以用邮箱池接口领取、使用和退役地址。
| 能力 | 使用体验 |
|---|---|
| 一个面板管理多个主号 | Apple 风格界面，支持 Liquid Glass 效果与深浅色模式；JS、CSS 随服务本地提供。 |
| 隐藏邮箱批量管理 | 同步地址、搜索筛选、跨页选择、框选多选、批量创建与删除。 |
| 自动补充地址 | 手动批量创建与定时自动创建计划并存；新旧双通道按各自额度和状态工作。 |
| 项目邮箱池 | 为不同项目签发 Pool Key，提供领取、确认使用、续租、释放与退役接口。 |
| 链接与 API 取码 | 每个邮箱有独立取件入口；支持将已登记根邮箱的 +tag 邮件归入根邮箱取件。 |
| 按需接收邮件 | 访问取件链接或 API 时触发增量读取，同一主号复用收件连接，减少重复请求和历史正文下载。 |
| 独立凭据与连接恢复 | 每邮箱独立 API Key、IMAP 密码及 OAuth 凭据，支持轮换；可选配置双重验证接码链接，连接失效时自动重新登录。 |
凭据说明：独立 IMAP/OAuth 凭据由本网关签发，用于连接本服务；连接 Apple 上游邮箱仍需对应主号的收件凭据。
交流使用体验、反馈问题、功能建议、部署经验和开源协作：1105888476 · 点击加入 QQ 群
v0.2.9：用过的不重发，空闲数量更准确。
- 用过的地址即使删除后重新加入，也不会被当成新库存；列表、筛选总数和实际可领取数量保持一致。
- 主号停用再恢复时，历史已用地址继续暂停分配，保留正常邮箱状态和项目领取记录。
- 支持每次最多 50 个邮箱批量确认使用，减少大量地址接入时的请求次数。
- 纳入完整目录同步清理与长期待确认地址修复，更新中英文部署和接口说明。
完整的功能变化、修复和升级说明见 CHANGELOG.md。
- auto-team：一个面向 Team 空间和 Free 账号池的轻量管理台，适合需要统一维护 Team、账号、自动席位轮转和 Sub2API 数据的个人开发者与小型团队。
需要 Docker Engine、Docker Compose v2 和 Git，建议至少 2 核 / 4 GB 内存，保持单个应用实例。预构建镜像支持 AMD64 / ARM64；使用隐藏邮箱功能前，请准备具备该功能的 Apple 账户。
git clone --depth 1 https://github.com/t508708/icloud-mail.git
cd icloud-mail
cp -n .env.example .env
docker compose pull
docker compose up -d --wait
docker compose ps默认拉取 ghcr.io/t508708/icloud-mail:latest 和配套 PostgreSQL 镜像，无需本地编译。latest 跟随主分支镜像发布，正式版本与离线包见 Releases。
使用示例配置时，后台地址为 **http://127.0.0.1:8788/admin/**，用户名为 admin。查看首次生成的密码：
docker compose exec -T icloud-api cat /app/keys/admin-password如果部署在远程服务器，在自己的电脑建立 SSH 隧道后访问上面的地址：
ssh -N -L 127.0.0.1:8788:127.0.0.1:8788 USER@SERVER需要公网域名、HTTPS、Cloudflare 或宝塔部署时，参阅 公网部署指南。
在面板中 添加主号 → 配置收件 → 连接 Apple → 同步地址，然后复制取件链接，或选择地址加入邮箱池。自动创建与自动保活按需开启。
直连 iCloud IMAP 收件使用 Apple App 专用密码，与管理隐藏邮箱、重新登录 Apple 时使用的账户密码分开配置。
更新前备份数据库、密钥和邮件归档，保留 .env 与已有数据卷，再执行：
git pull --ff-only
docker compose pull
docker compose up -d --wait需要自行构建时使用：
docker compose -f compose.yaml -f compose.build.yaml up -d --build --wait备份、迁移、离线安装和固定版本部署详见 安装与升级。
将面板中对应邮箱的 API Key 交给自己的程序，即可读取验证码：
curl -H 'Authorization: Bearer MAILBOX_API_KEY' \
https://HOST/api/v1/otp示例配置默认返回最新验证码；也可直接使用面板生成的取件链接。root+tag@domain 仅在对应根地址已登记时归入根邮箱，完整地址精确匹配优先，域名保持不变。
项目对接使用 邮箱池与 API；完整请求定义见 OpenAPI。部署后的 /docs/ 也提供对应服务版本的接入说明。
以下为每个主号滚动一小时的本地自动尝试上限，不是 Apple 官方配额或成功数量承诺。
| 连接状态 | 自动计划 |
|---|---|
| 新旧通道均正常 | 新通道 19 次 + 旧通道 4 次，合计 23 次 / 小时。 |
| 新通道失效、旧通道与目录正常 | 降级为旧通道 5 次 / 小时，新通道重新登录后恢复双通道规则。 |
| 旧通道目录校验失效 | 保留计划，暂停创建，恢复所需连接后继续。 |
为什么不跑满 20 + 5？ 已有观察中，新旧通道常在约 20 次和 5 次附近触限，因此双通道计划各留一次余量，并分散执行时间，减少滚动窗口重叠或其他客户端操作导致的触顶等待。Apple 明确限流时遵守对应通道的冷却与更长 Retry-After。
失败也可能消耗尝试额度。手动创建与探测不受本地自动额度限制，仍受 Apple 实际限制；更多规则见 自动创建与通道恢复。
- 新通道仍可能在约 8 小时后失效。 当前续期尚未证明解决这一现象。可选自动保活会在需要时重新登录，但仍取决于密码、接码服务和 Apple 账户状态，详见 自动保活服务。
- 取码速度受投递和上游连接影响。 按需增量读取、连接复用与批量处理减少重复工作，实际耗时还取决于邮件是否已送达及服务器到上游的网络。
- 登录与收件是两类连接。 Apple 管理连接正常，不代表 IMAP 收件凭据也有效；两者可以分别维护。
- 妥善保管凭据与备份。 登录密码和接码链接加密保存、不回显，服务运行时可解密使用。迁移时需要保留数据库和原密钥。
- 默认直连 Apple 服务。 邮件接收使用 Apple 公开支持的标准 IMAP；隐藏邮箱管理适配 Apple 官网使用的接口，其行为可能随官网调整、账户区域及账户状态变化。本项目为独立维护的自托管工具，与 Apple 无隶属或背书关系。
| 想了解什么 | 入口 |
|---|---|
| 安装、更新、备份与迁移 | 安装与升级 · 公网与 HTTPS |
| 邮箱池和程序接入 | Pool API · OpenAPI |
| 创建计划与登录恢复 | 自动创建 · 自动保活 |
| 收件与配置细节 | 邮件接收 · 配置参考 |
- LINUX DO — 社区支持与灵感
MIT 许可文本见 LICENSE；适用范围、上游来源与第三方许可见 NOTICE.md。
感谢原作者 mangobubu。本项目基于 icloud-api 持续开发，保留上游来源与 Git 历史。
不想折腾嫌麻烦，想直接到手即用的大白菜隐藏邮箱： 点击加入QQ群