oled01/automx2

automx2：邮件客户端配置简化工具

镜像概述

本镜像基于开源项目automx2制作，用于简化邮件客户端（Mail User Agent）的配置过程。镜像本身不开发或维护automx2核心代码，仅提供容器化部署支持。核心源码可参考https://github.com/rseichter/automx2%EF%BC%8C%E5%AE%98%E6%96%B9%E6%96%87%E6%A1%A3%E8%A7%81https://rseichter.github.io/automx2/%E3%80%82

核心功能

• 支持IMAP、SMTP、CalDAV、CardDAV等邮件相关服务的配置生成
• 通过配置文件自动初始化数据库（默认使用内存SQLite）
• 适配代理环境，可通过调整proxy_count参数获取真实客户端IP
• 支持多种数据库类型（内存SQLite、文件SQLite、MySQL）

使用场景

• 企业邮件服务提供者：为员工快速配置统一的邮件客户端设置
• 个人邮件服务器：简化个人邮件客户端的手动配置步骤
• 集群环境：可通过Helm chart（参考https://github.com/OLED1/oleds-helm-charts%EF%BC%89%E9%83%A8%E7%BD%B2%E5%88%B0Kubernetes%E9%9B%86%E7%BE%A4

配置说明

准备配置文件

需在本地创建automx2config目录，并放置以下两个文件：

1. automx2.conf（配置文件）
2. provider.json（服务提供者信息）

automx2.conf示例

[automx2]
loglevel = DEBUG  # 生产环境建议改为WARNING
db_echo = no
db_uri = sqlite:///:memory:  # 默认内存数据库
proxy_count = 1  # 代理服务器数量，根据实际环境调整

provider.json示例

{
  "provider": "示例公司",
  "domains": ["example.com", "example.net"],
  "servers": [
    {"type": "imap", "name": "imap.example.com"},
    {"type": "smtp", "name": "smtp.example.com"},
    {"type": "caldav", "port": 443, "url": "https://example.net/SOGo/dav/%EMAILADDRESS%/Calendar/personal/"},
    {"type": "carddav", "port": 443, "url": "https://example.net/SOGo/dav/%EMAILADDRESS%/Contacts/personal/"}
  ]
}

Docker Compose部署示例

yaml
services:
  automx2:
    container_name: automx2
    image: oled01/automx2
    environment:
      FLASK_APP: automx2.server:app
      FLASK_CONFIG: production
    ports:
      - "4243:4243"
    volumes:
      - ./automx2config:/etc/automx2
    networks:
      - gx_network

networks:
  gx_network:
    driver: bridge

版权信息

© 2019-2025 Ralph Seichter
automx2基于GNU General Public License V3或更高版本授权，源码托管于https://github.com/rseichter/automx2%EF%BC%8C%E5%B9%B6%E5%9C%A8https://pypi.org/project/automx2/%E5%8F%91%E5%B8%83%E3%80%82 ===END===