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

Dovecot

2019-02-28T16:30:47Z

Gogorockn: 不必要になった設定内容の追記

[[Category:メールサーバー]]
[[en:Dovecot]]
{{Related articles start}}
{{Related|Postfix}}
{{Related|Courier MTA}}
{{Related|OpenSMTPD}}
{{Related|Fail2ban}}
{{Related|SOGo}}
{{Related|仮想ユーザーメールシステム}}
{{Related articles end}}
この記事では個人やスモールオフィスでの利用に適したメールサーバーの設定方法について記述しています。

[http://www.dovecot.org/ Dovecot] は Linux/Unix ライクなシステム向けのオープンソースの [[Wikipedia:IMAP|IMAP]] と [[Wikipedia:POP3|POP3]] サーバーで、セキュリティを主眼に置いて書かれています。Dovecot は Timo Sirainen によって開発され、2002年7月に初めてリリースされました。Dovecot は第一に軽量で高速、設定しやすいオープンソースのメールサーバーを目指しています。詳しい情報は、公式の [https://wiki2.dovecot.org/ Dovecot Wiki] を見て下さい。

==インストール==

{{Pkg|dovecot}} と {{Pkg|pam}} パッケージを[[pacman|インストール]]してください。

==設定==

===前提===

* Dovecot によるメールアカウントはそれぞれ、サーバーに定義するローカルのユーザーアカウントを持ちます。
* サーバーはローカルのユーザーデータベース (/etc/passwd) ではなく [[PAM]] を使ってユーザーを認証します。
* 認証パスワードの暗号化には [[Wikipedia:ja:Transport_Layer_Security|SSL]] が使われます。
* 一般的な [[Wikipedia:ja:Maildir|Maildir]] フォーマットを使ってユーザーのホームディレクトリにメールを保存します。
* [[Wikipedia:ja:メール配送エージェント|MDA]] はあらかじめローカルユーザーにメールを配達するように設定されています。

===SSL 証明書の作成===

{{Pkg|dovecot}} パッケージにはサーバーの SSL 証明書を生成するためのスクリプトが含まれています。

* サンプルファイルから設定ファイルをコピーしてください: {{ic|# cp /usr/share/doc/dovecot/dovecot-openssl.cnf /etc/ssl/dovecot-openssl.cnf}}。
* {{ic|/etc/ssl/dovecot-openssl.cnf}} を編集して証明書を設定してください。

* {{ic|# /usr/lib/dovecot/mkcert.sh}} を実行すれば証明書が生成されます。

証明書・キーのペアは {{ic|/etc/ssl/certs/dovecot.pem}} と {{ic|/etc/ssl/private/dovecot.pem}} として作成されます。

証明書を変更した時は {{ic|cp /etc/ssl/certs/dovecot.pem /etc/ca-certificates/trust-source/anchors/dovecot.crt}} と {{ic|# trust extract-compat}} を実行してください。

{{Warning|SSL/TLS を使用する場合、{{ic|/etc/dovecot/conf.d/10-ssl.conf}} の[[#Dovecot の設定|設定]]に以下を追加して [http://disablessl3.com/ POODLE] と [https://weakdh.org/sysadmin.html FREAK/Logjam] の対策をしてください:
{{bc|1=
ssl_protocols = !SSLv3
ssl_cipher_list = ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:AES:CAMELLIA:DES-CBC3-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA
ssl_prefer_server_ciphers = yes
}}}}

===DH パラメータの生成===

新しい DH パラメータファイルを生成するには (長い時間がかかります):

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

{{ic|/etc/dovecot/dovecot.conf}} にファイルを追加してください:

ssl_dh = </etc/ssl/dh.pem

===PAM 認証===
{{note| 最新の {{pkg|dovecot}} パッケージでは、この設定がデフォルトで有効になります。 }}
* dovecot の PAM を設定するには、以下の内容で {{ic|/etc/pam.d/dovecot}} を作成してください:
{{hc|/etc/pam.d/dovecot|
auth required pam_unix.so nullok
account required pam_unix.so
}}

===PAM 認証と LDAP===

* [[OpenLDAP]] サーバーを使って認証している場合、[[LDAP 認証]]に書かれているように先に LDAP ユーザーでログインできることを確認してください。それから、{{ic|/etc/pam.d/dovecot}} に以下を記述します。エントリの順番には意味があるので注意してください:
{{hc|/etc/pam.d/dovecot|2=
auth sufficient pam_ldap.so
auth required pam_unix.so nullok
account sufficient pam_ldap.so
account required pam_unix.so
session required pam_mkhomedir.so skel=/etc/skel umask=0022
session sufficient pam_ldap.so
}}
上記の設定の場合 LDAP とシステムユーザーの両方がメールボックスを持つことになります。

* {{ic|/etc/dovecot/conf.d/auth-system.conf}} を編集して {{ic|passdb}} ディレクティブを以下のように変更:
<pre>
passdb {
driver = pam
args = session=yes dovecot
}
</pre>
{{ic|pam_mkhomedir.so}} モジュールを使用して {{ic|passdb}} ディレクティブに {{ic|session}} を追加することで、LDAP ユーザーが最初にログインしたときにホームディレクトリを自動的に作成します。

===Dovecot の設定===

* {{ic|/usr/share/doc/dovecot/example-config}} から {{ic|/etc/dovecot}} に {{ic|dovecot.conf}} と {{ic|conf.d/*}} 設定ファイルをコピーしてください:
{{bc|
# cp /usr/share/doc/dovecot/example-config/dovecot.conf /etc/dovecot
# cp -r /usr/share/doc/dovecot/example-config/conf.d /etc/dovecot
}}

ほとんどのシステムではデフォルト設定で問題ありませんが、設定ファイルを読んで利用できるオプションを確認してください。詳しい説明は [https://wiki2.dovecot.org/QuickConfiguration クイック設定ガイド] や [https://wiki2.dovecot.org/#Dovecot_configuration dovecot configuration] を見て下さい。

デフォルトで dovecot はシステムで使われているメールストレージシステムを検出しようとします。Maildir フォーマットを使うには {{ic|/etc/dovecot/conf.d/10-mail.conf}} を編集して {{ic|1=mail_location = maildir:~/Maildir}} を設定してください。

===Sieve===

[[wikipedia:Sieve (mail filtering language)|Sieve]] はメールサーバーのメールのフィルターを作成するのに使うことができるプログラミング言語です。

====Sieve Interpreter Plugin====

* {{Pkg|pigeonhole}} をインストールしてください。
* {{ic|sieve}} を {{ic|mail_plugins}} に追加してください:
** {{ic|<nowiki>/etc/dovecot/conf.d/15-lda.conf</nowiki>}}{{bc|<nowiki>
protocol lda {
mail_plugins = $mail_plugins sieve
}
</nowiki>}}
** {{ic|/etc/dovecot/conf.d/20-lmtp.conf}}{{bc|<nowiki>
protocol lmtp {
mail_plugins = $mail_plugins sieve
}
</nowiki>}}
{{Note|最近は LDA のかわりに LMTP を使用することが推奨されます。ただし小規模なメールサーバー用に Dovecot LDA はまだ使い続けられます。詳しくは [https://wiki2.dovecot.org/LMTP Dovecot Wiki] を参照。}}

* 任意で {{ic|plugin}} セクションに設定を追加してください。設定オプションとデフォルト値については [https://wiki2.dovecot.org/Pigeonhole/Sieve/Configuration Sieve Interpreter Documentation] を見てください。例: {{bc|<nowiki>
plugin {
sieve = file:~/sieve;active=~/.dovecot.sieve
}
</nowiki>}}

{{Note|{{ic|/etc/dovecot/conf.d/}} 内の設定ファイルは {{ic|/etc/dovecot/dovecot.conf}} に {{ic|!include /etc/dovecot/conf.d/*.conf}} という行がないと読み込まれません。[[仮想ユーザーメールシステム]]のガイドに従っている場合、行を追加してください。}}

=====SpamAssassin - スパムを "Junk" フォルダに移動=====
* スパムテスト設定を追加:
{{hc|/etc/dovecot/conf.d/90-sieve.conf|<nowiki>
plugin {
sieve_extensions = +spamtest +spamtestplus

sieve_spamtest_status_type = score
sieve_spamtest_status_header = \
X-Spam_score: (-?[[:digit:]]+\.[[:digit:]]).*
sieve_spamtest_max_value = 5.0

sieve_before = /var/lib/dovecot/sieve/global_sieves/move_to_spam_folder.sieve
}
</nowiki>}} {{Note|上記は "X-Spam_score" (Exim のデフォルト設定におけるスパムのヘッダー形式) をテストします。ヘッダーは多少異なる可能性があります。例: "X-Spam-Score"。}}
* sieve スクリプトを作成:
{{hc|/var/lib/dovecot/sieve/global_sieves/move_to_spam_folder.sieve|<nowiki>
require "spamtestplus";
require "fileinto";
require "relational";
require "comparator-i;ascii-numeric";

if spamtest :value "ge" :comparator "i;ascii-numeric" "5" {
fileinto "Junk";
}
</nowiki>}}

* sieve をコンパイル: {{bc|<nowiki>
sievec /var/lib/dovecot/sieve/global_sieves
</nowiki>}} {{ic|move_to_spam_folder.sieve}} と {{ic|move_to_spam_folder.svbin}} ファイルが誰からでも読み込めるように権限が設定されているか確認してください。

====ManageSieve Server====
サーバー上の Sieve スクリプトをリモートで管理できる ManageSieve プロトコルが実装されています。

* 上記の '''Sieve Interpreter Plugin''' の手順に従ってください。
* {{ic|dovecot.conf}} の {{ic|protocols}} に {{ic|sieve}} を追加: {{bc|<nowiki>
protocols = imap pop3 sieve
</nowiki>}}
* {{ic|/etc/dovecot/conf.d/20-managesieve.conf}} を追加: {{bc|<nowiki>
service managesieve-login {
}

service managesieve {
}

protocol sieve {
}
</nowiki>}}
* {{ic|dovecot}} を再起動してください。managesieve デーモンはデフォルトではポート 4190 を使用します。

==サーバーを起動する==

標準の [[systemd]] を使って {{ic|dovecot.service}} [[デーモン]]を操作してください。
# systemctl start dovecot.service

ブート時に起動させるには
# systemctl enable dovecot.service

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

デフォルトではないハッシュ関数を使ってハッシュを生成する:

doveadm pw -s SHA512-CRYPT -p "superpassword"

データベースのカラムが十分大きいことを確認してください (警告は表示されません)。

dovecot-sql.conf ファイルにパスワードの形式を設定します:

default_pass_scheme = SHA512-CRYPT

Postfix と SASL

2019-02-21T09:48:09Z

Gogorockn: pambase 20190105.1-1 での変更に伴う修正を追加(英語版wiki参照)。

[[Category:メールサーバー]]
[[en:Postfix with SASL]]
{{Related articles start}}
{{Related|Postfix}}
{{Related|Dovecot}}
{{Related articles end}}
[http://www.postfix.org/SASL_README.html Postfix のサイト] より:

:''わざわざ Postfix をインストールする人たちは、Postfix が他のメーラよりもセキュアであると思っていることでしょう。Cyrus SASL ライブラリは大量のコードで成り立っています。Postfix SMTP クライアントや SMTP サーバで SASL 認証を有効にしても、 Postfix は Cyrus SASL ライブラリを使う他のメールシステムと同程度にしかセキュアになりません。Dovecot は検討に値するかもしれない代替策を提供しています。''

==イントロダクション==

この記事では [[Postfix]] で SASL 認証をセットアップする方法を説明します。

Postfix を立ち上げたら SASL 認証を追加することでリレーをなくすことができます。認証を通過した信頼できるユーザーだけがメールを送ることができるようになります。匿名ユーザーによってスパムが作成されるのを防げます。

[extra]] に入っている {{pkg|postfix}} パッケージは既に SASL のサポートを有効にしてコンパイルされているので、SASL 認証を使う場合、2つの選択肢があります:

*{{pkg|cyrus-sasl}} パッケージを使う。
*[[Dovecot]] を有効にして (Dovecot の認証だけでなく) Postfix の認証を処理させる。

==cyrus-sasl パッケージの設定==

[[公式リポジトリ]]から {{pkg|cyrus-sasl}} を[[インストール]]してください。

SASL を有効にして他のユーザーからのメールを承認するには、{{ic|/etc/postfix/master.cf}} で (デフォルトで存在するがコメントアウトされている) 以下の行をアンコメントして [https://tools.ietf.org/html/rfc6409 "Message submission"] ポート (TCP 587) を開きます:
{{bc|<nowiki>
submission inet n - n - - smtpd
-o syslog_name=postfix/submission
-o smtpd_tls_security_level=encrypt
-o smtpd_sasl_auth_enable=yes
-o smtpd_reject_unlisted_recipient=no
# -o smtpd_client_restrictions=$mua_client_restrictions
# -o smtpd_helo_restrictions=$mua_helo_restrictions
# -o smtpd_sender_restrictions=$mua_sender_restrictions
-o smtpd_recipient_restrictions=permit_sasl_authenticated,reject
-o milter_macro_daemon_name=ORIGINATING
</nowiki>}}

上記の設定では SSL も有効になるので、SSL 証明書を持っていない場合は、"smtpd_tls_security_level" オプションはコメントアウトされたままにしてください。

3つの制限オプション (client, helo, sender) もコメントアウトしたままにできます。smtpd_recipient_restrictions は既に SASL ユーザーを処理するからです。

通常通りに Postfix をセットアップして[[起動]]します。ブート時に起動するようにしたいときは[[有効化]]してください。

SASL は複数の認証方式を使うことができます。デフォルトの認証方式は PAM ({{ic|/etc/conf.d/saslauthd}} で設定) ですが、正しくセットアップするには {{ic|/usr/lib/sasl2/smtpd.conf}} を作成する必要があります:

{{bc|
pwcheck_method: saslauthd
mech_list: plain
log_level: 7
}}

{{pkg|pambase}} 20190105.1-1 以降では "other" サービスに対して制限付きのフォールバックが適用される [https://git.archlinux.org/svntogit/packages.git/commit/trunk?h=packages/pambase&id=3552aba772e8bebbe754a4d01f2729e291dd2070] ので、 Postfix で SASL 認証を使うにはこれに加えて [[PAM]] の設定ファイルを作成する必要があります [https://bugs.archlinux.org/task/61700][https://bbs.archlinux.org/viewtopic.php?pid=1824850] 。

以下の内容で {{ic|/etc/pam.d/smtp}} を作成:

{{bc|<nowiki>
#%PAM-1.0
auth required pam_unix.so
account required pam_unix.so
</nowiki>}}

postfix と saslauthd サービスを[[再起動]]してください。

上手く行っていれば、次のコマンドで Postfix サーバーに telnet できるはずです: {{ic|telnet localhost 587}}。

それから、次のコマンドを入力してください: {{ic|EHLO test.com}}。

以下のように表示されるはずです:

{{bc|
Trying 127.0.0.1...

Connected to localhost.localdomain
Escape character is '^]'

220 justin ESMTP Postfix
EHLO test.com
250-justin
250-PIPELINING
250-SIZE 10240000
250-VRFY
250-ETRN
250-AUTH PLAIN OTP DIGEST-MD5 CRAM-MD5
250 8BITMIME
}}

==Dovecot の設定==

IMAP や POP メールサーバーとして [[Dovecot]] を使っていて既に (PAM などで) 認証を設定している場合、他のパッケージを設定する必要はありません。

{{ic|/etc/postfix/master.cf}} を編集して {{ic|submission}} または {{ic|smtp}} セクションの下に以下の行を追加してください:

{{bc|<nowiki>
# SASL authentication with dovecot
-o smtpd_tls_security_level=encrypt
-o smtpd_sasl_auth_enable=yes
-o smtpd_sasl_type=dovecot
-o smtpd_sasl_path=private/auth
-o smtpd_sasl_security_options=noanonymous
-o smtpd_sasl_local_domain=$myhostname
-o smtpd_client_restrictions=permit_sasl_authenticated,reject
-o smtpd_recipient_restrictions=reject_non_fqdn_recipient,reject_unknown_recipient_domain,permit_sasl_authenticated,reject
</nowiki>}}

上記の設定で、認証を受けたユーザーだけがメールを送信できるようになります。{{ic|smtpd_client_restrictions}} がそれです。

以下を Dovecot 設定ファイル {{ic|/etc/dovecot/dovecot.conf}} に追加してください:

{{bc|<nowiki>
service auth {
unix_listener /var/spool/postfix/private/auth {
group = postfix
mode = 0660
user = postfix
}
user = root
}
</nowiki>}}

{{ic|master.cf}} の {{ic|smtpd_sasl_path}} オプションで指定したのと同じ {{ic|/var/spool/postfix/private/auth}} に unix ソケットが作成されます。

最後に postfix と dovecot サービスを[[再起動]]してください。

==参照==

*Postfix 公式ドキュメントの [http://www.postfix.org/SASL_README.html Postfix SASL readme]
*Dovecot 公式ドキュメントの [https://wiki2.dovecot.org/HowTo/PostfixAndDovecotSASL SASL authentication with Dovecot]
*[http://wiki.centos.org/HowTos/postfix_sasl Centos Howto Postfix SASL]

Pantheon

2018-12-01T11:23:48Z

Gogorockn: 非公式リポジトリの更新

[[Category:デスクトップ環境]]
[[en:Pantheon]]
[[pl:Pantheon]]
[[zh-hans:Pantheon]]
[http://elementary.io/ Pantheon] は elementary OS ディストリビューションのために作成されたデスクトップ環境です。Vala と GTK3 ツールキットを使ってスクラッチから書かれています。ユーザビリティと外観に関して言うと、[[GNOME]] Shell や macOS と似ているところをいくつか持っているデスクトップです。

==インストール==

{{Note|Pantheon のリリーススケジュールやツールチェインは [[Arch と他のディストリビューションの比較#Ubuntu|Ubuntu]] の LTS リリースサイクルに従っていますが、[https://plus.google.com/communities/104613975513761463450 elementary OS] の開発は素早く、最近になって [https://github.com/elementary github] に移動しました。}}

=== 非公式リポジトリ ===

[https://github.com/alucryd/aur-alucryd/tree/master/pantheon Alucryd の非公式リポジトリ] には [[community]] に入っているパッケージよりも多くの新しいパッケージが含まれています。非公式リポジトリを使用するには {{Ic|/etc/pacman.conf}} に以下の行を追加してください:
{{bc|<nowiki>
[extra-alucryd]
Server = https://pkgbuild.com/~alucryd/$repo/$arch
</nowiki>}}
{{Note|パッケージの PKGBUILD は [[AUR]] からも入手できます。}}

=== デスクトップ環境 ===

{{AUR|pantheon-session-bzr}}{{Broken package link|パッケージが存在しません}} のインストールから始めれば、最小のデスクトップインターフェイスを作ることができます。このパッケージによって以下のコアコンポーネントがインストールされます:
* {{AUR|cerbere}}: Pantheon のコアアプリが動いていることを監視するサービス
* {{AUR|gala-git}}: ウィンドウマネージャ (開発版)
* {{AUR|wingpanel}}: トップパネル
* {{AUR|pantheon-applications-menu-git}}: アプリケーションランチャー (開発版)
以下のパッケージをインストールすることもできます:
* {{Pkg|plank}} または {{AUR|plank-bzr}}{{Broken package link|パッケージが存在しません}}: MacOS ライクなドック
* {{AUR|wingpanel-git}}: トップパネル (開発版)

=== サービスと設定 ===

以下のパッケージは Pantheon や elementary OS アプリケーションのバックグラウンドサービスおよびデフォルト設定を提供します:
* {{AUR|pantheon-default-settings-bzr}}{{Broken package link|パッケージが存在しません}}: デスクトップの外観・挙動やアプリケーションのデフォルト設定。テーマパッケージの {{Pkg|elementary-icon-theme}}, {{AUR|gtk-theme-elementary}}, {{AUR|pantheon-backgrounds-bzr}}{{Broken package link|パッケージが存在しません}} もインストールされます。
* {{Pkg|contractor}}: アプリ間でデータを共有するためのサービス
* {{AUR|gnome-settings-daemon-elementary}}: {{AUR|elementary-dpms-helper-bzr}}{{Broken package link|パッケージが存在しません}} と {{AUR|wingpanel-indicator-power-git}} のサポートを追加した {{AUR|gnome-settings-daemon-ubuntu}}
* {{AUR|pantheon-print-git}}: 印刷設定ダイアログ
* {{AUR|pantheon-polkit-agent}}: Polkit 認証エージェント

=== テーマ ===

以下のパッケージはデスクトップのルックアンドフィールを向上させます:
* {{AUR|elementary-icon-theme-git}}: スムーズ・セクシー・クリア・効率的なアイコンテーマ (開発版)
* {{AUR|lightdm-pantheon-greeter}}: LightDM greeter
以下のフォントをインストールすることが推奨されます:
* {{AUR|ttf-opensans}}: Open Sans フォント
* {{AUR|ttf-raleway}}: Raleway フォント
* {{Pkg|ttf-dejavu}}: Bitstream Vera フォントベースのフォントファミリー
* {{Pkg|ttf-droid}}: Google によって Android の一部としてリリースされている汎用フォント
* {{Pkg|ttf-freefont}}: Unicode 文字セットをカバーしているフリーのアウトラインフォントのセット
* {{Pkg|ttf-liberation}}: Red Hat の Liberation フォント

=== アプリケーション ===

以下は elementary OS ソフトウェアスイートを構成するパッケージです:
* {{Pkg|pantheon-files}}: Marlin から開発されているファイルエクスプローラー
* {{Pkg|pantheon-terminal}}: ターミナルエミュレータ
* {{Pkg|scratch-text-editor}}{{Broken package link|置換パッケージ: {{Pkg|pantheon-code}}}}: テキストエディタ
* {{AUR|pantheon-calculator}}: 電卓
* {{Pkg|pantheon-music}}: 音楽プレイヤー (旧 Noise Player)
* {{Pkg|pantheon-videos}}: 動画プレイヤー
* {{AUR|pantheon-calendar-git}}: {{AUR|maya-calendar}}{{Broken package link|パッケージが存在しません}} から開発され {{AUR|wingpanel-indicator-datetime}} と統合されたカレンダー
* {{AUR|epiphany-pantheon-bzr}}: {{AUR|midori-granite}} を置き換えるウェブブラウザ
* {{AUR|pantheon-mail-git}}: {{Pkg|geary}} ベースのメールクライアント
* {{AUR|pantheon-screenshot}}: スクリーンショットツール
* {{AUR|eidete-bzr}}: シンプルなスクリーンキャスタ
* {{Pkg|pantheon-photos}}: {{Pkg|shotwell}} ベースのフォトマネージャ
* {{AUR|pantheon-camera-git}}: {{AUR|snap-photobooth}} から開発されたウェブカメラアプリ
* {{AUR|elementary-scan-bzr}}: シンプルなスキャンユーティリティ
* {{AUR|footnote-bzr}}{{Broken package link|パッケージが存在しません}}: メモアプリ
* {{AUR|switchboard}}: {{Pkg|gnome-control-center}} と似ているプラグイン方式の設定マネージャ

==Pantheon を起動する==

===ディスプレイマネージャを使う===

{{AUR|pantheon-session-bzr}}{{Broken package link|パッケージが存在しません}} に {{Pkg|gdm}} や {{Pkg|lightdm}} などのディスプレイマネージャのためのセッションエントリが入っています。

===.xinitrc を使う===

{{Ic|~/.xinitrc}} を使って Pantheon シェルを起動することも可能です。以下のコードは Pantheon セッションを起動します:

#!/bin/sh

if [ -d /etc/X11/xinit/xinitrc.d ]; then
for f in /etc/X11/xinit/xinitrc.d/*; do
[ -x "$f" ] && . "$f"
done
unset f
fi

gsettings-data-convert &
xdg-user-dirs-gtk-update &
/usr/lib/polkit-gnome/polkit-gnome-authentication-agent-1 &
/usr/lib/gnome-settings-daemon/gnome-settings-daemon &
/usr/lib/gnome-user-share/gnome-user-share &
eval $(gnome-keyring-daemon --start --components=pkcs11,secrets,ssh,gpg)
export GNOME_KEYRING_CONTROL GNOME_KEYRING_PID GPG_AGENT_INFO SSH_AUTH_SOCK
exec cerbere

===アプリケーションの自動起動===

Pantheon は {{Ic|~/.xinitrc}} で起動した場合、XDG の自動起動をサポートしていません。しかしながら、systemd ユニットを提供していないアプリケーションを自動起動するための方法が3つ存在します:

* {{Ic|~/.xinitrc}} に (できれば ''exec cerbere'' 行の直前に) プログラムを追加することができます。単発のプログラムの場合この方法が好ましいでしょう。
* もしくは ''dconf-editor'' を使って {{Ic|org.pantheon.cerbere.monitored-processes}} キーを編集して自動起動したいプログラムを追加することができます。この方法はバックグラウンドで動作し続けるアプリケーションで最適です。
* {{AUR|dapper}}, {{AUR|dex-git}}, {{AUR|fbautostart}} などのプログラムを使って {{ic|~/.xinitrc}} に XDG の自動起動のサポートを追加するという方法もあります。

{{Note|''cerbere'' によって起動したアプリケーションは終了させることができないので注意してください、何度でも起動されます。}}

==設定==

Pantheon の設定は {{AUR|switchboard}} と plug (''switchboard-plug-*'') によって行います。ほとんどは AUR やカスタムリポジトリから利用できます。pantheon の設定は全て ''dconf'' によって変更することも可能で、設定は {{Ic|org.pantheon}} キーにあります。簡単な編集には ''dconf-editor'' を使って下さい。

設定の一部は特定の plug から {{Pkg|gnome-control-center}} で扱われますが、残念ながら 3.6 までの GNOME しかサポートしていません。代わりに {{Pkg|gnome-control-center}} 本体や {{Pkg|gnome-tweak-tool}}{{Broken package link|置換パッケージ: {{Pkg|gnome-tweaks}}}} を使って下さい。

=== Plank ===

==== 新しいアプリケーションアイコンの追加 ====

デスクトップファイルをドックにドラッグアンドドロップするか、実行中のアプリケーションを右クリックして "Keep in dock" を選択してください。ドラッグアンドドロップでアイコンの順番を変えられます。
{{Note|Plank の設定ファイルは {{ic|~/.config/plank/}} に保存されます。}}

===Pantheon Files===

====コンテクストメニューのエントリを有効にする====

{{Pkg|file-roller}} でアーカイブを展開・圧縮したりするためにコンテクストメニューのエントリを有効にしたい場合、{{Pkg|contractor}} を追加でインストールする必要があります。

===Terminal===

====透明度====

Pantheon Terminal には透明度を設定することができます。{{ic|dconf-editor}} を開いて {{ic|org.pantheon.terminal.settings.opacity}} から自由に透明度を設定してください。{{AUR|pantheon-terminal-git}} の場合、背景色と透過は {{ic|org.pantheon.terminal.settings.background}} で設定します。

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

=== ユーザビリティ ===

==== LightDM Pantheon greeter が使えない ====

{{ic|/var/lib/lightdm/.pam_environment}} を削除してください。ただし、このファイルは次の LightDM バグの回避策です: https://bugs.launchpad.net/ubuntu/+source/unity-greeter/+bug/1024482

==== Gala が起動時にクラッシュする ====

未設定の gala は背景としてデフォルトの gnome の壁紙を使おうとします。しかし、{{Pkg|gnome-themes-standard}}{{Broken package link|パッケージが存在しません}} をインストールしていないと適切なファイルが存在しません。そのため、クラッシュを回避するには {{Pkg|gnome-themes-standard}}{{Broken package link|パッケージが存在しません}} をインストールしてください。pantheon の設定をした後はこのパッケージを削除しても大丈夫です。

==== マウスカーソルが表示されません ====

おそらく 'gala' ウィンドウマネージャが動作していません。{{AUR|cerbere-git}} をインストールするか [[#.xinitrc を使う|.xinitrc]] を使って 'gala' を cerbere の監視プロセスのリストに追加してください。

=== インジケータ ===

==== wingpanel にインジケータが表示されない ====

Wingpanel にはインジケータが付属していません。別個にインストールする必要があります。
{{Note|{{AUR|wingpanel}} は [[Unity|Ayatana インジケータ]]に対応しており、{{AUR|wingpanel-git}} にはネイティブのインジケータが存在します (''wingpanel-indicator-*-git'')。}}

==== サードパーティ製のインジケータ ====

* [[#ディスプレイマネージャを使う|ディスプレイマネージャ]]で起動する場合、サードパーティ製インジケータの [[デスクトップエントリ#自動起動|*.desktop ファイル]]の {{ic|1=OnlyShowIn=}} に {{Ic|Pantheon}} を追加してください。

* [[#.xinitrc を使う|~/.xinitrc]] で起動する場合、[[#Pantheon を起動する|上記]]で説明しているどれかの起動方法にインジケータを追加してください。

* {{AUR|wingpanel-git}} の場合、[[Unity]] 用に設計されたインジケータは {{AUR|wingpanel-indicator-ayatana}} を必要とします。

==== Indicator-session のメニューが動作しない ====

* {{AUR|indicator-session}} は機能の多くの [[Unity]] による dbus メソッドに依存しており、存在しない場合は gnome や systemd のメソッドにフォールバックします。

* {{AUR|wingpanel-indicator-session-git}} は {{Ic|Lock}} メニューアイテムを機能させるために [[light-locker]] または {{AUR|xscreensaver-dbus-screenlock}} を必要とします。

=== 外観 ===

==== Pantheon-terminal の透過 ====

pantheon-terminal の透過は elmentary OS テーマ以外の GTK テーマでは完全には機能しません。{{AUR|gtk-theme-elementary}} あるいは {{AUR|gtk-theme-elementary-git}} を使用するか [https://bazaar.launchpad.net/~elementary-design/egtk/4.x/revision/210 このコード] をテーマや {{ic|~/.config/gtk-3.0/gtk.css}} に追加してください。

==== Wingpanel の透過 ====

Wingpanel は {{AUR|gtk-theme-elementary}} または {{AUR|gtk-theme-elementary-git}} を使用している場合、透過するように設計されており、最大化したときに不透明になります。他の GTK テーマを使用している場合は不透明のパネルが表示されます。

他のテーマでも透過するようにしたい場合、以下の行を {{ic|~/.config/gtk-3.0/gtk.css}} に追加してください:

/*********************
* wingpanel support *
********************/
.panel {
background-color: transparent;
transition: all 1s ease-in-out;
}

.panel.maximized {
background-color: #000;
}

==== GTK+ アプリケーションの回りに黒い影が表示される ====

Elementary の GTK テーマは独自のファイルを使用して {{Ic|~/.config/gtk-3.0/gtk.css}} ファイルの設定を無視します。{{Ic|/usr/share/themes/elementary/gtk-3.0/gtk-widgets.css}} ファイルを開いて以下の部分を見てください (3669行目付近):

decoration,
.window-frame {
border-radius: 4px 4px 0 0;
box-shadow: 0 0 0 1px alpha (#000, 0.3),
0 14px 28px rgba(0,0,0,0.35),
0 10px 10px rgba(0,0,0,0.22);
margin: 12px;
}

上記のコードを以下のように置き換えてください:

decoration,
.window-frame {
box-shadow: none;
border: none;
padding: 0;
margin: 0;
}

==== pantheon-files のアイコンが白い ====

現在テーマにバグがあって黒の代わりに白色で一番上にアイコンが表示されるようです。この問題は {{AUR|gtk-theme-elementary-git}} をインストールするか {{AUR|gtk-theme-elementary}} テーマの {{ic|gtk-widgets.css}} に次の行を追加することで修正できます:

GtkToolItem { color: @text_color; }