Postfix Admin Docker镜像文档

镜像概述和主要用途

注意：本镜像为s390x架构的Postfix Admin官方镜像构建版本。更多架构相关信息请参考官方镜像文档中的“非amd64架构”说明及官方镜像FAQ中的“镜像源变更后处理”。

Postfix Admin是一个基于Web的管理界面，用于配置和管理基于Postfix的邮件服务器，支持多用户场景。其主要用途包括虚拟域管理、邮件别名配置、配额设置及自动回复（外出留言）功能。该镜像需配合PHP、Postfix及数据库（MySQL、PostgreSQL或SQLite）使用。

核心功能和特性

• Web管理界面：提供直观的浏览器操作界面，简化Postfix服务器配置流程
• 多域支持：管理多个虚拟邮件域及对应的用户和别名
• 用户与别名管理：创建、编辑和删除邮件账户及别名
• 配额控制：设置用户邮件存储配额
• 自动回复功能：配置用户外出留言（vacation）规则
• 多数据库支持：兼容MySQL（mysqli）、PostgreSQL（pgsql）和SQLite
• 灵活配置：支持通过环境变量动态生成配置文件或挂载现有配置文件

使用场景和适用范围

• 企业邮件服务器管理：适用于需要集中管理多部门/多用户邮件账户的企业
• 多域名邮件系统：支持管理多个独立域名的邮件服务
• 自助邮件管理：允许用户自主配置别名和自动回复，减轻管理员负担
• 轻量级部署：可通过Docker快速部署，适合中小型邮件服务场景

支持的标签及对应Dockerfile链接

• 3.3.16-apache, 3.3-apache, 3-apache, apache, 3.3.16, 3.3, 3, latest
• 3.3.16-fpm, 3.3-fpm, 3-fpm, fpm
• 3.3.16-fpm-alpine, 3.3-fpm-alpine, 3-fpm-alpine, fpm-alpine

详细使用方法和配置说明

无现有config.local.php文件（首次部署）

若无需使用现有配置文件，可通过环境变量自动生成config.local.php。

基础启动命令

$ docker run -e POSTFIXADMIN_DB_TYPE=mysqli \
           -e POSTFIXADMIN_DB_HOST=数据库地址 \
           -e POSTFIXADMIN_DB_USER=数据库用户 \
           -e POSTFIXADMIN_DB_PASSWORD=数据库密码 \
           -e POSTFIXADMIN_DB_NAME=数据库名称 \
           --name some-postfixadmin \
        s390x/postfixadmin

环境变量说明

注意：SQLite数据库不推荐用于生产环境，仅作为无配置文件时的 fallback。若使用SQLite，需挂载数据卷存储数据库文件。

映射端口以访问Web界面

$ docker run -e POSTFIXADMIN_DB_TYPE=mysqli \
           -e POSTFIXADMIN_DB_HOST=数据库地址 \
           -e POSTFIXADMIN_DB_USER=数据库用户 \
           -e POSTFIXADMIN_DB_PASSWORD=数据库密码 \
           -e POSTFIXADMIN_DB_NAME=数据库名称 \
           --name some-postfixadmin \
           -p 8080:80 \
        s390x/postfixadmin

启动后，通过浏览器访问 http://localhost:8080 或 [***] 即可打开Postfix Admin界面。

使用现有config.local.php文件

若已有自定义配置文件，可通过挂载文件方式启动：

$ docker run -v /本地路径/config.local.php:/var/www/html/config.local.php \
           --name some-postfixadmin \
           -p 8080:80 \
        s390x/postfixadmin

使用Docker Compose部署

以下是使用Docker Compose部署Postfix Admin（配合MySQL数据库）的示例：

compose.yaml 配置

services:
  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_RANDOM_ROOT_PASSWORD: 1  # 自动生成root密码
      MYSQL_DATABASE: postfixadmin   # 数据库名称
      MYSQL_USER: postfixadmin       # 数据库用户
      MYSQL_PASSWORD: example        # 数据库密码

  postfixadmin:
    depends_on:
      - db  # 依赖数据库服务
    image: s390x/postfixadmin
    ports:
      - 8000:80  # 映射容器80端口到主机8000端口
    restart: always
    environment:
      POSTFIXADMIN_DB_TYPE: mysqli       # 使用MySQL数据库
      POSTFIXADMIN_DB_HOST: db           # 数据库主机（服务名）
      POSTFIXADMIN_DB_USER: postfixadmin # 数据库用户
      POSTFIXADMIN_DB_NAME: postfixadmin # 数据库名称
      POSTFIXADMIN_DB_PASSWORD: example  # 数据库密码

启动服务

$ docker compose up -d

服务启动后，通过 http://localhost:8000 或 [***] 访问Postfix Admin界面。

镜像变体

s390x/postfixadmin 提供多种变体，适用于不同场景：

s390x/postfixadmin:<version>（默认变体）

默认镜像，若未指定变体标签（如latest），将使用此变体。适合作为临时容器或基础镜像构建其他镜像。

s390x/postfixadmin:<version>-apache

包含Apache Web服务器和PHP，开箱即可使用，无需额外配置Web服务。适合快速部署独立的Postfix Admin服务。

s390x/postfixadmin:<version>-fpm

仅包含PHP-FPM进程，需配合独立的Web服务器（如Nginx）使用。适合已有Web服务器架构的场景。

s390x/postfixadmin:<version>-fpm-alpine

基于Alpine Linux构建，体积更小，仅包含PHP-FPM进程。适合对镜像大小有严格要求且需配合独立Web服务器的场景。若需要Alpine Linux不包含的工具，建议使用fpm变体。

支持的架构

该镜像支持多种硬件架构，包括：
amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x

维护与支持

• 维护者：Postfix Admin团队
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux、Stack Overflow
• 提交Issue：GitHub Issues

许可信息

Postfix Admin软件许可信息参见官方仓库。
Docker镜像可能包含基础系统及依赖软件，其许可信息可参考repo-info仓库的postfixadmin目录。
使用前请确保遵守所有包含软件的许可协议。