Postfix Admin Docker 镜像文档

镜像概述和主要用途

Postfix Admin 是一个基于 Web 的界面，用于配置和管理基于 Postfix 的多用户电子邮件服务器。本镜像为 arm64v8 架构构建的官方 Postfix Admin 镜像，提供了便捷的邮件服务器管理解决方案。

核心功能和特性

• 支持虚拟域和别名管理
• 邮件配额设置
• 自动回复/外出邮件功能
• 多数据库支持：MySQL、PostgreSQL 和 SQLite
• 基于 Web 的直观管理界面

支持的标签和镜像变体

标签列表

• 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

镜像变体

apache

此变体包含 Apache Web 服务器和 PHP，可直接使用 Postfix Admin，无需额外配置 Web 服务器。

fpm

此变体仅启动 PHP FPM 进程，适用于已有独立 Web 服务器的场景。

fpm-alpine

基于 Alpine Linux 的轻量级变体，仅启动 PHP FPM 进程，适合对镜像大小有要求且已有独立 Web 服务器的场景。

支持的架构

• amd64
• arm32v5
• arm32v6
• arm32v7
• arm64v8 (本镜像)
• i386
• mips64le
• ppc64le
• riscv64
• s390x

使用场景和适用范围

• 企业邮件服务器管理
• 个人或小型组织的邮件服务搭建
• 需要多域和多用户管理的邮件系统
• 希望通过 Web 界面直观管理 Postfix 配置的场景

详细使用方法和配置说明

前提条件

• Docker 环境
• 数据库服务 (MySQL、PostgreSQL 或 SQLite)
• Web 服务器 (如使用 fpm 或 fpm-alpine 变体)

无现有配置文件 (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 \
           arm64v8/postfixadmin

支持的数据库类型 (POSTFIXADMIN_DB_TYPE)

• mysqli - MySQL 数据库
• pgsql - PostgreSQL 数据库
• sqlite - SQLite 数据库 (不推荐用于生产环境)

注意：如果使用 SQLite 数据库，需要添加数据卷挂载以持久化数据。

可选环境变量

• POSTFIXADMIN_SETUP_PASSWORD - 设置管理员密码

端口映射

若要从主机访问容器，可进行端口映射：

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 \
           arm64v8/postfixadmin

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

使用现有配置文件 (config.local.php)

如果已有配置文件，可通过数据卷挂载使用：

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

Docker Compose 部署示例

创建 compose.yaml 文件：

services:
  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_RANDOM_ROOT_PASSWORD: 1
      MYSQL_DATABASE: postfixadmin
      MYSQL_USER: postfixadmin
      MYSQL_PASSWORD: examplepassword
    volumes:
      - mysql-data:/var/lib/mysql

  postfixadmin:
    depends_on:
      - db
    image: arm64v8/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: examplepassword

volumes:
  mysql-data:

启动服务：

docker compose up -d

服务启动后，通过 http://localhost:8000 或 [***] 访问 Postfix Admin。

维护和支持

• 维护者: Postfix Admin
• 获取帮助: Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow
• 提交问题: [***]
• 镜像更新: official-images repo's library/postfixadmin label

许可证信息

Postfix Admin 的软件许可信息请查看 LICENSE.TXT。

本镜像可能包含其他软件组件，这些组件可能具有不同的许可证。有关详细信息，请查看 repo-info 仓库的 postfixadmin 目录。

使用本镜像即表示您同意遵守其中包含的所有软件的相关许可条款。