aspettl/docker-mailserver-configreload

docker-mailserver集成工具

镜像概述

本镜像用于集成mailadmin项目（GitHub地址：https://github.com/aspettl/mailadmin%EF%BC%89%E4%B8%8Edocker-mailserver%EF%BC%88https://github.com/docker-mailserver/docker-mailserver%EF%BC%89%EF%BC%8C%E6%8F%90%E4%BE%9B%E7%AE%80%E5%8D%95%E7%9A%84%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E7%94%9F%E6%88%90%E4%B8%8E%E6%9B%B4%E6%96%B0%E8%83%BD%E5%8A%9B%E3%80%82%E5%85%B6%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E6%98%AF%E5%AF%BC%E5%87%BAmailadmin%E6%95%B0%E6%8D%AE%EF%BC%8C%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BAdocker-mailserver%E6%89%80%E9%9C%80%E7%9A%84%60postfix-accounts.cf%60%E5%92%8C%60postfix-virtual.cf%60%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%EF%BC%8C%E5%B9%B6%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87webhook%E8%A7%A6%E5%8F%91%E9%85%8D%E7%BD%AE%E6%9B%B4%E6%96%B0%EF%BC%8C%E7%A1%AE%E4%BF%9Ddocker-mailserver%E9%85%8D%E7%BD%AE%E5%AE%9E%E6%97%B6%E5%90%8C%E6%AD%A5%E3%80%82

核心功能与特性

• 自动配置生成：启动时自动（重新）生成docker-mailserver所需的核心配置文件。
• webhook触发更新：通过检测webserver日志中特定webhook token的存在，触发配置文件重新生成。
• 无缝集成：docker-mailserver会在配置文件变化时自动重载，无需手动干预。
• 环境适应性：需与docker-mailserver运行在同一主机，并挂载webserver日志文件。

使用场景

适用于已部署mailadmin和docker-mailserver的环境，需要自动同步mailadmin数据到docker-mailserver配置的场景，尤其适合需要定期或按需更新邮件账户、虚拟别名配置的用户。

配置与使用说明

运行环境要求

1. 部署位置：容器需与docker-mailserver运行在同一主机。
2. 日志挂载：需将运行中的webserver日志文件挂载到容器内，以便检测webhook token。

docker-mailserver配置要求

• postfix-aliases.cf文件中必须包含行：devnull: /dev/null。该文件仅在不存在时自动生成，若已存在需手动确保包含此行。

工作流程

1. 启动时生成：容器启动时，自动（重新）生成postfix-accounts.cf和postfix-virtual.cf配置文件。
2. webhook触发更新：容器持续监控挂载的webserver日志文件，当检测到预设的webhook token时，重新生成配置文件。
3. 自动重载：docker-mailserver会监控配置文件变化，文件更新后自动重载配置。

建议配置

• 定时任务：推荐设置定时任务（如每小时）定期触发webhook，避免忘记在mailadmin中手动点击“Reload configuration”导致配置不同步。