Poste.io Docker镜像文档

镜像概述和主要用途

Poste.io 是一个一站式邮件服务器解决方案，以Docker容器形式提供完整的邮件服务栈。该镜像集成了SMTP(s)、POP3(s)、IMAP(s)协议支持，搭配Rspamd（反垃圾邮件）、Clamav（防病毒）、Roundcube（Web邮件客户端）及Web管理界面，支持TLS加密、DKIM/SPF配置、自动化证书管理（Let's Encrypt）等核心功能，可快速部署并通过Web界面完成全流程配置，适用于需要自建邮件服务器的个人、小型企业或组织，简化邮件系统的部署与维护。

核心功能和特性

基础功能（免费版）

• 自动TLS证书：集成Let's Encrypt，支持免费、自动的TLS证书申请与续期。
• 邮件协议支持：完整支持SMTP（25/587端口）、SMTPS（465端口）、POP3（110端口）、POP3S（995端口）、IMAP（143端口）、IMAPS（993端口）。
• SMTP路由与SRS：支持SMTP路由（将所有外发邮件重定向至智能主机）及发件人重写系统（SRS，解决邮件转发时的SPF验证问题）。
• 防发件人伪造：支持针对邮件服务器用户的“From”头校验，防止发件人地址伪造（可按用户单独启用/禁用）。
• 隐私保护：自动移除冗余邮件头，隐藏已认证发件人的IP地址。
• 反垃圾邮件与防病毒：内置Rspamd（反垃圾邮件）和Clamav（防病毒）引擎，提供入站邮件的垃圾邮件过滤与病毒扫描。
• 自动清理机制：支持“垃圾邮件”和“回收站”文件夹的自动清理。
• Karma机制：通过p0f（发件人系统检测）、DNS/MX/反向解析、DNSBL（域名黑名单）等手段，增加垃圾邮件发送者的发送难度并减缓其发送速度。
• 黑白名单管理：支持手动配置黑白名单，并可自动屏蔽资源滥用者。
• 隔离区功能：可疑邮件自动进入隔离区，可通过Web管理界面查看与处理。
• 域名级功能：支持全域名转发、“Domain-bin”（即catch-all地址，接收域名下所有未匹配地址的邮件）。
• DKIM配置：通过Web管理界面可视化配置DKIM（域名密钥识别邮件），简化邮件认证部署。
• DNS诊断工具：内置服务器及域名级别的DNS诊断功能，支持DNSBL检查，辅助排查邮件投递问题。
• 用户配额管理：支持为***用户配置存储空间配额。
• 管理权限分级：支持系统管理员和用户两级权限控制（域管理员为PRO版功能）。
• Sieve过滤器：默认集成Sieve规则引擎，支持邮件重定向、复制、自动回复（外出回复）及自定义过滤规则。

PRO版增强功能

• 中继限制与阻断：限制单用户/域名的邮件中继量，可阻断感染病毒设备的垃圾邮件发送行为。
• 详细日志与检索：提供可搜索、可通过Web管理界面查看的详细邮件处理日志。
• DMARC报告：支持生成并解析DMARC报告，提升邮件认证与送达率。
• 域管理员权限：支持创建域级别管理员，细化权限管理。

使用场景和适用范围

Poste.io 适用于以下场景：

• 个人/小型组织自建邮件服务器：需要完整邮件收发能力（SMTP/IMAP/POP3），且希望简化部署与维护流程的场景。
• Web邮件需求：需集成Web邮件客户端（Roundcube），支持用户通过浏览器访问***。
• 安全性要求：对邮件传输加密（TLS）、身份认证（DKIM/SPF）、反垃圾邮件/防病毒有明确需求的场景。
• 定制化管理：需要通过Web界面配置域名、用户、配额、过滤规则等，且需灵活调整邮件策略的场景。
• 轻量化部署：偏好Docker容器化部署，追求低运维成本、快速迁移能力的用户或组织。

使用方法和配置说明

前置要求

• Docker Engine 1.13+ 或 Docker Desktop。
• 服务器需开放以下端口（根据需求调整）：25（SMTP）、465（SMTPS）、587（SMTP提交）、110（POP3）、995（POP3S）、143（IMAP）、993（IMAPS）、80/443（Web管理与Web邮件）。
• 需提前准备域名（用于邮件服务器主机名及***域名），并完成DNS记录配置（A记录、MX记录等）。

Docker Run命令示例

通过以下命令快速启动Poste.io容器（需替换<your-domain>为实际域名，<data-path>为宿主机数据持久化目录）：

bash
docker run -d \
  --name poste.io \
  --restart always \
  -p 25:25 \
  -p 465:465 \
  -p 587:587 \
  -p 110:110 \
  -p 995:995 \
  -p 143:143 \
  -p 993:993 \
  -p 80:80 \
  -p 443:443 \
  -v <data-path>:/opt/poste/data \
  -e TZ=Asia/Shanghai \
  -e HOSTNAME=mail.<your-domain> \
  -e DOMAIN=<your-domain> \
  analogic/poste.io

参数说明：

• -p：端口映射，对应SMTP（25/587/465）、POP3（110/995）、IMAP（143/993）、Web管理（80/443）。
• -v <data-path>:/opt/poste/data：数据持久化，将容器内邮件数据、配置、证书等存储至宿主机<data-path>目录（需提前创建目录并赋予权限）。
• -e TZ：时区设置（如Asia/Shanghai）。
• -e HOSTNAME：邮件服务器主机名（建议格式：mail.<your-domain>）。
• -e DOMAIN：默认域名（用于创建初始管理员***）。

Docker Compose配置示例

创建docker-compose.yml文件，内容如下：

yaml
version: '3'

services:
  poste:
    image: analogic/poste.io
    container_name: poste.io
    restart: always
    ports:
      - "25:25"       # SMTP
      - "465:465"     # SMTPS
      - "587:587"     # SMTP Submission
      - "110:110"     # POP3
      - "995:995"     # POP3S
      - "143:143"     # IMAP
      - "993:993"     # IMAPS
      - "80:80"       # HTTP (Let's Encrypt验证/临时Web访问)
      - "443:443"     # HTTPS (Web管理/Web邮件)
    volumes:
      - ./poste-data:/opt/poste/data  # 宿主机当前目录下的poste-data目录作为数据卷
    environment:
      - TZ=Asia/Shanghai
      - HOSTNAME=mail.example.com     # 替换为实际主机名
      - DOMAIN=example.com            # 替换为实际域名
    networks:
      - poste-network

networks:
  poste-network:
    driver: bridge

启动服务：

bash
docker-compose up -d

初始配置步骤

1. 访问Web管理界面：容器启动后，通过浏览器访问 https://<服务器IP或HOSTNAME>/admin（首次访问可能提示证书不安全，忽略后继续）。

2. 初始登录：默认管理员账户为 admin@<DOMAIN>（即环境变量DOMAIN值），密码为 admin。首次登录需强制修改密码。

3. 基础配置：

   • 在“Settings”→“System”中确认主机名、域名、时区等基础信息。
   • 通过“Domains”→“Add Domain”添加***域名。
   • 在“Mailboxes”中创建用户***（需关联已添加的域名）。

4. 邮件认证配置：

   • 在“Domains”→选择域名→“DKIM”中生成DKIM密钥，并按提示在域名DNS解析中添加TXT记录。
   • 配置SPF记录：在域名DNS中添加TXT记录，值为 v=spf1 mx a ~all（允许服务器IP及MX记录指向的IP发送邮件）。

5. 启用Let's Encrypt：在“Settings”→“TLS”中，勾选“Use Let's Encrypt”并输入域名，自动申请并配置免费TLS证书。

核心配置参数说明

补充说明

• PRO版升级：通过Web管理界面“Settings”→“License”购买并激活PRO版，解锁增强功能。
• 日志查看：免费版日志可通过容器日志查看（docker logs poste.io），PRO版支持Web界面日志检索。
• 备份建议：定期备份宿主机<data-path>目录，避免数据丢失。
• 安全加固：生产环境需限制25端口访问（仅允许信任IP的SMTP中继），并定期更新容器镜像。