后端通信云原生【免费下载链接】docker-mailserverProduction-ready fullstack but simple mail server (SMTP, IMAP, LDAP, Antispam, Antivirus, etc.) running inside a container.项目地址https://gitcode.com/gh_mirrors/do/docker-mailserver点击查看免费下载导读本文是 docker-mailserverDMS容器邮件服务器可选配置Advanced | Optional Configuration的实战指南核心讲解两类主题一是邮件数据、运行状态、日志与配置四大持久化卷Volumes的挂载路径规范与底层实现原理二是挂载到 Config 卷/tmp/docker-mailserver/中的全部可选配置文件与目录——从 Sieve 脚本、Postfix/Dovecot 覆盖配置、账户别名文件到 LDAP 映射、Fail2Ban、SpamAssassin 与user-patches.sh等。读完本文你将能根据自己的部署场景精确选择需要持久化的卷并熟练通过 Config 卷中的各文件对邮件服务器做细粒度定制。为什么需要关注持久化卷与可选配置docker-mailserver 将所有邮件服务Postfix、Dovecot、Amavis、ClamAV、Rspamd 等打包进单个容器。容器默认是无状态的一旦容器被删除或重建容器层内的一切数据都会随之丢失。因此 DMS 在镜像内部设计了若干数据锚点目录并通过 compose.yaml 等编排文件将它们以卷Volume形式暴露给宿主机持久化。同时容器化封装把各服务的配置文件隐藏在镜像内部DMS 又约定了一个统一的配置入口目录Config 卷让使用者无需进入容器就能按约定文件名放置覆盖配置实现配置即文件。官方文档约定为了便于分组管理文档与示例配置中本地路径统一使用公共前缀docker-data/dms/。推荐优先使用 bind mount 卷即把宿主机目录直接挂载进容器因为这样便于在本地文件系统直接查看和编辑文件。四大核心卷总览卷作用域宿主机本地路径约定容器内路径用途Configdocker-data/dms/config//tmp/docker-mailserver/Postfix、Dovecot 等大部分配置文件Mail Storagedocker-data/dms/mail-data//var/mail/邮件投递到邮箱的存储位置Statedocker-data/dms/mail-state//var/mail-state/各服务运行时状态数据Logsdocker-data/dms/mail-logs//var/log/mail/全套日志文件仓库根目录的 compose.yaml 中给出了标准的挂载写法volumes: - ./docker-data/dms/mail-data/:/var/mail/ - ./docker-data/dms/mail-state/:/var/mail-state/ - ./docker-data/dms/mail-logs/:/var/log/mail/ - ./docker-data/dms/config/:/tmp/docker-mailserver/ - /etc/localtime:/etc/localtime:ro下文按四个卷逐一展开。其中Config 卷是可选配置的核心会花最多篇幅讲解其内部每一个目录与文件的作用。Mail Storage 邮件存储卷宿主机路径docker-data/dms/mail-data/容器内路径/var/mail/这是邮件实际投递到用户邮箱的位置即 Dovecot 的邮箱数据目录。邮箱容量、邮件数量都体现在这里通常也是四个卷中体积增长最快的一个。持久化该卷是邮件服务的基本前提——不挂载它容器重建后所有历史邮件都会丢失。State 运行状态卷宿主机路径docker-data/dms/mail-state/容器内路径/var/mail-state/该卷保存运行时状态数据。其中既有可随时重建的缓存类数据也包含一旦发生故障崩溃、断电时值得保留的关键数据例如Postfix 队列如等待投递的邮件Fail2Ban 封禁记录ClamAV 病毒库签名更新Rspamd 的 Redis 存储。状态整合的底层实现正常情况下各服务把状态散落在容器内各自的原生路径如/var/lib/redis、/var/spool/postfix要逐一挂载非常繁琐。DMS 的策略是当/var/mail-state/卷存在时把各服务的状态目录统一搬移并整合进该卷再用符号链接把原路径指回新位置。该逻辑在 target/scripts/startup/setup.d/mail_state.sh 的_setup_save_states()中实现核心步骤如下如果/var/mail-state不存在未挂载卷直接跳过整合维护一个SERVICEDIRS数组始终启用的项包括lib/logrotate、lib/postfix、spool/postfix按功能开关ENABLE_*环境变量条件追加各服务目录源码明确注释Notably avoids copying over 200MB for the ClamAV database——即只为已启用的服务做状态整合避免为未启用的服务白白拷贝大体积数据对每个服务目录若卷中已有同名目标则直接删除容器内原目录并建符号链接若是空卷/新启用功能则把容器内原目录mv到卷中再建立符号链接例如/var/lib/redis→/var/mail-state/lib-redis/单个服务文件如启用 SRS 时的/etc/postsrsd.secret同样被搬移并链接到/var/mail-state/下。权限与属主修正由于跨容器重建时镜像内用户 UID/GID 可能因软件包安装顺序变化而改变或宿主机侧迁移脚本改动了属主mail_state.sh还提供了_setup_adjust_state_permissions()L95-L137在启动时做修正为/var/mail-state补上x执行位保证以非 root 用户运行的服务进程能进入各自状态目录按服务逐一chown到正确属主如amavis:amavis、clamav:clamav、_rspamd:_rspamd、redis:redis、debian-spamd:debian-spamd等Postfix 队列因混合属主关系特殊处理spool-postfix下的maildrop、public需要postdrop组与 730/710 权限位搬移目录时会同步应用 SELinux 安全上下文chcon -R --reference失败静默忽略避免访问受限。受支持的整合服务清单与源码中的条件分支一一对应Postfix、Dovecot、Fail2Ban、Amavis、PostGrey、ClamAV、SpamAssassin、Rspamd 与 Redis、Fetchmail、Getmail、LogRotate、PostSRSd、MTA-STS。排障提示官方文档特别提醒当怀疑状态数据损坏例如某次故障事件导致时排障期间可以临时不挂载 State 卷或挂载一个空白卷用干净的状态启动容器以验证问题是否出在该卷存储的数据上。这是区分状态数据损坏与配置错误的高效手段。Logs 日志卷宿主机路径docker-data/dms/mail-logs/容器内路径/var/log/mail/该卷持久化全套日志文件便于排障时长期留存与检索。相关初始化逻辑位于 setup-stack.sh 的__log_fixes()确保目录存在、将属主设为syslog:root、目录权限 755、文件权限 640若启用 ClamAV 还会预创建clamav.log、freshclam.log并设置属主clamav:adm。若不需要长期保留日志此卷可以省略。Config 配置入口目录宿主机路径docker-data/dms/config/容器内路径/tmp/docker-mailserver/这是 DMS 的配置中枢Postfix、Dovecot 等服务的绝大多数配置都持久化于此。镜像启动时会扫描该目录按约定文件名加载或覆盖配置。下面是该目录中所有可选目录与文件的完整清单均由setupCLI 或内部脚本自动生成/更新属于可选配置。目录目录作用sieve-filter/Sieve 过滤脚本目录详见 Mail Sievesieve-pipe/Sieve 管道脚本目录详见 Mail Sieveopendkim/DKIM 密钥目录可通过setup.sh config dkim自动配置详见 DKIM 指南ssl/当SSL_TYPE设为self-signed或custom时的证书目录详见 SSL 文档rspamd/使用 Rspamd 时自定义设置的覆盖目录详见 Rspamd 自定义设置文件清单与机制详解Sieve 相关{user_email_address}.dovecot.sieve用户专属 Sieve 过滤脚本如userexample.com.dovecot.sievebefore.dovecot.sieve全局 Sieve 脚本先于${login}.dovecot.sieve执行after.dovecot.sieve全局 Sieve 脚本后于${login}.dovecot.sieve执行。三者共同构成 DMS 的 Sieve 三层过滤链详见 Mail Sieve。测试用例目录 test/config/dovecot-sieve/ 展示了before.dovecot.sieve、user2otherdomain.tld.dovecot.sieve等真实示例文件的放置方式。Postfix 覆盖配置postfix-main.cf文件中的每一行都会被追加到 Postfix 主配置main.cf。其加载逻辑见 setup.d/postfix.sh先cat追加到/etc/postfix/main.cf再通过postconf -n将结果规范化输出后回写从而过滤掉注释与默认值同时避免直接写main.cf引发的读写冲突。注意该文件应在postfix-master.cf之后处理因为自定义参数需要先在main.cf/master.cf中存在引用否则会被postconf丢弃详见 Override Postfix Defaultspostfix-master.cf与上者处理方式完全不同——每一行会通过postconf -P解析并非整文件追加且只有以[0-9a-z]开头的行才会被采纳见 setup.d/postfix.sh。适合调整 master 进程的-o参数等。账户与别名postfix-accounts.cf用户账户文件通过setup.sh email add等命令维护详见 setup.sh 文档postfix-send-access.cf被禁止发送的用户列表通过setup.sh email restrict维护postfix-receive-access.cf被禁止接收的用户列表通过setup.sh email restrict维护。二者在 setup.d/postfix.sh 的_setup_postfix_late()中通过check_sender_access/check_recipient_access前置插入到对应限制链prepend 保证优先级高于后续策略postfix-virtual.cf别名Alias配置文件通过setup.sh alias维护。中继Relaypostfix-sasl-password.cf被中继域及其用户名:密码清单通过setup.sh relay add-auth 域 用户名 [密码]维护详见 Relay-Hosts 高级配置postfix-relaymap.cf按域指定的中继与排除规则通过setup.sh relay add-domain与setup.sh relay exclude-domain维护同上链接。正则别名postfix-regexp.cf正则表达式别名文件。加载逻辑见 helpers/aliases.sh启动时拷贝为/etc/postfix/regexp并追加pcre:/etc/postfix/regexp到virtual_alias_maps详见 正则别名配置。配置变更热检测也会监听该文件见 check-for-changes.sh。LDAP 映射使用 LDAP 账户供给时ldap-users.cf虚拟用户映射对应 Postfixvirtual_mailbox_mapsldap-groups.cf虚拟别名映射对应virtual_alias_maps组ldap-aliases.cf虚拟别名映射对应virtual_alias_maps别名ldap-domains.cf虚拟域映射对应virtual_mailbox_domains。加载机制见 setup.d/ldap.sh启动时把这四个文件从 Config 卷拷贝到/etc/postfix/下随后 L189-L204 依据文件是否存在分别执行postconfpostconf virtual_mailbox_maps ldap:/etc/postfix/ldap-users.cf postconf virtual_mailbox_domains /etc/postfix/vhost, ldap:/etc/postfix/ldap-domains.cf postconf virtual_alias_maps ldap:/etc/postfix/ldap-aliases.cf, ldap:/etc/postfix/ldap-groups.cf仓库测试夹具 test/config/ldap/overrides/ 中提供了ldap-users.cf、ldap-groups.cf、ldap-aliases.cf的参考内容可对照学习字段格式更多背景见 LDAP 供给文档。反垃圾邮件whitelist_clients.localPostgrey 白名单每行一个主机或域命中者不会被 Postgrey 检查。实现见 security/misc.sh拷贝为/etc/postgrey/whitelist_clients.localspamassassin-rules.cfSpamAssassin 自定义反垃圾规则同样由 security/misc.sh 拷贝到/etc/spamassassin/详见 FAQ - 自定义 SpamAssassin 规则。Fail2Ban 与 Amavisfail2ban-fail2ban.cffail2ban.cf的附加配置项详见 Fail2Ban 文档fail2ban-jail.cfFail2Ban jail 行为的附加配置项同上仓库示例见 config-examples/fail2ban-jail.cfamavis.cf整体替换/etc/amavis/conf.d/50-user文件。Dovecotdovecot.cf替换/etc/dovecot/local.conf详见 Override Dovecot Defaults仓库示例见 config-examples/dovecot.cfdovecot-quotas.cf按邮箱设置的自定义配额列表详见 账户配额示例见 config-examples/dovecot-quotas.cf。自定义脚本user-patches.sh该脚本会在所有配置文件设置完成后、postfix/amavis 等守护进程启动前执行是最灵活的最后调整钩子。执行逻辑位于 setup-stack.sh 的_setup_run_user_patches()若文件存在则以bash执行否则静默跳过。官方示例 config-examples/user-patches.sh 注释提示若修改了 supervisord 相关配置需在其后运行supervisorctl update或supervisorctl reload生效详见 FAQ - user-patches.sh。Rspamdrspamd/custom-commands.conf以简单命令行的方式便捷调整 Rspamd 模块参数详见 Rspamd 自定义文件测试参考见 test/config/rspamd_full/rspamd/custom-commands.conf。配置变更热检测Config 卷内的配置不仅在容器启动时生效DMS 还内置了变更检测机制check-for-changes.sh会周期监听 Config 卷中的关键文件如postfix-regexp.cf、各类账户/别名文件检测到变更后触发对应服务的局部重载无需重建容器启动阶段的变更快照准备见 setup-stack.sh 的_prepare_for_change_detection。因此把可写配置统一放入 Config 卷既能持久化也能享受热更新。总结如何选择挂载哪些卷必挂Mail Storage/var/mail/与 Config/tmp/docker-mailserver/——前者保住邮件数据后者承载全部自定义配置强烈建议State/var/mail-state/——避免队列、封禁记录、病毒库等状态在容器重建后丢失同时减少各服务状态目录分散挂载的运维负担排障时可临时摘除按需Logs/var/log/mail/——需要长期留存日志或集中排障时挂载。按官方约定四卷统一放在宿主机docker-data/dms/前缀下config、mail-data、mail-state、mail-logs配合 compose.yaml 即可搭建出数据与配置全部落盘、容器可随时重建的生产级邮件服务。赞分享后端通信云原生【免费下载链接】docker-mailserverProduction-ready fullstack but simple mail server (SMTP, IMAP, LDAP, Antispam, Antivirus, etc.) running inside a container.项目地址https://gitcode.com/gh_mirrors/do/docker-mailserver点击查看免费下载相关推荐Docker数据持久化终极指南Volume挂载与Bind Mount详解Docker数据持久化终极指南Volume挂载与Bind Mount详解 Docker数据持久化是容器化应用开发中的核心挑战直接影响数据安全与应用可靠性。本示例工程CubeSandbox Python SDK 持久化卷Volume实战指南创建、挂载、共享与销毁CubeSandbox Python SDK 持久化卷Volume实战指南创建、挂载、共享与销毁 本篇指南基于 CubeSandbox Python SDAgent 沙箱虚拟化云原生人工智能后端容器运行时终极指南Docker Minecraft Server数据持久化策略——从Volume挂载到自动备份终极指南Docker Minecraft Server数据持久化策略——从Volume挂载到自动备份 Docker Minecraft Server是一款强大游戏开发后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考