Mailez 是一个自托管邮件服务器解决方案，为自有域名提供完整的 SMTP/IMAP/POP3、CardDAV/CalDAV 服务，附带 React Webmail 和管理控制台，支持一键 Docker Compose 部署。v1.0.2 版本于 2026年10月14日发布，带来了多签名支持、组织页脚、导航界面优化以及多项关键安全修复。

🎯 核心亮点

多签名支持与组织页脚
账户级多签名：每个账户可维护多个富文本签名（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 内的常见布局
保留传输编码和字符集：每个部分独立处理，附件、日历和字符集处理保持不变

🔧 其他修复

Web 推送基线优化：投递回执直接宣布收件箱副本，避免错过订阅前的邮件
转发保留 HTML 和附件：优先使用原始 HTML 正文并携带附件，镜像草稿恢复逻辑
Ban 引擎空 IP 防护：不可归因来源不再成为封禁主体，防止全局锁定

📦 获取方式

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

🚀 快速开始

下载并解压
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

📝 升级说明

此版本无数据库迁移或破坏性变更，现有部署重启后自动获取新行为。

使用组织页脚：
管理控制台 → 设置 → 组织页脚
发布页脚内容（支持 HTML）
为特定域名启用

配置多签名：
Webmail 设置 → 签名
添加多个富文本签名
为账户选择默认签名

👥 贡献者

感谢 @FengHuangYuan 贡献转发 HTML+附件修复（PR #8）。

🔗 相关链接

项目主页:  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