arm32v6/postfixadmin

Postfix Admin Docker镜像文档

镜像概述和主要用途

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

注意：本镜像为arm32v6架构的构建版本，对应https://hub.docker.com/_/postfixadmin%E7%9A%84%E7%89%B9%E5%AE%9A%E6%9E%B6%E6%9E%84%E4%BB%93%E5%BA%93%E3%80%82%E6%9C%89%E5%85%B3%E5%A4%9A%E6%9E%B6%E6%9E%84%E6%94%AF%E6%8C%81%E7%9A%84%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%80%83https://github.com/docker-library/official-images#architectures-other-than-amd64%E3%80%82

核心功能和特性

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

使用场景和适用范围

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

快速参考

维护者

https://github.com/postfixadmin/docker

支持标签及对应Dockerfile链接

• https://github.com/postfixadmin/docker/blob/3253e7ee2122be4101486bd80b6356ff7e0a367a/fpm-alpine/Dockerfile

支持架构

• amd64 (https://hub.docker.com/r/amd64/postfixadmin/)
• arm32v5 (https://hub.docker.com/r/arm32v5/postfixadmin/)
• arm32v6 (https://hub.docker.com/r/arm32v6/postfixadmin/)
• arm32v7 (https://hub.docker.com/r/arm32v7/postfixadmin/)
• arm64v8 (https://hub.docker.com/r/arm64v8/postfixadmin/)
• i386 (https://hub.docker.com/r/i386/postfixadmin/)
• mips64le (https://hub.docker.com/r/mips64le/postfixadmin/)
• ppc64le (https://hub.docker.com/r/ppc64le/postfixadmin/)
• riscv64 (https://hub.docker.com/r/riscv64/postfixadmin/)
• s390x (https://hub.docker.com/r/s390x/postfixadmin/)

问题反馈

https://github.com/postfixadmin/docker/issues

镜像元数据

https://github.com/docker-library/repo-info/blob/master/repos/postfixadmin%EF%BC%88%E5%8C%85%E5%90%AB%E9%95%9C%E5%83%8F%E5%85%83%E6%95%B0%E6%8D%AE%E3%80%81%E4%BC%A0%E8%BE%93%E5%A4%A7%E5%B0%8F%E7%AD%89%EF%BC%89

详细使用方法和配置说明

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

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

必要环境变量

基本启动命令

console
$ 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

端口映射（主机访问）

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

console
$ 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或http://主机IP:8080访问Web界面。

SQLite注意事项

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

console
$ 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，可通过卷挂载直接使用：

console
$ 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配置示例：

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软件的许可证信息见https://github.com/postfixadmin/postfixadmin/blob/master/LICENSE.TXT%E3%80%82

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

额外许可证信息可参考https://github.com/docker-library/repo-info/tree/master/repos/postfixadmin%E3%80%82