Postfix Admin Docker镜像（arm32v7架构）文档

镜像概述与主要用途

Postfix Admin是一个基于Web的管理界面，用于配置和管理基于Postfix的多用户邮件服务器。该镜像为arm32v7架构的专用构建，是Postfix Admin官方镜像的特定架构版本，支持通过网页界面管理虚拟域、邮箱账户、别名、配额及假期/外出自动回复等功能。

核心功能与特性

• 虚拟域与别名管理：支持创建和管理多个虚拟邮件域，配置邮箱别名及转发规则。
• 配额控制：为邮箱账户设置存储空间配额，限制用户邮件容量。
• 假期/外出消息：允许用户配置自动回复，通知发件人收件人暂时无法回复。
• 多数据库支持：兼容MySQL（mysqli）、PostgreSQL（pgsql）和SQLite数据库，存储服务器配置数据。
• 灵活部署变体：提供Apache（开箱即用）、FPM（需外部Web服务器）和FPM-Alpine（轻量级）三种镜像变体。

使用场景与适用范围

• 企业邮件系统：适用于企业环境中集中管理多部门、多用户的邮件账户。
• 个人/小型组织服务器：为个人或小型组织提供简易的Postfix服务器管理工具。
• 邮件服务提供商：帮助服务提供商高效管理客户虚拟域及邮箱资源。
• 开发测试环境：快速部署用于测试Postfix邮件服务器配置的场景。

支持的标签与架构

支持的标签及Dockerfile链接

支持的架构

该镜像支持多种架构，本文档针对arm32v7架构，其他架构可参考官方仓库：
amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x

使用方法与配置说明

前提条件

• 已安装支持arm32v7架构的Docker Engine。
• 若使用MySQL/PostgreSQL，需提前部署数据库服务并创建对应数据库及用户。

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

镜像可通过环境变量自动生成配置文件，适用于首次部署。

基本运行命令

$ docker run -e POSTFIXADMIN_DB_TYPE=mysqli \
           -e POSTFIXADMIN_DB_HOST=数据库主机IP或域名 \
           -e POSTFIXADMIN_DB_USER=数据库用户名 \
           -e POSTFIXADMIN_DB_PASSWORD=数据库密码 \
           -e POSTFIXADMIN_DB_NAME=数据库名称 \
           --name some-postfixadmin \
        arm32v7/postfixadmin

端口映射（允许主机访问）

$ docker run -e POSTFIXADMIN_DB_TYPE=mysqli \
           -e POSTFIXADMIN_DB_HOST=数据库主机IP或域名 \
           -e POSTFIXADMIN_DB_USER=数据库用户名 \
           -e POSTFIXADMIN_DB_PASSWORD=数据库密码 \
           -e POSTFIXADMIN_DB_NAME=数据库名称 \
           --name some-postfixadmin \
           -p 8080:80 \
        arm32v7/postfixadmin

启动后通过http://localhost:8080或[***]访问Web界面。

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

若已有自定义config.local.php，通过卷挂载使用：

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

3. 使用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
    volumes:
      - mysql-data:/var/lib/mysql

  postfixadmin:
    depends_on:
      - db
    image: arm32v7/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 或 [***]。

环境变量说明

SQLite使用提示：需挂载数据文件路径，例如：-v /本地路径/postfixadmin.db:/var/www/html/postfixadmin.db。

镜像变体说明

apache（默认）

• 组成：Apache Web服务器 + PHP模块。
• 优势：开箱即用，无需额外配置Web服务器。
• 适用场景：快速部署独立的Postfix Admin实例。

fpm

• 组成：仅包含PHP FPM进程。
• 优势：需配合外部Web服务器（如Nginx），适合已有Web架构的场景。
• 使用方式：需配置Web服务器反向代理至容器的9000端口（PHP FPM默认端口）。

fpm-alpine

• 组成：基于Alpine Linux，仅包含PHP FPM进程。
• 优势：镜像体积小，资源占用低。
• 限制：Alpine基础镜像工具较少，依赖缺失时建议使用fpm变体。

许可证信息

Postfix Admin软件许可证信息参见官方仓库。
镜像可能包含基础系统组件（如Bash等），其许可证需用户自行合规检查。相关自动检测的许可证信息可参考repo-info仓库。

支持与反馈

• 维护者：Postfix Admin团队
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux Stack Exchange、Stack Overflow
• 提交Issue：GitHub Issues
• 镜像更新跟踪：official-images仓库