Postfix Admin Docker镜像文档

镜像概述

主要用途

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

维护与支持

• 维护者：Postfix Admin 项目
• 获取帮助：Docker 社区 Slack（[***] Fault、Unix & Linux 或 Stack Overflow

核心功能与特性

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

适用范围

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

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

支持的标签与架构

支持的标签及对应 Dockerfile

支持的架构

• amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x
  （各架构镜像地址：[***]<架构>/postfixadmin/，如 ppc64le/postfixadmin）

使用方法

无现有配置文件（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 \
        ppc64le/postfixadmin

暴露端口访问

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

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 或 [***]。

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

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

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 示例：

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：Postfix Admin Docker 项目 Issues
• 镜像更新跟踪：official-images 仓库 library/postfixadmin 标签
• 镜像元数据：repo-info 仓库 postfixadmin 目录（包含镜像大小、传输体积等信息）

许可证信息

• 软件许可证：Postfix Admin 许可证
• 镜像包含软件：镜像可能包含基础系统（如 Bash）及依赖软件，其许可证需用户自行确认合规性。
• 补充许可证信息：repo-info 仓库 postfixadmin 目录