mail-archiver
自托管邮件归档系统，支持自动同步、搜索、导出、多用户管理和保留策略。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
你的私人邮件小档案馆，支持IMAP和M365，一键Docker部署。
核心功能
- 自动归档多个邮箱的收/发邮件，支持定时同步
- 高级搜索（按发件人、主题、日期、附件等过滤）
- 导出为 mbox 或 ZIP（EML 格式），支持批量选择
- 多用户系统，可精细化分配每个用户的邮箱账号权限
- 保留策略：可分别设置服务端删除和本地存档保留天数
避坑指南
- •应用本身不提供 HTTPS，必须通过反向代理（如 Nginx）配置加密访问。2. 首次启动后请立即修改默认管理员密码。3. 数据库密码不要用示例中的 masterkey，设置强密码。4. 时间区设置（TimeZone__DisplayTimeZoneId）务必正确，否则时间显示混乱。5. 大规模归档时建议定期备份 PostgreSQL 数据库。
适用场景
- 企业合规存档：自动备份所有员工邮件，满足法规要求
- 个人邮件备份：将多个邮箱的邮件集中归档到本地服务器
- 迁移辅助：从旧邮件系统导出并导入到新账户
详细介绍
Mail-Archiver 是一款功能全面的自托管邮件归档系统，适合个人或团队使用。它能自动从多个邮箱账户（支持 IMAP 和 Microsoft 365）同步收/发邮件，并将内容及附件存储在 PostgreSQL 数据库中。通过现代化的 Web 界面，你可以搜索、预览、导出邮件（支持 mbox 或 EML 压缩包），还能管理用户权限、集成 OIDC 身份认证、设置邮件保留策略（分别控制服务器端和本地存档）。基于 ASP.NET Core 10 构建，使用 Docker Compose 一键部署，无需复杂配置。无论是合规存档、数据备份还是个人邮件管理，它都能胜任。
常见问题与排障 (2)
故障排除为什么职位页面上的俄语文本会显示为HTML实体（例如 П）？
此漏洞已在 Mail-Archiver 版本 2604.2 中修复。对于 Docker 安装，请通过拉取最新镜像并重启容器来更新：docker compose pull && docker compose up -d。更新后验证版本。如果问题仍然存在，请确保清除浏览器缓存或尝试使用无痕窗口。
故障排除为什么MailArchiver Docker容器在Synology NAS上因'libgssapi_krb5.so.2'错误而失败？
此错误出现在2512.1之后的版本中，原因在于Docker镜像缺少Kerberos库libgssapi_krb5.so.2。要解决此问题，可以覆盖entrypoint在启动时安装该包。对于基于Debian/Ubuntu的镜像，在docker-compose.yml中添加：command: sh -c "apt update && apt install -y libgssapi-krb5-2 && exec mailarchiver"。对于基于Alpine的镜像，使用：command: sh -c "apk add --no-cache krb5-libs && exec mailarchiver"。或者构建自定义Dockerfile，加入RUN apt install -y libgssapi-krb5-2（或Alpine对应的命令）。官方修复正在GitHub issue #366中跟踪，可订阅以获取更新。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：确保本机安装了 Docker 和 Docker Compose
步骤2：创建 docker-compose.yml 文件并填写数据库连接、管理员账号密码（参考 README）
步骤3：执行 docker compose up -d 启动容器
- 步骤1：确保本机安装了 Docker 和 Docker Compose
- 步骤2：创建 docker-compose.yml 文件并填写数据库连接、管理员账号密码（参考 README）
- 步骤3：执行 docker compose up -d 启动容器
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止容器：docker compose down，删除项目目录下的 postgres-data 和 data-protection-keys 文件夹即可完全卸载。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs