monogramm/autodiscover-email-settings

Autodiscover Email Settings 镜像文档

镜像概述和主要用途

Autodiscover Email Settings 是一个提供邮件服务自动发现功能的Docker镜像，旨在帮助用户自动配置邮件客户端设置。它支持IMAP/POP/SMTP/LDAP协议的自动发现，兼容Microsoft Outlook、Apple Mail、Thunderbird等主流邮件客户端，并提供iOS设备的配置文件生成功能。此外，镜像还包含一个简易的支持页面，方便用户手动获取配置信息或下载iOS配置文件。

核心功能和特性

• 多协议支持：提供IMAP、POP、SMTP、LDAP协议的自动发现能力
• 多客户端兼容：支持Microsoft Outlook、Apple Mail的Autodiscover，Thunderbird的Autoconfig，以及iOS设备的配置文件
• 简易支持页面：在自动发现域名根目录提供可视化支持页面，展示邮件配置信息
• 灵活配置：通过环境变量自定义邮件服务器参数、企业信息、LDAP设置等
• 轻量级部署：基于Node.js和Alpine Linux，镜像体积小，资源占用低

使用场景和适用范围

• 企业邮件服务器：为员工提供自动配置邮件客户端的能力，减少IT支持工作量
• 个人邮件服务：简化个人邮件客户端的手动配置步骤
• 邮件服务提供商：为用户提供标准化的自动发现服务，提升用户体验
• 需要支持多客户端邮件配置的场景：同时兼容Outlook、Thunderbird、Apple Mail等多种客户端

详细使用方法和配置说明

DNS设置

使用前需配置以下DNS记录，将变量替换为实际值：

autoconfig              IN      A      {{$AUTODISCOVER_IP}}
autodiscover            IN      A      {{$AUTODISCOVER_IP}}
imap                    IN      CNAME  {{$MX_DOMAIN}}.
smtp                    IN      CNAME  {{$MX_DOMAIN}}.
@                       IN      MX 10  {{$MX_DOMAIN}}.
@                       IN      TXT    "mailconf=https://autoconfig.{{$DOMAIN}}/mail/config-v1.1.xml"
_imaps._tcp             IN      SRV    0 0 {{IMAP_PORT}} {{MX_DOMAIN}}.
_pop3s._tcp             IN      SRV    0 0 {{POP_PORT}} {{MX_DOMAIN}}.
_submission._tcp        IN      SRV    0 0 {{SMTP_PORT}} {{MX_DOMAIN}}.
_autodiscover._tcp      IN      SRV    0 0 443 autodiscover.{{$DOMAIN}}.
_ldap._tcp              IN      SRV    0 0 {{LDAP_PORT}} {{LDAP_HOST}}.

Docker部署（使用docker-compose）

yaml
version: '2'

services:
  autodiscover-example-com:
    image: monogramm/autodiscover-email-settings:latest
    container_name: autodiscover
    environment:
      - COMPANY_NAME=公司名称
      - SUPPORT_URL=https://autodiscover.example.com
      - DOMAIN=example.com
      # IMAP配置（需设置主机名以启用）
      - IMAP_HOST=imap.example.com
      - IMAP_PORT=993
      - IMAP_SOCKET=SSL
      # POP配置（需设置主机名以启用）
      - POP_HOST=pop3.example.com
      - POP_PORT=995
      - POP_SOCKET=SSL
      # SMTP配置（需设置主机名以启用）
      - SMTP_HOST=smtp.example.com
      - SMTP_PORT=587
      - SMTP_SOCKET=STARTTLS
      # MobileSync/ActiveSync配置（需设置URL以启用）
      - MOBILESYNC_URL=https://sync.example.com
      - MOBILESYNC_NAME=sync.example.com
      # LDAP配置（需设置主机名以启用）
      - LDAP_HOST=ldap.example.com
      - LDAP_PORT=636
      - LDAP_SOCKET=SSL
      - LDAP_BASE=dc=ldap,dc=example,dc=com
      - LDAP_USER_FIELD=uid
      - LDAP_USER_BASE=ou=People,dc=ldap,dc=example,dc=com
      - LDAP_SEARCH=(|(objectClass=PostfixBookMailAccount))
      # Apple移动配置标识符（需设置标识符以启用）
      - PROFILE_IDENTIFIER=com.example.autodiscover
      - PROFILE_UUID=92943D26-CAB3-4086-897D-DC6C0D8B1E86
      - MAIL_UUID=7A981A9E-D5D0-4EF8-87FE-39FD6A506FAC
      - LDAP_UUID=6ECB6BA9-2208-4ABF-9E60-4E9F4CD7309E
    labels:
      - "traefik.port=8000"
      - "traefik.frontend.rule=Host:autoconfig.example.com,autodiscover.example.com"

Docker Swarm部署

yaml
version: '3'

services:
  autodiscover-example-com:
    image: monogramm/autodiscover-email-settings:latest
    container_name: autodiscover
    environment:
      - COMPANY_NAME=公司名称
      - SUPPORT_URL=https://autodiscover.example.com
      - DOMAIN=example.com
      # IMAP配置（需设置主机名以启用）
      - IMAP_HOST=imap.example.com
      - IMAP_PORT=993
      - IMAP_SOCKET=SSL
      # POP配置（需设置主机名以启用）
      - POP_HOST=pop3.example.com
      - POP_PORT=995
      - POP_SOCKET=SSL
      # SMTP配置（需设置主机名以启用）
      - SMTP_HOST=smtp.example.com
      - SMTP_PORT=587
      - SMTP_SOCKET=STARTTLS
      # MobileSync/ActiveSync配置（需设置URL以启用）
      - MOBILESYNC_URL=https://sync.example.com
      - MOBILESYNC_NAME=sync.example.com
      # LDAP配置（需设置主机名以启用）
      - LDAP_HOST=ldap.example.com
      - LDAP_PORT=636
      - LDAP_SOCKET=SSL
      - LDAP_BASE=dc=ldap,dc=example,dc=com
      - LDAP_USER_FIELD=uid
      - LDAP_USER_BASE=ou=People,dc=ldap,dc=example,dc=com
      - LDAP_SEARCH=(|(objectClass=PostfixBookMailAccount))
      # Apple移动配置标识符（需设置标识符以启用）
      - PROFILE_IDENTIFIER=com.example.autodiscover
      - PROFILE_UUID=92943D26-CAB3-4086-897D-DC6C0D8B1E86
      - MAIL_UUID=7A981A9E-D5D0-4EF8-87FE-39FD6A506FAC
      - LDAP_UUID=6ECB6BA9-2208-4ABF-9E60-4E9F4CD7309E
    deploy:
      replicas: 1
      labels:
        - "traefik.port=8000"
        - "traefik.frontend.rule=Host:autoconfig.example.com,autodiscover.example.com"

环境变量说明

注意事项

• 自动配置功能假设：如果用户名不包含@符号，将基于域名设置生成完整***地址
• 建议使用反向代理（如Traefik或Nginx）处理HTTPS，确保安全连接
• 各协议（IMAP/POP/SMTP/LDAP）需设置对应的主机名才能启用相关功能

相关链接

• Mozilla Autoconfig配置文档
• Microsoft Exchange命令参考
• Apple 配置文件参考
• https://github.com/doctorjbeam/LDAPAutoDiscover

许可证

本项目基于MIT许可证发布。