tozd/nginx-mailer

tozd/nginx-mailer

https://gitlab.com/tozd/docker/nginx-mailer

可用镜像地址：

• https://hub.docker.com/r/tozd/nginx-mailer
• https://gitlab.com/tozd/docker/nginx-mailer/container_registry

镜像继承

https://gitlab.com/tozd/docker/base ← https://gitlab.com/tozd/docker/dinit ← https://gitlab.com/tozd/docker/nginx ← tozd/nginx-mailer

另请参见 https://gitlab.com/tozd/docker/mailer%E3%80%82

标签

• ubuntu-trusty: nullmailer 1.11
• ubuntu-xenial: nullmailer 1.13
• ubuntu-bionic: nullmailer 2.1
• ubuntu-focal: nullmailer 2.2
• ubuntu-jammy: nullmailer 2.2
• ubuntu-noble: nullmailer 2.2

卷

• /var/log/nullmailer: 当 LOG_TO_STDOUT 未设置为 1 时的日志文件存储路径。
• /var/spool/nullmailer: 工作文件（如邮件队列）存储路径。需持久化此卷以避免状态丢失。

环境变量

• ADMINADDR: 若设置，容器内系统用户的所有邮件将发送至此地址。
• REMOTES: 容器用于发送邮件的邮件中继服务器配置。
• LOG_TO_STDOUT: 若设置为 1，日志将输出到标准输出（可通过 docker logs 查看），而非日志卷。

描述

该镜像扩展自 https://gitlab.com/tozd/docker/nginx 镜像，集成了 nullmailer 以实现容器内简单邮件发送功能。

当 LOG_TO_STDOUT 设置为 1 时，Docker 镜像日志将输出到标准输出（stdout）和标准错误（stderr），其中所有标准输出内容为 JSON 格式。

此镜像主要用作其他需要发送邮件的镜像的基础镜像。它并不直接向互联网投递邮件，而是将邮件中继到通过 REMOTES 配置的邮件服务器。扩展此镜像的程序无需关注这些细节，只需使用本地 sendmail 程序即可。

若需向互联网发送邮件，建议使用 https://gitlab.com/tozd/docker/postfix Docker 镜像。也可将 REMOTES 配置为发送所有邮件至 tozd/postfix 容器。

使用示例

基本运行命令

bash
docker run -d \
  --name nginx-mailer \
  -e REMOTES="smtp.example.com smtp --port=587 --user=your-email@example.com --pass=your-password" \
  -e LOG_TO_STDOUT=1 \
  -v /local/spool:/var/spool/nullmailer \
  tozd/nginx-mailer:ubuntu-jammy

持久化邮件队列

为避免重启容器后丢失邮件队列，需持久化 /var/spool/nullmailer 卷：

bash
docker run -d \
  --name nginx-mailer \
  -e REMOTES="mail.example.com" \
  -v /path/to/local/spool:/var/spool/nullmailer \
  tozd/nginx-mailer:ubuntu-focal

GitHub 镜像

项目提供 https://github.com/tozd/docker-nginx-mailer%EF%BC%8C%E5%A6%82%E9%9C%80%E5%9C%A8 GitHub 上分叉项目可使用此镜像。