Postfix Admin Docker镜像文档

镜像概述和主要用途

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

核心功能和特性

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

使用场景和适用范围

• 企业级邮件服务器管理，需维护多用户、多域邮件系统
• 中小型组织搭建和管理 Postfix 邮件服务器
• 需要通过 Web 界面简化 Postfix 配置的系统管理员
• 需支持邮件配额、自动回复等高级功能的邮件服务场景

支持的标签及 Dockerfile 链接

使用方法和配置说明

无现有配置文件（首次部署）

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

基础运行命令

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

环境变量说明

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

端口映射（主机访问）

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

console
$ docker run -e POSTFIXADMIN_DB_TYPE=mysqli \
           -e POSTFIXADMIN_DB_HOST=db \
           -e POSTFIXADMIN_DB_USER=postfixadmin \
           -e POSTFIXADMIN_DB_PASSWORD=example \
           -e POSTFIXADMIN_DB_NAME=postfixadmin \
           --name some-postfixadmin \
           -p 8080:80 \
        postfixadmin

访问地址：http://localhost:8080 或 [***]。

有现有配置文件

若已有 config.local.php，可通过卷挂载配置文件：

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

Docker Compose 部署

示例 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
    volumes:
      - mysql-data:/var/lib/mysql

  postfixadmin:
    depends_on:
      - db
    image: postfixadmin
    ports:
      - 8000:80
    restart: always
    environment:
      POSTFIXADMIN_DB_TYPE: mysqli
      POSTFIXADMIN_DB_HOST: db
      POSTFIXADMIN_DB_USER: postfixadmin
      POSTFIXADMIN_DB_NAME: postfixadmin
      POSTFIXADMIN_DB_PASSWORD: example

volumes:
  mysql-data:

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

镜像变体

postfixadmin:<version>-apache

默认镜像，包含 Apache Web 服务器和 PHP 环境，开箱即用，无需额外配置 Web 服务。

postfixadmin:<version>-fpm

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

postfixadmin:<version>-fpm-alpine

基于 Alpine Linux，体积更小，仅包含 PHP-FPM 进程，适合对镜像大小有严格要求的场景。若需额外工具（Alpine 中未预装），建议使用 fpm 变体。

支持信息

• 维护者：Postfix Admin
• 问题反馈：GitHub Issues
• 支持架构：amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x
• 镜像元数据：repo-info
• 更新记录：official-images

许可证

镜像包含的软件许可证信息见 Postfix Admin 许可证。
Docker 镜像可能包含基础系统及依赖软件（如 Bash、PHP 等），其许可证需遵循各软件自身规定。用户应确保使用此镜像符合所有相关许可证要求。