s390x/postfixadmin

Postfix Admin Docker镜像文档

镜像概述和主要用途

注意：本镜像为s390x架构的https://hub.docker.com/_/postfixadmin%E6%9E%84%E5%BB%BA%E7%89%88%E6%9C%AC%E3%80%82%E6%9B%B4%E5%A4%9A%E6%9E%B6%E6%9E%84%E7%9B%B8%E5%85%B3%E4%BF%A1%E6%81%AF%E8%AF%B7%E5%8F%82%E8%80%83https://github.com/docker-library/official-images#architectures-other-than-amd64%E5%8F%8Ahttps://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

Postfix Admin是一个基于Web的管理界面，用于配置和管理基于Postfix的邮件服务器，支持多用户场景。其主要用途包括虚拟域管理、邮件别名配置、配额设置及自动回复（外出留言）功能。该镜像需配合PHP、Postfix及数据库（MySQL、PostgreSQL或SQLite）使用。

核心功能和特性

• Web管理界面：提供直观的浏览器操作界面，简化Postfix服务器配置流程
• 多域支持：管理多个虚拟邮件域及对应的用户和别名
• 用户与别名管理：创建、编辑和删除邮件账户及别名
• 配额控制：设置用户邮件存储配额
• 自动回复功能：配置用户外出留言（vacation）规则
• 多数据库支持：兼容MySQL（mysqli）、PostgreSQL（pgsql）和SQLite
• 灵活配置：支持通过环境变量动态生成配置文件或挂载现有配置文件

使用场景和适用范围

• 企业邮件服务器管理：适用于需要集中管理多部门/多用户邮件账户的企业
• 多域名邮件系统：支持管理多个独立域名的邮件服务
• 自助邮件管理：允许用户自主配置别名和自动回复，减轻管理员负担
• 轻量级部署：可通过Docker快速部署，适合中小型邮件服务场景

支持的标签及对应Dockerfile链接

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

详细使用方法和配置说明

无现有config.local.php文件（首次部署）

若无需使用现有配置文件，可通过环境变量自动生成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 \
        s390x/postfixadmin

环境变量说明

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

映射端口以访问Web界面

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 \
           -p 8080:80 \
        s390x/postfixadmin

启动后，通过浏览器访问 http://localhost:8080 或 http://主机IP:8080 即可打开Postfix Admin界面。

使用现有config.local.php文件

若已有自定义配置文件，可通过挂载文件方式启动：

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

使用Docker Compose部署

以下是使用Docker Compose部署Postfix Admin（配合MySQL数据库）的示例：

compose.yaml 配置

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

  postfixadmin:
    depends_on:
      - db  # 依赖数据库服务
    image: s390x/postfixadmin
    ports:
      - 8000:80  # 映射容器80端口到主机8000端口
    restart: always
    environment:
      POSTFIXADMIN_DB_TYPE: mysqli       # 使用MySQL数据库
      POSTFIXADMIN_DB_HOST: db           # 数据库主机（服务名）
      POSTFIXADMIN_DB_USER: postfixadmin # 数据库用户
      POSTFIXADMIN_DB_NAME: postfixadmin # 数据库名称
      POSTFIXADMIN_DB_PASSWORD: example  # 数据库密码

启动服务

console
$ docker compose up -d

服务启动后，通过 http://localhost:8000 或 http://主机IP:8000 访问Postfix Admin界面。

镜像变体

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

s390x/postfixadmin:<version>（默认变体）

默认镜像，若未指定变体标签（如latest），将使用此变体。适合作为临时容器或基础镜像构建其他镜像。

s390x/postfixadmin:<version>-apache

包含Apache Web服务器和PHP，开箱即可使用，无需额外配置Web服务。适合快速部署独立的Postfix Admin服务。

s390x/postfixadmin:<version>-fpm

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

s390x/postfixadmin:<version>-fpm-alpine

基于Alpine Linux构建，体积更小，仅包含PHP-FPM进程。适合对镜像大小有严格要求且需配合独立Web服务器的场景。若需要Alpine Linux不包含的工具，建议使用fpm变体。

支持的架构

该镜像支持多种硬件架构，包括：
https://hub.docker.com/r/amd64/postfixadmin/%E3%80%81https://hub.docker.com/r/arm32v5/postfixadmin/%E3%80%81https://hub.docker.com/r/arm32v6/postfixadmin/%E3%80%81https://hub.docker.com/r/arm32v7/postfixadmin/%E3%80%81https://hub.docker.com/r/arm64v8/postfixadmin/%E3%80%81https://hub.docker.com/r/i386/postfixadmin/%E3%80%81https://hub.docker.com/r/mips64le/postfixadmin/%E3%80%81https://hub.docker.com/r/ppc64le/postfixadmin/%E3%80%81https://hub.docker.com/r/riscv64/postfixadmin/%E3%80%81https://hub.docker.com/r/s390x/postfixadmin/

维护与支持

• 维护者：https://github.com/postfixadmin/docker
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux、Stack Overflow
• 提交Issue：https://github.com/postfixadmin/docker/issues

许可信息

Postfix Admin软件许可信息参见https://github.com/postfixadmin/postfixadmin/blob/master/LICENSE.TXT%E3%80%82
Docker镜像可能包含基础系统及依赖软件，其许可信息可参考https://github.com/docker-library/repo-info/tree/master/repos/postfixadmin%E3%80%82
使用前请确保遵守所有包含软件的许可协议。