管理控制台
Mailez 管理控制台让邮件系统管理变得简单，不再头疼。
核心功能
一站式管理
在一个界面中管理所有邮件相关配置：
- 域名管理 — 添加、验证、配置域名
- 邮箱管理 — 创建、编辑、删除邮箱账户
- 别名管理 — 配置邮件别名、转发规则与匿名别名
- 通讯组管理 — 创建、编辑、删除通讯组，一个地址投递到多个成员（含外部地址与嵌套组）
- 中继配置 — 设置外部 SMTP 中继
- 外部邮箱抓取 — 从外部邮箱自动抓取邮件
- 应用令牌 — 为第三方应用生成专用密码
DKIM 一键配置
- 一键生成 DKIM 签名密钥
- 状态提示清晰，确保邮件不进垃圾箱
- 自动配置 DNS 记录
目录与身份
- AD / LDAP 集成（企业版） — LDAP/AD 认证兜底、账号生命周期同步与自动开户
- 组织通讯录 — 按部门树状浏览，LDAP 组实时展开为邮件列表
- SSO 单点登录（企业版） — OIDC 联合登录，对接企业身份提供商，按邮箱匹配本地账号
- 白标品牌（企业版） — 登录页与管理控制台替换为单位的名称、标志与配色；社区版保持内置品牌
邮件归档
- 引擎侧全量捕获收/发邮件
- 保留策略与元数据检索
- 审查备注、.eml 下载与 mbox 导出
出站 DLP 审批
- 敏感词 / 正则规则匹配出站邮件，命中后阻断或转入审批
- 审批台放行 / 拒绝，到期自动驳回
- 全程可审计
公告（企业版）
- 全局公告横幅一键发布
- 覆盖全组织收件箱
审计日志
- 记录所有管理员操作与登录事件
- 谁在什么时候做了什么，一目了然
- 企业版支持按用户/时间范围筛选并导出 CSV
角色权限
- 管理员 — 完全控制权限
- 经理 — 管理邮箱和用户
- 用户 — 仅管理自己的设置
授权与邮箱数
- 企业版按授权文件（
MAILEZ_LICENSE_FILE）控制邮箱数上限（用户数/邮箱数） - 创建邮箱、自助注册与 AD/LDAP 自动开通均执行上限校验，超限返回 403
- 概览页展示授权状态：版本、已用/上限、到期时间
技术服务
- 服务（支持/SLA/护航）为独立按年订阅，社区版与企业版均可购买
- 服务证书由
MAILEZ_SERVICE_FILE加载，概览页展示档位与在保状态
配置导入导出
- 一键备份整个配置
- 迁移到新服务器时快速恢复
- 配置版本管理
Webhook 集成
- 新邮件、审批等事件回调外部系统
- HMAC 签名校验，可对接工单、CRM 与监控平台
安全特性
- 两步验证（TOTP）
- 会话管理
- IP 白名单（可选）
- 操作审计
横向扩容与多副本 HA
企业版支持控制面多副本横向扩容：mailezctl up ha（enterprise 栈叠加
docker-compose.ha.yml）。backend 与前端均为无状态副本，gateway 自动纳管
新副本，容量按需增长。
- 定时发送原子认领——任意副本数下不双发；副本在投递中途崩溃，认领 5 分钟后自动回收重投
- 后台任务租约选主——外部邮箱聚合拉取、web 推送、日历提醒、超大附件 清理、归档保留、DLP 审批过期、LDAP 同步由租约持有者单独执行，leader 故障 60 秒内自动接管，无需人工介入
- 共享对象存储——超大附件与云盘落 MinIO/S3（
MAILEZ_DRIVE_BACKEND=minio）， 上传与下载可以落在不同副本 - 存储层原生横向——控制面 MySQL、引擎 KV（TiDB）、blob（MinIO/S3）
均为分布式组件；引擎集群可选租约 active-passive 容灾，或
multi档 全服务多活（任意副本服务任意账户，出站投递按消息认领、崩溃租约 接管、扩容即加副本——mailezctl up multi）
扩容副本：docker compose … up -d --scale backend=4，gateway 30 秒内自动
纳管。NTP、备份与滚动升级等运维要点见仓库 docs/scaling.md。
访问控制台
首次启动后，创建管理员账户：容器部署运行
docker compose … exec backend mailez-seed，源码开发运行 go run ./cmd/seed
（默认账号 admin@example.com / MailezDemo2026!，可用环境变量覆盖）。