コンテナ - MailHogのソースを表示

== 概要 ==
MailHogは、開発環境で使用するメールテスト用のツールである。<br>
<br>
SMTPサーバとして動作し、送信されたメールを実際には配信せず、Web UIで確認することができる。<br>
これにより、開発中に誤って実際のメールアドレスにメールを送信してしまうリスクを防ぐ。<br>
<br>
MailHogの主な機能を以下に示す。<br>
* SMTPサーバ機能 (デフォルト : ポート1025)
* Web UI でのメール確認 (デフォルト : ポート8025)
* 送信されたメールの保存と検索
* メールの削除や詳細表示
<br><br>

== Containerfile ==
Containerfileを作成する。<br>
<br>
<syntaxhighlight lang="dockerfile">
 FROM mailhog/mailhog:latest
 
 EXPOSE 1025 8025
 
 VOLUME ["/data"]
 
 CMD ["MailHog"]
 </syntaxhighlight>
<br>
コンテナイメージをビルドする。<br>
 podman build -t mailhog:custom -f Containerfile .
<br>
ビルドしたイメージからコンテナを実行する。<br>
 podman run -d           \
   --name mailhog        \
   -p 0.0.0.0:1025:1025  \
   -p 0.0.0.0:8025:8025  \
   -v mailhog-data:/data \
   mailhog:custom
<br><br>

== Compose ==
Composeファイルを作成する。<br>
<br>
<syntaxhighlight lang="yaml">
version: '3'
services:
  mailhog:
    image: mailhog/mailhog
    container_name: mailhog
    ports:
      - "0.0.0.0:1025:1025"  # SMTP用（すべてのIPでリッスン）
      - "0.0.0.0:8025:8025"  # Web UI用（すべてのIPでリッスン）
    volumes:
      - mailhog-data:/data

volumes:
  mailhog-data:
</syntaxhighlight>
<br>
Composeファイルを実行して、コンテナを作成および実行する。<br>
 podman-compose up -d
 # または
 podman-compose -f <Composeファイル名> up -d
<br><br>

== アクセス方法 ==
コンテナが起動したら、以下のURLでアクセスできる。<br>
<br>
* Web UI: <nowiki>http://localhost:8025</nowiki>
* SMTP サーバー: localhost:1025
<br>
==== アプリケーションからの使用例 ====
アプリケーションのメール設定で以下のように設定する。<br>
<br>
 SMTP Host: localhost（または MailHog が動作しているホスト）
 SMTP Port: 1025
 認証: 不要
 暗号化: なし
<br><br>

== ファイヤーウォールの設定 ==
同一ネットワーク上の外部PCからアクセスする場合は、ファイヤーウォールのポート開放を行う。<br>
<br>
==== Linux ====
 # Firewalldを使用している場合
 sudo firewall-cmd --permanent --add-port=1025/tcp
 sudo firewall-cmd --permanent --add-port=8025/tcp
 sudo firewall-cmd --reload
 
 # UFWを使用している場合
 sudo ufw allow 1025/tcp
 sudo ufw allow 8025/tcp 
<br>
==== Windows 11 ====
PowerShellを管理者権限で起動して、以下に示すコマンドを実行する。<br>
<br>
SMTPポート（1025）の受信ルールを追加する。<br>
 New-NetFirewallRule -DisplayName "Mailhog SMTP" -Direction Inbound -Protocol TCP -LocalPort 1025 -Action Allow
<br>
Web UIポート（8025）の受信ルールを追加する。<br>
 New-NetFirewallRule -DisplayName "Mailhog Web UI" -Direction Inbound -Protocol TCP -LocalPort 8025 -Action Allow
<br>
正常にポート開放が行われているかどうかを確認する場合、別PCからPowerShellを起動して、以下のコマンドを実行する。<br>
 Test-NetConnection -ComputerName <Windows PCのIPアドレス> -Port 8025
 Test-NetConnection -ComputerName <Windows PCのIPアドレス> -Port 1025
<br>
ファイアウォールルールを削除する場合は、以下に示すコマンドを実行する。<br>
 # SMTPポート（1025）のルール削除
 Remove-NetFirewallRule -DisplayName "Mailhog SMTP" -ErrorAction SilentlyContinue
 
 # Web UIポート（8025）のルール削除
 Remove-NetFirewallRule -DisplayName "Mailhog Web UI" -ErrorAction SilentlyContinue
<br>
==== Windows 10 ====
PowerShellを管理者権限で起動して、以下に示すコマンドを実行する。<br>
<br>
SMTPポート（1025）の受信ルールを追加する。<br>
 New-NetFirewallRule -DisplayName "Mailhog SMTP" -Direction Inbound -Protocol TCP -LocalPort 1025 -Action Allow
<br>
Web UIポート（8025）の受信ルールを追加する。<br>
 New-NetFirewallRule -DisplayName "Mailhog Web UI" -Direction Inbound -Protocol TCP -LocalPort 8025 -Action Allow
<br>
正常にポート開放が行われているかどうかを確認する場合、別PCからPowerShellを起動して、以下のコマンドを実行する。<br>
 Test-NetConnection -ComputerName <Windows PCのIPアドレス> -Port 8025
 Test-NetConnection -ComputerName <Windows PCのIPアドレス> -Port 1025
<br>
ファイアウォールルールを削除する場合は、以下に示すコマンドを実行する。<br>
 # SMTPポート（1025）のルール削除
 Remove-NetFirewallRule -DisplayName "Mailhog SMTP" -ErrorAction SilentlyContinue
 
 # Web UIポート（8025）のルール削除
 Remove-NetFirewallRule -DisplayName "Mailhog Web UI" -ErrorAction SilentlyContinue
<br><br>

== 参考情報 ==
* [https://github.com/mailhog/MailHog MailHog GitHub リポジトリ]
* [https://hub.docker.com/r/mailhog/mailhog MailHog Docker Hub]
<br><br>


[[カテゴリ:コンテナ]]