loganmarchione/docker-postfixrelay

docker-postfixrelay

https://github.com/loganmarchione/docker-postfixrelay/actions/workflows/main.yml/badge.svg](https://github.com/loganmarchione/docker-postfixrelay/actions/workflows/main.yml) https://img.shields.io/docker/image-size/loganmarchione/docker-postfixrelay](https://hub.docker.com/r/loganmarchione/docker-postfixrelay)

在Docker中运行Postfix（作为中继）

• 源代码：https://github.com/loganmarchione/docker-postfixrelay
• Docker容器：https://hub.docker.com/r/loganmarchione/docker-postfixrelay
• 基础镜像：https://hub.docker.com/_/alpine/
• 初始化系统：https://github.com/Yelp/dumb-init
• 应用：http://www.postfix.org/
• 架构：linux/amd64,linux/arm64,linux/arm/v7

概述与主要用途

• 此镜像在Docker中运行Postfix作为邮件中继。
• 大多数家庭ISP会阻止25端口，因此出站邮件必须通过外部SMTP服务器（如Gmail）中继。
• 此容器作为需要发送邮件的设备的集中点。
• ⚠️ Postfix作为开放中继运行。因此，此镜像不应在互联网上运行，仅在可信的内部网络中使用！⚠️

        内部（LAN）网络                                        公共互联网

------------------
|                |
| 发送邮件警报的设备 |                            |   |
|                | -------------              |   |
|                |             |              |   |
------------------             |              |   |
                               |              |   |
------------------             v              | 防 |
|                |       ------------------   | 火 |    -----------------------------       -------------------
| 发送邮件警报的设备 |       |                |   | 墙 |    |                           |       |                 |
|                | ----> | 本容器          | --|    |--> | SMTP服务器（如Gmail）      | ----> | 收件人邮箱      |
|                |       |                |   |    |    |                           |       |                 |
------------------       ------------------   |    |    -----------------------------       -------------------
                               ^              |    |
------------------             |              |   |
|                |             |              |   |
| 发送邮件警报的设备 |             |              |   |
|                | -------------              |   |
|                |
------------------

核心功能与特性

• 集中邮件中继：作为内部网络中所有设备发送邮件的统一入口。
• 外部SMTP转发：通过外部SMTP服务器（如Gmail、AWS SES）转发邮件，绕过ISP对25端口的封锁。
• 加密支持：仅支持加密的外部SMTP连接，确保邮件传输安全。
• 多架构支持：兼容linux/amd64、linux/arm64、linux/arm/v7架构。
• 灵活配置：通过环境变量自定义时区、网络范围、邮件大小限制等参数。

使用场景与适用范围

• 家庭网络：家庭内部设备（如NAS、路由器、监控系统）需要发送警报邮件时。
• 小型办公网络：内部多台设备需集中发送通知邮件，且受ISP端口限制。
• 开发/测试环境：需要模拟邮件发送流程的内部环境。

使用要求

• 您必须已在外部SMTP服务器上拥有账户（如Gmail、AWS SES等）。
• 您的外部SMTP服务器必须使用加密（即不允许明文传输）。

使用方法与配置说明

Docker镜像信息

Docker镜像标签

• latest：最新版本
• X.X.X：https://semver.org/%EF%BC%88%E5%A6%82%E9%9C%80%E5%9B%BA%E5%AE%9A%E7%89%B9%E5%AE%9A%E7%89%88%E6%9C%AC%E6%97%B6%E4%BD%BF%E7%94%A8%EF%BC%89

环境变量

端口

卷

示例用法

以下是docker-compose.yml文件示例：

yaml
version: '3'
services:
  postfixrelay:
    container_name: docker-postfixrelay
    restart: unless-stopped
    environment:
      - TZ=America/New_York
      - RELAY_HOST=smtp.gmail.com
      - RELAY_PORT=587
      # 如果使用secrets，请注释掉下面两行
      - RELAY_USER=your_email_here@gmail.com
      - RELAY_PASS=your_password_here
      # 如果使用secrets，请取消下面两行的注释
      # - RELAY_USER_FILE=/run/secrets/RELAY_USER_FILE
      # - RELAY_PASS_FILE=/run/secrets/RELAY_PASS_FILE
      - RELAY_SUBMISSIONS=true
      - TEST_EMAIL=test_email@domain.com
      - TEST_EMAIL_SUBJECT=阅后即焚
      - MYORIGIN=domain.com
      - FROMADDRESS=my_email@domain.com
      - MYNETWORKS=1.2.3.4/24
      - MSG_SIZE=30720000
      - LOG_DISABLE=true
    # 如果使用secrets，请取消下面的注释
    # secrets:
    #   - RELAY_USER_FILE
    #   - RELAY_PASS_FILE
    networks:
      - postfixrelay
    ports:
      - '25:25'
    volumes:
      - 'postfixrelay_data:/var/spool/postfix'
    image: docker.xuanyuan.run/loganmarchione/docker-postfixrelay:latest

networks:
  postfixrelay:

volumes:
  postfixrelay_data:
    driver: local

# 如果使用secrets，请取消下面的注释
# secrets:
#    RELAY_USER_FILE:
#      file: ./relay_user.txt
#    RELAY_PASS_FILE:
#      file: ./relay_pass.txt

仅调试使用

以下是本地运行示例（用于编辑/测试/调试）：

bash
# 构建Dockerfile
docker compose -f docker-compose-dev.yml up -d

# 查看日志
docker compose -f docker-compose-dev.yml logs -f

# 完成后销毁
docker compose -f docker-compose-dev.yml down