Mailez 是一个自托管邮件服务器解决方案,为自有域名提供完整的 SMTP/IMAP/POP3、CardDAV/CalDAV 服务,附带 React Webmail 和管理控制台,支持一键 Docker Compose 部署。v1.0.2 版本于 2026年10月14日发布,带来了多签名支持、组织页脚、导航界面优化以及多项关键安全修复。
:dart: 核心亮点
多签名支持与组织页脚
账户级多签名:每个账户可维护多个富文本签名(HTML 格式 + 纯文本备选),撰写时灵活选择
组织级页脚:管理员可从控制台发布统一的组织页脚,自动附加到指定域名的外发邮件中
企业合规:满足企业对邮件签名统一管理和品牌展示的需求
Webmail 导航界面重构
管理控制台移至顶部:从侧边栏底部溢出菜单移到右上角标题栏,仅管理员可见
过滤规则直接显示:侧边栏底部以图标形式直接展示,消除"…"溢出菜单
更主流的体验:对齐网易邮箱大师等主流 Webmail 的交互设计
安装与初始化加固
快速失败机制:admin 账户种子化失败时立即报错,不再静默留下无管理员的运行栈
Passkey 注册修复:用户句柄编码改为 WebAuthn 规范的 base64url,解决非 UTF-8 字节导致的注册失败
镜像标签持久化:MAILEZ_IMAGE_TAG 正确写入环境文件,防止意外回退到 :latest
Admin 地址构造修复:解决域名长度导致的 slice panic,支持任意长度的域名
认证与会话安全增强
IMAP 开关全端口生效:移除端口 143 豁免,禁用 IMAP 后立即对所有端口生效
认证缓存作用域限定:密码和应用令牌始终查询控制面板,仅 webmail 会话令牌被缓存
禁用时主动断开会话:账户禁用或凭证轮换时,通过管理 API 强制断开活动的 IMAP 会话
封禁引擎归因修复:空 IP 不再创建全局封禁,引擎现在正确传递客户端地址
MIME 处理改进
嵌套 multipart 正确渲染:完整遍历 MIME 树结构,正确处理 multipart/alternative 嵌套在 multipart/mixed 内的常见布局
保留传输编码和字符集:每个部分独立处理,附件、日历和字符集处理保持不变
:wrench: 其他修复
Web 推送基线优化:投递回执直接宣布收件箱副本,避免错过订阅前的邮件
转发保留 HTML 和附件:优先使用原始 HTML 正文并携带附件,镜像草稿恢复逻辑
Ban 引擎空 IP 防护:不可归因来源不再成为封禁主体,防止全局锁定
:package: 获取方式
GitHub Release: https://github.com/mailez-hq/mailez/releases/tag/v1.0.2
安装 Tarball: https://github.com/mailez-hq/mailez/releases/download/v1.0.2/mailez-v1.0.2.tar.gz (15KB)
校验和: https://github.com/mailez-hq/mailez/releases/download/v1.0.2/checksums.txt
:rocket: 快速开始
下载并解压
wget https://github.com/mailez-hq/mailez/releases/download/v1.0.2/mailez-v1.0.2.tar.gz
tar xzf mailez-v1.0.2.tar.gz
cd mailez-v1.0.2
交互式安装
./install.sh
:memo: 升级说明
此版本无数据库迁移或破坏性变更,现有部署重启后自动获取新行为。
使用组织页脚:
管理控制台 → 设置 → 组织页脚
发布页脚内容(支持 HTML)
为特定域名启用
配置多签名:
Webmail 设置 → 签名
添加多个富文本签名
为账户选择默认签名
:busts_in_silhouette: 贡献者
感谢 @FengHuangYuan 贡献转发 HTML+附件修复(PR #8)。
:link: 相关链接
项目主页: https://github.com/mailez-hq/mailez https://gitee.com/mailez-hq/mailez
完整变更日志: https://github.com/mailez-hq/mailez/blob/v1.0.2/docs/release-notes-v1.0.2.zh-CN.md
文档: https://github.com/mailez-hq/mailez/tree/main/docs