跳到主要内容

管理控制台

Mailez 管理控制台让邮件系统管理变得简单，不再头疼。

域名健康检查（Health）​

管理台的「健康」页对每个邮件域做实时体检，一条条给出 正常 / 提醒 / 失败 / 未知 状态与对应修复提示，可一键重跑——上线当天 用它自检，平时用它巡检：

  • DNS 逐项核验（按域展示）：
    • MX — 是否指向本机主机名；指向别处（可能经网关/中继）时提示而非误报
    • SPF — 是否存在 v=spf1 记录、是否覆盖本机、是否为 -all 硬策略
    • DMARC — 策略档位（p=reject / p=quarantine 通过，p=none 仅监控则提醒）
    • DKIM — 把 DNS 里已发布的公钥与服务器实际密钥逐字比对，改错了立刻现形
    • Spamhaus ZEN 黑名单 — 查询服务器 IP；SBL/XBL 命中判失败；云厂商 IP 常见的 PBL 策略收录单独列为提醒（建议出站走中继或申请移除）， 不算垃圾邮件证据，收信不受影响
    • autoconfig / MTA-STS — 客户端自动配置与 MTA-STS 子域是否已发布
  • 系统探测：引擎 IMAP / MTA 拨号、Redis、数据库、磁盘与内存余量、 公网 TLS 证书剩余有效期（14 天内提醒、过期即失败）

健康检查把「记录缺失」和「探测失败」区分开，绝不显示假通过或假失败。

DNS 向导​

域名页为每个域名内置 DNS 向导：列出部署必须发布的 9 条记录 ——MX、SPF、DKIM、DMARC、autoconfig / autodiscover / mta-sts 三个 CNAME、MTA-STS 策略 TXT、TLSRPT 报告 TXT——每条给出应填的主机名 与记录值（DKIM 直接取当前密钥公钥），并实时核验「已配置 / 缺失 / 不一致」。照抄即可，不必翻文档。

客户端自动配置与 MTA-STS​

系统内置邮件客户端自动配置端点，Thunderbird / Outlook / Apple 客户端 输入邮箱地址即可自动带上服务器参数：

  • Mozilla autoconfig：/mail/config-v1.1.xml（含 /.well-known/ 路径）
  • Microsoft autodiscover：/stack/autoconfig/microsoft(.json)
  • Apple 配置描述文件：/stack/autoconfig/apple
  • MTA-STS 策略：/.well-known/mta-sts.txt（STSv1，默认 testing 档—— 仅报告不强制，可安全发布）

配合上面的 autoconfig/mta-sts CNAME 记录，客户端零手工配置。

两步验证自助开通（TOTP）​

管理员在「配置 → 安全」页可自助开通 TOTP 两步验证：页面展示密钥与 otpauth:// URI（可扫码导入验证器 App），验证一次动态码后启用， 关闭时同样需输入动态码确认。

灰名单开关​

引擎内置的灰名单（对可疑发件人首次投递临时婉拒、一小时内重试放行） 通过环境变量 MAILEZINE_JUNK_GREYLIST 暴露在 compose 配置中，社区版与 企业版均可开启；默认关闭，开启前请评估对方服务器重试能力。

运维摘要与流量报告（企业版）​

  • 运维摘要邮件 — 每日（默认 03:00）或每周向首管理员发送运营摘要： 账号/域名数量、新增用户、登录与失败尝试、发信量，以及健康检查结论； 多副本由数据库租约保证只发一份
  • 流量报告 — 每 5 分钟采样引擎 Prometheus 指标，按天汇总收发流量 （含计数器重置检测），管理台「报告」页以图表呈现，无需外接监控

核心功能​

一站式管理​

在一个界面中管理所有邮件相关配置：

  • 域名管理 — 添加、验证、配置域名
  • 邮箱管理 — 创建、编辑、删除邮箱账户
  • 别名管理 — 配置邮件别名、转发规则与匿名别名
  • 通讯组管理 — 创建、编辑、删除通讯组，一个地址投递到多个成员（含外部地址与嵌套组）
  • 中继配置 — 设置外部 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 秒内自动接管，无需人工介入
  • 共享对象存储——超大附件与云盘落 S3 兼容对象存储（MAILEZ_DRIVE_BACKEND=s3；默认 RustFS，MinIO 亦可）， 上传与下载可以落在不同副本
  • 存储层原生横向——控制面 MySQL、引擎 KV（TiDB）、blob（S3 兼容：RustFS/MinIO） 均为分布式组件；引擎集群可选租约 active-passive 容灾，或 multi 档 全服务多活（任意副本服务任意账户，出站投递按消息认领、崩溃租约 接管、扩容即加副本——mailezctl up multi）

扩容副本：docker compose … up -d --scale backend=4，gateway 30 秒内自动 纳管。NTP、备份与滚动升级等运维要点见仓库 docs/scaling.md。

访问控制台​

生产部署推荐经网关入口访问，Webmail 与管理控制台同域同端口：

  • 管理控制台：https://<邮件主机>/admin（如 https://mail.example.com/admin）
  • Webmail：https://<邮件主机>/

容器宿主机的直连端口 8081 / 8082 / 8083 默认只绑定本机回环地址 （127.0.0.1），仅供调试使用；CardDAV / CalDAV 同样经网关 https://<邮件主机>/dav/ 提供，不需要对外暴露任何后端端口。

本地试用（未起网关）时访问 http://localhost:8082（管理台）与 http://localhost:8083（Webmail）。

首次启动后，创建管理员账户：容器部署运行 docker compose … exec backend mailez-seed，源码开发运行 go run ./cmd/seed （默认账号 admin@example.com / MailezDemo2026!，可用环境变量覆盖）。