ArchWiki - 利用者の投稿記録 [ja]

ISCSI/LIO

2024-06-08T08:13:43Z

Teasoak: python-configshell-fbがaurからExtra入りしていたためリンクを変更

{{Lowercase title}}
[[Category:ストレージ]]
[[Category:ネットワーク]]
[[en:ISCSI/LIO]]
[[zh-hans:ISCSI Target]]
{{Related articles start}}
{{Related|iSCSI イニシエータ}}
{{Related|iSCSI ブート}}
{{Related articles end}}
[http://linux-iscsi.org/ LIO]{{Dead link|2022|12|31|接続不可; 3週間前の Web アーカイブ版}} (LinuxIO) は、カーネル内の [[iSCSI]] ターゲットです（Linux 2.6.38 以降）。

== インストール ==

iSCSI ターゲットファブリックは Linux 3.1 から含まれています。

重要なカーネルモジュールは ''target_core_mod'' と ''iscsi_target_mod'' であり、これらはカーネルに組み込まれており、自動的にロードされるべきです。

フリーブランチのパッケージ {{AUR|targetcli-fb}}、{{AUR|python-rtslib-fb}}、および {{Pkg|python-configshell-fb}} の使用が強く推奨されます。

必要なモジュールをロードし、configfs をマウントし、以前に保存された iSCSI ターゲット設定をロードするために、{{AUR|python-rtslib-fb}} に含まれる {{ic|target.service}} を[[開始/有効化]]してください。

== targetcli ==
外部マニュアルは''フリーブランチ''にしか存在しません。[https://github.com/agrover/targetd targetd] は AUR に存在しませんが、フリーブランチに依存しています。

設定シェルはほとんどの名前と数字を自動的に作成しますが、自分で設定することもできます。シェルの中で {{ic|help}} と入力することで実行できるコマンドを確認できます。
{{Tip|
* シェルではタブ補完が利用できます。シェルに {{ic|cd}} と入力するとパスが表示・選択されます。}}

ターゲットの起動後、以下のコマンドで設定シェルを開くことができます:
# targetcli
シェルの中では以下のようにして使用するブロックデバイスを指定できます (例: {{ic|/dev/disk/by-id/md-name-nas:iscsi}}):
/> cd backstores/block
/backstores/block> create md_block0 /dev/disk/by-id/md-name-nas:iscsi
{{Note|ブロックデバイスであれば [[RAID]] や [[LVM]] でも使用できます。block ではなく fileio を使用するのであればファイルも使えます。}}

iSCSI Qualified Name (IQN) とターゲットポータルグループ (TPG) を作成するには:
...> cd /iscsi
/iscsi> create
{{Note|{{ic|create}} にお好きな IQN を付けることで targetcli で自動的に IQN を作成することができます。}}

ターゲットの''バックストア''としてブロックデバイスを使用することを LIO に伝えるには以下を実行:
{{Note|{{ic|cd}} で {{ic|<iqn>/tpg1}} のパスを選択できます。}}
.../tpg1> cd luns
.../tpg1/luns> create /backstores/block/md_block0

それから''ポータル''を作成して、デーモンが接続を待機するようにしてください:
.../luns/lun0> cd ../../portals
.../portals> create
targetcli は LIO が接続を listen する IP とポートを表示します (デフォルトは 0.0.0.0 (all) です)。最低でもクライアントの IP が必要です。ポートは標準ポートの 3260 にするべきです。

クライアント/[[iSCSI イニシエータ|イニシエータ]]から接続するにはターゲットの設定にイニシエータの IQN を記述する必要があります:
...> cd ../../acls
.../acls> create iqn.2005-03.org.open-iscsi:SERIAL
{{ic|iqn.2005-03.org.open-iscsi:SERIAL}} はイニシエータの IQN に置き換えてください。通常は {{ic|/etc/iscsi/initiatorname.iscsi}} で確認できます。接続する全てのイニシエータを設定してください。targetcli は作成済みの LUN を新しく作成した ACL に自動的にマッピングします。
{{Note|マッピング済みの LUN を変更したり読み書きアクセスから読み取り専用に変えることができます。詳しくは targetcli シェルで {{ic|help create}} を実行してください。}}

最後に設定を保存します:
...> cd /
/> saveconfig
上記のコマンドで {{ic|/etc/target/saveconfig.json}} に設定が作成されます。これで設定を失うことなく {{ic|target.service}} を安全に起動・停止することが可能になります。
{{Tip|{{ic|saveconfig}} にパラメータとしてファイル名を指定することができます。また、{{ic|clearconfig}} で設定を消去できます。}}

==== 認証 ====
デフォルトで CHAP によるターゲットの認証が有効になっています。パスワードを設定したり、逆に認証を無効化することができます。

===== 認証の無効化 =====
targetcli でターゲットまで移動して ({{ic|/iscsi/iqn.../tpg1}})、以下のコマンドを実行してください:
.../tpg1> set attribute authentication=0
{{Warning|認証を無効化するとクライアント (イニシエータ) の IQN を知っていれば誰でもターゲットにアクセスできるようになります。あくまでテストあるいは家庭環境で行ってください。}}
===== 認証情報の設定 =====
ターゲットの ACL に移動して ({{ic|/iscsi/iqn.../tpg1/acls/iqn.../}})、以下のコマンドを実行すると現在の認証情報が表示されます:
...> get auth
以下のようにして認証情報を設定してください:
...> set auth userid=<username in target>
...> set auth password=<password in target>
...> set auth mutual_userid=<username in initiator> (optional)
...> set auth mutual_password=<password in initiator> (optional)

最初の2つはターゲットのユーザー名とパスワードです。設定したユーザー名とパスワードを使用してイニシエータはターゲットにログインします。("mutual_" と付いている) 残りの2つはイニシエータのユーザー名とパスワードです (全てのイニシエータは同じユーザー名とパスワードを使います)。イニシエータのユーザー名とパスワードは任意のパラメータであり、イニシエータは許可されたターゲットからの接続だけを通すようになります。

== ヒントとテクニック ==
* {{ic|targetcli sessions}} で現在開いているセッションを確認できます。このコマンドは {{AUR|targetcli-fb}} パッケージには含まれていますが ''lio-utils'' やオリジナルの ''targetcli'' には存在しません。

== 参照 ==
* [http://www.linux-iscsi.org/wiki/Targetcli targetcli]
* [[永続的なブロックデバイスの命名]]: 適切なターゲットのブロックデバイスを使用。

仮想ユーザーメールシステム

2023-04-14T15:09:04Z

Teasoak: 必要なインストールパッケージを追記

[[Category:メールサーバー]]
[[en:Virtual user mail system]]
{{Related articles start}}
{{Related|Courier MTA}}
{{Related|OpenDKIM}}
{{Related|Postfix}}
{{Related|SOGo}}
{{Related articles end}}
この記事では Arch Linux 環境に完全な仮想ユーザーメールシステムを出来る限りシンプルにセットアップする方法を説明しています。シンプルとはいえ、メールシステムは多数の複雑なコンポーネントによって構成されるため、必要な設定の数は大量です。

この記事で使用するコンポーネントを並べると、メールサーバーは Postfix、IMAP サーバーは Dovecot、ウェブメールインターフェイスは Roundcube、全てを管理する管理インターフェイスは PostfixAdmin です。

最新のセキュリティを利用して SMTP と SMTPS を使ってメールを送ったり POP3, POP3S, IMAP, IMAPS を使ってメールを受信できるようになるのが最終的な目標です。PostfixAdmin を利用することで設定は最小限に留め、ユーザーは Roundcube を使ってログインできるようにします。

== インストール ==
まず最初に、[[MySQL]] の記事に書かれているように MySQL サーバーをセットアップして、[[Postfix]] の記事に従って Postfix サーバーを設定してください。

そして {{Pkg|dovecot}} と {{Pkg|roundcubemail}} パッケージを[[インストール]]します。また、postfixからmysqlにアクセスするため {{Pkg|postfix-mysql}} パッケージをインストールしてください。

== 設定 ==
=== ユーザー ===
セキュリティの観点から、メールを保存するための新しいユーザーを作成します:
# groupadd -g 5000 vmail
# useradd -u 5000 -g vmail -s /usr/bin/nologin -d /home/vmail -m vmail
通常ユーザーと衝突が発生しないように gid と uid は5000にしています。メールは全て {{ic|/home/vmail}} に保存されます。ホームディレクトリから {{ic|/var/mail/vmail}} などに変更することはできますが、以下で設定を作成するときに注意してください。

=== データベース ===
空のデータベースとユーザーを作成する必要があります。この記事では、例としてユーザー ''postfix_user'' がデータベース ''postfix_db'' にパスワード ''hunter2'' で読み書きアクセスできるようにします。データベースとユーザーを作成したら、以下のようにデータベースを使用する権限を与えます:

{{hc|$ mysql -u root -p|
CREATE DATABASE postfix_db;
GRANT ALL ON postfix_db.* TO 'postfix_user'@'localhost' IDENTIFIED BY 'hunter2';
FLUSH PRIVILEGES;
}}

次に PostfixAdmin のセットアップページを開きます。PostfixAdmin で必要なテーブルとユーザーを作成してください。

==== PostfixAdmin ====
[[Postfix#PostfixAdmin]] を見てください。

=== SSL 証明書 ===
メール通信を暗号化させるために SSL 証明書が必要になります (SMTPS/IMAPS/POP3S)。証明書を持っていない場合、作成してください:
# cd /etc/ssl/private/
# openssl req -new -x509 -nodes -newkey rsa:4096 -keyout vmail.key -out vmail.crt -days 1460 #days are optional
# chmod 400 vmail.key
# chmod 444 vmail.crt

Alternatively, create a free trusted certificate using [[Let's Encrypt]]. The private key will be in {{ic|/etc/letsencrypt/live/''yourdomain''/privkey.pem}}, the certificate in {{ic|/etc/letsencrypt/live/''yourdomain''/fullchain.pem}}. Either change the configuration accordingly, or symlink the keys to {{ic|/etc/ssl/private}}:
# ln -s /etc/letsencrypt/live/''yourdomain''/privkey.pem /etc/ssl/private/vmail.key
# ln -s /etc/letsencrypt/live/''yourdomain''/fullchain.pem /etc/ssl/private/vmail.crt

=== Postfix ===

以下の設定をコピーアンドペーストする前に、{{ic|relay_domains}} が設定されていることを確認してください。複数のドメインを設定している場合、実行時に警告が表示されます。

{{Warning|{{ic|<nowiki>relay_domains</nowiki>}} は危険です。知らない人のメールを Postfix で転送してしまう可能性があります。{{ic|<nowiki>$mydestination</nowiki>}} は妥当なデフォルト値です。Postfix を起動する前に値をよく確認してください。http://www.postfix.org/BASIC_CONFIGURATION_README.html#relay_to を参照。}}

また、SSL 証明書のパスも正しいか確認してください。

==== Postfix の設定 ====

{{ic|/etc/postfix/main.cf}} に以下を追加:
relay_domains = $mydestination
virtual_alias_maps = proxy:mysql:/etc/postfix/virtual_alias_maps.cf
virtual_mailbox_domains = proxy:mysql:/etc/postfix/virtual_mailbox_domains.cf
virtual_mailbox_maps = proxy:mysql:/etc/postfix/virtual_mailbox_maps.cf
virtual_mailbox_base = /home/vmail
virtual_mailbox_limit = 512000000
virtual_minimum_uid = 5000
virtual_transport = virtual
virtual_uid_maps = static:5000
virtual_gid_maps = static:5000
local_transport = virtual
local_recipient_maps = $virtual_mailbox_maps
transport_maps = hash:/etc/postfix/transport

smtpd_sasl_auth_enable = yes
smtpd_sasl_type = dovecot
smtpd_sasl_path = /var/run/dovecot/auth-client
smtpd_recipient_restrictions = permit_mynetworks, permit_sasl_authenticated, reject_unauth_destination
smtpd_relay_restrictions = permit_mynetworks, permit_sasl_authenticated, reject_unauth_destination
smtpd_sasl_security_options = noanonymous
smtpd_sasl_tls_security_options = $smtpd_sasl_security_options
smtpd_tls_security_level = may
smtpd_tls_auth_only = yes
smtpd_tls_received_header = yes
smtpd_tls_cert_file = /etc/ssl/private/vmail.crt
smtpd_tls_key_file = /etc/ssl/private/vmail.key
smtpd_sasl_local_domain = $mydomain
broken_sasl_auth_clients = yes
smtpd_tls_loglevel = 1
smtp_tls_security_level = may
smtp_tls_loglevel = 1

* 上記の設定で {{ic|virtual_mailbox_domains}} はメールを受信したいドメインのリストになります。{{ic|mydestination}} に設定したドメインを含めてはいけません。{{ic|mydestination}} はローカルホストだけで使うからです。

* {{ic|virtual_mailbox_maps}} には仮想ユーザーとメールボックスのディレクトリの情報を記述します。ハッシュファイルを使って永続的なマップを保存することで、MySQL データベースの転送を上書きします。

* {{ic|virtual_mailbox_base}} は仮想メールボックスを保存するベースディレクトリになります。

{{ic|virtual_uid_maps}} と {{ic|virtual_gid_maps}} は仮想メールを所有する実際のシステムユーザーの ID になります。ストレージ目的に使用します。

{{note|ウェブインターフェイス (Roundcube) を使用するため、他の方法でアクセスできないようにし、ログイン権限を与えずにアカウントを作成します。}}

==== 設定ファイルの作成 ====

以下の新しい設定では、まだ存在しない大量のファイルを参照しています。それらのファイルは次のステップから作成していきます。

PostfixAdmin でデータベースを設定して PostfixAdmin でデータベーススキーマを作成した場合、以下のファイルが作成できます。パスワードは必ず変更するようにしてください:

{{hc|/etc/postfix/virtual_alias_maps.cf|<nowiki>
user = postfix_user
password = hunter2
hosts = localhost
dbname = postfix_db
table = alias
select_field = goto
where_field = address
</nowiki>}}

{{hc|/etc/postfix/virtual_mailbox_domains.cf|<nowiki>
user = postfix_user
password = hunter2
hosts = localhost
dbname = postfix_db
table = domain
select_field = domain
where_field = domain
</nowiki>}}

{{hc|/etc/postfix/virtual_mailbox_maps.cf|<nowiki>
user = postfix_user
password = hunter2
hosts = localhost
dbname = postfix_db
table = mailbox
select_field = maildir
where_field = username
</nowiki>}}

For alias domains functionality adjust the following files:

{{hc|/etc/postfix/main.cf|<nowiki>
virtual_alias_maps = proxy:mysql:/etc/postfix/virtual_alias_maps.cf,proxy:mysql:/etc/postfix/virtual_alias_domains_maps.cf
virtual_alias_domains = proxy:mysql:/etc/postfix/virtual_alias_domains.cf
</nowiki>}}

{{hc|/etc/postfix/virtual_alias_domains_maps.cf|<nowiki>
user = postfix_user
password = hunter2
hosts = localhost
dbname = postfix_db
query = SELECT goto FROM alias,alias_domain WHERE alias_domain.alias_domain = '%d' and alias.address = CONCAT('%u', '@', alias_domain.target_domain) AND alias.active = '1' AND alias_domain.active='1'
</nowiki>}}

{{hc|/etc/postfix/virtual_alias_domains.cf|<nowiki>
user = postfix_user
password = hunter2
hosts = localhost
dbname = postfix_db
query = SELECT alias_domain FROM alias_domain WHERE alias_domain='%s' AND active = '1'
</nowiki>}}

{{Note|PostfixAdmin を使わずにセットアップする場合、以下のファイルを作成してください。}}

{{hc|/etc/postfix/virtual_alias_maps.cf|<nowiki>
user = postfix_user
password = hunter2
hosts = localhost
dbname = postfix_db
table = domains
select_field = virtual
where_field = domain
</nowiki>}}

{{hc|/etc/postfix/virtual_mailbox_domains.cf|<nowiki>
user = postfix_user
password = hunter2
hosts = localhost
dbname = postfix_db
table = forwardings
select_field = destination
where_field = source
</nowiki>}}

{{hc|/etc/postfix/virtual_mailbox_maps.cf|<nowiki>
user = postfix_user
password = hunter2
hosts = localhost
dbname = postfix_db
table = users
select_field = concat(domain,'/',email,'/')
where_field = email
</nowiki>}}

''transport'' で ''postmap'' を実行してデータベースを生成:
# postmap /etc/postfix/transport

=== Dovecot ===

Dovecot のサンプル設定ファイルは使わずに、{{ic|/etc/dovecot/dovecot.conf}} を作成します。ユーザーとグループは postfix ではなく vmail になるので注意してください。

{{hc|/etc/dovecot/dovecot.conf|<nowiki>
protocols = imap pop3
auth_mechanisms = plain
passdb {
driver = sql
args = /etc/dovecot/dovecot-sql.conf
}
userdb {
driver = sql
args = /etc/dovecot/dovecot-sql.conf
}

service auth {
unix_listener auth-client {
group = postfix
mode = 0660
user = postfix
}
user = root
}

mail_home = /home/vmail/%d/%n
mail_location = maildir:~

ssl_cert = </etc/ssl/private/vmail.crt
ssl_key = </etc/ssl/private/vmail.key
</nowiki>}}

{{note|{{ic|dovecot.conf.sample}} を修正して使いたい場合、デフォルト設定ファイルでは {{ic|conf.d/*.conf}} の中身がインポートされていることに注意してください。上記の設定例では存在しない他のファイルが使われることになります。}}

次に上の設定で参照した {{ic|/etc/dovecot/dovecot-sql.conf}} を作成します。あなたのシステム設定にあわせて以下の設定が正しいか確認してください。

PostfixAdmin を使用する場合、以下を追加:

{{hc|/etc/dovecot/dovecot-sql.conf|<nowiki>
driver = mysql
connect = host=localhost dbname=postfix_db user=postfix_user password=hunter2
# It is highly recommended to not use deprecated MD5-CRYPT. Read more at https://wiki2.dovecot.org/Authentication/PasswordSchemes
default_pass_scheme = SHA512-CRYPT
# Get the mailbox
user_query = SELECT '/home/vmail/%d/%n' as home, 'maildir:/home/vmail/%d/%n' as mail, 5000 AS uid, 5000 AS gid, concat('dirsize:storage=', quota) AS quota FROM mailbox WHERE username = '%u' AND active = '1'
# Get the password
password_query = SELECT username as user, password, '/home/vmail/%d/%n' as userdb_home, 'maildir:/home/vmail/%d/%n' as userdb_mail, 5000 as userdb_uid, 5000 as userdb_gid FROM mailbox WHERE username = '%u' AND active = '1'
# If using client certificates for authentication, comment the above and uncomment the following
#password_query = SELECT null AS password, ‘%u’ AS user
</nowiki>}}

PostfixAdmin を使用しない場合、以下を使用:

{{hc|/etc/dovecot/dovecot-sql.conf|<nowiki>
driver = mysql
connect = host=localhost dbname=postfix_db user=postfix_user password=hunter2
# It is highly recommended to not use deprecated MD5-CRYPT. Read more at https://wiki2.dovecot.org/Authentication/PasswordSchemes
default_pass_scheme = SHA512-CRYPT
# Get the mailbox
user_query = SELECT '/home/vmail/%d/%n' as home, 'maildir:/home/vmail/%d/%n' as mail, 5000 AS uid, 5000 AS gid, concat('dirsize:storage=', quota) AS quota FROM users WHERE email = '%u'
# Get the password
password_query = SELECT email as user, password, '/home/vmail/%d/%n' as userdb_home, 'maildir:/home/vmail/%d/%n' as userdb_mail, 5000 as userdb_uid, 5000 as userdb_gid FROM users WHERE email = '%u'
# If using client certificates for authentication, comment the above and uncomment the following
#password_query = SELECT null AS password, ‘%u’ AS user
</nowiki>}}

{{tip |Dovecot の変数に関する詳細は https://wiki2.dovecot.org/Variables を参照。}}

==== DH parameters ====

With v2.3 you are required to provide {{ic|1=ssl_dh = </path/to/dh.pem}} yourself.

To generate a new DH parameters file (this will take very long):

# openssl dhparam -out /etc/dovecot/dh.pem 4096

then add the file to {{ic|/etc/dovecot/dovecot.conf}}

ssl_dh = </etc/dovecot/dh.pem

=== PostfixAdmin ===
[[Postfix#PostfixAdmin]] を見てください。

{{ic|config.inc.php}} には以下の設定が必要です:

{{hc|/etc/postfixadmin/config.inc.php|<nowiki>
...
$CONF['domain_path'] = 'YES';
$CONF['domain_in_mailbox'] = 'NO';
...</nowiki>}}

=== Roundcube ===

{{ic|php.ini}} ファイルで {{ic|pdo_mysql.so}} と {{ic|iconv.so}} 拡張をアンコメントしてください。また、{{ic|.htaccess}} のアクセス制限も確認してください。ブラウザで {{ic|http://localhost/roundcube/installer/}} を開いて指示に従います。

Roundcube には別個にデータベースが必要になります。Roundcube と PostfixAdmin で同じデータベースを使うことはできません。新しいデータベース {{ic|roundcube_db}} と新しいユーザー {{ic|roundcube_user}} を作成してください。

インストーラーの実行時は以下の事柄に注意してください:

* IMAP ホストのアドレスは {{ic|ssl://localhost/}} あるいは {{ic|tls://localhost/}} になります。{{ic|localhost}} ではありません。
* ポートは {{ic|993}} を使ってください。SMTP と同じです。
* ラッパーモードを使用する場合は {{ic|ssl://localhost/}} でポートは {{ic|465}} にしてください。
* プロパー TLS モードを使用する場合は {{ic|tls://localhost/}} でポートは {{ic|587}} にしてください。
* 上記設定に関する説明は[[#Postfix|こちら]]を参照。

インストール後の作業は [[PhpMyAdmin]] や PostFixAdmin などのウェブアプリと同じです。設定ファイルは {{ic|/etc/webapps/roundcubemail/config/config.inc.php}} にあり、{{ic|default.inc.php}} を上書きします。

==== Apache の設定 ====

Apache を使用する場合、サンプル設定ファイルをウェブサーバーの設定ディレクトリにコピーしてください:

# cp /etc/webapps/roundcubemail/apache.conf /etc/httpd/conf/extra/httpd-roundcubemail.conf

そして以下を追加:

{{hc|/etc/httpd/conf/httpd.conf|<nowiki>
Include conf/extra/httpd-roundcubemail.conf
</nowiki>}}

==== Roundcube: パスワード変更プラグイン ====

Roundcube からユーザーのパスワードを変更できるようにするには、以下を実行:

以下の行を追加して password プラグインを有効化:

{{hc|/etc/webapps/roundcubemail/config/config.inc.php|<nowiki>
$rcmail_config['plugins'] = array('password');
</nowiki>}}

password プラグインを設定して設定を変更できることを確認:

{{hc|/usr/share/webapps/roundcubemail/plugins/password/config.inc.php|<nowiki>
<?php

$config['password_driver'] = 'sql';
$config['password_db_dsn'] = 'mysql://<postfix_database_user>:<password>@localhost/<postfix_database_name>';
// If you are not using dovecot specify another algorithm explicitly e.g 'sha256-crypt'
$config['password_algorithm'] = 'dovecot';
// For dovecot salted passwords only (above must be set to 'dovecot')
// $config['password_algorithm_prefix'] = 'true';
// $config['password_dovecotpw'] = 'doveadm pw';
// $config['password_dovecotpw_method'] = 'SHA512-CRYPT';
// $config['password_dovecotpw_with_method'] = true;
$config['password_query'] = 'UPDATE mailbox SET password=%P WHERE username=%u';
</nowiki>}}

== 起動 ==
必要なデーモン全てを起動して設定をテストしてください。{{ic|postfix}} と {{ic|dovecot}} の両方を[[起動]]します。

テスト用に、PostfixAdmin でドメインとメールアカウントを作成してください。作成したアカウントに Roundcube でログインして、自分自身にメールを送ってください。

== Testing ==

{{Style|Needs some cleanup. There are probably more general ways to write this.}}

Now lets see if Postfix is going to deliver mail for our test user.
{{bc|
nc servername 25
helo testmail.org
mail from:<test@testmail.org>
rcpt to:<cactus@virtualdomain.tld>
data
This is a test email.
.
quit
}}

=== Error response ===

451 4.3.0 <lisi@test.com>:Temporary lookup failure
Maybe you have entered the wrong user/password for MySQL or the MySQL socket is not in the right place.

This error will also occur if you neglect to run newaliases at least once before starting postfix. MySQL is not required for local only usage of postfix.

550 5.1.1 <email@spam.me>: Recipient address rejected: User unknown in virtual mailbox table.
Double check content of mysql_virtual_mailboxes.cf and check the main.cf for mydestination

=== See that you have received a email ===

Now type {{ic|$ find /home/vmailer}}.

You should see something like the following:
{{bc|
/home/vmailer/virtualdomain.tld/cactus@virtualdomain.tld
/home/vmailer/virtualdomain.tld/cactus@virtualdomain.tld/tmp
/home/vmailer/virtualdomain.tld/cactus@virtualdomain.tld/cur
/home/vmailer/virtualdomain.tld/cactus@virtualdomain.tld/new
/home/vmailer/virtualdomain.tld/cactus@virtualdomain.tld/new/1102974226.2704_0.bonk.testmail.org
}}
The key is the last entry. This is an actual email, if you see that, it is working.

== 任意設定 ==
以下の設定は必須ではありませんが、セットアップを完全にします。

=== クォータ ===
Dovecot によるメールボックスのクォータを有効にするには、以下を実行:
*まずは {{ic|/etc/dovecot/dovecot.conf}} に以下の行を追加:
dict {
quotadict = mysql:/etc/dovecot/dovecot-dict-sql.conf.ext
}
service dict {
unix_listener dict {
group = vmail
mode = 0660
user = vmail
}
user = root
}
service quota-warning {
executable = script /usr/local/bin/quota-warning.sh
user = vmail
unix_listener quota-warning {
group = vmail
mode = 0660
user = vmail
}
}
mail_plugins=quota
protocol pop3 {
mail_plugins = quota
pop3_client_workarounds = outlook-no-nuls oe-ns-eoh
pop3_uidl_format = %08Xu%08Xv
}
protocol lda {
mail_plugins = quota
postmaster_address = postmaster@yourdomain.com
}
protocol imap {
mail_plugins = $mail_plugins imap_quota
mail_plugin_dir = /usr/lib/dovecot/modules
}
plugin {
quota = dict:User quota::proxy::quotadict
quota_rule2 = Trash:storage=+10%%
quota_warning = storage=100%% quota-warning +100 %u
quota_warning2 = storage=95%% quota-warning +95 %u
quota_warning3 = storage=80%% quota-warning +80 %u
quota_warning4 = -storage=100%% quota-warning -100 %u # user is no longer over quota
}

*{{ic|/etc/dovecot/dovecot-dict-sql.conf.ext}} を以下の内容で作成:
connect = host=localhost dbname=yourdb user=youruser password=yourpassword
map {
pattern = priv/quota/storage
table = quota2
username_field = username
value_field = bytes
}
map {
pattern = priv/quota/messages
table = quota2
username_field = username
value_field = messages
}
*警告スクリプト {{ic|/usr/local/bin/quota-warning.sh}} を作成して実行可能属性を付与。警告スクリプトは postfix の lmtp 設定で動作します。
<pre> #!/bin/sh
BOUNDARY="$1"
USER="$2"
MSG=""
if [[ "$BOUNDARY" = "+100" ]]; then
MSG="Your mailbox is now overfull (>100%). In order for your account to continue functioning properly, you need to remove some emails NOW."
elif [[ "$BOUNDARY" = "+95" ]]; then
MSG="Your mailbox is now over 95% full. Please remove some emails ASAP."
elif [[ "$BOUNDARY" = "+80" ]]; then
MSG="Your mailbox is now over 80% full. Please consider removing some emails to save space."
elif [[ "$BOUNDARY" = "-100" ]]; then
MSG="Your mailbox is now back to normal (<100%)."
fi

cat << EOF | /usr/lib/dovecot/dovecot-lda -d $USER -o "plugin/quota=maildir:User quota:noenforcing"
From: postmaster@yourdomain.com
Subject: Email Account Quota Warning

Dear User,

$MSG

Best regards,
Your Mail System
EOF
</pre>

*以下のように {{ic|dovecot-sql.conf}} の user_query を変更して iterat_query を追加:
user_query = SELECT '/home/vmail/%d/%n' as home, 'maildir:/home/vmail/%d/%n' as mail, 5000 AS uid, 5000 AS gid, concat('*:bytes=', quota) AS quota_rule FROM mailbox WHERE username = '%u' AND active = '1'
iterate_query = SELECT username AS user FROM mailbox
*上記と同じように SpamAssassin で LDA を設定。SpamAssassin を使っていない場合、{{ic|/etc/postfix/master.cf}} のパイプは以下のようになります:
dovecot unix - n n - - pipe
flags=DRhu user=vmail:vmail argv=/usr/lib/dovecot/deliver -f ${sender} -d ${recipient}
上と同じように Postfix の {{ic|main.cf}} で有効にしてください:
virtual_transport = dovecot
*postfixadmin のメールボックスごとにクォータを設定することができます。{{ic|config.inc.php}} に以下のような行を設定してください:
$CONF['quota'] = 'YES';
$CONF['quota_multiplier'] = '1024000';

postfix と dovecot サービスを再起動してください。問題がなければ、以下のコマンドで全てのユーザーのクォータと使用率を確認できます:
doveadm quota get -A
roundcube でもクォータを確認できるはずです。

== 注記 ==

=== vmail フォルダの構造を変更する ===

{{ic|/home/vmail/example.com/user@example.com}} のようなディレクトリを使う代わりに {{ic|select_field}} と {{ic|where_field}} を以下のように置き換えることで (ドメイン名が付かない) わかりやすいサブディレクトリを使えます:
{{bc|1=query = SELECT CONCAT(SUBSTRING_INDEX(email,'@',-1),'/',SUBSTRING_INDEX(email,'@',1),'/') FROM users WHERE email='%s'}}

== トラブルシューティング ==

=== IMAP/POP3 クライアントがメールを受け取れない ===

エラーが表示される場合、{{ic|/var/log/mail.log}} を確認したり {{ic|journalctl -xn --unit postfix.service}} で詳しく出力をチェックしてください。

待機中のメールが存在する場合 Maildir の {{ic|/home/vmail/mail@domain.tld}} が作成中ということもあります。そうでない場合は先にディレクトリを作成する必要はありません。

=== Roundcube でメールを削除したり 'standard' フォルダを表示できない ===

Roundcube の {{ic|config.inc.php}} ファイルに以下が記述されていることを確認してください:

{{bc|1=
$rcmail_config['default_imap_folders'] = array('INBOX', 'Drafts', 'Sent', 'Junk', 'Trash');
$rcmail_config['create_default_folders'] = true;
$rcmail_config['protect_default_folders'] = true;
}}

== See also ==

* [https://wiki.gentoo.org/wiki/Complete_Virtual_Mail_Server/ja| Gentoo 完璧な仮想メールサーバ]

AUR 投稿ガイドライン

2023-03-16T15:43:12Z

Teasoak: 誤字の修正

[[Category:Arch について]]
[[Category:パッケージ開発]]
[[Category:パッケージ管理]]
[[en:AUR submission guidelines]]
[[pt:AUR submission guidelines]]
[[ru:AUR submission guidelines]]
[[zh-hans:AUR submission guidelines]]
{{Related articles start}}
{{Related|Arch User Repository}}
{{Related|Arch パッケージガイドライン}}
{{Related|AUR Trusted User ガイドライン}}
{{Related articles end}}

ユーザーは [[Arch User Repository]] を使って PKGBUILD を'''シェア'''することができます。AUR にはバイナリパッケージはありませんが、他のユーザがダウンロードできる PKGBUILD をアップロードできます。これらの PKGBUILD は完全に非公式なものであり、徹底して管理されてはいないので、自己責任において使うことになります。

== パッケージを投稿する ==

{{Warning|パッケージを投稿する前に、[[Arch パッケージングスタンダード]] や「関連記事」の記事すべてを熟知していることが期待されます。あなたのアップロードしようとしているものが正しいことを '''慎重に検証してください'''。規則に違反するパッケージは、警告も無く '''削除される''' 場合があります。}}

このセクションを2度読んでもパッケージやビルド/投稿のプロセスに分からないことがあれば、AUR に投稿する前に、[https://lists.archlinux.org/mailman3/lists/aur-general.lists.archlinux.org/ AUR メーリングリスト]や Arch フォーラムの [https://bbs.archlinux.org/viewforum.php?id=4 AUR フォーラム]に PKGBUILD を投稿するか、[[IRC チャンネル]] で公開レビューを依頼してください。

=== 投稿の規則 ===

パッケージを AUR に投稿する際には、以下のルールを守りましょう:

* 投稿する PKGBUILD は、いかなる状況であっても、'''公式''' バイナリ '''リポジトリ'''に '''すでに存在する''' アプリケーションをビルドするものであってはいけません。[https://archlinux.org/packages/ 公式パッケージデータベース]でパッケージをチェックしてください。そのパッケージの任意のバージョンが存在する場合、そのパッケージを投稿'''しないでください'''。公式のパッケージが out-of-date である場合、そのフラグを立ててください。公式のパッケージが壊れている、あるいは機能不足である場合、[https://bugs.archlinux.org/ バグレポート]を提出してください。

:この厳格な規則の'''例外'''は、パッケージが公式のパッケージと比べて '''追加の機能''' が有効化されていたり '''パッチ''' が当てられていたりする場合のみです。そのような場合は、{{ic|pkgname}} が、その違いを表すように異なっているべきです。例えば、サイドバーのパッチを適用した GNU screen のパッケージは {{ic|screen-sidebar}} などと名前を付けます。さらに、公式パッケージと衝突しないようにするため {{ic|1=provides=('screen')}} を使ってください。

* そのパッケージが'''すでに存在してないか''' '''AUR をチェックしてください'''。メンテナンスされているパッケージがあるのならば、コメントからメンテナに修正を求めることができます。パッケージがメンテナンスされておらず、かつメンテナが応答しないならば、必要に応じてそのパッケージを継承し、更新することができます。重複したパッケージを作成しないでください。

* 投稿するパッケージが皆の'''役に立つ'''か考えて下さい。他の誰かがそのパッケージを使おうと考えるでしょうか？あまりにも特殊化しすぎていませんか？少なからぬ人が役に立つと思うようなパッケージであれば、投稿するのにふさわしいでしょう。

:AUR と公式リポジトリは、一般的にソフトウェアやソフトウェアに関連するコンテンツをインストールするパッケージのために存在します。該当するコンテンツとしては次のものが含まれます: 実行可能ファイル、設定ファイル、特定のソフトウェアもしくは Arch Linux ディストリビューション全体のオンライン・オフラインのドキュメント、ソフトウェアによって直接使用されるメディア。

* AUR の PKGBUILD で {{ic|replaces}} を使うのはパッケージの名前を変更したいときです。例えば ''Ethereal'' から ''Wireshark'' に名前が変更されたときのようにです。'''既存のパッケージの別バージョン'''としてパッケージを作成する場合、{{ic|conflicts}} を使ってください (他のパッケージから必要とされる場合は {{ic|provides}} も使ってください)。{{ic|conflicts}} と {{ic|replaces}} は、同期後 (-Sy) に pacman が即座にパッケージを置き換えるかどうかが違います。{{ic|conflicts}} はパッケージのインストール時にしか評価されません。

* '''ビルド済み'''の[[Wikipedia:ja:成果物|成果物]]を使うパッケージには、ソースコードが利用可能な場合は、{{ic|-bin}} サフィックスを付けなければなりません。この規則の例外として、[[Java パッケージガイドライン#パッケージング|Java]] を使う場合です。AUR には、makepkg によって作成されたバイナリ tarball や、filelist が含まれているべきではありません。

* {{ic|PKGBUILD}} ファイルのトップには、現在の '''メンテナ''' と以前の '''貢献者''' の情報を含む '''コメント行''' を、以下の形式に沿って追加してください。スパムから身を守るためにメールアドレスをぼかしましょう。追加/不必要な行は任意です。
:もしあなたが既存の PKGBUILD のメンテナの役割を引き受けるのであれば、以下のようにあなたの名前をトップに追加してください。
:{{bc|<nowiki>
# Maintainer: Your Name <address at domain dot tld>
</nowiki>}}
:以前のメンテナがいたのであれば、彼らを貢献者として追加してください。これがあなたでなければ、オリジナルの投稿者に対しても同様です。あなたが共同メンテナであるならば、現在の他のメンテナの名前も追加してください。
:{{bc|<nowiki>
# Maintainer: Your name <address at domain dot tld>
# Maintainer: Other maintainer's name <address at domain dot tld>
# Contributor: Previous maintainer's name <address at domain dot tld>
# Contributor: Original submitter's name <address at domain dot tld>
</nowiki>}}

=== 認証 ===

AUR への書き込みアクセス権を得るには、[[SSH 鍵|SSH 鍵のペア]]が必要です。公開鍵の内容は ''My Account'' のプロファイルにコピーする必要があります。対応する秘密鍵は {{ic|aur.archlinux.org}} ホスト用に設定してください。例えば:

{{hc|~/.ssh/config|
Host aur.archlinux.org
IdentityFile ~/.ssh/aur
User aur}}

何かが起こった時に SSH 鍵を選択的に無効化できるように、既存の SSH 鍵を使うのではなく、[[SSH 鍵#SSH 鍵のペアを生成|新しく鍵のペアを作成]]するべきです:

$ ssh-keygen -f ~/.ssh/aur

{{Tip|入力フィールドで改行することで複数の公開鍵をプロフィールに追加することができます。}}

=== パッケージのリポジトリを作成する ===

ゼロから[[パッケージの作成|新しいパッケージを作成]]しているのであれば、目的の [[PKGBUILD#pkgbase|pkgbase]] を[[Git|クローン]]して、ローカルの Git リポジトリと AUR リモートリポジトリを作る必要があります。パッケージがまだ存在しない場合、以下の警告が表示されるでしょう:

{{hc|$ git clone <nowiki>ssh://</nowiki>aur@aur.archlinux.org/''pkgbase''.git|
Cloning into '''pkgbase'''...
warning: You appear to have cloned an empty repository.
Checking connectivity... done.}}

{{Note|{{ic|''pkgbase''}} が[[#リクエスト|削除された]]パッケージとマッチする場合、リポジトリは空にはなりません。}}

すでにパッケージを持っている場合、それが Git リポジトリでないならば、Git リポジトリとして[[Git|初期化]]してください。そして AUR リモートリポジトリを追加してください:

$ git remote add ''label'' <nowiki>ssh://</nowiki>aur@aur.archlinux.org/''pkgbase''.git

次に、このリモートリポジトリを[[Git#リモートの使用|フェッチ]]して初期化してください。

{{Note|{{ic|''pkgbase''}} が削除されたパッケージとマッチする場合、衝突を解決するために [https://git-scm.com/docs/git-pull#git-pull---rebasefalsetruemergespreserveinteractive pull、rebase] してください。}}

=== 新しいパッケージコンテンツを公開する ===

{{Warning|あなたのコミットは、あなたの[[Git#設定|グローバルな Git の名前と email アドレス]]によって認証されます。コミットを、push した後に変更するのは非常に困難です ({{Bug|45425}})。別の認証情報を使って AUR に push したい場合、パッケージごとに {{ic|git config user.name "..."}} と {{ic|git config user.email "..."}} を使って認証情報を変更することができます。}}

パッケージングされたソフトウェアの新しいバージョンをリリースする際は、[[pkgver]] 変数か [[PKGBUILD#pkgrel|pkgrel]] 変数を更新して、すべてのユーザにアップグレードが必要であることを通知してください。typo の修正など、[[PKGBUILD]] のマイナーな変更だけの場合は、これらの値を更新しないでください。

[[VCS パッケージガイドライン|VSC パッケージ]]の単なる {{ic|pkgver}} バージョンアップはコミットしないでください。それらは、上流に新しいコミットがある場合に、out-of-date とみなされません。新しいコミットをするのは、他の変更 (ビルドプロセスの変更など) が発生した場合に限ります。

{{ic|PKGBUILD}} メタデータが変更された際 ({{ic|pkgver()}} が更新されたときなど) は必ず [[.SRCINFO]] を再生成してください。さもないと、AUR は更新後のバージョン番号を表示しません。

パッケージをアップロード/アップデートするには、''少なくとも'' {{ic|PKGBUILD}} と {{ic|.SRCINFO}} を、次に追加の新しい/変更された補助ファイル ([[PKGBUILD#install|''.install'']] ファイルや、[[パッケージにパッチを適用|パッチ]]などの[[PKGBUILD#source|ローカルのソースファイル]]) [[Git#ステージング|追加]]してください。そして、意味のあるコミットメッセージを付けて[[Git#変更をコミット|コミット]]し、最後に変更を AUR に[[Git#リポジトリにプッシュ|プッシュ]]してください。

例:

$ makepkg --printsrcinfo > .SRCINFO
$ git add PKGBUILD .SRCINFO
$ git commit -m "''useful commit message''"
$ git push

{{Note|
* {{ic|.SRCINFO}} が最初のコミットに含まれていなかった場合、[https://git-scm.com/docs/git-rebase#git-rebase---root --root で rebase する]か[https://git-scm.com/docs/git-filter-branch#git-filter-branch---tree-filterltcommandgt ツリーをフィルタリング]して追加してください。そうすれば、AUR は初期のプッシュを受け入れます。
* AUR は、{{ic|master}} ブランチへのプッシュのみを許可します。ローカルのブランチに他の名前をつけている場合、[https://git-scm.com/docs/git-branch 名前を変更し]、再びプッシュしてください。
}}

{{Tip|作業ディレクトリとコミットもを可能な限り綺麗に保つには、すべてのファイルを除外する {{man|5|gitignore}} を作成し、必要に応じてファイルを force-add してください。}}

== パッケージをメンテナンスする ==

* 他のユーザーからのコメントやフィードバックをチェックして、ときには提案を汲み上げるようにしましょう。学習過程だと考えて下さい。
* パッケージを更新する度にバージョン番号を含むコメントを投稿するのはやめてください。コメント欄は、上記で説明したような意味ある内容のために使って下さい。
* パッケージを投稿したらそのまま放置するのはやめてください。アップデートをチェックし、PKGBUILD を修正してパッケージをメンテナンスするのがメンテナの仕事です。
* 何らかの理由でパッケージのメンテナンスが続けられない場合は、AUR ウェブインタフェースでパッケージを {{ic|disown}} するか、メーリングリストにメッセージを投稿してください。AUR パッケージのメンテナがパッケージを放棄すると、パッケージは[https://aur.archlinux.org/packages/?SB=n&do_Orphans=Orphans "孤児"]パッケージになります。

== リクエスト ==

孤児リクエスト、消去リクエスト、マージリクエストは右側の "パッケージアクション" の下にある "リクエストを送る" リンクをクリックして作成することができます。リクエストが作成されると自動的に通知メールがパッケージの現在のメンテナと [https://lists.archlinux.org/mailman3/lists/aur-requests.lists.archlinux.org/ aur-requests メーリングリスト] に送信されます。その後 [[Trusted Users]] がリクエストの承認・却下を行います。
* 孤児リクエストは、現在のメンテナが応答しない場合、通るのに2週間掛かります。例外は、180 日間以上パッケージに out-of-date フラグが立てられている場合です。この場合、孤児リクエストは自動的に受理されます。
* マージリクエストは、パッケージベースを削除し、票とコメントを他のパッケージベースに転送します。マージ先のパッケージベースの名前が必要です。これは 'git merge' や GitLab のマージリクエストとは関係ないことに注意してください。
* 消去リクエストには以下の情報が必要です:
** 削除の理由を説明する短いノート。パッケージのコメント欄は、パッケージを削除する理由を説明するのに十分でないことに注意してください。TU が行動を起こしてすぐにそのような情報を入手できる場所は aur-requests メーリングリストだけだからです。
** 補足事項を加えて下さい。仮にあなたがメンテナならば、他のパッケージで提供されるようになった、パッケージ名を変えて元の管理者が認めた、など。
** パッケージが削除されたあとも、その Git リポジトリは AUR で利用可能なままです。

{{TranslationStatus|AUR submission guidelines|2022-10-29|754975}}

Misskey

2023-03-15T21:13:27Z

Teasoak: 英語版をもとに、翻訳記事を新規作成しました。

[[Category:ウェブアプリケーション]]
[[en:Misskey]]
{{Related articles start}}
{{Related|nginx}}
{{Related|PostgreSQL}}
{{Related articles end}}

[https://github.com/misskey-dev/misskey Misskey] は分散型ソーシャル・ネットワーキングプラットフォームです。[[Wikipedia:Mastodon|Mastodon]] のように、メッセージや写真、映像をを共有したり、他のサービスと接続できます。インスタンス間は [[Wikipedia:ActivityPub|ActivityPub]] で通信します。

この記事では、Misskeyのインストール方法とシンプルな設定について説明しています。詳細については [https://misskey-hub.net Misskey-Hub] を御覧ください。

== インストール ==

{{AUR|misskey}} と、リバースプロキシとなるウェブサーバーを [[インストール]] してください。

* {{Pkg|nginx}} (推奨) リバースプロキシ及びウェブサーバー
* {{Pkg|ffmpeg}} メディアのエンコードのため

== 設定 ==

=== default.conf ===

最初のステップは、 {{ic|default.conf}} を編集してサーバーを反映させることです。

{{hc|/etc/webapps/misskey/default.conf|url: https://example.tld/}}

設定値は、インターネットから到達可能なパブリックなURLである必要があります。推奨はしませんが、IPアドレスを使用することもできます。
{{Warning|変更するには、データベースをリセットする必要があります。}}

=== PostgreSQL ===

[[PostgreSQL]] を [[PostgreSQL#PostgreSQL_.E3.81.AE.E3.82.A4.E3.83.B3.E3.82.B9.E3.83.88.E3.83.BC.E3.83.AB|初期設定]]、 [[Systemd#.E3.83.A6.E3.83.8B.E3.83.83.E3.83.88.E3.82.92.E4.BD.BF.E3.81.86|起動]] します。
デフォルトでは、Misskeyが使用する5432ポートを使ってlocalhostに到達できる必要があります。他のポートを使う場合は、 {{ic|default.conf}} を修正する必要があります。

デフォルトでは、 {{AUR|misskey}} はシステムユーザー ''misskey'' を使ってデータベースに接続します。 [[PostgreSQL#.E6.9C.80.E5.88.9D.E3.81.AE.E3.83.87.E3.83.BC.E3.82.BF.E3.83.99.E3.83.BC.E3.82.B9.2F.E3.83.A6.E3.83.BC.E3.82.B6.E3.83.BC.E3.81.AE.E4.BD.9C.E6.88.90|PostgreSQL 最初のデータベース/ユーザーの作成]] を参照して、PostgreSQLのユーザー ''misskey'' とデータベース ''misskey'' を作成します。

=== Redis ===

[[redis]] サービスを [[Systemd#.E3.83.A6.E3.83.8B.E3.83.83.E3.83.88.E3.82.92.E4.BD.BF.E3.81.86|起動]] します。

=== Misskeyデータベースの初期化 ===

Misskeyを開始する前に、データベースを初期化する必要があります。

# /usr/bin/misskey -i
{{Note|外部のデータベースサーバーの場合は、ヘルパースクリプトのパラメータを {{ic|-I}} に変更して、PostgreSQLとRedisの可用性チェックを実施しないようにします。}}

== 起動 ==

[[misskey]] サービスを [[Systemd#.E3.83.A6.E3.83.8B.E3.83.83.E3.83.88.E3.82.92.E4.BD.BF.E3.81.86|起動]] します。

サーバーの {{ic|:3000}} ポートでサービスが利用可能になります。

最後のステップは、 [[Nginx]] のようなリバースプロキシを設定することです。 [https://misskey-hub.net Misskey-Hub] では [https://misskey-hub.net/en/docs/admin/nginx.html テンプレート] が提供されています。

== トラブルシューティング ==
=== データベースの手動アップデート（マイグレーション） ===
場合によっては、データベースが停止していたり、ローカルに利用可能なPostgreSQLデータベースが存在しないことがあるでしょう。そのようなときには、パッケージアップデートの際にマイグレーションが実行されないため、手動による実施が必要になります。PostgreSQLとRedisに到達できる状態になってから、ヘルパースクリプトからマイグレーションを実施します。
# /usr/bin/misskey -m
{{Note|外部のデータベースサーバーの場合は、ヘルパースクリプトのパラメータを {{ic|-M}} に変更して、PostgreSQLとRedisの可用性チェックを実施しないようにします。}}

{{TranslationStatus|Misskey|2023-03-16|749820}}