ppc64le/postfixadmin

Postfix Admin Docker镜像文档

镜像概述

主要用途

Postfix Admin 是一个基于 Web 的界面，用于配置和管理基于 Postfix 的多用户邮件服务器。它提供虚拟域、别名管理、配额设置以及假期/外出消息等功能，需配合 PHP、Postfix 及数据库（MySQL、PostgreSQL 或 SQLite）使用。

维护与支持

• 维护者：https://github.com/postfixadmin/docker
• 获取帮助：Docker 社区 Slack（[***] Fault、Unix & Linux 或 Stack Overflow

核心功能与特性

• 支持虚拟域和***别名管理
• ***配额设置
• 假期/外出自动回复消息配置
• 兼容多种数据库：MySQL（mysqli）、PostgreSQL（pgsql）、SQLite
• 多架构支持，适配不同硬件平台

适用范围

适用于需要集中管理多用户 Postfix 邮件服务器的场景，如：

• 企业内部邮件系统管理
• 中小型邮件服务提供商的用户配置
• 个人或组织自建邮件服务器的日常运维

支持的标签与架构

支持的标签及对应 Dockerfile

支持的架构

• amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x
  （各架构镜像地址：https://hub.docker.com/r/<架构>/postfixadmin/，如 ppc64le/postfixadmin）

使用方法

无现有配置文件（config.local.php）

若未创建 config.local.php，可通过环境变量自动生成配置文件。

基础运行命令

bash
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 \
        ppc64le/postfixadmin

暴露端口访问

如需从主机直接访问，可映射端口：

bash
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 \
        ppc64le/postfixadmin

访问地址：http://localhost:8080 或 http://主机IP:8080。

有现有配置文件（config.local.php）

若已通过本地文件 config.local.php 配置，可挂载文件运行：

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

使用 docker-compose 部署

以下为配合 MySQL 数据库的 compose.yaml 示例：

yaml
services:
  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_RANDOM_ROOT_PASSWORD: 1
      MYSQL_DATABASE: postfixadmin  # 数据库名
      MYSQL_USER: postfixadmin      # 数据库用户名
      MYSQL_PASSWORD: example       # 数据库密码

  postfixadmin:
    depends_on:
      - db
    image: ppc64le/postfixadmin
    ports:
      - 8000:80  # 主机端口:容器端口
    restart: always
    environment:
      POSTFIXADMIN_DB_TYPE: mysqli
      POSTFIXADMIN_DB_HOST: db       # 数据库服务名（与db容器名对应）
      POSTFIXADMIN_DB_USER: postfixadmin
      POSTFIXADMIN_DB_NAME: postfixadmin
      POSTFIXADMIN_DB_PASSWORD: example

启动命令：docker compose up，访问地址：http://localhost:8000。

配置参数

环境变量说明

注意：若使用 SQLite 数据库，需挂载数据卷以持久化数据（不推荐生产环境使用）。

镜像变体

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

apache 变体

• 标签示例：3.3.16-apache、3-apache、latest
• 包含 Apache Web 服务器和 PHP 环境，开箱即用，无需额外配置 Web 服务。

fpm 变体

• 标签示例：3.3.16-fpm、3-fpm、fpm
• 仅包含 PHP-FPM 进程，需配合独立 Web 服务器（如 Nginx）使用。

fpm-alpine 变体

• 标签示例：3.3.16-fpm-alpine、3-fpm-alpine、fpm-alpine
• 基于 Alpine Linux，体积更小，仅包含 PHP-FPM 进程，适用于对镜像大小敏感的场景。若需额外工具（Alpine 未预装），建议使用 fpm 变体。

问题反馈与支持

• 提交 issue：https://github.com/postfixadmin/docker/issues
• 镜像更新跟踪：https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fpostfixadmin
• 镜像元数据：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%A4%A7%E5%B0%8F%E3%80%81%E4%BC%A0%E8%BE%93%E4%BD%93%E7%A7%AF%E7%AD%89%E4%BF%A1%E6%81%AF%EF%BC%89

许可证信息

• 软件许可证：https://github.com/postfixadmin/postfixadmin/blob/master/LICENSE.TXT
• 镜像包含软件：镜像可能包含基础系统（如 Bash）及依赖软件，其许可证需用户自行确认合规性。
• 补充许可证信息：https://github.com/docker-library/repo-info/tree/master/repos/postfixadmin