i386架构postfixadmin镜像说明

说明：本仓库是postfixadmin官方镜像的i386架构构建版本。更多信息可参考官方镜像文档的“非amd64架构说明”及FAQ的“镜像源码变更后处理”。

快速参考

维护与支持

• 维护者：Postfix Admin团队
• 获取帮助：可通过Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow获取支持

支持的标签及对应Dockerfile链接

• 3.3.16-apache, 3.3-apache, 3-apache, apache, 3.3.16, 3.3, 3, latest
• 3.3.16-fpm, 3.3-fpm, 3-fpm, fpm
• 3.3.16-fpm-alpine, 3.3-fpm-alpine, 3-fpm-alpine, fpm-alpine

快速参考（续）

• 提交问题：[***]
• 支持的架构（更多信息）：
  amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x
• 镜像详情：repo-info仓库的repos/postfixadmin/目录（历史记录）（包含元数据、传输大小等）
• 镜像更新：official-images仓库的library/postfixadmin标签、official-images仓库的library/postfixadmin文件（历史记录）
• 本文档来源：docs仓库的postfixadmin/目录（历史记录）

什么是Postfix Admin？

Postfix Admin是一款基于Web的Postfix邮件服务器管理工具，支持多用户配置。功能包括虚拟域管理、邮件别名设置、配额控制、自动回复（外出）消息等。使用需依赖PHP、Postfix，以及MySQL、PostgreSQL或SQLite数据库。

如何使用本镜像

无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 \
        i386/postfixadmin

POSTFIXADMIN_DB_TYPE支持以下数据库类型：

• mysqli（MySQL）
• pgsql（PostgreSQL）
• sqlite（SQLite，不推荐用于生产环境，仅作为无配置文件时的 fallback）

注意：若使用SQLite，需通过卷挂载指定数据库文件路径。

可额外设置POSTFIXADMIN_SETUP_PASSWORD环境变量定义初始管理员密码。

如需从主机访问容器（不通过容器IP），可映射端口：

$ 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 \
        i386/postfixadmin

启动后，通过浏览器访问`[***]

已有config.local.php文件（迁移或自定义配置）

若需使用本地已有的config.local.php，通过卷挂载文件到容器内：

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

通过docker compose部署

以下是compose.yaml示例（需先安装docker compose）：

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: 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

执行docker compose up启动服务，待初始化完成后，访问`[***]

镜像变体

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

i386/postfixadmin:<version>

默认镜像。若不确定需求，建议使用此版本。支持直接运行（含基础环境），也可作为其他镜像的基础。

apache

内置Apache Web服务器和PHP环境，可直接启动使用。

fpm

仅包含PHP-FPM进程，需配合独立Web服务器（如Nginx）使用。

fpm-alpine

基于Alpine Linux，体积更小，仅包含PHP-FPM进程。适用于已有Web服务器且对镜像大小敏感的场景。若需额外工具（Alpine未预装），建议使用fpm变体。

许可协议

镜像中软件的许可信息请参考Postfix Admin源码仓库的LICENSE.TXT。
Docker镜像可能包含基础系统（如Bash）及依赖软件，其许可协议需另行查阅。部分自动检测的许可信息可在repo-info仓库的postfixadmin/目录查看。
使用前请确保遵守所有包含软件的许可协议。