Postfix Admin Docker镜像文档

镜像概述和主要用途

Postfix Admin是一个基于Web的界面，用于配置和管理基于Postfix的多用户邮件服务器。它支持虚拟域、别名管理、配额设置以及自动回复（假期/外出）消息等功能。该工具需要PHP、Postfix环境，并支持MySQL、PostgreSQL或SQLite数据库。

注意：本镜像为arm32v6架构的构建版本，对应官方Postfix Admin镜像的特定架构仓库。有关多架构支持的更多信息，请参考官方镜像文档中的“非amd64架构”说明。

核心功能和特性

• 虚拟域与别名管理：支持创建和管理多个虚拟邮件域及邮箱别名
• 配额控制：为邮箱账户设置存储空间配额
• 自动回复功能：配置假期/外出自动回复消息
• 多数据库支持：兼容MySQL（mysqli）、PostgreSQL（pgsql）和SQLite数据库
• Web界面：直观的基于Web的管理界面，简化服务器配置流程

使用场景和适用范围

• 企业内部邮件系统管理，支持多部门/团队虚拟域
• 邮件服务提供商（ISP）管理客户邮件账户
• 需要集中管理多用户Postfix服务器的场景
• 轻量级邮件服务器部署，需通过Web界面简化配置

快速参考

维护者

Postfix Admin项目

支持标签及对应Dockerfile链接

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

支持架构

• amd64 (镜像链接)
• arm32v5 (镜像链接)
• arm32v6 (镜像链接)
• arm32v7 (镜像链接)
• arm64v8 (镜像链接)
• i386 (镜像链接)
• mips64le (镜像链接)
• ppc64le (镜像链接)
• riscv64 (镜像链接)
• s390x (镜像链接)

问题反馈

GitHub Issues

镜像元数据

repo-info仓库的postfixadmin目录（包含镜像元数据、传输大小等）

详细使用方法和配置说明

环境变量配置（无现有config.local.php）

若没有现成的config.local.php配置文件，镜像将通过环境变量自动生成配置文件。

必要环境变量

基本启动命令

$ docker run -e POSTFIXADMIN_DB_TYPE=mysqli \
           -e POSTFIXADMIN_DB_HOST=mysql-host \
           -e POSTFIXADMIN_DB_USER=postfixadmin \
           -e POSTFIXADMIN_DB_PASSWORD=secure-password \
           -e POSTFIXADMIN_DB_NAME=postfixadmin_db \
           --name some-postfixadmin \
        arm32v6/postfixadmin

端口映射（主机访问）

如需从主机直接访问容器服务，可通过端口映射实现：

$ docker run -e POSTFIXADMIN_DB_TYPE=mysqli \
           -e POSTFIXADMIN_DB_HOST=mysql-host \
           -e POSTFIXADMIN_DB_USER=postfixadmin \
           -e POSTFIXADMIN_DB_PASSWORD=secure-password \
           -e POSTFIXADMIN_DB_NAME=postfixadmin_db \
           --name some-postfixadmin \
           -p 8080:80 \  # 将容器80端口映射到主机8080端口
        arm32v6/postfixadmin

启动后，通过http://localhost:8080或[***]访问Web界面。

SQLite注意事项

SQLite不推荐用于生产环境，仅作为无数据库时的 fallback。需通过卷挂载指定数据库路径：

$ docker run -e POSTFIXADMIN_DB_TYPE=sqlite \
           -v /host/path/to/sqlite.db:/var/www/html/postfixadmin.db \
           --name some-postfixadmin \
           -p 8080:80 \
        arm32v6/postfixadmin

现有config.local.php配置

若已有自定义config.local.php，可通过卷挂载直接使用：

$ docker run -v /local/path/to/config.local.php:/var/www/html/config.local.php \
           --name some-postfixadmin \
           -p 8080:80 \
        arm32v6/postfixadmin

Docker Compose部署示例

以下为使用MySQL数据库的compose.yaml配置示例：

services:
  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_RANDOM_ROOT_PASSWORD: 1  # 自动生成root密码
      MYSQL_DATABASE: postfixadmin_db  # 数据库名称
      MYSQL_USER: postfixadmin  # 数据库用户
      MYSQL_PASSWORD: secure-password  # 数据库密码
    volumes:
      - mysql-data:/var/lib/mysql  # 持久化数据库数据

  postfixadmin:
    depends_on:
      - db  # 依赖MySQL服务启动
    image: arm32v6/postfixadmin
    ports:
      - 8000:80  # 主机8000端口映射到容器80端口
    restart: always
    environment:
      POSTFIXADMIN_DB_TYPE: mysqli
      POSTFIXADMIN_DB_HOST: db  # 容器内通过服务名访问MySQL
      POSTFIXADMIN_DB_USER: postfixadmin
      POSTFIXADMIN_DB_PASSWORD: secure-password
      POSTFIXADMIN_DB_NAME: postfixadmin_db

volumes:
  mysql-data:  # 定义MySQL数据卷

启动命令：docker compose up -d，服务就绪后通过http://localhost:8000访问。

镜像变体

arm32v6/postfixadmin提供以下标签变体，适用于不同场景：

arm32v6/postfixadmin:<version>

默认镜像，包含Web服务器和PHP环境，适用于直接部署的场景。若不确定需求，推荐使用此变体。

arm32v6/postfixadmin:fpm

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

arm32v6/postfixadmin:fpm-alpine

基于Alpine Linux的轻量级变体，仅包含PHP-FPM进程，体积更小，适合资源受限环境。若需要Alpine不提供的工具，建议使用fpm变体。

许可证信息

镜像中Postfix Admin软件的许可证信息见官方仓库LICENSE.TXT。

与所有Docker镜像一样，本镜像可能包含其他软件（如基础系统的Bash等），这些软件可能具有独立许可证。用户需自行确保使用本镜像符合所有包含软件的许可证要求。

额外许可证信息可参考repo-info仓库的postfixadmin目录。