v1.1.12026-11-16
1.1.1 是一个偏修复的版本,同时把一项企业功能放进了开源版。
先说变化:掩码邮箱地址(masked email)不再需要企业授权,直接可用。DNS 的 Netcup 供应商改走 Netcup 的纯密钥 REST API,只管理 CloudDNS 域,升级后原有配置必须把 CloudDNS 密钥填进新的 apiKey 字段,否则连不上。
修复集中在几个容易踩坑的地方。MTA 侧,排队邮件改为只由发件方租户(或收件人同属一个租户时的收件方租户)管理,不再对所有相关租户可见;掩码地址在自定义子地址规则的域名上不再被拒。IMAP 方面,请求大小限制现在按令牌的实际内存占用计算,登录前刷 ""、登录后刷 ( 这类攻击不再耗尽内存;FETCH、SEARCH 等命令会先补发 EXISTS 再引用新邮件,客户端此前可能记下 UID 却永远拿不到邮件。同一 Message-ID 的草稿不再让新收进来的邮件被误判为重复。
日历修复也不少:iTIP 回复不再覆盖组织者的 RSVP 请求,本地与会者转发的邀请会以未受邀副本形式入历,DTSTART 与 RRULE 不符的周期事件按 DTSTART 起算,多条 RRULE 统一取第一条。S/MIME 邮件改用 Content-Disposition: inline,iOS Mail 能正常显示解密预览。S3 传输错误现在按 maxRetries 重试,Sieve 的 envelope "to" 也补上了 +detail。
v1.1.02026-11-09
[1.1.0] - 2026-11-09
Add the passkey permissions to the default roles. Passkey management needs the new sysPasskey permissions, which default roles created by an earlier version do not include. Add these permissions manually using the recovery administrator or restart the server once with the environment variable STALWARTUPDATEROLEPERMISSIONS=true to add them, then remove the variable. See Default roles on upgraded servers for details.
Added
- Passkeys (WebAuthn) for accounts in the internal directory:
- Passwordless sign-in on the built-in login page, for the authorization code and device flows, with a "Sign in with a passkey" button and browser autofill. Passkeys are not a second factor: signing in with a passkey does not ask for the TOTP code.
- Passkey objects (x:Passkey) to register, list, rename and delete passkeys, with the new x:Passkey/registrationOptions method. Registering a passkey requires the current password, and the TOTP code when one is set. Passkeys are listed in the WebUI under Account > Credentials.
- ES256, Ed25519 and RS256 keys, with attestation none or self-attested packed.
- maxPasskeys limit per account (default 10) in the Authentication settings, and as a per-account quota.
- The relying party ID is the host of the public URL, so the WebUI must run on that host or one of its subdomains.
- Stalwart Keep as an in-memory store, lookup store, cluster coordinator and cache swap store (keep feature).
Fixed
- MTA:
- The reply after the message data is now read with dataTimeout instead of rcptToTimeout.
- Shutdown now drains outbound deliveries in progress (up to 8 seconds) and releases their queue locks, so a restart no longer causes duplicate deliveries or a 10 minute delay in clusters.
- A queue update that fails after a successful delivery (for example during a database failover) is now retried while the queue lock is held, instead of the message being delivered again.
- In clusters, a node that takes over a queued message now reads it at the latest committed version (FoundationDB) or from the primary (SQL read replicas), so a message another node has just delivered is not delivered again and its queue quota is not released twice.
- Milter header edits follow libmilter: SMFIRADDHEADER appends, SMFIRINSHEADER inserts at its position in the whole header list, folded values are written with CRLF, and values that are not UTF-8 are accepted (also MTA hook header edits).
- JMAP:
- PushSubscription/get now returns the verificationCode of verified subscriptions instead of always returning null.
- FileNode/set rejects a Directory role that another Directory in the account already has (draft-ietf-jmap-filenode-20), and FileNode/copy no longer copies role.
- Email/set body parts with a raw header:Content-Type (or Content-Disposition) no longer get a second, generated header field; giving the same header field both raw and through a body part property (type, disposition, cid, ...) is rejected with invalidProperties.
- Calendar: an RSVP (JMAP or CalDAV) on an invitation that was stored without scheduling now sends the iTIP REPLY to the organizer.
- DKIM: a signature whose DNS record cannot be built (such as a DKIM2 ML-DSA-44 key created before v1.0.2) no longer stops publishing, rotation and deletion of the domain's other DKIM signatures.
- ACME: Domain subjectAlternativeNames are validated on save; a name containing a dot that is outside the domain and its aliases and has no public suffix (such as webmail.test) is rejected instead of failing every renewal.
- Storage:
- MySQL/MariaDB: connections no longer switch to the local Unix socket reported by the server (@@socket), which could reach a different local server than the configured host.
- SQLite: a path that is a directory now stores the database there as stalwart.db (the setup wizard carried the RocksDB directory over), and the field is described as a database file.
- PostgreSQL: the wait for server replies is bounded by the new responseTimeout setting (default 2m) and the login handshake by connectTimeout; /healthz/ready returns 503 while the data store is not answering.
- Bootstrap: New installations set up with an external directory (LDAP, SQL, OIDC) now get the default roles, so directory users can log in.
- Cluster: Notifications over Redis/Valkey: subscribing is bounded by connectTimeout and idle subscriptions are pinged every 15 seconds, so a dead or unresponsive server is detected and the subscription is re-established.
- Network: Listeners on a wildcard address (0.0.0.0 or ::) now start when the kernel binds them to a specific address, such as in FreeBSD jails without VNET.
- Enterprise:
- After a lapsed license is renewed, the metrics and tracing stores and the data store read replicas are restored without a restart.
- Queued messages and their contents are now scoped to the tenant that owns them.
- ACME renewal rejects certificates naming identifiers that were not ordered, and tenant domains can only request certificate names within the domain or its aliases (an existing tenant domain with other names stops renewing until they are removed).
- Successful Enterprise license renewals are now logged, with the new key's account limit and validity period.
<hr />
Check binary attestation here
v1.0.32026-11-04
Stalwart 1.0.3:第三方应用(非 WebUI)经 Stalwart 或外部 OIDC 登录时,现在必须申请新的 OAuth scope 才能管理应用密码、API 密钥与账户设置——在 OAuthClient 的 scopes 中补上 urn:stalwart:oauth:scope:security、urn:stalwart:oauth:scope:settings、urn:stalwart:oauth:scope:full(full 仅超级用户可授予),走外部身份提供方的则需创建这些 scope 并分配给对应应用。WebUI 无需操作。
默认角色新增了一批权限,但角色只在全新安装首次启动时创建,升级上来的服务器需重启一次并设 STALWARTUPDATEROLE_PERMISSIONS=true,之后移除该变量。
Blob 存储新增静态加密(AES-256-GCM、ChaCha20-Poly1305,以 SymmetricKey 定义)与 Zstandard 压缩,并配套 BlobRecode 任务,可按新参数重写已存数据。
修复若干:JMAP /copy 同账号调用报错更明确;空 types 的 PushSubscription 不再收到 StateChange;IMAP SEARCH 嵌套上限提到 32 层,Apple Mail 免文搜索不再报 Too many nested filters;OIDC Bearer token 改为优先按 issuer 匹配目录;
v1.0.22026-11-02
1.0.2 升级后有两件事必须手动处理。其一,静态加密要重新启用:加密算法现在由用户密钥决定,旧版按账号选择的 AES-128/256、ChaCha20-Poly1305 等选项已取消,原本开启的账号升级后一律变为 Disabled——在账户加密设置中重新选定公钥之前,新邮件将以明文存储;已注册的公钥和既有密文不受影响。服务端配置也随之搬家:Email.encryptAtRest 改为 Encryption 设置下的 atRestEnable(默认开启,原先关闭过的服务需再关一次),Email.encryptOnAppend 改为账号级设置。其二,升级服务器的管理员要补授权:默认角色只在首次安装时创建,否则「加密」「外部公钥」「S/MIME 信任锚」三处界面不会显示,需用 x:Role/get 查出角色 ID,再按 x:Role/set 授予相关权限。
新功能上,本版重点扩充加密栈:OpenPGP 支持 RFC 9580 的 v4/v6 密钥与 RFC 9980 后量子算法,S/MIME 覆盖 RFC 8551 及后量子证书,新增 RFC 9788 信头保护(可隐藏主题),公钥增加 authenticatedEncryption、strictKeyWrapEncoding 开关与服务端计算的指纹、能力及告警。
v1.0.12026-10-28
1.0.1 主打可观测性与稳定性。遥测改用自研 OpenTelemetry(OTLP over HTTP/gRPC)与 Prometheus 导出器,编码速度提升 4~14 倍;指标名随之规范化——OTLP 下为 stalwart.,Prometheus 下为带单位和 total 后缀的 stalwart,已建仪表盘与告警需同步调整。另新增 OpenMetrics 输出及 serviceName、serviceNamespace、resourceAttributes 配置,取代 OTEL 环境变量;gRPC 导出器支持 TLS、鉴权与自定义头。
草稿($draft)与经 JMAP 提交的已发送副本不再加密落盘,保证客户端所写即所存。OAuth 同意页改为登录后按需展示,prompt=consent 强制显示,集群须全部升级后再启用新流程。
其余修复集中在 ACME DNS-01、全天事件邀请时间、BusyCal 回复兼容、JMAP 各 */set 返回值、RocksDB 升级与 aarch64 并发崩溃、垃圾邮件判定、WebUI 默认值保存与跨租户选择器、租户管理员越权,以及安装脚本的 systemd 单元类型。
v1.0.02026-10-26
Stalwart 1.0.0(2026-10-26)带来多项破坏性变更和全新的数据库布局,v0.16.x 无法原地升级,必须借助迁移工具迁移数据,具体见官方迁移文档。
新增内容中,最实用的是全文搜索:支持从 PDF、Office、OpenDocument、EPUB、RTF 附件中抽取文本建索引,文件存储内容也可检索,并配有带重试与重建能力的索引队列。元数据方面补齐了 JMAP Object Metadata 与 IMAP METADATA 扩展;DKIM2 引入 ML-DSA-44 与 Ed25519 的后量子复合签名;OAuth/OIDC 支持 scopes、可管理的第三方应用授权及外部目录的受众校验。缓存子系统重新设计,新增单机内置内存存储,同时支持 Azure Blob 多种认证方式、LDAP 备用服务器、出站请求的 SSRF 防护和可配置的代理信任跳数。企业版 AI 功能可接入多家模型厂商,并提供垃圾邮件分类器。
需要留意的是,设置结构和遥测事件均做了大规模重命名与重编号,升级前请务必对照 SCHEMA_CHANGES.md。
v0.16.272026-10-18
Stalwart v0.16.27 发布,本次为纯修复版本,未新增功能。IMAP 方面向前:向他人邮箱执行 APPEND、COPY/MOVE 不再改动 JMAP 的 EmailDelivery 状态;SEARCH RETURN 配合 MIN/MAX 与 ALL 时只返回极值,SAVE 组合 MIN/MAX 与 ALL/COUNT 也只保存极值,不再把全部命中项都存下来。iTIP 方面,合并收到的会议更新时不再带上其中的 VTIMEZONE 定义,修复了外部组织者改期后引用不存在的 TZID(如 W. Europe Standard Time),导致 Apple 日历同时显示原定与改期两个日程的问题。OAuth 端,不带路径的回环重定向 URI(如 http://127.0.0.1:45678)现在能正确匹配注册的回环地址,不再被动态客户端注册拒绝。WebDAV 的 PROPFIND allprop 会返回 DAV:current-user-principal,Windows 资源管理器因此能正常把文件夹显示在账户名下。从 v0.16.x 升级只需替换二进制或 docker pull;更早版本请参阅官方升级文档。
v0.16.262026-10-11
0.16.26(2026-10-11)是 0.16 系列的维护版本:从 v0.16.x 升级直接替换二进制或 docker pull 即可;从 v0.15 及更早版本升级,请先读官方 UPGRADING 文档。
新增 sd_notify 支持,方便用 systemd 托管服务。JMAP 的 Mailbox/set 现在允许把邮箱移到已有同名子邮箱的父目录下,仅改变大小写的重命名则返回 alreadyExists,避免制造出看似重复的两个邮箱。
修复集中在这几个坑上:DNSSEC 换用自家修补的 hickory-resolver 分支;RocksDB 此前每次压缩 blob 列族都会重写全部 blob,约每积累 128MB 新邮件就跑一遍;Milter 在协商了 SMFIPNOHDRS 却未协商 SMFIPNOEOH 时收不到头结束标记,事务会一直卡到超时;OIDC 在令牌缺少 claimUsername 时直接用 email 建账号,不再请求 userinfo 端点。JMAP 另修两处:EmailSubmission/set 的 onSuccessUpdateEmail、onSuccessDestroyEmail 会误按提交 id 去改动 id 相同的邮件;VacationResponse/set 只写 isEnabled 会
v0.16.252026-10-05
Stalwart 0.16.25:v0.16.x 用户替换二进制或 docker pull 即可升级,更早版本需先阅读升级文档。本版没有新增功能,集中修复一批缺陷:JMAP 中多域名账户创建带 emailDomain 的 MaskedEmail 一律返回 forbidden;Autodiscover 对 ActiveSync 等非 Outlook 请求误回 Outlook 配置;IMAP 用错密码时只回未标记的 NO,客户端会干等到连接超时。DKIM 轮换问题较重——后继密钥未发布就轮换,外发邮件会失去签名;手动管理期创建的密钥永不轮换;切回手动后还会激活从未发布的新密钥,导致验签失败。垃圾邮件过滤的 Pyzor 检查、DNSBL 计分与负缓存逻辑亦有修正。此外,空 match 的队列配额不再形同虚设,RocksDB 日志不再无限膨胀,WebUI 启动时 S3 认证失败也不会再卡住界面加载。
v0.16.242026-09-27
从 0.16.x 升级直接替换二进制或 docker pull;0.15.x 及更早版本请先阅读升级文档。
新版接入 PowerDNS Authoritative,支持自动管理 DNS 记录。
修复最集中的是垃圾邮件过滤:OpenPhish、PhishTank 中含大写字符的条目此前永不匹配,短链展开也用错大小写;增量训练反复重学旧样本,规则更新只增不改,上游对既有规则、DNSBL 和查找键的修改同步不进来,导入失败还照样报成功。JMAP 推送补了几个洞:限流窗口内的验证请求被直接丢弃、重试推送会覆盖更新状态、VAPID 的 aud 声明可被伪造推送 URL 劫持,另有 Email/import 与 Email/set 的 blobId、邮箱变更问题。MTA 端,无 outboundMta 角色的节点积压约 1024 封后不再响应 DATA,Sieve 脚本也看不到 milter 添加的邮件头。此外修复 MySQL 大范围删除超时后才分批、IMAP 并发 COPY/MOVE 报错、自动发现端口加密标记误导 Outlook、HTTP 空闲连接不关闭等问题。