Mailrelay 镜像文档

镜像概述和主要用途

该镜像主要基于Debian（trixie版本）构建，已预装Postfix邮件服务器。其核心设计目标是作为Kubernetes集群内的内部邮件中继服务，必须通过挂载自定义配置的main.cf文件到/etc/postfix/main.cf路径实现功能定制。

核心功能和特性

• 基于Debian trixie系统，提供稳定的运行环境
• 内置Postfix邮件服务器，支持标准邮件中继功能
• 强制配置机制：必须通过外部挂载main.cf文件完成自定义配置
• 轻量级设计，适配Kubernetes容器化部署场景

使用场景和适用范围

适用于Kubernetes集群内部需要邮件中继服务的场景，例如：

• 集群内应用程序的邮件通知转发
• 内部服务间的邮件消息传递
• 需要自定义邮件路由规则的内部邮件系统

使用方法和配置说明

配置前置要求

使用该镜像前，必须准备好完整配置的Postfix主配置文件（main.cf），包含必要的中继规则、网络配置、域名设置等参数。

Docker运行示例

bash
docker run -d \
  --name internal-mailrelay \
  -v /host/path/to/custom/main.cf:/etc/postfix/main.cf:ro \
  [镜像名称]:[标签]

参数说明：

• -v /host/path/to/custom/main.cf:/etc/postfix/main.cf:ro：将主机上的自定义main.cf文件以只读方式挂载到容器内Postfix配置目录
• :ro 权限确保配置文件不会被容器内进程意外修改

Kubernetes部署示例

1. 创建ConfigMap（存储配置文件）

yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: postfix-config
data:
  main.cf: |
    # 此处填入完整的Postfix配置内容
    myhostname = relay.example.com
    mydomain = example.com
    myorigin = $mydomain
    inet_interfaces = all
    relay_domains = example.com
    # 其他必要配置...

2. 部署Pod

yaml
apiVersion: v1
kind: Pod
metadata:
  name: mailrelay-pod
spec:
  containers:
  - name: mailrelay
    image: [镜像名称]:[标签]
    volumeMounts:
    - name: config-volume
      mountPath: /etc/postfix/main.cf
      subPath: main.cf
  volumes:
  - name: config-volume
    configMap:
      name: postfix-config

注意事项

• 配置文件main.cf必须包含正确的网络和权限设置，确保Postfix能在容器环境中正常启动
• 容器需具备网络访问权限，以实现邮件中继功能
• 生产环境建议结合Kubernetes Deployment或StatefulSet进行部署，确保服务稳定性