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`)

如果没有配置文件，镜像将通过环境变量生成配置文件：

bash
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 - 设置管理员密码

端口映射

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

bash
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`)

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

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

Docker Compose 部署示例

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

启动服务：