postfixadmin

Postfixadmin Docker Image

Postfix Admin是用于Postfix邮件服务器的基于Web的管理界面。

215 次收藏下载次数: 0状态:Docker 官方镜像维护者:Docker 官方镜像仓库类型:镜像最近更新:

Postfix Admin Docker镜像文档

镜像概述和主要用途

Postfix Admin 是一个基于 Web 的管理界面,用于配置和管理基于 Postfix 的邮件服务器,支持多用户场景。该工具提供虚拟域、邮件别名、配额管理及假期/外出消息等功能,需配合 PHP、Postfix 及数据库(MySQL、PostgreSQL 或 SQLite)使用。

核心功能和特性

  • 虚拟域与别名管理:支持创建和管理多个虚拟邮件域及邮件别名
  • 配额控制:配置用户邮件存储配额
  • 假期/外出消息:自动回复功能设置
  • 多数据库支持:兼容 MySQL (mysqli)、PostgreSQL (pgsql) 和 SQLite
  • Web 界面操作:直观的浏览器管理界面,简化服务器配置流程

使用场景和适用范围

  • 企业级邮件服务器管理,需维护多用户、多域邮件系统
  • 中小型组织搭建和管理 Postfix 邮件服务器
  • 需要通过 Web 界面简化 Postfix 配置的系统管理员
  • 需支持邮件配额、自动回复等高级功能的邮件服务场景

支持的标签及 Dockerfile 链接

标签Dockerfile 链接
3.3.16-apache, 3.3-apache, 3-apache, apache, 3.3.16, 3.3, 3, latesthttps://github.com/postfixadmin/docker/blob/3253e7ee2122be4101486bd80b6356ff7e0a367a/apache/Dockerfile
3.3.16-fpm, 3.3-fpm, 3-fpm, fpmhttps://github.com/postfixadmin/docker/blob/3253e7ee2122be4101486bd80b6356ff7e0a367a/fpm/Dockerfile
3.3.16-fpm-alpine, 3.3-fpm-alpine, 3-fpm-alpine, fpm-alpinehttps://github.com/postfixadmin/docker/blob/3253e7ee2122be4101486bd80b6356ff7e0a367a/fpm-alpine/Dockerfile

使用方法和配置说明

无现有配置文件(首次部署)

若无需使用现有 config.local.php,可通过环境变量自动生成配置文件。

基础运行命令

console
$ 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 \
        postfixadmin

环境变量说明

变量名说明可选值
POSTFIXADMIN_DB_TYPE数据库类型mysqli(MySQL)、pgsql(PostgreSQL)、sqlite(SQLite)
POSTFIXADMIN_DB_HOST数据库主机地址-
POSTFIXADMIN_DB_USER数据库用户名-
POSTFIXADMIN_DB_PASSWORD数据库密码-
POSTFIXADMIN_DB_NAME数据库名称-
POSTFIXADMIN_SETUP_PASSWORD初始设置密码可选,用于首次配置

注意:SQLite 数据库不推荐用于生产环境,仅作为无配置文件时的 fallback。若使用 SQLite,需挂载卷存储数据库文件。

端口映射(主机访问)

如需从主机直接访问容器,可映射端口:

console
$ docker run -e POSTFIXADMIN_DB_TYPE=mysqli \
           -e POSTFIXADMIN_DB_HOST=db \
           -e POSTFIXADMIN_DB_USER=postfixadmin \
           -e POSTFIXADMIN_DB_PASSWORD=example \
           -e POSTFIXADMIN_DB_NAME=postfixadmin \
           --name some-postfixadmin \
           -p 8080:80 \
        postfixadmin

访问地址:http://localhost:8080 或 http://主机IP:8080。

有现有配置文件

若已有 config.local.php,可通过卷挂载配置文件:

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

Docker Compose 部署

示例 compose.yaml 配置:

yaml
services:
  db:
    image: docker.xuanyuan.run/mysql:8.0
    restart: always
    environment:
      MYSQL_RANDOM_ROOT_PASSWORD: 1
      MYSQL_DATABASE: postfixadmin
      MYSQL_USER: postfixadmin
      MYSQL_PASSWORD: example
    volumes:
      - mysql-data:/var/lib/mysql

  postfixadmin:
    depends_on:
      - db
    image: docker.xuanyuan.run/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

volumes:
  mysql-data:

启动命令:docker compose up -d,访问地址 http://localhost:8000。

镜像变体

postfixadmin:<version>-apache

默认镜像,包含 Apache Web 服务器和 PHP 环境,开箱即用,无需额外配置 Web 服务。

postfixadmin:<version>-fpm

仅包含 PHP-FPM 进程,需配合独立 Web 服务器(如 Nginx)使用,适合已有 Web 服务架构的场景。

postfixadmin:<version>-fpm-alpine

基于 Alpine Linux,体积更小,仅包含 PHP-FPM 进程,适合对镜像大小有严格要求的场景。若需额外工具(Alpine 中未预装),建议使用 fpm 变体。

支持信息

  • 维护者:https://github.com/postfixadmin/docker
  • 问题反馈:https://github.com/postfixadmin/docker/issues
  • 支持架构:amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x
  • 镜像元数据:https://github.com/docker-library/repo-info/blob/master/repos/postfixadmin
  • 更新记录:https://github.com/docker-library/official-images/blob/master/library/postfixadmin

许可证

镜像包含的软件许可证信息见 https://github.com/postfixadmin/postfixadmin/blob/master/LICENSE.TXT。
Docker 镜像可能包含基础系统及依赖软件(如 Bash、PHP 等),其许可证需遵循各软件自身规定。用户应确保使用此镜像符合所有相关许可证要求。

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 postfixadmin 镜像标签

docker pull docker.xuanyuan.run/postfixadmin:<标签>

DockerHub 原生拉取命令

docker pull postfixadmin:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告