Postfix Admin是用于Postfix邮件服务器的基于Web的管理界面。
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, latest | https://github.com/postfixadmin/docker/blob/3253e7ee2122be4101486bd80b6356ff7e0a367a/apache/Dockerfile |
3.3.16-fpm, 3.3-fpm, 3-fpm, fpm | https://github.com/postfixadmin/docker/blob/3253e7ee2122be4101486bd80b6356ff7e0a367a/fpm/Dockerfile |
3.3.16-fpm-alpine, 3.3-fpm-alpine, 3-fpm-alpine, fpm-alpine | https://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 配置:
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: 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 等),其许可证需遵循各软件自身规定。用户应确保使用此镜像符合所有相关许可证要求。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务
