PostfixAdmin

![Docker Pulls]([] ![Artifact Hub]([]

镜像概述与主要用途

本镜像为PostfixAdmin的替代容器化实现。PostfixAdmin是一款用于管理Postfix邮件服务器的Web应用程序，支持虚拟域、***账户、别名等资源的管理。

本镜像的主要目标是：

• 支持基于Kubernetes/Helm的容器编排部署
• 提供通过环境变量进行灵活配置的能力
• 简化PostfixAdmin的容器化部署流程

核心功能与特性

• 多环境部署支持：兼容Docker单机部署与Kubernetes集群部署（通过Helm Chart）
• 环境变量配置：所有PHP配置项可通过环境变量注入，无需手动修改配置文件
• 多数据库支持：兼容SQLite、PostgreSQL及MySQL/MariaDB数据库后端
• 灵活的密码加密：支持多种密码加密算法（默认md5crypt，可根据需求配置）
• 自定义界面元素：支持配置页脚文本、链接及显示状态
• 邮件发送配置：可自定义SMTP服务器、端口及客户端标识

使用场景与适用范围

• 企业邮件服务器管理：集中管理多域名、多用户的Postfix邮件服务
• 个人/小型组织邮件服务：快速部署轻量级邮件账户管理界面
• 容器化环境集成：适用于Docker或Kubernetes环境下的邮件服务组件
• 开发/测试环境：通过SQLite后端快速搭建无依赖的测试环境

使用方法与配置说明

环境变量配置

所有配置项通过前缀为POSTFIXADMIN_的环境变量定义，对应PostfixAdmin的PHP配置参数（参考上游配置示例）。

核心环境变量列表

关键环境变量说明

POSTFIXADMIN_DATABASE_TYPE

数据库后端类型，支持以下值：

• sqlite：默认，无需额外数据库服务
• pgsql：PostgreSQL数据库
• mysqli：MySQL/MariaDB数据库

POSTFIXADMIN_DATABASE_PORT

非SQLite数据库时自动填充默认端口：

• MySQL/MariaDB：3306
• PostgreSQL：5432

POSTFIXADMIN_SETUP_PASSWORD

访问setup.php页面的必需密码，将自动通过bcrypt哈希处理，对应配置项$CONF['setup_password']。

POSTFIXADMIN_ENCRYPT

用户密码加密算法，默认md5crypt，支持的算法参考上游文档。

POSTFIXADMIN_DATABASE_USE_SSL

启用数据库SSL连接（true/false），需同时配置POSTFIXADMIN_DATABASE_KEY（私钥路径）、POSTFIXADMIN_DATABASE_CERT（证书路径）、POSTFIXADMIN_DATABASE_CA（CA证书路径）。

Docker部署示例

1. 基础部署（SQLite后端）

使用默认SQLite数据库，适合快速测试：

bash
docker run -d \
  --name postfixadmin \
  -p 8080:80 \
  -e POSTFIXADMIN_SETUP_PASSWORD="your_setup_password" \
  -e POSTFIXADMIN_ADMIN_EMAIL="***" \
  -v postfixadmin-data:/var/tmp \
  volkerraschek/postfixadmin

说明：-v postfixadmin-data:/var/tmp 用于持久化SQLite数据库文件（默认路径/var/tmp/postfixadmin.db）

2. Docker Compose部署（MySQL后端）

使用MySQL数据库的生产环境配置：

yaml
version: '3.8'

services:
  postfixadmin:
    image: volkerraschek/postfixadmin
    ports:
      - "8080:80"
    environment:
      - POSTFIXADMIN_DATABASE_TYPE=mysqli
      - POSTFIXADMIN_DATABASE_HOST=mysql
      - POSTFIXADMIN_DATABASE_USER=postfixadmin
      - POSTFIXADMIN_DATABASE_PASSWORD=strong_password
      - POSTFIXADMIN_DATABASE_NAME=postfixadmin_db
      - POSTFIXADMIN_SETUP_PASSWORD=your_setup_password
      - POSTFIXADMIN_ADMIN_EMAIL=***
      - POSTFIXADMIN_SMTP_SERVER=mail.example.com
      - POSTFIXADMIN_SMTP_PORT=587
    depends_on:
      - mysql

  mysql:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=postfixadmin_db
      - MYSQL_USER=postfixadmin
      - MYSQL_PASSWORD=strong_password
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  mysql-data:

启动服务：

bash
docker-compose up -d

访问Web界面：http://localhost:8080，通过http://localhost:8080/setup.php完成初始化配置（需输入POSTFIXADMIN_SETUP_PASSWORD）。

Kubernetes/Helm部署

参考Artifact Hub获取Helm Chart及部署说明。