schvin/fetchmail

dockerfile-fetchmail 镜像文档

镜像概述

dockerfile-fetchmail是一个基于fetchmail工具的Docker镜像，主要用于从远程邮件服务器（如POP3、IMAP服务器）获取邮件，并与Exim邮件传输代理（MTA）容器集成，实现邮件的接收、处理与转发功能。该镜像简化了邮件获取流程的部署与配置，适用于需要构建轻量级邮件接收系统的场景。

核心功能与特性

• 邮件获取：支持通过POP3、IMAP等协议从远程邮件服务器拉取邮件
• Exim集成：与Exim容器协同工作，将获取的邮件传递给Exim进行后续处理（如转发、存储）
• 配置灵活：支持通过环境变量自定义邮件服务器参数、认证信息及获取频率
• 轻量级：基于精简基础镜像构建，资源占用低，部署便捷

使用场景

• 个人或小型企业邮件服务器，需从外部邮件服务（如Gmail、Outlook）拉取邮件并通过Exim处理
• 邮件聚合系统，集中获取多个***账户的邮件并统一管理
• 测试环境中模拟邮件接收流程，配合Exim进行邮件路由测试

使用方法与配置说明

环境变量配置

Docker Run 部署示例

bash
docker run -d \
  --name fetchmail \
  --link exim-container:exim \  # 链接到Exim容器，确保网络互通
  -e FETCHMAIL_SERVER=mail.example.com \
  -e FETCHMAIL_PORT=995 \
  -e FETCHMAIL_USER=user@example.com \
  -e FETCHMAIL_PASSWORD=your_password \
  -e FETCHMAIL_PROTOCOL=pop3 \
  -e FETCHMAIL_INTERVAL=5 \
  -e EXIM_HOST=exim \
  -e EXIM_PORT=25 \
  your-registry/fetchmail:latest

Docker Compose 配置示例

yaml
version: '3.8'

services:
  fetchmail:
    image: your-registry/fetchmail:latest
    container_name: fetchmail
    environment:
      - FETCHMAIL_SERVER=mail.example.com
      - FETCHMAIL_PORT=995
      - FETCHMAIL_USER=user@example.com
      - FETCHMAIL_PASSWORD=your_password
      - FETCHMAIL_PROTOCOL=pop3
      - FETCHMAIL_INTERVAL=5
      - EXIM_HOST=exim
      - EXIM_PORT=25
    depends_on:
      - exim
    restart: unless-stopped

  exim:
    image: exim:latest  # Exim容器镜像
    container_name: exim
    ports:
      - "25:25"
    volumes:
      - ./exim-config:/etc/exim4  # 挂载Exim配置文件
    restart: unless-stopped

工作流程说明

1. fetchmail容器启动后，根据配置的FETCHMAIL_*参数连接远程邮件服务器
2. 按设定的FETCHMAIL_INTERVAL定期拉取邮件
3. 获取的邮件通过SMTP协议发送到EXIM_HOST指定的Exim容器
4. Exim容器接收邮件后，根据其自身配置进行后续处理（如转发至本地用户、外部***等）

注意事项

• 确保Exim容器已正确配置，允许接收来自fetchmail容器的SMTP连接
• 远程邮件服务器需开启对应协议（POP3/IMAP）及端口，并确保账户认证信息正确
• 对于需要SSL/TLS加密的连接（如POP3S、IMAPS），无需额外配置，fetchmail会自动启用加密
• 生产环境中建议通过Docker Secrets或环境变量文件管理敏感信息（如密码），避免明文配置