開発・検証用のダミーメールサーバの構築(fakeSMTP)

1 概要
2 fakeSMTPのインストール
- 2.1 インストールと動作確認
- 2.2 補足
3 開発者展開用のバッチ
- 3.1 概要
- 3.2 使い方

概要

アプリ開発や検証等でメールサーバを利用したい場合がある。
プロジェクトで共有の検証用メールサーバを構築できると効率が良いか、その準備が間に合わなかったり、使用者が限定的な場合は、使用者の開発環境上に構築した方が手っ取り早い。
ここでは、fakeSMTPというダミーのメールサーバを構築する方法を説明する。

FakeSMTP – FakeSMTP - Dummy SMTP server for developers

…

fakeSMTPのインストール

公式サイトからfakeSMTP.jarをダウンロード・展開し、実行します。

インストールと動作確認

上記の公式サイトのdownloadページから最新版をダウンロード(fakeSMTP-latest.zip)します。
(2019年9月現在、v2.0が最新でした。)
ダウンロード後、任意の場所に解凍します。
（以降では”C:\fakeSMTP-latest”に展開した想定で説明します。）
javaコマンドを使ってfakeSMTPを実行します。
```
java.exe -jar C:\fakeSMTP-latest\fakeSMTP-2.0.jar
```
表示されたGUIで[サーバー起動]をクリックします。

何らかの方法でメールを送信します。
簡単にメール送信したい場合は、下記のようなPowerShellを実行してメールを送信できます。

$EmailFrom = "sender@example.com"$EmailTo ="receiver@example.com"$Subject = "お知らせ"$Body = "これはテストです。"$SMTPServer = "localhost"$SMTPClient = New-Object Net.Mail.SmtpClient($SmtpServer, 25)$SMTPClient.EnableSsl = $false$SMTPClient.Send($EmailFrom, $EmailTo, $Subject, $Body)$SMTPClient.Dispose()

$EmailFrom = "sender@example.com"

$EmailTo ="receiver@example.com"

$Subject = "お知らせ"

$Body = "これはテストです。"

$SMTPServer = "localhost"

$SMTPClient = New-Object Net.Mail.SmtpClient($SmtpServer, 25)

$SMTPClient.EnableSsl = $false

$SMTPClient.Send($EmailFrom, $EmailTo, $Subject, $Body)

$SMTPClient.Dispose()

送信したメールの内容が、次のようにfakeSMTPのGUIに表示されることを確認する。
表示行をダブルクリックすることで、OutlookやThunderbird等のメールクライアントで確認することもできます。（拡張子emlに対応するアプリが起動されますが、Outlook等の当該アプリが単独で正常に起動できるようになっていないとエラーで開けません。）

リンク

補足

公式サイトに説明がない動作についての補足です。

fakeSMTPが終了する際、設定情報がユーザフォルダ(%USERPROFILE%)の下記プロパティファイルに出力されます。

#Last user settings#Sun Sep 15 21:23:14 JST 2019emails.suffix=.emlemails.default.dir=received-emailsapplication.name=FakeSMTPsmtp.default.port=25application.min.height=440logback.appender.name=SMTPLOGSapplication.min.width=640application.title=Fake SMTP Serverapplication.icon.path=/icon.gif

#Last user settings

#Sun Sep 15 21:23:14 JST 2019

emails.suffix=.eml

emails.default.dir=received-emails

application.name=FakeSMTP

smtp.default.port=25

application.min.height=440

logback.appender.name=SMTPLOGS

application.min.width=640

application.title=Fake SMTP Server

application.icon.path=/icon.gif

「メッセージ保存先」は既定でreceived-emailsとなっています。これは、ユーザフォルダ(%USERPROFILE%)のreceived-emailsとなります。

開発者展開用のバッチ

概要

開発者が難しいことを知らずに、ワンクリックでローカルにダミーのSMTPサーバを起動するためのバッチです。開発標準の一環として、”C:\fakeSMTP-latest”を圧縮して開発者に展開する想定です。

起動するfakeSMTPの仕様は次の通りです。

fakeSMTPのGUIを表示し、サーバを自動で開始する。
（既定では、GUI表示後にユーザが[サーバー開始]ボタンをクリックする必要がある。）
受信したメールは証跡として、バッチと同じフォルダのmailフォルダに残す。
SMTPの既定の25番ポートを使用する。
fakeSMTP起動時の-aオプションでリッスンするアドレスを指定できますが、-b, -sと併せて指定する必要があります。-bはバックグラウンド実行オプションで自動開始の-sオプションと併せて使う必要があります。GUIで確認できた方が分かりやすいので、ここでは-bオプションは使用しません。

使い方

fakeSMTP-2.0.jarと同じフォルダに配置し、バッチ上のJAVA_HOMEまたはJVM変数を環境に合わせて書き換えて、管理者権限を持つユーザで実行してください。
使用している環境変数に関しては、こちらをご覧ください。

@echo offtitle fakeSMTPrem ========================================rem fakeSMTP.bat - fakeSMTP起動ラッパーrem ========================================rem カレントフォルダを、このバッチがある場所に変更cd /d "%~dp0"rem 基本定数--------------------------------rem 使用するfakeSMTPSET TARGET=fakeSMTP-2.0.jarrem fakeSMTPの実行に使用するJDK/JRE(1.6以上が必要)SET JAVA_HOME=C:\Program Files\Java\jdk1.8.0_171SET JVM=%JAVA_HOME%\bin\java.exerem 受信したメールの保存先rem 当該フォルダが存在しない場合、fakeSMTPが作成SET MAIL_FOLDER=.\mailrem fakeSMTPオプション(v2.0)----------------rem (詳細: http://nilhcem.com/FakeSMTP/)SET FS_OPT=rem fakeSMTPオプション: 起動後にSMTPサービスを開始SET FS_OPT=%FS_OPT% -srem fakeSMTPオプション: リッスンポートrem ※25番ポートを使う場合は管理者権限で実行が必要SET FS_OPT=%FS_OPT% -p 25rem fakeSMTPオプション: メール保存先(保存しない場合は-m)rem SET FS_OPT=%FS_OPT% -mSET FS_OPT=%FS_OPT% -o "%MAIL_FOLDER%"rem バインドするインターフェイスを指定する-aオプションはrem -b, -sオプションと併せて指定する必要がある。rem 実行------------------------------------echo fakeSMTPを起動します.....echo (終了する場合はGUIを閉じるか、このバッチをCtrl+Cで終了してください。)SET RUN_CMD="%JVM%" -jar "%TARGET%" %FS_OPT%rem echo コマンド: %RUN_CMD%%RUN_CMD%rem EOF

@echo off

title fakeSMTP

rem ========================================

rem fakeSMTP.bat - fakeSMTP起動ラッパー

rem ========================================

rem カレントフォルダを、このバッチがある場所に変更

cd /d "%~dp0"

rem 基本定数--------------------------------

rem 使用するfakeSMTP

SET TARGET=fakeSMTP-2.0.jar

rem fakeSMTPの実行に使用するJDK/JRE(1.6以上が必要)

SET JAVA_HOME=C:\Program Files\Java\jdk1.8.0_171

SET JVM=%JAVA_HOME%\bin\java.exe

rem 受信したメールの保存先

rem 当該フォルダが存在しない場合、fakeSMTPが作成

SET MAIL_FOLDER=.\mail

rem fakeSMTPオプション(v2.0)----------------

rem (詳細: http://nilhcem.com/FakeSMTP/)

SET FS_OPT=

rem fakeSMTPオプション: 起動後にSMTPサービスを開始

SET FS_OPT=%FS_OPT% -s

rem fakeSMTPオプション: リッスンポート

rem ※25番ポートを使う場合は管理者権限で実行が必要

SET FS_OPT=%FS_OPT% -p 25

rem fakeSMTPオプション: メール保存先(保存しない場合は-m)

rem SET FS_OPT=%FS_OPT% -m

SET FS_OPT=%FS_OPT% -o "%MAIL_FOLDER%"

rem バインドするインターフェイスを指定する-aオプションは

rem -b, -sオプションと併せて指定する必要がある。

rem 実行------------------------------------

echo fakeSMTPを起動します.....

echo (終了する場合はGUIを閉じるか、このバッチをCtrl+Cで終了してください。)

SET RUN_CMD="%JVM%" -jar "%TARGET%" %FS_OPT%

rem echo コマンド: %RUN_CMD%

%RUN_CMD%

rem EOF

リンク