amd64/postfixadmin

Postfix Admin Docker镜像文档

快速参考

• 维护者:
  https://github.com/postfixadmin/docker

• 获取帮助:
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应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

快速参考（续）

• 问题反馈地址:
  https://github.com/postfixadmin/docker/issues?q=

• 支持的架构: (https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/postfixadmin/, https://hub.docker.com/r/arm32v5/postfixadmin/, https://hub.docker.com/r/arm32v6/postfixadmin/, https://hub.docker.com/r/arm32v7/postfixadmin/, https://hub.docker.com/r/arm64v8/postfixadmin/, https://hub.docker.com/r/i386/postfixadmin/, https://hub.docker.com/r/mips64le/postfixadmin/, https://hub.docker.com/r/ppc64le/postfixadmin/, https://hub.docker.com/r/riscv64/postfixadmin/, https://hub.docker.com/r/s390x/postfixadmin/

• 镜像工件详情:
  https://github.com/docker-library/repo-info/blob/master/repos/postfixadmin (https://github.com/docker-library/repo-info/commits/master/repos/postfixadmin)
  (镜像元数据、传输大小等)

• 镜像更新:
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fpostfixadmin
  https://github.com/docker-library/official-images/blob/master/library/postfixadmin (https://github.com/docker-library/official-images/commits/master/library/postfixadmin)

• 本描述的来源:
  https://github.com/docker-library/docs/tree/master/postfixadmin (https://github.com/docker-library/docs/commits/master/postfixadmin)

什么是Postfix Admin？

Postfix Admin是一个基于Web的界面，用于配置和管理多用户的Postfix邮件服务器。功能包括支持虚拟域和别名、配额管理以及假期/外出自动回复消息。它需要PHP、Postfix以及MySQL、PostgreSQL或SQLite中的一种数据库支持。

!https://raw.githubusercontent.com/docker-library/docs/be39946abe91fb116d24d8b797c9adacfd15a851/postfixadmin/logo.png

如何使用本镜像

无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或http://host-ip: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

使用https://github.com/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或http://host-ip: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镜像。

许可证

查看https://github.com/postfixadmin/postfixadmin/blob/master/LICENSE.TXT%E3%80%82

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

自动检测到的额外许可证信息可能位于https://github.com/docker-library/repo-info/tree/master/repos/postfixadmin%E3%80%82

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