appfim/postfix_relay

镜像概述与主要用途

本镜像为基于 https://github.com/panubo/docker-postfix 的分支版本，是一个功能增强的Postfix中继服务Docker镜像。其核心用途是作为邮件中继节点，支持在中继层灵活管理邮件地址路由，特别适用于需要集中控制地址重写规则的场景。

核心功能与特性

1. 每日构建更新：镜像每日自动构建，确保同步并获取最新上游基础镜像及安全补丁。
2. virtual_alias_maps参数化：支持通过参数配置Postfix的 virtual_alias_maps，实现邮件地址的别名映射管理。
3. 正则条件重写：允许添加base64编码的正则表达式条件，用于精准匹配并重写邮件地址。
4. 灵活路由控制：可在中继层定义地址路由规则，如将非特定地址统一路由至内部catch-all地址，同时保留特定地址的正常转发。

使用场景与适用范围

• QA/测试环境：在测试或QA系统中，可通过配置将测试邮件路由至内部catch-all地址，避免测试邮件发送至外部用户，同时允许特定测试地址（如 test@example.com）正常转发。
• 企业邮件中继：作为企业内部邮件中继节点，集中管理多系统间的地址映射，简化跨系统邮件流转配置。
• 第三方服务集成：与第三方应用集成时，通过地址重写规则统一邮件发送源标识或路由至指定处理系统。

使用方法与配置说明

配置参数参考

详细配置参数（如环境变量、配置文件格式等）请参见项目文档：https://github.com/mastamark/docker-postfix/blob/virtual_alias_maps/README.md

基本部署流程

1. 拉取镜像：从镜像仓库拉取最新版本（具体命令需根据实际仓库地址调整）：

   bash
   docker pull [镜像仓库地址]/postfix-relay:latest  
   

2. 配置地址规则：根据需求配置 virtual_alias_maps 及base64编码的正则条件（具体配置方式参考上述文档）。
3. 启动容器：通过 docker run 或 docker-compose 启动容器，映射必要端口（如SMTP端口25）及挂载配置文件卷：

   bash
   docker run -d -p 25:25 \  
     -e VIRTUAL_ALIAS_MAPS=[配置值] \  
     -e REGEX_CONDITIONS_BASE64=[base64编码的正则规则] \  
     [镜像仓库地址]/postfix-relay:latest  
   

典型应用示例

在QA系统中，需将所有非 `^specific-qa@example.com## 镜像概述与主要用途
本镜像为基于 https://github.com/panubo/docker-postfix 的分支版本，是一个功能增强的Postfix中继服务Docker镜像。其核心用途是作为邮件中继节点，支持在中继层灵活管理邮件地址路由，特别适用于需要集中控制地址重写规则的场景。

核心功能与特性

1. 每日构建更新：镜像每日自动构建，确保同步并获取最新上游基础镜像及安全补丁。
2. virtual_alias_maps参数化：支持通过参数配置Postfix的 virtual_alias_maps，实现邮件地址的别名映射管理。
3. 正则条件重写：允许添加base64编码的正则表达式条件，用于精准匹配并重写邮件地址。
4. 灵活路由控制：可在中继层定义地址路由规则，如将非特定地址统一路由至内部catch-all地址，同时保留特定地址的正常转发。

使用场景与适用范围

• QA/测试环境：在测试或QA系统中，可通过配置将测试邮件路由至内部catch-all地址，避免测试邮件发送至外部用户，同时允许特定测试地址（如 test@example.com）正常转发。
• 企业邮件中继：作为企业内部邮件中继节点，集中管理多系统间的地址映射，简化跨系统邮件流转配置。
• 第三方服务集成：与第三方应用集成时，通过地址重写规则统一邮件发送源标识或路由至指定处理系统。

使用方法与配置说明

配置参数参考

详细配置参数（如环境变量、配置文件格式等）请参见项目文档：https://github.com/mastamark/docker-postfix/blob/virtual_alias_maps/README.md

基本部署流程

1. 拉取镜像：从镜像仓库拉取最新版本（具体命令需根据实际仓库地址调整）：

   bash
   docker pull [镜像仓库地址]/postfix-relay:latest  
   

2. 配置地址规则：根据需求配置 virtual_alias_maps 及base64编码的正则条件（具体配置方式参考上述文档）。
3. 启动容器：通过 docker run 或 docker-compose 启动容器，映射必要端口（如SMTP端口25）及挂载配置文件卷：

   bash
   docker run -d -p 25:25 \  
     -e VIRTUAL_ALIAS_MAPS=[配置值] \  
     -e REGEX_CONDITIONS_BASE64=[base64编码的正则规则] \  
     [镜像仓库地址]/postfix-relay:latest  
   

典型应用示例

在QA系统中，需将所有非 的邮件地址重写为 catch-all@internal.qa，可通过以下步骤实现：

1. 编写正则规则：/^(.+)$/ catch-all@internal.qa（匹配所有地址并转发至catch-all）。
2. 对规则进行base64编码（具体编码工具可使用 echo -n "/^(.+)$/ catch-all@internal.qa" | base64）。
3. 将编码结果通过环境变量 REGEX_CONDITIONS_BASE64 传入容器，同时配置 VIRTUAL_ALIAS_MAPS 排除特定地址规则。

通过上述配置，镜像将在中继层自动应用地址重写逻辑，实现QA环境的邮件路由控制。