digrouz/fetchmail

docker-fetchmail 镜像文档

镜像概述

docker-fetchmail是一个基于Alpine Linux的Docker镜像，集成了fetchmail、procmail和msmtp三个邮件相关工具。该镜像旨在提供容器化的邮件处理能力，支持从邮件服务器获取邮件、对邮件进行过滤处理以及通过SMTP协议发送邮件。

核心功能与特性

• 集成关键工具：包含fetchmail（邮件获取）、procmail（邮件过滤/处理）和msmtp（邮件发送）
• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 灵活配置：支持通过外部配置文件自定义邮件服务器连接、处理规则和发送参数

使用场景

• 容器化邮件客户端，用于自动化获取和处理邮件
• 邮件转发服务，将获取的邮件经过规则处理后转发至指定地址
• 邮件过滤系统，对接收邮件进行分类、筛选或自动响应
• 轻量级邮件网关，连接不同邮件服务实现邮件流转

使用方法

前提条件

需准备以下配置文件：

• fetchmailrc：fetchmail配置文件，定义邮件获取规则
• procmailrc：procmail配置文件，定义邮件处理规则
• msmtprc：msmtp配置文件，定义邮件发送参数

基本运行命令

bash
docker run -d \
  -v /本地路径/fetchmailrc:/root/.fetchmailrc \
  -v /本地路径/procmailrc:/root/.procmailrc \
  -v /本地路径/msmtprc:/root/.msmtprc \
  --name fetchmail-container \
  docker-fetchmail

docker-compose配置示例

yaml
version: '3'
services:
  fetchmail:
    image: docker-fetchmail
    volumes:
      - ./config/fetchmailrc:/root/.fetchmailrc
      - ./config/procmailrc:/root/.procmailrc
      - ./config/msmtprc:/root/.msmtprc
    restart: unless-stopped

配置说明

fetchmailrc配置

用于定义从邮件服务器获取邮件的规则，示例：

# 从POP3服务器获取邮件
poll pop.example.com protocol pop3
  user "user@example.com" password "your_password"
  is root here
  fetchall
  no keep

主要参数说明：

• poll：指定邮件服务器地址
• protocol：邮件协议（pop3/imap等）
• user/password：***账号和密码
• is [user] here：指定本地接收用户
• fetchall：获取所有邮件
• no keep：服务器端不保留已获取邮件

procmailrc配置

用于定义邮件处理规则，示例：

# 将特定发件人的邮件保存到指定目录
:0
* ^From:.*sender@example.com
/var/mail/sender/

# 将主题包含"Important"的邮件标记为已读
:0 fh
* ^Subject:.*Important
| formail -I "Status: RO"

msmtprc配置

用于定义SMTP发送参数，示例：

account default
host smtp.example.com
port 587
from user@example.com
auth on
user user@example.com
password your_password
tls on
tls_starttls on

主要参数说明：

• host：SMTP服务器地址
• port：SMTP端口（通常587或465）
• from：发件人***地址
• auth：是否启用认证
• tls：是否启用TLS加密