wodby/opensmtpd

OpenSMTPD 容器镜像

概述

wodby/opensmtpd容器镜像是基于OpenSMTPD的轻量级邮件传输代理（MTA）容器化实现，旨在简化SMTP服务器的部署与管理。OpenSMTPD是一款遵循RFC标准、设计简洁的邮件传输软件，该镜像将其封装为容器，支持快速启动、环境隔离和灵活配置，适用于个人服务器、开发测试环境及小型企业邮件服务。

项目源码及更多细节请参考：https://github.com/wodby/opensmtpd

核心功能与特性

邮件传输能力

• 完整支持SMTP/ESMTP协议，符合RFC 5321标准
• 支持邮件发送、接收、本地投递及远程转发
• 灵活的邮件路由规则配置，支持域名映射、用户别名等

安全特性

• 可选TLS加密传输，保护邮件内容隐私
• 支持SMTP AUTH认证机制，防止未授权使用
• 兼容主流反垃圾邮件策略（需配合SPF/DKIM等DNS记录）

容器化优势

• 轻量级设计，资源占用低，适合边缘设备及小型服务器
• 即开即用，无需复杂系统级依赖配置
• 支持配置文件挂载，便于自定义邮件服务规则

使用场景

• 开发/测试环境：快速搭建本地邮件服务器，测试应用邮件发送功能
• 个人邮件服务：为个人域名提供基础邮件收发能力
• 小型企业部署：作为内部邮件中继或对外邮件网关
• 应用集成：与Web应用、监控系统等集成，处理告警通知邮件

使用方法

快速启动（docker run）

通过以下命令快速启动基础SMTP服务（默认配置可能仅支持本地测试，生产环境需自定义配置）：

bash
docker run -d \
  --name opensmtpd \
  -p 25:25 \
  -v $(pwd)/smtpd.conf:/etc/smtpd/smtpd.conf \
  wodby/opensmtpd

说明：-v $(pwd)/smtpd.conf:/etc/smtpd/smtpd.conf 用于挂载自定义配置文件，覆盖默认配置。

Docker Compose 配置示例

创建docker-compose.yml文件，集成到容器化应用架构中：

yaml
version: '3.8'

services:
  opensmtpd:
    image: wodby/opensmtpd
    container_name: opensmtpd
    ports:
      - "25:25"  # SMTP标准端口
      - "587:587" # 提交端口（可选，用于客户端提交）
    volumes:
      - ./smtpd.conf:/etc/smtpd/smtpd.conf:ro  # 只读挂载配置文件
      - ./certs:/etc/ssl/smtpd:ro              # 挂载TLS证书（如需启用加密）
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai  # 设置时区

配置说明

OpenSMTPD的核心配置通过smtpd.conf文件定义，容器默认配置可能仅适用于基础场景，生产环境需根据需求自定义。典型配置项包括：

• 监听地址：指定服务器监听的IP和端口（如listen on all port 25）
• 邮件路由：定义邮件接收与转发规则（如action "local" mbox alias <aliases>）
• TLS配置：启用加密传输（如tls on key "/etc/ssl/smtpd/server.key" cert "/etc/ssl/smtpd/server.crt"）
• 访问控制：限制客户端IP或配置认证（如accept from any for domain "example.com" deliver to mbox）

配置文件示例（基础本地投递）：

conf
# 监听所有网络接口的25端口
listen on all port 25

# 定义本地投递动作（存储到mbox格式邮件文件）
action "local" mbox alias <aliases>

# 接受本地用户邮件并投递
accept for local action "local"
# 接受转发到本地域名的邮件并投递
accept for domain "example.com" action "local"

详细配置语法请参考OpenSMTPD官方文档及镜像GitHub仓库说明。

数据持久化

为避免容器重启后配置丢失，建议通过-v参数挂载以下目录：

• /etc/smtpd/：存放配置文件（如smtpd.conf、aliases）
• /var/spool/mail/：存放本地用户邮件（mbox格式）
• /etc/ssl/smtpd/：存放TLS证书和密钥（如需启用加密）

注意事项

• 端口占用：确保宿主机25端口（SMTP）未被其他服务占用
• 安全配置：生产环境必须启用TLS并配置强认证，避免成为垃圾邮件中继
• DNS记录：对外提供服务时，需配置正确的MX、SPF、DKIM记录，提高邮件送达率
• 日志查看：通过docker logs opensmtpd查看服务运行日志，排查邮件传输问题

核心功能详情