Postfix Admin Docker镜像文档

快速参考

• 维护者:
  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中的一种数据库支持。

!logo

如何使用本镜像

无config.local.php / 无现有配置

如果没有config.local.php，镜像将回退到查找环境变量来生成配置文件。

console
$ docker run -e POSTFIXADMIN_DB_TYPE=mysqli \
           -e POSTFIXADMIN_DB_HOST=whatever \
           -e POSTFIXADMIN_DB_USER=user \
           -e POSTFIXADMIN_DB_PASSWORD=topsecret \
           -e POSTFIXADMIN_DB_NAME=postfixadmin \
           --name some-postfixadmin \
        amd64/postfixadmin

POSTFIXADMIN_DB_TYPE可选值：

• mysqli
• pgsql
• sqlite

注意：不推荐使用SQLite数据库，但如果没有config.local.php且未指定上述变量，将作为回退选项。使用SQLite时，不要忘记为SQLite路径添加卷挂载。

还可以指定POSTFIXADMIN_SETUP_PASSWORD环境变量设置初始密码。

如需从主机访问容器实例（不通过容器IP），可使用标准端口映射：

console
$ docker run -e POSTFIXADMIN_DB_TYPE=mysqli \
           -e POSTFIXADMIN_DB_HOST=whatever \
           -e POSTFIXADMIN_DB_USER=user \
           -e POSTFIXADMIN_DB_PASSWORD=topsecret \
           -e POSTFIXADMIN_DB_NAME=postfixadmin \
           --name some-postfixadmin \
           -p 8080:80 \
        amd64/postfixadmin

然后通过浏览器访问http://localhost:8080或[***]。

已有config.local.php

console
$ docker run -v /local/path/to/config.local.php:/var/www/html/config.local.php \
           --name some-postfixadmin \
           -p 8080:80 \
        amd64/postfixadmin

使用docker compose

postfixadmin的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

  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，等待初始化完成后，访问http://localhost:8080或[***]（根据实际情况调整）。

镜像变体

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

amd64/postfixadmin:<version>

默认镜像。如不确定需求，建议使用此变体。既可作为临时容器（挂载源码启动），也可作为构建其他镜像的基础。

apache

启动带PHP的Apache Web服务器，可直接使用Postfix Admin。

fpm

仅启动PHP FPM容器。如已有独立Web服务器，使用此变体。

fpm-alpine

极小体积镜像，基于Alpine Linux，仅启动PHP FPM进程。如已有独立Web服务器且需要最小镜像体积，使用此变体。如需Alpine Linux未提供的工具，建议使用fpm镜像。

许可证

查看软件许可证信息。

与所有Docker镜像一样，本镜像可能包含其他软件，这些软件可能具有不同的许可证（如基础发行版中的Bash等，以及主要软件的直接或间接依赖）。

自动检测到的额外许可证信息可能位于repo-info仓库的postfixadmin/目录。

对于任何预构建镜像的使用，用户有责任确保其使用符合镜像中所有软件的相关许可证要求。