Postorius - 版の履歴

Kgx: /* インストール */ 翻訳を修正

2023-10-18T05:00:47Z

インストール: 翻訳を修正

← 古い版		2023年10月18日 (水) 14:00時点における版
6行目:		6行目:
	== インストール ==		== インストール ==

	Postorius を使うためには、動作する[[ウェブサーバー]]のセットアップが必要です (例えば、[[Apache HTTP Server\|Apache]] を使って [[wikipedia:Wsgi\|WSGI]] に直接転送するか、[[Nginx]] を使ってリクエストを [[UWSGI]] のようなアプリケーションサーバーに転送する)。		Postorius を使うためには、動作する [[ウェブサーバー]] のセットアップが必要です (例えば、[[Apache HTTP Server\|Apache]] を使って [[wikipedia:Wsgi\|WSGI]] に直接転送するか、[[Nginx]] を使ってリクエストを [[UWSGI]] のようなアプリケーションサーバーに転送します。)

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

	{{Warning\|Postorius は、パスワードやユーザーデータをネットワークに公開してしまうため、[[TLS]] 経由でのみアクセスされるべきです (テスト目的でそれを実行しているマシンから直接アクセスされる場合を除く)。}}		{{Warning\|Postorius は、パスワードやユーザーデータをネットワークに公開してしまうため、[[TLS]] 経由でのみアクセスされるべきです (テスト目的でそれを実行しているマシンから直接アクセスされる場合を除く。)}}

	== 設定 ==		== 設定 ==

Kgx: /* ヒントとコツ */ タイトルを同期

2023-10-18T04:59:09Z

ヒントとコツ: タイトルを同期

← 古い版		2023年10月18日 (水) 13:59時点における版
112行目:		112行目:
	[postorius]$ django-admin createsuperuser --pythonpath /usr/share/webapps/postorius/ --settings settings		[postorius]$ django-admin createsuperuser --pythonpath /usr/share/webapps/postorius/ --settings settings

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

	=== エイリアスドメインを設定する ===		=== エイリアスドメインを設定する ===

Kgx: /* Configuration */ 翻訳

2023-10-16T11:40:05Z

Configuration: 翻訳

← 古い版		2023年10月16日 (月) 20:40時点における版
12行目:		12行目:
	{{Warning\|Postorius は、パスワードやユーザーデータをネットワークに公開してしまうため、[[TLS]] 経由でのみアクセスされるべきです (テスト目的でそれを実行しているマシンから直接アクセスされる場合を除く)。}}		{{Warning\|Postorius は、パスワードやユーザーデータをネットワークに公開してしまうため、[[TLS]] 経由でのみアクセスされるべきです (テスト目的でそれを実行しているマシンから直接アクセスされる場合を除く)。}}

	== ~~Configuration~~ ==		== 設定 ==

	~~The web application is configured in~~ {{ic\|/etc/webapps/postorius/settings_local.py}} ~~which is included by the default configuration in~~ {{ic\|/usr/share/webapps/postorius/settings.py}}.		Web アプリケーションは、{{ic\|/etc/webapps/postorius/settings_local.py}} で設定されます。これは、{{ic\|/usr/share/webapps/postorius/settings.py}} のデフォルト設定に含まれています。

	{{Note\|Postorius ~~should store user sensitive data~~ (~~e.g.~~ sqlite ~~database~~) in {{ic\|/var/lib/postorius/data/}}, ~~as that directory is only accessible by~~ root ~~and the application itself.~~}}		{{Note\|Postorius は、ユーザーの機密データ (sqlite データベースなど) を {{ic\|/var/lib/postorius/data/}} に保存する必要があります。このディレクトリには root とアプリケーション自体だけがアクセスできるためです。}}

			アプリケーションのデフォルトのシークレットを変更します。
	Change the default secret for the application:

	{{hc\|/etc/webapps/postorius/settings_local.py\|2=		{{hc\|/etc/webapps/postorius/settings_local.py\|2=
24行目:		24行目:
	}}		}}

			運用環境で実行する場合は、必ずデバッグを無効にしてください。
	Make sure to disable debugging when running in production:

	{{hc\|/etc/webapps/postorius/settings_local.py\|2=		{{hc\|/etc/webapps/postorius/settings_local.py\|2=
30行目:		30行目:
	}}		}}

			実行中の [[mailman]] インスタンスを設定できるようにするには、REST API の設定オプションを postorius の構成に追加する必要があります。
	To be able to configure a running [[mailman]] instance configuration options for its REST API have to be added to postorius' configuration.

	{{hc\|/etc/webapps/postorius/settings_local.py\|<nowiki>		{{hc\|/etc/webapps/postorius/settings_local.py\|<nowiki>
38行目:		38行目:
	</nowiki>}}		</nowiki>}}

			有効な電子メール設定を追加します ([[Django]] アプリケーションが購読者を確認できるようにします)。
	Add a valid email configuration (so that the [[Django]] application can verify subscribers):

	{{hc\|/etc/webapps/postorius/settings_local.py\|2=		{{hc\|/etc/webapps/postorius/settings_local.py\|2=
48行目:		48行目:
	}}		}}

	{{Note\|~~The~~ {{ic\|DEFAULT_FROM_EMAIL}} ~~and~~ {{ic\|SERVER_EMAIL}} ~~configuration options can be used to define the~~ {{ic\|From:}} ~~header of mails sent for internal authentication and error reporting (respectively).~~}}		{{Note\|{{ic\|DEFAULT_FROM_EMAIL}} および {{ic\|SERVER_EMAIL}} 設定オプションを使用して、それぞれ内部認証とエラー報告のために送信されるメールの {{ic\|From:}} ヘッダーを定義できます。}}

			アプリケーションの有効なホスト名またはドメイン名を定義する必要があります。
	The valid hosts or domain names for the application need to be defined:

	{{hc\|/etc/webapps/postorius/settings_local.py\|2=		{{hc\|/etc/webapps/postorius/settings_local.py\|2=

Kusanaginoturugi: /* Hosting */ 翻訳

2023-09-01T11:54:34Z

Hosting: 翻訳

← 古い版		2023年9月1日 (金) 20:54時点における版
59行目:		59行目:
	}}		}}

	== ~~Hosting~~ ==		== ホスティング ==

	{{Expansion\|~~Example for a setup using~~ [[Apache HTTP Server]].}}		{{Expansion\|[[Apache HTTP Server]] を使ったセットアップの例。}}

	{{Note\|Postorius ~~needs to be run as its own user and group~~ (~~i.e.~~ {{ic\|postorius}}). It is ~~using~~ {{ic\|/etc/webapps/postorius/}}, {{ic\|/var/lib/postorius/}} ~~and~~ {{ic\|/run/postorius/}} ~~for configurations, static caches and (potentially) sockets, respectively.~~}}		{{Note\|Postorius はそれ自身のユーザーとグループ (すなわち {{ic\|postorius}}) として実行する必要があります。それは設定、静的キャッシュ、および (潜在的に) ソケットのためにそれぞれ {{ic\|/etc/webapps/postorius/}}, {{ic\|/var/lib/postorius/}}, および {{ic\|/run/postorius/}} を使用しています。}}

	{{Note\|~~As the static files are by default served from a top-level~~ {{ic\|static/}} ~~directory,~~ ~~which will conflict~~ ~~with~~ [[hyperkitty]] ~~on the same (sub)domain, it is advisable to set the {{ic\|STATIC_URL}} variable in~~ {{ic\|/etc/webapps/postorius/settings_local.py}} to ~~something~~ ~~unique~~ (~~e.g.~~ {{ic\|'/postorius_static/'}}).}}		{{Note\|静的ファイルはデフォルトでトップレベルの {{ic\|static/}} ディレクトリから提供され、同じ (サブ) ドメイン上の [[hyperkitty]] と競合するため、{{ic\|/etc/webapps/postorius/settings_local.py}} の {{ic\|STATIC_URL}} 変数をユニークなもの (例: {{ic\|'/postorius_static/'}}) に設定することをお勧めします。}}

	=== Nginx ~~and~~ uWSGI ===		=== Nginx と uWSGI ===

	Postorius ~~comes with a working [[uWSGI]] configuration file in~~ {{ic\|/etc/uwsgi/postorius.ini}}.		Postorius は {{ic\|/etc/uwsgi/postorius.ini}} にある動作する [[uWSGI]] 設定ファイルが付属しています。

	~~[[Install]]~~ {{Pkg\|nginx}} ~~and~~ {{Pkg\|uwsgi-plugin-python}}~~, create a per-application socket for~~ [[uWSGI]] (~~see~~ [[UWSGI#Accessibility of uWSGI socket]] ~~for reference~~) ~~and [[enable]]~~ {{ic\|uwsgi-secure@postorius.socket}}.		{{Pkg\|nginx}} と {{Pkg\|uwsgi-plugin-python}} を[[インストール]]し、[[uWSGI]] のアプリケーションごとのソケットを作成し ([[UWSGI#Accessibility of uWSGI socket]] を参照)、{{ic\|uwsgi-secure@postorius.socket}} を[[有効化]]してください。

	~~For a local test setup, serving Postorius at~~ http://127.0.0.1:80/postorius ~~add~~ ~~the~~ ~~following~~ [[Nginx]] ~~configuration to your setup~~:		ローカルのテストセットアップで、http://127.0.0.1:80/postorius で Postorius を提供するには、以下の [[Nginx]] 設定をセットアップに追加します:

	{{hc\|/etc/nginx/postorius.conf\|<nowiki>		{{hc\|/etc/nginx/postorius.conf\|<nowiki>

Kusanaginoturugi: /* Setup */ 翻訳

2023-09-01T11:50:19Z

Setup: 翻訳

← 古い版		2023年9月1日 (金) 20:50時点における版
96行目:		96行目:
	</nowiki>}}		</nowiki>}}

	== ~~Setup~~ ==		== セットアップ ==

	{{Note\| ~~Run the following commands as the~~ {{ic\|postorius}} ~~user~~ (~~e.g. using~~ [[sudo]] or [[su]]).}}		{{Note\| 以下のコマンドは {{ic\|postorius}} ユーザーとして実行してください (例: [[sudo]] または [[su]] を使用して)。}}

			初回インストール後、データベースを生成することを確認してください:
	After first installation make sure to generate a database:

	[postorius]$ django-admin migrate --pythonpath /usr/share/webapps/postorius/ --settings settings		[postorius]$ django-admin migrate --pythonpath /usr/share/webapps/postorius/ --settings settings

			その後、アプリケーションの静的データを収集する必要があります:
	Afterwards, the static data for the application needs to be collected:

	[postorius]$ django-admin collectstatic --pythonpath /usr/share/webapps/postorius/ --settings settings		[postorius]$ django-admin collectstatic --pythonpath /usr/share/webapps/postorius/ --settings settings

			[[Django]] アプリケーションのスーパーユーザーアカウントを作成します:
	Create a superuser account for the [[Django]] application:

	[postorius]$ django-admin createsuperuser --pythonpath /usr/share/webapps/postorius/ --settings settings		[postorius]$ django-admin createsuperuser --pythonpath /usr/share/webapps/postorius/ --settings settings

Kusanaginoturugi: /* See also */ 翻訳

2023-09-01T10:38:19Z

Kusanaginoturugi: /* Tips and tricks */ 翻訳

2023-09-01T10:37:06Z

Tips and tricks: 翻訳

← 古い版		2023年9月1日 (金) 19:37時点における版
112行目:		112行目:
	[postorius]$ django-admin createsuperuser --pythonpath /usr/share/webapps/postorius/ --settings settings		[postorius]$ django-admin createsuperuser --pythonpath /usr/share/webapps/postorius/ --settings settings

	== ~~Tips and tricks~~ ==		== ヒントとコツ ==

			=== エイリアスドメインを設定する ===
	=== Set an Alias Domain ===

	To ~~use a domain in a~~ [http://www.postfix.org/ADDRESS_CLASS_README.html#virtual_alias_class ~~virtual alias domain~~] ~~setup with with [[postfix]] it is necessary to set the domain's~~ {{ic\|Alias Domain}}. ~~The domain name does not have to exist.~~		[[postfix]] と共に [http://www.postfix.org/ADDRESS_CLASS_README.html#virtual_alias_class 仮想エイリアスドメイン] のセットアップでドメインを使用するためには、ドメインの {{ic\|Alias Domain}} を設定する必要があります。ドメイン名は実在しなくても構いません。

	~~To set the~~ {{ic\|Alias Domain}}, ~~log in using the admin user~~ (~~i.e.~~ {{ic\|postorius}} ~~by default~~) ~~and alter the domain's settings it in the~~ {{ic\|Domains}} ~~menu.~~		{{ic\|Alias Domain}} を設定するためには、管理ユーザーでログインします (デフォルトでは {{ic\|postorius}}) し、{{ic\|Domains}} メニューでドメインの設定を変更します。

	== See also ==		== See also ==

Kusanaginoturugi: 翻訳

2023-09-01T10:33:50Z

翻訳

← 古い版		2023年9月1日 (金) 19:33時点における版
2行目:		2行目:
	[[Category:ウェブアプリケーション]]		[[Category:ウェブアプリケーション]]
	[[en:Postorius]]		[[en:Postorius]]
	[https://gitlab.com/mailman/postorius Postorius] ~~is a~~ [[~~Django~~]] ~~based management interface for~~ [[~~Mailman~~]].		[https://gitlab.com/mailman/postorius Postorius] は、[[Mailman]] の管理インターフェースのための [[Django]] ベースのツールです。

	== ~~Installation~~ ==		== インストール ==

	~~To use~~ Postorius~~, a working~~ [[~~web server~~]] ~~setup is required~~ (~~e.g. using~~ [[Apache HTTP Server]] ~~to forward to the~~ [[wikipedia:Wsgi\|WSGI]] ~~directly, or using~~ [[Nginx]] ~~forwarding requests to an application server such as~~ [[UWSGI]]).		Postorius を使うためには、動作する[[ウェブサーバー]]のセットアップが必要です (例えば、[[Apache HTTP Server\|Apache]] を使って [[wikipedia:Wsgi\|WSGI]] に直接転送するか、[[Nginx]] を使ってリクエストを [[UWSGI]] のようなアプリケーションサーバーに転送する)。

	~~[[Install]] the~~ {{Pkg\|postorius}} ~~package.~~		{{Pkg\|postorius}} パッケージを[[インストール]]します。

			{{Warning\|Postorius は、パスワードやユーザーデータをネットワークに公開してしまうため、[[TLS]] 経由でのみアクセスされるべきです (テスト目的でそれを実行しているマシンから直接アクセスされる場合を除く)。}}
	{{Warning\|Postorius should only be accessed over [[TLS]] (unless only accessed directly from the machine running it for testing purposes), as it otherwise exposes passwords and user data to the network.}}

	== Configuration ==		== Configuration ==

Kusanaginoturugi: 英語版より転載

2023-09-01T10:31:28Z

英語版より転載

新規ページ

[[Category:メールサーバー]]
[[Category:ウェブアプリケーション]]
[[en:Postorius]]
[https://gitlab.com/mailman/postorius Postorius] is a [[Django]] based management interface for [[Mailman]].

== Installation ==

To use Postorius, a working [[web server]] setup is required (e.g. using [[Apache HTTP Server]] to forward to the [[wikipedia:Wsgi|WSGI]] directly, or using [[Nginx]] forwarding requests to an application server such as [[UWSGI]]).

[[Install]] the {{Pkg|postorius}} package.

{{Warning|Postorius should only be accessed over [[TLS]] (unless only accessed directly from the machine running it for testing purposes), as it otherwise exposes passwords and user data to the network.}}

== Configuration ==

The web application is configured in {{ic|/etc/webapps/postorius/settings_local.py}} which is included by the default configuration in {{ic|/usr/share/webapps/postorius/settings.py}}.

{{Note|Postorius should store user sensitive data (e.g. sqlite database) in {{ic|/var/lib/postorius/data/}}, as that directory is only accessible by root and the application itself.}}

Change the default secret for the application:

{{hc|/etc/webapps/postorius/settings_local.py|2=
SECRET_KEY = <nowiki>'</nowiki>''something-very-secret''<nowiki>'</nowiki>
}}

Make sure to disable debugging when running in production:

{{hc|/etc/webapps/postorius/settings_local.py|2=
DEBUG = False
}}

To be able to configure a running [[mailman]] instance configuration options for its REST API have to be added to postorius' configuration.

{{hc|/etc/webapps/postorius/settings_local.py|<nowiki>
MAILMAN_REST_API_URL = 'http://localhost:8001'
MAILMAN_REST_API_USER = 'rest_admin'
MAILMAN_REST_API_PASS = 'rest_admin_password'
</nowiki>}}

Add a valid email configuration (so that the [[Django]] application can verify subscribers):

{{hc|/etc/webapps/postorius/settings_local.py|2=
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'localhost'
EMAIL_PORT = 25
EMAIL_HOST_USER = ''username''
EMAIL_HOST_PASSWORD = ''password''
}}

{{Note|The {{ic|DEFAULT_FROM_EMAIL}} and {{ic|SERVER_EMAIL}} configuration options can be used to define the {{ic|From:}} header of mails sent for internal authentication and error reporting (respectively).}}

The valid hosts or domain names for the application need to be defined:

{{hc|/etc/webapps/postorius/settings_local.py|2=
ALLOWED_HOSTS = [
'localhost',
'lists.example.com'
]
}}

== Hosting ==

{{Expansion|Example for a setup using [[Apache HTTP Server]].}}

{{Note|Postorius needs to be run as its own user and group (i.e. {{ic|postorius}}). It is using {{ic|/etc/webapps/postorius/}}, {{ic|/var/lib/postorius/}} and {{ic|/run/postorius/}} for configurations, static caches and (potentially) sockets, respectively.}}

{{Note|As the static files are by default served from a top-level {{ic|static/}} directory, which will conflict with [[hyperkitty]] on the same (sub)domain, it is advisable to set the {{ic|STATIC_URL}} variable in {{ic|/etc/webapps/postorius/settings_local.py}} to something unique (e.g. {{ic|'/postorius_static/'}}).}}

=== Nginx and uWSGI ===

Postorius comes with a working [[uWSGI]] configuration file in {{ic|/etc/uwsgi/postorius.ini}}.

[[Install]] {{Pkg|nginx}} and {{Pkg|uwsgi-plugin-python}}, create a per-application socket for [[uWSGI]] (see [[UWSGI#Accessibility of uWSGI socket]] for reference) and [[enable]] {{ic|uwsgi-secure@postorius.socket}}.

For a local test setup, serving Postorius at http://127.0.0.1:80/postorius add the following [[Nginx]] configuration to your setup:

{{hc|/etc/nginx/postorius.conf|<nowiki>
server {
listen 80;
server_name localhost;
charset utf-8;
client_max_body_size 75M;
root /usr/share/webapps/postorius;
access_log /var/log/nginx/access.postorius.log;
error_log /var/log/nginx/error.postorius.log;

location /postorius_static {
alias /var/lib/postorius/static;
}

location ~^/(accounts|admin|postorius)/(.*)$ {
include /etc/nginx/uwsgi_params;
uwsgi_pass unix:/run/postorius/postorius.sock;
}
}
</nowiki>}}

== Setup ==

{{Note| Run the following commands as the {{ic|postorius}} user (e.g. using [[sudo]] or [[su]]).}}

After first installation make sure to generate a database:

[postorius]$ django-admin migrate --pythonpath /usr/share/webapps/postorius/ --settings settings

Afterwards, the static data for the application needs to be collected:

[postorius]$ django-admin collectstatic --pythonpath /usr/share/webapps/postorius/ --settings settings

Create a superuser account for the [[Django]] application:

[postorius]$ django-admin createsuperuser --pythonpath /usr/share/webapps/postorius/ --settings settings

== Tips and tricks ==

=== Set an Alias Domain ===

To use a domain in a [http://www.postfix.org/ADDRESS_CLASS_README.html#virtual_alias_class virtual alias domain] setup with with [[postfix]] it is necessary to set the domain's {{ic|Alias Domain}}. The domain name does not have to exist.

To set the {{ic|Alias Domain}}, log in using the admin user (i.e. {{ic|postorius}} by default) and alter the domain's settings it in the {{ic|Domains}} menu.

== See also ==

* [https://postorius.readthedocs.io/en/latest/ Postorius Documentation] - The upstream documentation
* [https://docs.mailman3.org/en/latest/ Mailman Suite Documentation] - The (high level) upstream documentation for the entire Mailman Suite (Mailman, Hyperkitty and Postorius)

← 古い版		2023年9月1日 (金) 19:38時点における版
120行目:		120行目:
	{{ic\|Alias Domain}} を設定するためには、管理ユーザーでログインします (デフォルトでは {{ic\|postorius}}) し、{{ic\|Domains}} メニューでドメインの設定を変更します。		{{ic\|Alias Domain}} を設定するためには、管理ユーザーでログインします (デフォルトでは {{ic\|postorius}}) し、{{ic\|Domains}} メニューでドメインの設定を変更します。

	== ~~See also~~ ==		== 参照 ==

	* [https://postorius.readthedocs.io/en/latest/ Postorius ~~Documentation~~] - ~~The upstream documentation~~		* [https://postorius.readthedocs.io/en/latest/ Postorius ドキュメンテーション] - アップストリームのドキュメンテーション
	* [https://docs.mailman3.org/en/latest/ Mailman Suite ~~Documentation~~] - ~~The (high level) upstream documentation for the entire~~ Mailman Suite (Mailman, Hyperkitty ~~and~~ Postorius)		* [https://docs.mailman3.org/en/latest/ Mailman Suite ドキュメンテーション] - Mailman Suite (Mailman, Hyperkitty および Postorius) 全体に関する (高レベルの) アップストリームドキュメンテーション