Postfix Admin是Postfix邮件服务器的基于Web的管理界面。
Postfix Admin Docker 镜像文档
镜像概述和主要用途
Postfix Admin 是一个基于 Web 的界面,用于配置和管理基于 Postfix 的多用户电子邮件服务器。本镜像为 arm64v8 架构构建的官方 Postfix Admin 镜像,提供了便捷的邮件服务器管理解决方案。
核心功能和特性
- 支持虚拟域和别名管理
- 邮件配额设置
- 自动回复/外出邮件功能
- 多数据库支持:MySQL、PostgreSQL 和 SQLite
- 基于 Web 的直观管理界面
支持的标签和镜像变体
标签列表
- 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
镜像变体
apache
此变体包含 Apache Web 服务器和 PHP,可直接使用 Postfix Admin,无需额外配置 Web 服务器。
fpm
此变体仅启动 PHP FPM 进程,适用于已有独立 Web 服务器的场景。
fpm-alpine
基于 Alpine Linux 的轻量级变体,仅启动 PHP FPM 进程,适合对镜像大小有要求且已有独立 Web 服务器的场景。
支持的架构
amd64arm32v5arm32v6arm32v7arm64v8(本镜像)i386mips64leppc64leriscv64s390x
使用场景和适用范围
- 企业邮件服务器管理
- 个人或小型组织的邮件服务搭建
- 需要多域和多用户管理的邮件系统
- 希望通过 Web 界面直观管理 Postfix 配置的场景
详细使用方法和配置说明
前提条件
- Docker 环境
- 数据库服务 (MySQL、PostgreSQL 或 SQLite)
- Web 服务器 (如使用 fpm 或 fpm-alpine 变体)
无现有配置文件 (config.local.php)
如果没有配置文件,镜像将通过环境变量生成配置文件:
bashdocker 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 \ docker.xuanyuan.run/arm64v8/postfixadmin
支持的数据库类型 (POSTFIXADMIN_DB_TYPE)
mysqli- MySQL 数据库pgsql- PostgreSQL 数据库sqlite- SQLite 数据库 (不推荐用于生产环境)
注意:如果使用 SQLite 数据库,需要添加数据卷挂载以持久化数据。
可选环境变量
POSTFIXADMIN_SETUP_PASSWORD- 设置管理员密码
端口映射
若要从主机访问容器,可进行端口映射:
bashdocker 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 \ docker.xuanyuan.run/arm64v8/postfixadmin
然后通过浏览器访问 http://localhost:8080 或 http://主机IP:8080。
使用现有配置文件 (config.local.php)
如果已有配置文件,可通过数据卷挂载使用:
bashdocker run -v /本地路径/config.local.php:/var/www/html/config.local.php \ --name some-postfixadmin \ -p 8080:80 \ docker.xuanyuan.run/arm64v8/postfixadmin
Docker Compose 部署示例
创建 compose.yaml 文件:
yamlservices: db: image: docker.xuanyuan.run/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: docker.xuanyuan.run/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:
启动服务:
bashdocker compose up -d
服务启动后,通过 http://localhost:8000 或 http://主机IP:8000 访问 Postfix Admin。
维护和支持
- 维护者: https://github.com/postfixadmin/docker
- 获取帮助: Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow
- 提交问题: https://github.com/postfixadmin/docker/issues
- 镜像更新: https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fpostfixadmin
许可证信息
Postfix Admin 的软件许可信息请查看 https://github.com/postfixadmin/postfixadmin/blob/master/LICENSE.TXT。
本镜像可能包含其他软件组件,这些组件可能具有不同的许可证。有关详细信息,请查看 https://github.com/docker-library/repo-info/tree/master/repos/postfixadmin。
使用本镜像即表示您同意遵守其中包含的所有软件的相关许可条款。
更多相关 Docker 镜像与资源
以下是 arm64v8/postfixadmin 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 postfixadmin 镜像标签
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务