mailman

郵便配達員

Mailman は、電子メール サーバー データベースの管理を支援する React で書かれた SPA です。

目次

• 前提条件
• ドッカー
• 導入
  • リバースプロキシ
• 郵便配達員を更新する
• すべてのメールアドレスをキャッチ
• ライセンス
• 謝辞

特徴

• ドメイン、アカウント、エイリアス、TLS ポリシーの作成、更新、削除
• アカウントはエイリアスを作成し、パスワードを変更できます
• レスポンシブな Web インターフェイス
• ドメインごとの管理者
• UIのカスタマイズ

前提条件

Thomas Leister 氏の素晴らしいメールサーバー チュートリアル「Dovecot、Postfix、MySQL および Rspamd を使用した Debian 9 ストレッチのメールサーバー」で提供されているデータベース モデルを備えた機能的なメールサーバーが必要です。

vmail データベース ユーザーの権限を更新して、クエリの挿入、更新、削除を許可します。

 grant select , insert, update , delete on vmail. * to ' vmail ' @ ' localhost ' identified by ' vmaildbpass ' ;

または、新しいユーザーを作成します。

 grant select , insert, update , delete on vmail. * to ' vmail_mailman ' @ ' localhost ' identified by ' vmaildbpass ' ;

ドッカー

サーバーにdockerがインストールされている場合は、Docker コンテナーで Mailman を実行できます。それ以外の場合は、「デプロイメント」セクションに進み、手動でデプロイする方法を確認してください。

sample.envファイルをダウンロードします。

wget https://github.com/phiilu/mailman/raw/master/sample.env -O .env

.env内の変数を更新して、mailman を起動します。

docker run -d --net= " host " --env-file .env --restart=always --name mailman phiilu/mailman

説明：

• -d 、コンテナをデーモン プロセス (別名バックグラウンド) として実行します。
• --net="host"ネットワークをホストと共有するように docker に指示します。これは vmail データベースにアクセスするために必要です
• --env-file .envコンテナ内の環境変数を設定します
• --name mailman Docker コンテナの名前を mailman に設定します。

---

サブフォルダー構成を備えた Docker:

http root /ではなくサブフォルダー/mailmanを介して mailman にアクセスする場合は、以下を変更する必要があります。

sample.subfolder.envファイルをダウンロードします。

wget https://github.com/phiilu/mailman/raw/master/sample.subfolder.env -O .env

.env内の変数を更新し、:subfolder タグを使用して mailman を起動します。

docker run -d --net= " host " --env-file .env --restart=always --name mailman phiilu/mailman:subfolder

注:この Docker イメージはパス/mailman専用です。変更することはできません。

---

導入

必要なビルドツールをインストールする

sudo apt install build-essential python

nvm を使用して Node.js をインストールする

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.6/install.sh | bash

nvm をインストールした後は、ほとんどの場合、ログアウトして再度ログインします。

nvm を使用してノードをインストールする

nvm install 9.1.0

Node.jsがインストールされているかどうかを確認する

$ node -v
v9.1.0

$ npm -v
5.5.1

PM2 を Node.js プロセス マネージャーとしてインストールする

npm i -g pm2

GitHub から Mailman のクローンを作成する

Mailman のクローンを root 以外のユーザーのホーム ディレクトリに作成するのが最も簡単です。

git clone https://github.com/phiilu/mailman.git

.env ファイルを作成する

cp sample.env .env

テキスト エディタで .env を開き、環境変数を構成に合わせて調整します。

• MAILMAN_SECRET JWT トークンに署名するための長い一意のランダム文字列
• MAILMAN_DB_ENGINE mailman によって使用されるエンジン。値が指定されていない場合、デフォルトは maria になります。
• MAILMAN_DB_USER vmailデータベース ユーザー
• MAILMAN_DB_PASSWORD vmailデータベース ユーザーのパスワード
• MAILMAN_DB_DATABASE vmailデータベース
• MAILMAN_HOST mailman がバインドする IP アドレス。デフォルトは0.0.0.0です
• MAILMAN_PORTメールマンがバインドする TCP ポート。デフォルトは4000です
• MAILMAN_BASENAME HTTP ベース。デフォルトは/です
• MAILMAN_ADMIN vmailデータベースの管理を許可されているユーザーの電子メール アドレス

---

サブフォルダーの構成:

http root /ではなくサブフォルダー/mailmanを介して mailman にアクセスする場合は、以下を変更する必要があります。

これらの手順は、Mailman を構築する前に行う必要があります。

1. mailman/client/package.jsonを開き、 "homepage": "http://localhost:4000/"を"homepage": "http://localhost:4000/mailman"に変更します。
2. mailman/client/.env.productionを開き、 REACT_APP_BASENAME=/ REACT_APP_BASENAME=/mailmanに変更します。
3. mailman/.envを開き、 MAILMAN_BASENAME=/をMAILMAN_BASENAME=/mailmanに変更します。
4. build Mailman npm install && cd client && npm install && cd - && npm run build
5. すでにpm2 pm2 kill kill
6. Mailman を再度起動します: npm start

---

ランダムなハッシュを生成するには、ターミナルでコマンドを使用します。

head /dev/urandom | tr -dc A-Za-z0-9 | head -c 128 ; echo ' '

アプリを構築する

 cd mailman && npm install && cd client && npm install && cd - && npm run build

郵便配達員を開始する

npm start

Mailman はサーバーのポート4000で実行されているはずです。

郵便配達員を更新する

手動展開

mailman ディレクトリ内で次のコマンドを実行します。

git stash && git pull && npm install && cd client && npm install && cd - && npm run build && pm2 restart all

ドッカー

docker pull phiilu/mailman:latest

新しいイメージをプルした後は、新しいコンテナを起動するだけです。

リバースプロキシ

NGINX

 server {
    listen 80 ;
    server_name mailman.example.org;

    ##
    ## Uncomment one of the two possibilities
    ##

    # Subdomain
    #location / {
    #  proxy_pass       http://localhost:4000;
    #  proxy_set_header Host      $host;
    #  proxy_set_header X-Real-IP $remote_addr;
    #}

    # Subfolder
    #location /mailman {
    #  proxy_pass       http://localhost:4000;
    #  proxy_set_header Host      $host;
    #  proxy_set_header X-Real-IP $remote_addr;
    #}
}

すべてのメールアドレスをキャッチ

キャッチオール電子メールアドレスを使用したい場合は、トーマスガイドを参照してください。

キャッチオールのアドレスを設定しますか? (ドイツ語)

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています

謝辞

• 優れたメールサーバーのインストール手順を教えてくれた Thomas Leister に感謝します