PostfixAdminのインストール
この手順は、Postfix、Dovecot、MySQL、Apache、PHPが導入済みの環境を対象にします。PHPの要件とDB更新手順は、使用するPostfixAdminリリースの公式ドキュメントで確認してください。
以前の文書に記載されていたDBパスワードとセットアップパスワードのハッシュは公開済みとして扱い、該当環境では直ちに認証情報を変更してください。
PostfixAdminの取得
公式リポジトリのタグとリリースノートを確認し、使用する安定版を選びます。X.Y.Z は確認したタグに置き換えてください。
# cd /opt
# git clone https://github.com/postfixadmin/postfixadmin.git
# cd /opt/postfixadmin
# git fetch --tags origin
# git tag --list 'postfixadmin-*' --sort=-version:refname
# TAG=postfixadmin-X.Y.Z
# git show --no-patch --decorate "$TAG"
# git checkout --detach "$TAG"
Apacheの設定
HTTPSのVirtualHost内にAliasを設定し、管理ネットワークからのみアクセスを許可します。CIDRと証明書設定は実環境に合わせてください。
Alias /postfixadmin/ "/opt/postfixadmin/public/"
<Directory "/opt/postfixadmin/public">
Require ip 192.168.1.0/24
</Directory>
Apacheの設定を検査して反映します。
# httpd -t
# systemctl reload httpd
データベースの作成
rootでMySQLへ接続し、PostfixAdmin専用のデータベースとユーザーを作成します。プレースホルダーを強固で一意な値に置き換え、実パスワードを文書や共有ログに書かないでください。
CREATE DATABASE postfixdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'postfix'@'localhost' IDENTIFIED BY 'REPLACE_WITH_UNIQUE_SECRET';
GRANT SELECT, INSERT, UPDATE, DELETE ON postfixdb.* TO 'postfix'@'localhost';
初回セットアップでDBスキーマの作成・更新が必要な場合は、公式手順が求めるDDL権限だけを postfixdb.* に一時付与します。セットアップ完了後は不要な権限を取り消してください。FILE 権限やグローバル権限は付与しません。
ローカル設定ファイル
/opt/postfixadmin/config.local.php を作成します。
<?php
$CONF['database_type'] = 'mysqli';
$CONF['database_user'] = 'postfix';
$CONF['database_password'] = 'REPLACE_WITH_UNIQUE_SECRET';
$CONF['database_name'] = 'postfixdb';
$CONF['configured'] = true;
?>
実パスワードを設定した後、Webサーバー実行方式に合わせて読み取り権限を制限します。以下はApacheグループでPHPを実行する場合の例です。PHP-FPM等で別グループを使う場合は適宜変更してください。
# chown root:apache /opt/postfixadmin/config.local.php
# chmod 0640 /opt/postfixadmin/config.local.php
# restorecon -v /opt/postfixadmin/config.local.php
書き込み可能にするのはキャッシュなど必要なディレクトリだけにします。
# install -d -o apache -g apache -m 0750 /opt/postfixadmin/templates_c
# restorecon -Rv /opt/postfixadmin/templates_c
初回セットアップ
セットアップ画面はHTTPSでアクセスし、Apache設定で許可した管理ネットワークからのみ操作します。セットアップパスワードは独自の強固な値を設定し、ハッシュも含めて文書や共有ログに貼り付けないでください。初期化は使用リリースの公式手順に従います。
https://mail.example.org/postfixadmin/setup.php
セットアップ完了後は、公式手順に従ってセットアップ機能を無効化または削除し、再アクセスできないことを確認します。通常の管理画面もHTTPSで使用します。
https://mail.example.org/postfixadmin/
登録
- 管理者アカウントを作成
- 仮想ドメインとメールユーザーを作成
- 必要なメール転送設定を作成
