后端通信【免费下载链接】MailuInsular email distribution - mail server as Docker images项目地址https://gitcode.com/gh_mirrors/ma/Mailu点击查看免费下载Mailu 是一个以一组 Docker 镜像为交付形态的轻量而全功能的邮件服务器。本文基于仓库根目录的 README 展开结合core/、docs/、setup/等目录中的源码与配置文件系统梳理 Mailu 的功能矩阵、容器架构、部署配置与安全机制帮助读者理解其设计取舍并掌握从零部署与调优的完整路径。项目定位邮件服务器即一组 Docker 镜像Mailu 的自我定位清晰而克制simple yet full-featured——简单但功能完整。它不是又一个重量级群件套件而是聚焦于邮件核心业务收发、转发、过滤、管理并且刻意不内置专有软件、不附带与邮件无关的功能。README 用两句话概括了它的哲学It is free software (both as in free beer and as in free speech), open to suggestions and external contributions. The project aims at providing people with an easily setup, easily maintained and full-featured mail server while not shipping proprietary software nor unrelated features often found in popular groupware.即自由软件免费且开源、欢迎外部贡献、追求易部署、易维护、功能完整同时拒绝大多数群件套件常见的臃肿与专有组件。这一理念直接体现在仓库结构上所有组件都位于 core/ 与 optional/ 目录下每个子目录对应一个独立容器镜像彼此通过环境变量与网络通信解耦。功能矩阵README 中列出的六大能力逐项拆解README 的 Features 部分是整份文档的技术骨架。以下结合仓库实际实现逐条展开1. 标准邮件协议服务IMAP / IMAP / SMTP / SubmissionIMAP 与 IMAP由 core/dovecot/ 提供容器内默认监听 143明文与 993TLS端口docs/compose/docker-compose.yml 中 front 容器向宿主机暴露了这些端口。Dovecot 还承担了配额管理、全文检索见后文与 managesieve 脚本支持。SMTP 与 Submission由 core/postfix/ 提供监听 25SMTP、465SMTPS、587Submission端口。MESSAGE_SIZE_LIMIT等参数直接作用于 postfix 的message_size_limit配置。客户端自动配置README 强调 auto-configuration profiles for clients。这一能力由 core/admin/mailu/internal/views/autoconfig.py 实现——Mailu 会为 Thunderbird 等客户端提供autoconfig配置档让客户端无需手工填写服务器参数即可完成 IMAP/SMTP 设置。2. 高级邮件功能别名、域别名、自定义路由、附件全文检索别名Alias与域别名Alternative/Domain Alias管理界面中分别对应 alias 与 alternative 两个资源core/admin/mailu/models.py 中的Alias、Alternative模型承载其数据结构core/admin/mailu/ui/views/aliases.py 提供增删改查视图。自定义路由Custom routing通过域级与别名级的目标地址配置可将特定地址的邮件转发到外部邮箱或本域其他地址对应模型中的destination字段。附件全文检索FULL_TEXT_SEARCH配置项默认en控制 Dovecot FTSfull-text search支持的语言列表可设为off关闭以节省性能FULL_TEXT_SEARCH_ATTACHMENTS则控制是否启用 Tika 对附件内容做 OCR/文本抽取实现真正的附件全文检索。相关说明见 docs/configuration.rst。3. Web 访问多 Webmail 与统一管理界面Mailu 提供三套 Web 入口管理界面Admin UI由 core/admin/ 提供默认路径/admin覆盖用户、域、别名、中继、Token、管理员与公告的全量管理README 中嵌入了域管理界面的截图Webmail支持 webmails/roundcube/ 与 webmails/snappymail/ 两种实现通过WEBMAIL变量选择roundcube/snappymail/none。RESTful API默认路径/api由 core/admin/mailu/api/v1/ 实现提供域、别名、用户、中继、Token 等资源的 JSON 接口依赖API_TOKEN进行认证见 docs/configuration.rst。4. 用户自助功能别名、自动回复、自动转发、外部账户拉取、ManageSieve自动回复Auto-reply与自动转发Auto-forward在用户管理界面中配置对应 core/admin/mailu/ui/views/users.py 中 reply 与 forward 相关逻辑底层由 Dovecot Sieve 脚本执行。外部账户拉取Fetched accounts由 optional/fetchmail/ 提供FETCHMAIL_ENABLED默认 True开启后可在管理界面配置从外部邮箱拉取邮件FETCHMAIL_DELAY默认 600 秒控制轮询间隔——过短会被外部服务封禁过长则收件不及时。ManageSieve用于管理用户端过滤脚本Roundcube 默认启用managesieve插件见 docs/configuration.rst 的默认插件列表。5. 管理员功能全局管理员、公告、域委派、配额全局管理员admindomain用户拥有全局权限可通过INITIAL_ADMIN_*系列变量在首次部署时自动创建create/ifmissing/update三种模式见 docs/configuration.rst。公告Announcements管理员可在管理界面发布全局公告模板位于 core/admin/mailu/ui/templates/announcement.html。按域委派Per-domain delegationdomain_admin角色允许将某个域的管理权委托给非全局管理员用户相关访问控制逻辑在 core/admin/mailu/ui/access.py 中统一处理。配额Quotas支持全局DEFAULT_QUOTA与按域覆盖由 Dovecot 强制执行。6. 安全能力TLS、DANE、MTA-STS、Lets Encrypt、DKIM、杀毒、恶意附件拦截强制 TLS 与证书管理TLS_FLAVOR决定证书获取方式支持letsencrypt、cert自定义证书、notls。Lets Encrypt 模式下由 core/nginx/certwatcher.py 与 core/nginx/letsencrypt.py 自动申请并续期证书证书落在$ROOT/certs目录供 nginx、dovecot、postfix 共用。另有TLS_PERMISSIVE默认 true控制 25 端口 STARTTLS 的兼容性取向。DANE 与 MTA-STS由 postfix 的outbound_tls_level与 mta-sts 守护进程实现core/postfix/conf/mta-sts-daemon.yml 是其配置文件DEFER_ON_TLS_ERROR控制策略不完整时是否延迟投递。出站 DKIM私钥由管理端生成并存放于$ROOT/dkimrspamd 的 dkim_signing.conf 负责出站签名。杀毒AntivirusANTIVIRUS变量可选clamav或noneANTIVIRUS_ACTION决定检出病毒后的行为——discard默认静默丢弃或rejectSMTP 对话期拒绝。恶意附件拦截Snuffleupagus / oletoolsSCAN_MACROS默认 True启用后Mailu 使用 oletools 的 mraptor 检测 Office 文档中的恶意宏相关实现在 core/oletools/start.py。7. 反垃圾能力自动学习、灰名单、DMARC/SPF、防伪造Rspamd 内核反垃圾全部由 core/rspamd/ 承担conf 目录下包含 antivirus.conf杀毒联动、arc.conf、dmarc.conf、multimap.conf黑白名单映射等。自动学习Auto-learn基于 Bayes 分类器classifier-bayes.conf 配置训练与阈值dovecot 侧的 ham.script 与 spam.script 支持用户在客户端侧标记为垃圾/非垃圾回流训练。灰名单Greylisting由 greylist.conf 实现。DMARC 报告DMARC_RUA/DMARC_RUF定义报告接收地址DMARC_SEND_REPORTS默认 false启用后由 Rspamd 每天凌晨 2 点自动生成并发送前一天的 DMARC 聚合报告。防伪造Anti-spoofingSPF/DKIM/DMARC 联合校验 WILDCARD_SENDERS白名单机制——默认禁止用户冒用任意地址发信只有列入该列表的地址才被允许伪造发件人。8. 自由与隐私全 FOSS 组件、无追踪器README 特别强调 Freedom, all FOSS components, no tracker included。整个组件栈nginx、Dovecot、Postfix、Rspamd、Roundcube/SnappyMail、ClamAV、oletools、Redis均为开源软件DISABLE_STATISTICS变量允许用户选择退出匿名统计上报setup/flavors/compose/mailu.env。容器架构与编排方式Mailu 的一组 Docker 镜像具体指哪些容器docs/compose/docker-compose.yml 与 setup/flavors/compose/docker-compose.yml 给出了标准编排服务镜像职责主要数据卷frontmailu/nginx:$VERSION统一入口反向代理 SMTP/IMAP 端口转发$ROOT/certsredisredis:alpine会话、限流与队列缓存$ROOT/redisimapmailu/dovecot:$VERSIONIMAP/POP3、配额、全文检索$ROOT/mailsmtpmailu/postfix:$VERSIONSMTP 收发、转发、队列$ROOT/mailqueueantispammailu/rspamd:$VERSION垃圾过滤、DKIM 签名$ROOT/filter、$ROOT/dkimantivirusmailu/$ANTIVIRUS:$VERSION病毒扫描clamav 或 none$ROOT/filterwebdavmailu/$WEBDAV:$VERSIONCardDAV/CalDAVradicale 或 none$ROOT/davadminmailu/admin:$VERSION管理界面 RESTful API$ROOT/data、$ROOT/dkimwebmailmailu/$WEBMAIL:$VERSIONWeb 邮箱roundcube/snappymail$ROOT/webmailfetchmailmailu/fetchmail:$VERSION外部邮箱拉取—几个值得注意的设计细节端口集中暴露所有对外端口80/443/110/143/993/995/25/465/587全部由front容器统一暴露内网服务间通过 Docker 网络互访简化了防火墙管理。覆盖层overrides机制nginx、dovecot、postfix、rspamd 均支持只读挂载$ROOT/overrides/服务目录实现不改镜像、只加配置的定制方式。可插拔可选组件ANTIVIRUS、WEBMAIL、WEBDAV、SCAN_MACROS均为可开关变量README 中不含无关功能的理念在此落地——不需要的功能直接不部署对应容器。编排灵活性除 Docker Compose 外仓库还提供 Kubernetes 部署文档docs/kubernetes/mailu/index.rst以及为复制部署设计的目录结构 RFCdesign/mailu-directory-structure.md该 RFC 将$ROOT划分为config可复制共享、data仅本地、local仅本地与mail需分布式文件系统四类存储。部署要点版本选择、环境要求与关键配置版本选择根据 docs/setup.rst 的说明2024.06等日期版本最新稳定版推荐新部署使用1.0/1.1等旧分支不再接受补丁建议尽快迁移latestmaster 开发分支的最新构建仅建议用于测试环境切勿用于生产。硬件与环境要求镜像支持linux/amd64、linux/arm64v8、linux/armv7多架构x86_64 平台要求 CPU 支持SSE4.2指令集部分 2013 年前的 Intel Atom 不满足。内存要求docs/compose/requirements.rst启用 ClamAV 时至少3GB 内存 1GB swap不启用时1GB 内存 1GB swap。需要准备一个主域名与用于收信的 DNS 名称并完成 MX、SPF、DKIM、DMARC 记录配置。推荐在部署后先自测向外部服务发信并验证 DKIM/SPF 通过、接收外部来信、用docker compose logs -f 服务名检查日志、用开放中继检测工具确认未成为垃圾邮件源。核心配置项mailu.env配置文件由安装向导自动生成位于setup/flavors/compose/mailu.envdocs/configuration.rst 提供了完整参考。以下是最关键的几组通用配置SECRET_KEY必须改为随机生成的 16 字节值用于保护认证 Cookie 等关键用途可用pwgen 16 1生成DOMAIN主邮件域用于退信、postmaster 地址等技术性地址HOSTNAMES所有公共主机名第一个为主机名对外暴露 SMTP/IMAPSUBNETDocker 网络地址段需避免与系统内外网冲突POSTMASTERpostmaster 地址的本地部分建议设为通用值后配置别名TLS_FLAVOR证书获取方式letsencrypt/cert/notls。安全限流docs/configuration.rstAUTH_RATELIMIT_IP默认 5/小时同一 IP 子网IPv4 /24、IPv6 /48对不存在的账户的认证尝试上限用于抵御密码喷洒攻击AUTH_RATELIMIT_USER默认 50/天单账户的认证尝试上限用于抵御暴力破解同一账户同一密码的多次尝试只计一次AUTH_RATELIMIT_EXEMPTION_LENGTH默认 86400成功登录后该 IP 的豁免秒数避免 NAT 场景误伤AUTH_RATELIMIT_EXEMPTION豁免的 CIDR 列表设0.0.0.0/0, ::/0即完全关闭限流。邮件行为MESSAGE_SIZE_LIMIT单封邮件大小上限默认 50MB附件上限约为其 2/3MESSAGE_RATELIMIT默认 200/天与MESSAGE_RATELIMIT_EXEMPTION单用户出站量限制用于抑制被攻陷账户的滥发RELAYNETS免认证中继网段使用需极度谨慎配置失误会变成开放中继RELAYHOST/RELAYUSER/RELAYPASSWORD将全部出站邮件交由 smarthost 转发的配置RECIPIENT_DELIMITER默认启用localparttagdomain式地址便于按标记归类邮件FULL_TEXT_SEARCH全文检索语言列表或offCOMPRESSIONgz/bz2/zstd与COMPRESSION_LEVEL邮件落盘压缩。Web 与高级配置WEB_ADMIN/WEB_WEBMAIL/WEB_API默认/admin、/webmail、/api与WEBROOT_REDIRECT根路径重定向目标需指向已启用服务API_TOKENRESTful API 的必填认证令牌最短 3 字符通过请求头传递CREDENTIAL_ROUNDS默认 13口令哈希轮数兼顾安全与性能SESSION_COOKIE_SECURE默认 True与SESSION_TIMEOUT默认 3600、PERMANENT_SESSION_LIFETIME默认 108000会话安全策略REAL_IP_HEADER/REAL_IP_FROM反向代理场景下信任客户端真实 IP 的配置只设前者不设后者存在 IP 伪造漏洞PROXY_PROTOCOL启用 PROXY protocol 的端口列表需同时配置REAL_IP_FROM且必须清空REAL_IP_HEADERPORTS默认25,80,443,465,993,995,4190启用的端口集合25/465/993 不可禁用。数据库配置docs/configuration.rst默认使用 SQLitesqlite:////data/main.dbRoundcube 为sqlite:////data/roundcube.db对单机部署足够且更可靠可选 PostgreSQL驱动postgresql或 MariaDB/MySQL驱动mysqlmysqlconnector但官方建议保持 SQLite。首次管理员创建部署后需要管理员账户可通过环境变量自动创建docs/configuration.rstINITIAL_ADMIN_ACCOUNTme INITIAL_ADMIN_DOMAINexample.net INITIAL_ADMIN_PWpassword INITIAL_ADMIN_MODEifmissing # create默认/ ifmissing / update官方建议使用ifmissing或update保留默认的create会在系统重启时因账户已存在而报错。许可证与贡献方式Mailu 采用MIT 许可证LICENSE.mdREADME 明确说明所有组件均为自由软件且与 MIT 兼容仓库中所有特定配置文件、Dockerfile 与代码均置于 MIT 许可之下。贡献者需遵循 CONTRIBUTING.md 与 CODE_OF_CONDUCT.md 中的流程与行为规范变更记录采用 towncrier 管理见 towncrier/newsfragments/每个改动对应一个 newsfragment 文件便于生成结构化的 CHANGELOG.md。对于希望先体验再部署的读者Mailu 提供了演示服务器docs/demo.rsttest.mailu.io每日三次自动重置开放 IMAP/POP3/SMTP、Webmail、Admin UI 与 RESTful API 的完整功能但 SMTP 出站被禁用防止滥用且容器资源受限——适合功能验证不适合作为性能基准。总结从 README 这份功能宣言出发可以看到 Mailu 的设计主线用一组职责单一的开源容器拼装出一个覆盖收发、过滤、管理、Web 访问全链路的邮件服务器同时把每个可选组件都做成可开关的变量将复杂度封装在配置文件中。无论是家庭自建邮箱、小型团队邮件服务还是需要深度定制的企业场景都可以基于这套镜像集快速起步并通过overrides覆盖层与*_ADDRESS服务发现变量逐步演进到更复杂的编排环境。赞分享后端通信【免费下载链接】MailuInsular email distribution - mail server as Docker images项目地址https://gitcode.com/gh_mirrors/ma/Mailu点击查看免费下载相关推荐Mailu 完全指南以 Docker 镜像形式部署的轻量级开源邮件服务器Mailu 完全指南以 Docker 镜像形式部署的轻量级开源邮件服务器 Mailu 是一套以 Docker 镜像形式交付的完整邮件服务器解决方案定位于简后端通信Mailu邮件服务器Docker容器化邮件系统的终极指南Mailu邮件服务器Docker容器化邮件系统的终极指南 Mailu是一个基于Docker容器的开源邮件服务器解决方案它将复杂的邮件系统组件打包成易于部署和后端通信Mailu 邮件服务器设计哲学与总体架构从 Freeposte 到多容器 Docker 邮件栈Mailu 邮件服务器设计哲学与总体架构从 Freeposte 到多容器 Docker 邮件栈 Mailu 是一套以 Docker 镜像形式交付的开源邮件服务后端通信上一篇OpenMMO服务器为什么区分不出AI玩家设计哲学与实现分析下一篇React Bits完整教程5分钟掌握动画组件库终极配置创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Mailu 项目全解析：以 Docker 镜像集形态交付的一体化开源邮件服务器
后端通信【免费下载链接】MailuInsular email distribution - mail server as Docker images项目地址https://gitcode.com/gh_mirrors/ma/Mailu点击查看免费下载Mailu 是一个以一组 Docker 镜像为交付形态的轻量而全功能的邮件服务器。本文基于仓库根目录的 README 展开结合core/、docs/、setup/等目录中的源码与配置文件系统梳理 Mailu 的功能矩阵、容器架构、部署配置与安全机制帮助读者理解其设计取舍并掌握从零部署与调优的完整路径。项目定位邮件服务器即一组 Docker 镜像Mailu 的自我定位清晰而克制simple yet full-featured——简单但功能完整。它不是又一个重量级群件套件而是聚焦于邮件核心业务收发、转发、过滤、管理并且刻意不内置专有软件、不附带与邮件无关的功能。README 用两句话概括了它的哲学It is free software (both as in free beer and as in free speech), open to suggestions and external contributions. The project aims at providing people with an easily setup, easily maintained and full-featured mail server while not shipping proprietary software nor unrelated features often found in popular groupware.即自由软件免费且开源、欢迎外部贡献、追求易部署、易维护、功能完整同时拒绝大多数群件套件常见的臃肿与专有组件。这一理念直接体现在仓库结构上所有组件都位于 core/ 与 optional/ 目录下每个子目录对应一个独立容器镜像彼此通过环境变量与网络通信解耦。功能矩阵README 中列出的六大能力逐项拆解README 的 Features 部分是整份文档的技术骨架。以下结合仓库实际实现逐条展开1. 标准邮件协议服务IMAP / IMAP / SMTP / SubmissionIMAP 与 IMAP由 core/dovecot/ 提供容器内默认监听 143明文与 993TLS端口docs/compose/docker-compose.yml 中 front 容器向宿主机暴露了这些端口。Dovecot 还承担了配额管理、全文检索见后文与 managesieve 脚本支持。SMTP 与 Submission由 core/postfix/ 提供监听 25SMTP、465SMTPS、587Submission端口。MESSAGE_SIZE_LIMIT等参数直接作用于 postfix 的message_size_limit配置。客户端自动配置README 强调 auto-configuration profiles for clients。这一能力由 core/admin/mailu/internal/views/autoconfig.py 实现——Mailu 会为 Thunderbird 等客户端提供autoconfig配置档让客户端无需手工填写服务器参数即可完成 IMAP/SMTP 设置。2. 高级邮件功能别名、域别名、自定义路由、附件全文检索别名Alias与域别名Alternative/Domain Alias管理界面中分别对应 alias 与 alternative 两个资源core/admin/mailu/models.py 中的Alias、Alternative模型承载其数据结构core/admin/mailu/ui/views/aliases.py 提供增删改查视图。自定义路由Custom routing通过域级与别名级的目标地址配置可将特定地址的邮件转发到外部邮箱或本域其他地址对应模型中的destination字段。附件全文检索FULL_TEXT_SEARCH配置项默认en控制 Dovecot FTSfull-text search支持的语言列表可设为off关闭以节省性能FULL_TEXT_SEARCH_ATTACHMENTS则控制是否启用 Tika 对附件内容做 OCR/文本抽取实现真正的附件全文检索。相关说明见 docs/configuration.rst。3. Web 访问多 Webmail 与统一管理界面Mailu 提供三套 Web 入口管理界面Admin UI由 core/admin/ 提供默认路径/admin覆盖用户、域、别名、中继、Token、管理员与公告的全量管理README 中嵌入了域管理界面的截图Webmail支持 webmails/roundcube/ 与 webmails/snappymail/ 两种实现通过WEBMAIL变量选择roundcube/snappymail/none。RESTful API默认路径/api由 core/admin/mailu/api/v1/ 实现提供域、别名、用户、中继、Token 等资源的 JSON 接口依赖API_TOKEN进行认证见 docs/configuration.rst。4. 用户自助功能别名、自动回复、自动转发、外部账户拉取、ManageSieve自动回复Auto-reply与自动转发Auto-forward在用户管理界面中配置对应 core/admin/mailu/ui/views/users.py 中 reply 与 forward 相关逻辑底层由 Dovecot Sieve 脚本执行。外部账户拉取Fetched accounts由 optional/fetchmail/ 提供FETCHMAIL_ENABLED默认 True开启后可在管理界面配置从外部邮箱拉取邮件FETCHMAIL_DELAY默认 600 秒控制轮询间隔——过短会被外部服务封禁过长则收件不及时。ManageSieve用于管理用户端过滤脚本Roundcube 默认启用managesieve插件见 docs/configuration.rst 的默认插件列表。5. 管理员功能全局管理员、公告、域委派、配额全局管理员admindomain用户拥有全局权限可通过INITIAL_ADMIN_*系列变量在首次部署时自动创建create/ifmissing/update三种模式见 docs/configuration.rst。公告Announcements管理员可在管理界面发布全局公告模板位于 core/admin/mailu/ui/templates/announcement.html。按域委派Per-domain delegationdomain_admin角色允许将某个域的管理权委托给非全局管理员用户相关访问控制逻辑在 core/admin/mailu/ui/access.py 中统一处理。配额Quotas支持全局DEFAULT_QUOTA与按域覆盖由 Dovecot 强制执行。6. 安全能力TLS、DANE、MTA-STS、Lets Encrypt、DKIM、杀毒、恶意附件拦截强制 TLS 与证书管理TLS_FLAVOR决定证书获取方式支持letsencrypt、cert自定义证书、notls。Lets Encrypt 模式下由 core/nginx/certwatcher.py 与 core/nginx/letsencrypt.py 自动申请并续期证书证书落在$ROOT/certs目录供 nginx、dovecot、postfix 共用。另有TLS_PERMISSIVE默认 true控制 25 端口 STARTTLS 的兼容性取向。DANE 与 MTA-STS由 postfix 的outbound_tls_level与 mta-sts 守护进程实现core/postfix/conf/mta-sts-daemon.yml 是其配置文件DEFER_ON_TLS_ERROR控制策略不完整时是否延迟投递。出站 DKIM私钥由管理端生成并存放于$ROOT/dkimrspamd 的 dkim_signing.conf 负责出站签名。杀毒AntivirusANTIVIRUS变量可选clamav或noneANTIVIRUS_ACTION决定检出病毒后的行为——discard默认静默丢弃或rejectSMTP 对话期拒绝。恶意附件拦截Snuffleupagus / oletoolsSCAN_MACROS默认 True启用后Mailu 使用 oletools 的 mraptor 检测 Office 文档中的恶意宏相关实现在 core/oletools/start.py。7. 反垃圾能力自动学习、灰名单、DMARC/SPF、防伪造Rspamd 内核反垃圾全部由 core/rspamd/ 承担conf 目录下包含 antivirus.conf杀毒联动、arc.conf、dmarc.conf、multimap.conf黑白名单映射等。自动学习Auto-learn基于 Bayes 分类器classifier-bayes.conf 配置训练与阈值dovecot 侧的 ham.script 与 spam.script 支持用户在客户端侧标记为垃圾/非垃圾回流训练。灰名单Greylisting由 greylist.conf 实现。DMARC 报告DMARC_RUA/DMARC_RUF定义报告接收地址DMARC_SEND_REPORTS默认 false启用后由 Rspamd 每天凌晨 2 点自动生成并发送前一天的 DMARC 聚合报告。防伪造Anti-spoofingSPF/DKIM/DMARC 联合校验 WILDCARD_SENDERS白名单机制——默认禁止用户冒用任意地址发信只有列入该列表的地址才被允许伪造发件人。8. 自由与隐私全 FOSS 组件、无追踪器README 特别强调 Freedom, all FOSS components, no tracker included。整个组件栈nginx、Dovecot、Postfix、Rspamd、Roundcube/SnappyMail、ClamAV、oletools、Redis均为开源软件DISABLE_STATISTICS变量允许用户选择退出匿名统计上报setup/flavors/compose/mailu.env。容器架构与编排方式Mailu 的一组 Docker 镜像具体指哪些容器docs/compose/docker-compose.yml 与 setup/flavors/compose/docker-compose.yml 给出了标准编排服务镜像职责主要数据卷frontmailu/nginx:$VERSION统一入口反向代理 SMTP/IMAP 端口转发$ROOT/certsredisredis:alpine会话、限流与队列缓存$ROOT/redisimapmailu/dovecot:$VERSIONIMAP/POP3、配额、全文检索$ROOT/mailsmtpmailu/postfix:$VERSIONSMTP 收发、转发、队列$ROOT/mailqueueantispammailu/rspamd:$VERSION垃圾过滤、DKIM 签名$ROOT/filter、$ROOT/dkimantivirusmailu/$ANTIVIRUS:$VERSION病毒扫描clamav 或 none$ROOT/filterwebdavmailu/$WEBDAV:$VERSIONCardDAV/CalDAVradicale 或 none$ROOT/davadminmailu/admin:$VERSION管理界面 RESTful API$ROOT/data、$ROOT/dkimwebmailmailu/$WEBMAIL:$VERSIONWeb 邮箱roundcube/snappymail$ROOT/webmailfetchmailmailu/fetchmail:$VERSION外部邮箱拉取—几个值得注意的设计细节端口集中暴露所有对外端口80/443/110/143/993/995/25/465/587全部由front容器统一暴露内网服务间通过 Docker 网络互访简化了防火墙管理。覆盖层overrides机制nginx、dovecot、postfix、rspamd 均支持只读挂载$ROOT/overrides/服务目录实现不改镜像、只加配置的定制方式。可插拔可选组件ANTIVIRUS、WEBMAIL、WEBDAV、SCAN_MACROS均为可开关变量README 中不含无关功能的理念在此落地——不需要的功能直接不部署对应容器。编排灵活性除 Docker Compose 外仓库还提供 Kubernetes 部署文档docs/kubernetes/mailu/index.rst以及为复制部署设计的目录结构 RFCdesign/mailu-directory-structure.md该 RFC 将$ROOT划分为config可复制共享、data仅本地、local仅本地与mail需分布式文件系统四类存储。部署要点版本选择、环境要求与关键配置版本选择根据 docs/setup.rst 的说明2024.06等日期版本最新稳定版推荐新部署使用1.0/1.1等旧分支不再接受补丁建议尽快迁移latestmaster 开发分支的最新构建仅建议用于测试环境切勿用于生产。硬件与环境要求镜像支持linux/amd64、linux/arm64v8、linux/armv7多架构x86_64 平台要求 CPU 支持SSE4.2指令集部分 2013 年前的 Intel Atom 不满足。内存要求docs/compose/requirements.rst启用 ClamAV 时至少3GB 内存 1GB swap不启用时1GB 内存 1GB swap。需要准备一个主域名与用于收信的 DNS 名称并完成 MX、SPF、DKIM、DMARC 记录配置。推荐在部署后先自测向外部服务发信并验证 DKIM/SPF 通过、接收外部来信、用docker compose logs -f 服务名检查日志、用开放中继检测工具确认未成为垃圾邮件源。核心配置项mailu.env配置文件由安装向导自动生成位于setup/flavors/compose/mailu.envdocs/configuration.rst 提供了完整参考。以下是最关键的几组通用配置SECRET_KEY必须改为随机生成的 16 字节值用于保护认证 Cookie 等关键用途可用pwgen 16 1生成DOMAIN主邮件域用于退信、postmaster 地址等技术性地址HOSTNAMES所有公共主机名第一个为主机名对外暴露 SMTP/IMAPSUBNETDocker 网络地址段需避免与系统内外网冲突POSTMASTERpostmaster 地址的本地部分建议设为通用值后配置别名TLS_FLAVOR证书获取方式letsencrypt/cert/notls。安全限流docs/configuration.rstAUTH_RATELIMIT_IP默认 5/小时同一 IP 子网IPv4 /24、IPv6 /48对不存在的账户的认证尝试上限用于抵御密码喷洒攻击AUTH_RATELIMIT_USER默认 50/天单账户的认证尝试上限用于抵御暴力破解同一账户同一密码的多次尝试只计一次AUTH_RATELIMIT_EXEMPTION_LENGTH默认 86400成功登录后该 IP 的豁免秒数避免 NAT 场景误伤AUTH_RATELIMIT_EXEMPTION豁免的 CIDR 列表设0.0.0.0/0, ::/0即完全关闭限流。邮件行为MESSAGE_SIZE_LIMIT单封邮件大小上限默认 50MB附件上限约为其 2/3MESSAGE_RATELIMIT默认 200/天与MESSAGE_RATELIMIT_EXEMPTION单用户出站量限制用于抑制被攻陷账户的滥发RELAYNETS免认证中继网段使用需极度谨慎配置失误会变成开放中继RELAYHOST/RELAYUSER/RELAYPASSWORD将全部出站邮件交由 smarthost 转发的配置RECIPIENT_DELIMITER默认启用localparttagdomain式地址便于按标记归类邮件FULL_TEXT_SEARCH全文检索语言列表或offCOMPRESSIONgz/bz2/zstd与COMPRESSION_LEVEL邮件落盘压缩。Web 与高级配置WEB_ADMIN/WEB_WEBMAIL/WEB_API默认/admin、/webmail、/api与WEBROOT_REDIRECT根路径重定向目标需指向已启用服务API_TOKENRESTful API 的必填认证令牌最短 3 字符通过请求头传递CREDENTIAL_ROUNDS默认 13口令哈希轮数兼顾安全与性能SESSION_COOKIE_SECURE默认 True与SESSION_TIMEOUT默认 3600、PERMANENT_SESSION_LIFETIME默认 108000会话安全策略REAL_IP_HEADER/REAL_IP_FROM反向代理场景下信任客户端真实 IP 的配置只设前者不设后者存在 IP 伪造漏洞PROXY_PROTOCOL启用 PROXY protocol 的端口列表需同时配置REAL_IP_FROM且必须清空REAL_IP_HEADERPORTS默认25,80,443,465,993,995,4190启用的端口集合25/465/993 不可禁用。数据库配置docs/configuration.rst默认使用 SQLitesqlite:////data/main.dbRoundcube 为sqlite:////data/roundcube.db对单机部署足够且更可靠可选 PostgreSQL驱动postgresql或 MariaDB/MySQL驱动mysqlmysqlconnector但官方建议保持 SQLite。首次管理员创建部署后需要管理员账户可通过环境变量自动创建docs/configuration.rstINITIAL_ADMIN_ACCOUNTme INITIAL_ADMIN_DOMAINexample.net INITIAL_ADMIN_PWpassword INITIAL_ADMIN_MODEifmissing # create默认/ ifmissing / update官方建议使用ifmissing或update保留默认的create会在系统重启时因账户已存在而报错。许可证与贡献方式Mailu 采用MIT 许可证LICENSE.mdREADME 明确说明所有组件均为自由软件且与 MIT 兼容仓库中所有特定配置文件、Dockerfile 与代码均置于 MIT 许可之下。贡献者需遵循 CONTRIBUTING.md 与 CODE_OF_CONDUCT.md 中的流程与行为规范变更记录采用 towncrier 管理见 towncrier/newsfragments/每个改动对应一个 newsfragment 文件便于生成结构化的 CHANGELOG.md。对于希望先体验再部署的读者Mailu 提供了演示服务器docs/demo.rsttest.mailu.io每日三次自动重置开放 IMAP/POP3/SMTP、Webmail、Admin UI 与 RESTful API 的完整功能但 SMTP 出站被禁用防止滥用且容器资源受限——适合功能验证不适合作为性能基准。总结从 README 这份功能宣言出发可以看到 Mailu 的设计主线用一组职责单一的开源容器拼装出一个覆盖收发、过滤、管理、Web 访问全链路的邮件服务器同时把每个可选组件都做成可开关的变量将复杂度封装在配置文件中。无论是家庭自建邮箱、小型团队邮件服务还是需要深度定制的企业场景都可以基于这套镜像集快速起步并通过overrides覆盖层与*_ADDRESS服务发现变量逐步演进到更复杂的编排环境。赞分享后端通信【免费下载链接】MailuInsular email distribution - mail server as Docker images项目地址https://gitcode.com/gh_mirrors/ma/Mailu点击查看免费下载相关推荐Mailu 完全指南以 Docker 镜像形式部署的轻量级开源邮件服务器Mailu 完全指南以 Docker 镜像形式部署的轻量级开源邮件服务器 Mailu 是一套以 Docker 镜像形式交付的完整邮件服务器解决方案定位于简后端通信Mailu邮件服务器Docker容器化邮件系统的终极指南Mailu邮件服务器Docker容器化邮件系统的终极指南 Mailu是一个基于Docker容器的开源邮件服务器解决方案它将复杂的邮件系统组件打包成易于部署和后端通信Mailu 邮件服务器设计哲学与总体架构从 Freeposte 到多容器 Docker 邮件栈Mailu 邮件服务器设计哲学与总体架构从 Freeposte 到多容器 Docker 邮件栈 Mailu 是一套以 Docker 镜像形式交付的开源邮件服务后端通信上一篇OpenMMO服务器为什么区分不出AI玩家设计哲学与实现分析下一篇React Bits完整教程5分钟掌握动画组件库终极配置创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考