volkerraschek/postfixadmin

PostfixAdmin

![Artifact Hub]([***]

镜像概述与主要用途

本镜像为https://github.com/postfixadmin/postfixadmin%E7%9A%84%E6%9B%BF%E4%BB%A3%E5%AE%B9%E5%99%A8%E5%8C%96%E5%AE%9E%E7%8E%B0%E3%80%82PostfixAdmin%E6%98%AF%E4%B8%80%E6%AC%BE%E7%94%A8%E4%BA%8E%E7%AE%A1%E7%90%86Postfix%E9%82%AE%E4%BB%B6%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%9A%84Web%E5%BA%94%E7%94%A8%E7%A8%8B%E5%BA%8F%EF%BC%8C%E6%94%AF%E6%8C%81%E8%99%9A%E6%8B%9F%E5%9F%9F%E3%80%81***%E8%B4%A6%E6%88%B7%E3%80%81%E5%88%AB%E5%90%8D%E7%AD%89%E8%B5%84%E6%BA%90%E7%9A%84%E7%AE%A1%E7%90%86%E3%80%82

本镜像的主要目标是：

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

核心功能与特性

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

使用场景与适用范围

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

使用方法与配置说明

环境变量配置

所有配置项通过前缀为POSTFIXADMIN_的环境变量定义，对应PostfixAdmin的PHP配置参数（参考https://github.com/postfixadmin/postfixadmin/blob/master/config.inc.php%EF%BC%89%E3%80%82

核心环境变量列表

关键环境变量说明

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，支持的算法参考https://github.com/postfixadmin/postfixadmin/blob/master/DOCUMENTS/HASHING.md%E3%80%82

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="admin@example.com" \
  -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=admin@example.com
      - 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及部署说明。