Mailmanのソースを表示

[[Category:メール]]
[[Category:メールサーバー]]
[[en:mailman]]
[https://gitlab.com/mailman/mailman Mailman] はメーリングリスト管理システムです。[[メールサーバー]]と組み合わせて使用します。

== インストール ==

{{Pkg|mailman3}} パッケージを[[インストール]]します。

{{Note|{{Pkg|mailman3}} は近い将来 {{Pkg|mailman}} に置き換わる予定です。両方のアプリケーションが {{ic|/var/lib/mailman}} をステートディレクトリ、{{ic|mailman}} ユーザーとして使うので、現在衝突していて、一緒にインストールすることはできません。}}

Mailman は [[Postorius]] (設定用) と [[Hyperkitty]] (アーカイブ用)と一緒に使うことができます。

{{Note|''Mailman'' は専用の {{ic|mailman}} ユーザーとして実行されます。したがって、{{ic|mailman}} 実行ファイルは、{{ic|mailman}} ユーザーとして実行する必要があります。}}

== 設定 ==

Mailman の設定はすべて {{ic|/etc/mailman.cfg}} で行われます。全ての可能な設定オプションとデフォルトの設定を説明するスキーマは {{ic|/usr/lib/python3.8/site-packages/mailman/config/schema.cfg}} に格納されています。

また、コマンドラインからも設定にアクセスすることができます。{{ic|mailman}} ユーザーとして (例: [[sudo]] や [[su]] を使って) 以下のコマンドを実行します。

 [mailman]$ mailman conf

=== データベース ===

Mailman はデフォルトで、{{ic|/var/lib/mailman/data/ の [[SQLite]] [https://mailman.readthedocs.io/en/latest/src/mailman/docs/database.html データベース] を使用します。}} ですが、[[MariaDB]] または [[PostgreSQL]] を使用するように設定できます。

==== SQLite ====

[[SQLite]] データベースのデフォルトの場所はすでに {{ic|schema.cfg}} に反映されているため、Mailman で設定する必要はありません。

{{hc|/etc/mailman.cfg|
[database]
url: sqlite:////var/lib/mailman/data/mailman.db
}}

==== MariaDB ====

{{Pkg|python-pymysql}} パッケージを [[インストール]] し、[[MariaDB]] にデータベースを設定します。

{{hc|/etc/mailman.cfg|2=
[database]
class: mailman.database.mysql.MySQLDatabase
url: mysql+pymysql://''myuser'':''mypassword''@''mymysqlhost''/mailman?charset=utf8&use_unicode=1
}}

==== PostgreSQL ====

{{Pkg|python-psycopg2}} パッケージを [[インストール]] し、[[PostgreSQL]] を使用してデータベースを作成します。

{{hc|/etc/mailman.cfg|
[database]
class: mailman.database.postgresql.PostgreSQLDatabase
url: postgres://''myuser'':''mypassword''@''mypghost''/mailman
}}

=== REST API ===

Mailman は、設定の {{ic|[webservice]}} セクションの設定に基づいて REST API を公開します。{{ic|admin_user}} と {{ic|admin_pass}} のデフォルト値を必ず置き換えてください (以下の例の値は使用しないでください)

{{hc|/etc/mailman.cfg|
[webservice]
admin_user: my_new_admin_user_name
admin_pass: my_new_admin_user_password
}}

=== ARC ===

デフォルトでは、[[Wikipedia:ja:DMARC|DMARC]] および [[Wikipedia:ja:DKIM|DKIM]] は無効になっています。設定は、設定ファイルの {{ic|[ARC]}} セクションで行われます。必ず必要な値を設定し、デフォルトに関するドキュメントを読んでください。

{{hc|/etc/mailman.cfg|
[ARC]
enabled: yes
authserv_id: mailserver.tld
trusted_authserv_ids: subdomain.mailserver.tld, other.mailserver.tld
privkey: /path/to/privatekey.pem
selector: test
domain: mailserver.tld
}}

=== MTA ===

メール転送エージェント (MTA) を接続するには、設定ファイルの {{ic|[mta]}} セクションを設定する必要があります。  [https://mailman.readthedocs.io/en/latest/src/mailman/docs/mta.html アップストリームドキュメント] では、[[postfix]]、[[exim]]、[[sendmail]] の例について説明していますが、その他の例も説明しています。 MTA は技術的には可能です。

==== Postfix ====

ローカル [[postfix]] インスタンスに接続するには、次の構成セクションを使用できます。

{{hc|/etc/mailman.cfg|
[mta]
incoming: mailman.mta.postfix.LMTP
outgoing: mailman.mta.deliver.deliver
lmtp_host: mail.example.com
lmtp_port: 8024
smtp_host: mail.example.com
smtp_port: 25
}}

[[postfix]] 設定は互換性を確保するために拡張する必要があります ([https://mailman.readthedocs.io/en/latest/src/mailman/docs/mta.html#basic-postfix-connections アップストリームのメモ] を参照)

{{hc|/etc/postfix/main.cf|
<nowiki>
[..]
recipient_delimiter = +
unknown_local_recipient_reject_code = 550
owner_request_special = no
[..]
</nowiki>
}}

さらに、[[postfix]] は mailman の [https://mailman.readthedocs.io/en/latest/src/mailman/docs/mta.html#transport-maps トランスポートマップ] を認識する必要があります。postfix の設定に応じて、これらは次のようになります。

{{Note| 次の例では、{{ic|transport_maps}}、{{ic|local_recipient_maps}}、{{ic|relay_domains}}、{{ic|virtual_mailbox_domains}}、および {{ic|virtual_alias_maps}} の既存の値がマージされることを前提としています。追加の値。}}

{{hc|/etc/postfix/main.cf|
<nowiki>
[..]
transport_maps = hash:/var/lib/mailman/data/postfix_lmtp
local_recipient_maps = hash:/var/lib/mailman/data/postfix_lmtp
relay_domains = hash:/var/lib/mailman/data/postfix_domains
[..]
</nowiki>
}}

デフォルトのハッシュベースのエイリアスマップを作成するために mailman が {{ic|postmap}} に直接アクセスできない場合は、代わりに正規表現ベースのエイリアスマップを生成します。
デフォルトの Python クラスベースの設定を上書きするために、mailman は設定ファイルの使用を許可します。次のファイルを作成します。

{{hc|/etc/postfix-mailman.cfg|
[postfix]
postmap_command: /usr/bin/postmap
transport_file_type: regex
}}

このファイルを mailman の設定ファイルの {{ic|[mta]}} セクションに追加します。

{{hc|/etc/mailman.cfg|
[mta]
''[..]''
configuration: /etc/postfix-mailman.cfg
}}

その後、{{ic|regexp}} ベースのエクスポートを [[postfix]] 設定で使用できるようになります。

{{hc|/etc/postfix/main.cf|
<nowiki>
[..]
transport_maps = regexp:/var/lib/mailman/data/postfix_lmtp
local_recipient_maps = regexp:/var/lib/mailman/data/postfix_lmtp
relay_domains = regexp:/var/lib/mailman/data/postfix_domains
[..]
</nowiki>
}}

{{Note| タイプを変更した後(例: {{ic|hash}} から {{ic|regexp}} へ)、必ず新しいエイリアスマップを作成してください: {{ic|[mailman]$ mailman aliases}}}}

[[Postfix#Virtual_mail|仮想メール]] セットアップを使用してローカルの [[postfix]] インスタンスに接続するには、まず [[Postorius#Set_an_Alias_Domain|エイリアス ドメインを設定]] します。その後、それぞれの設定を変更します。

{{hc|/etc/postfix/main.cf|
<nowiki>
[..]
local_recipient_maps = regexp:/var/lib/mailman/data/postfix_lmtp
transport_maps = regexp:/var/lib/mailman/data/postfix_lmtp
virtual_mailbox_domains = regexp:/var/lib/mailman/data/postfix_domains
virtual_alias_maps = regexp:/var/lib/mailman/data/postfix_vmap
[..]
</nowiki>
}}

== 起動 ==

{{ic|mailman3.service}} を [[有効化]] して [[起動]] します。 

タイマーを備えた [[systemd]] サービスがいくつか存在し、リスト管理のさまざまな側面を処理します。

* {{ic|mailman3-digests.timer}}: 毎日のダイジェストを購読者に送信するため
* {{ic|mailman3-gatenews.timer}}: ニュースに関する [[Wikipedia:ja:Network News Transfer Protocol|NNTP]] サーバーの時間ごとのポーリング用
* {{ic|mailman3-notify.timer}}: 保留中のリクエストに関する通知を管理者に毎日送信するため

== セットアップ ==

=== メールサーバとの統合 ===

=== Hyperkitty との統合 ===

Mailman は、それ自体ではメールを自動的にアーカイブしません。[[Hyperkitty]] Web アプリケーションはこの目的に使用されます。  プラグインに基づいて、mailman はアーカイブのために [[Hyperkitty]] インスタンスにメールを送信できます。

{{Pkg|mailman3-hyperkitty}} パッケージを [[インストール]] し、{{ic|/etc/mailman-hyperkitty.cfg}} を設定します。

{{hc|/etc/mailman-hyperkitty.cfg|
[general]
base_url: https://example.tld/hyperkitty/
api_key: super_secret_password
}}

その後、mailman にプラグインを認識させます。

{{hc|/etc/mailman.cfg|
[archiver.hyperkitty]
class: mailman_hyperkitty.Archiver
enable: yes
configuration: /etc/mailman-hyperkitty.cfg
}}

== ヒントとテクニック ==

=== mailman 3.0 未満からのマイグレート ===

Mailman は、mailman < 3.0 ベースのリストデータベース ({{ic|config.pck}}) をインポートする機能を提供します。  {{ic|mailman}} ユーザーとして次のコマンドを実行します (例: [[sudo]] または [[su]] を使用。)

 [mailman]$ mailman import21 ''LISTSPEC'' ''PICKLE_FILE''

ここで、{{ic|''LISTSPEC''}} はインポートするリストの完全修飾名 (例: {{ic|list@example.com}}) を表し、{{ic|''PICKLE_FILE''}} はインポートするリストの完全修飾名を表し、{{ic|config.pck}} は、リストのファイルへのパスを表します。

{{Note|インポートされる mailman2 リストは、ターゲットの mailman インスタンスにすでに存在している必要があります。}}

=== REST API ===

Mailman は [https://mailman.readthedocs.io/en/latest/src/mailman/rest/docs/rest.html#the-rest-server REST API] を公開しています。これは、{{Pkg|python-mailmanclient}} をベースにしたスタムツールを使用できます。

== 参照 ==

* [https://mailman.readthedocs.io/en/latest/ Mailman Documentation] - ドキュメント
* [https://mailmanclient.readthedocs.io/en/latest/ Mailmanclient Documentation] - 上流のドキュメント
* [https://hyperkitty.readthedocs.io/en/latest/install.html#connecting-to-mailman Connecting to Mailman] - {{Pkg|mailman3-hyperkitty}} に関するアップストリームのドキュメント
* [https://docs.mailman3.org/en/latest/ Mailman Suite Documentation] - Mailman スイート全体 (Mailman、Hyperkitty、Postorius) の (高レベルの) アップストリームドキュメント