Postfixのバーチャルドメイン設定方法｜virtual_mailbox_domainsとvirtual_alias_mapsの書き方

【この記事でわかること】

・virtual_mailbox_domainsは独立したメールボックスを持つドメイン用
・virtual_alias_mapsは既存アカウントへの転送（エイリアス）に使う
・設定後はpostmap・postfixreloadで反映、postfix checkで構文確認
・2つを組み合わせるとドメイン別の柔軟なメール管理が実現できる

# バーチャルエイリアスドメインの宣言
virtual_alias_domains = another-domain.jp, sub.example.com

# エイリアスマップファイルの指定
virtual_alias_maps = hash:/etc/postfix/virtual

# 書式: 受信アドレス  転送先アドレス（タブまたはスペース区切り）

# another-domain.jp の info@ 宛てを localuser@example.com へ転送
info@another-domain.jp         localuser@example.com

# support@ 宛てを複数アドレスへ転送（カンマ区切り）
support@another-domain.jp      admin@example.com, helpdesk@example.com

# ドメイン全体をキャッチオールする（@ドメイン で指定）
@sub.example.com               catchall@example.com

# DBファイルを生成（/etc/postfix/virtual.db が作られる）
$ sudo postmap /etc/postfix/virtual

# 生成確認
$ ls -la /etc/postfix/virtual*
-rw-r--r-- 1 root root  312 Apr  7 10:30 /etc/postfix/virtual
-rw-r--r-- 1 root root 12288 Apr  7 10:30 /etc/postfix/virtual.db

# 構文チェック（エラーがあればここで検出できる）
$ sudo postfix check

# 設定を再読み込み（サービス停止不要）
$ sudo postfix reload
postfix/postfix-script: refreshing the Postfix mail system

# バーチャルメールボックスドメインの宣言
virtual_mailbox_domains = hosted-domain.jp, another-hosted.jp

# メールボックスマップファイルの指定
virtual_mailbox_maps = hash:/etc/postfix/vmailbox

# メールボックスのベースディレクトリ
virtual_mailbox_base = /var/vmail

# メールの配送UID/GID（専用ユーザーを作成して指定）
virtual_uid_maps = static:5000
virtual_gid_maps = static:5000

# メールボックスマップ（任意だが指定推奨）
virtual_alias_maps = hash:/etc/postfix/virtual

# UID/GID 5000 で vmail ユーザーを作成
$ sudo groupadd -g 5000 vmail
$ sudo useradd -g vmail -u 5000 -d /var/vmail -s /sbin/nologin vmail

# メールボックスのベースディレクトリを作成
$ sudo mkdir -p /var/vmail
$ sudo chown vmail:vmail /var/vmail
$ sudo chmod 770 /var/vmail

# 書式: メールアドレス  ボックスパス（virtual_mailbox_base からの相対パス）

# hosted-domain.jp のメールボックス
info@hosted-domain.jp          hosted-domain.jp/info/Maildir/
sales@hosted-domain.jp         hosted-domain.jp/sales/Maildir/
admin@hosted-domain.jp         hosted-domain.jp/admin/Maildir/

# another-hosted.jp のメールボックス
contact@another-hosted.jp      another-hosted.jp/contact/Maildir/

# vmailbox の DB を生成
$ sudo postmap /etc/postfix/vmailbox

# 確認
$ ls -la /etc/postfix/vmailbox*
-rw-r--r-- 1 root root   280 Apr  7 11:00 /etc/postfix/vmailbox
-rw-r--r-- 1 root root 12288 Apr  7 11:00 /etc/postfix/vmailbox.db

# 構文チェックと再読み込み
$ sudo postfix check
$ sudo postfix reload
postfix/postfix-script: refreshing the Postfix mail system

# /etc/postfix/virtual にエイリアスを追記
no-reply@hosted-domain.jp      admin@hosted-domain.jp
postmaster@hosted-domain.jp    admin@hosted-domain.jp

# postmap で再生成
$ sudo postmap /etc/postfix/virtual
$ sudo postfix reload

$ sudo postfix check
# エラーがなければ何も表示されない
# エラーがある場合の例：
# postfix/postfix-script: fatal: the Postfix mail system is not installed

# デフォルト値と異なる設定項目だけを表示
$ sudo postconf -n | grep virtual
virtual_alias_domains = another-domain.jp, sub.example.com
virtual_alias_maps = hash:/etc/postfix/virtual
virtual_mailbox_base = /var/vmail
virtual_mailbox_domains = hosted-domain.jp, another-hosted.jp
virtual_mailbox_maps = hash:/etc/postfix/vmailbox
virtual_uid_maps = static:5000
virtual_gid_maps = static:5000

# 特定のアドレスが vmailbox に登録されているか確認
$ sudo postmap -q "info@hosted-domain.jp" hash:/etc/postfix/vmailbox
hosted-domain.jp/info/Maildir/

# virtual に登録されているか確認
$ sudo postmap -q "no-reply@hosted-domain.jp" hash:/etc/postfix/virtual
admin@hosted-domain.jp

# テストメールを送信
$ echo "test body" | mail -s "test subject" info@hosted-domain.jp

# ログでメール配送を確認
$ sudo tail -f /var/log/maillog
Apr  7 11:30:01 mail postfix/virtual[12345]: 3A4B27E240: to=,
  relay=virtual, delay=0.05, delays=0.03/0.01/0/0.01, dsn=2.0.0, status=sent
  (delivered to maildir)

# vmailbox に対象アドレスが登録されているか確認
$ sudo postmap -q "info@hosted-domain.jp" hash:/etc/postfix/vmailbox

# 登録されている場合は出力あり。空の場合はファイルに追記してpostmapを再実行
$ sudo postmap /etc/postfix/vmailbox
$ sudo postfix reload

# キャッチオールを追加（any@ を既存アドレスへ転送）
@another-domain.jp    admin@example.com

$ sudo postmap /etc/postfix/virtual
$ sudo postfix reload

# 現在の mydestination を確認
$ sudo postconf mydestination
mydestination = $myhostname, localhost.$mydomain, localhost

# バーチャルドメインが含まれていないか確認
# もし含まれていれば mydestination から削除して postfix reload

# ベースディレクトリの確認
$ ls -la /var/vmail/
drwxrwx--- 3 vmail vmail 4096 Apr  7 11:00 .
drwxr-xr-x 1 root  root    60 Apr  7 10:00 ..
drwxrwx--- 2 vmail vmail 4096 Apr  7 11:30 hosted-domain.jp

# パーミッションが違う場合
$ sudo chown -R vmail:vmail /var/vmail
$ sudo chmod 770 /var/vmail

# === 基本設定 ===
myhostname = mail.example.com
mydomain = example.com
myorigin = $mydomain
inet_interfaces = all
inet_protocols = ipv4

# ローカル配送のドメイン（バーチャルドメインは含めない）
mydestination = $myhostname, localhost.$mydomain, localhost

# === バーチャルメールボックス設定 ===
virtual_mailbox_domains = hosted-domain.jp, another-hosted.jp
virtual_mailbox_base = /var/vmail
virtual_mailbox_maps = hash:/etc/postfix/vmailbox
virtual_uid_maps = static:5000
virtual_gid_maps = static:5000

# === バーチャルエイリアス設定 ===
virtual_alias_domains = alias-domain.jp
virtual_alias_maps = hash:/etc/postfix/virtual