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

NetworkManager

2021-12-26T08:00:28Z

Oriaca372m: スペルミスの修正

[[Category:ネットワークマネージャ]]
[[Category:Red Hat]]
[[cs:NetworkManager]]
[[de:Networkmanager]]
[[en:NetworkManager]]
[[es:NetworkManager]]
[[fr:NetworkManager]]
[[it:NetworkManager]]
[[pt:NetworkManager]]
[[ru:NetworkManager]]
[[tr:NetworkManager]]
[[zh-hans:NetworkManager]]
{{Related articles start}}
{{Related|ネットワーク設定}}
{{Related|ワイヤレス設定}}
{{Related|Netctl}}
{{Related|Wicd}}
{{Related articles end}}
[http://projects.gnome.org/NetworkManager/ NetworkManager] はネットワークの検知とシステムの設定を自動で行いネットワークに接続するプログラムです。NetworkManager の機能は無線・有線両方のネットワークに使うことができます。無線ネットワークでは、NetworkManager は既知の無線ネットワークを優先し、一番信頼性のあるネットワークに切り替えることができます。NetworkManager 対応アプリケーションはオンラインとオフラインを切り替えることが可能です。また、NetworkManager では無線接続よりも有線接続が優先され、モデム接続や特定の VPN に対応しています。NetworkManager はもともとは Red Hat によって開発されていましたが、現在では [[GNOME]] プロジェクトによってホストされています。

{{Warning|初期設定では、Wi-Fi パスワードは平文で保存されます。直すためには、[[#Wi-Fi パスワードの暗号化]]を見てください。}}

== インストール ==

NetworkManager は[[公式リポジトリ]]にある {{Pkg|networkmanager}} パッケージでインストールできます。これには、デーモンとコマンドラインインターフェース ({{ic|nmcli}})、cursesベースのテキストインターフェース ({{ic|nmtui}})が含まれます。

=== NetworkManager を有効にする ===

インストール後、{{ic|NetworkManager.service}} を [[systemd#ユニットを使う|開始/有効]] します。NetworkManager デーモンが起動すると、すでに構成されている使用可能な "system connections" に自動的に接続します。"user connections" または未接続の場合は、構成および接続するために、nmcli またはアプレットが必要です。

=== 追加のインターフェース ===

* {{Pkg|nm-connection-editor}}: グラフィカルインターフェース。
* {{Pkg|network-manager-applet}}: システムトレイアプレット ({{ic|nm-applet}}).

{{Note|ネットワークを設定しようとするサービスが他に動いていないことを確認してください。複数のネットワークサービスがあると衝突します。{{ic|1=systemctl --type=service}} で現在動作しているサービスのリストを表示できるので、ネットワークサービスがあったら[[systemd#ユニットを使う|停止]]してください。NetworkManager サービスを有効にする方法は[[#設定|設定]]を見てください。}}

=== VPN サポート ===

NetworkManager 1.16 から [[WireGuard]] に対応しました。詳細は [https://blogs.gnome.org/thaller/2019/03/15/wireguard-in-networkmanager/] を参照してください。

NetworkManager の VPN サポートはプラグインシステムをベースにしています。NetworkManager で VPN のサポートが必要なときは以下のパッケージの中から必要なものをインストールしてください:

* {{Pkg|networkmanager-openconnect}} for [[OpenConnect]]
* {{Pkg|networkmanager-openvpn}} for [[OpenVPN]]
* {{Pkg|networkmanager-pptp}} for [[PPTP クライアント]]
* {{Pkg|networkmanager-vpnc}} for [[Vpnc]]
* {{Pkg|networkmanager-strongswan}} for [[strongSwan]]
* {{AUR|networkmanager-fortisslvpn-git}}
* {{AUR|networkmanager-iodine-git}}
* {{AUR|networkmanager-libreswan}}
* {{AUR|networkmanager-l2tp}}
* {{AUR|networkmanager-ssh-git}}
* {{Pkg|network-manager-sstp}}

{{Warning|1=VPN サポートは [https://bugzilla.gnome.org/buglist.cgi?quicksearch=networkmanager%20vpn 不安定] です。GUI からデーモンプロセスのオプションが正しく設定されていることを確認して、パッケージがリリースされるたびに再確認してください [https://bugzilla.gnome.org/show_bug.cgi?id=755350]。}}

=== Mobile broadband support ===

モバイル回線に接続するためには、{{pkg|modemmanager}}か {{pkg|mobile-broadband-provider-info}} 、または {{pkg|usb_modeswitch}} を[[インストール]]してください。詳しくは [[USB 3G モデム#Network Manager]] を確認してください。

=== PPPoE / DSL サポート ===

PPPoE / DSL 接続のサポートが必要な場合は {{pkg|rp-pppoe}} を[[インストール]]してください。実際に使うためには、{{ic|1=nm-connection-editor}} から新しい DSL/PPPoE 接続を追加してください。

== グラフィカルフロントエンド ==

NetworkManager を簡単に使えるようにするためのアプレットをインストールすることができます。この GUI フロントエンドはシステムトレイ（や通知エリア）に収納され、NetworkManager のネットワーク選択や設定が可能です。異なるデスクトップにあわせて様々なアプレットが存在します。その他に [[#nm-applet]] を使うこともできます。

=== GNOME ===

GNOME にはツールが内蔵されており、ネットワーク設定からアクセスできます。

=== KDE Plasma ===

{{Pkg|plasma-nm}} アプレットをインストールしてください。

=== nm-applet ===

{{Pkg|network-manager-applet}} はあらゆる Xorg 環境で動作する GTK+ 3 フロントエンドです (システムトレイに表示されます)。

接続情報を保存するには [[GNOME Keyring]] をインストール・設定してください。

{{ic|Make available to other users}} オプションを有効にすると、NetworkManager はパスワードを平文で保存します。ただしファイルにアクセスできるのは root だけです (他のユーザーは {{ic|nm-applet}} を介してアクセスします)。[[#Wi-Fi パスワードの暗号化]]を見てください。

システムトレイを使わずに {{ic|nm-applet}} を起動したい場合、{{Pkg|trayer}} または {{Pkg|stalonetray}} を使います。例えば、以下のようなスクリプトを追加して使うことができます:

{{hc|nmgui|<nowiki>
#!/bin/sh
nm-applet 2>&1 > /dev/null &
stalonetray 2>&1 > /dev/null
killall nm-applet
</nowiki>}}

[[stalonetray]] のウィンドウを閉じると {{ic|nm-applet}} も終了するため、ネットワーク設定で無駄なメモリを消費することがありません。

==== Xfce ====
[[Xfce]] でも {{Pkg|network-manager-applet}} は動作しますが、エラーメッセージなど通知を表示するには {{ic|nm-applet}} に加えて FreeDesktop.org の仕様に準拠した[[デスクトップ通知]]デーモンが必要です。xfce のパネル設定では "Notification Area" という名前のアプリになります。通知を有効にするには {{Pkg|xfce4-notifyd}} をインストールしてください。新しい無線ネットワークに接続したときにパスワードの入力プロンプトを表示させるには {{Pkg|gnome-keyring}} などの org.freedesktop.secrets サービスが必要です。

通知デーモンがないと、{{ic|nm-applet}} アプレットは以下のエラーを標準出力に表示します:

(nm-applet:24209): libnotify-WARNING **: Failed to connect to proxy
** (nm-applet:24209): WARNING **: get_all_cb: couldn't retrieve
system settings properties: (25) Launch helper exited with unknown
return code 1.
** (nm-applet:24209): WARNING **: fetch_connections_done: error
fetching connections: (25) Launch helper exited with unknown return
code 1.
** (nm-applet:24209): WARNING **: Failed to register as an agent:
(25) Launch helper exited with unknown return code 1

{{ic|nm-applet}} は問題なく動作しますが、通知は表示されません。

アプレットが表示されない場合は {{AUR|xfce4-indicator-plugin}} パッケージをインストールしてください [https://askubuntu.com/questions/449658/networkmanager-tray-nm-applet-is-gone-after-upgrade-to-14-04-trusty]。

==== Openbox ====

Openbox で正しく動作させるには、XFCE と同じ理由で GNOME アプレットに {{Pkg|xfce4-notifyd}} 通知デーモンが必要です。また、システムトレイにアプレットを表示するには {{Pkg|gnome-icon-theme}} パッケージが必要です。

認証情報 (Wireless/DSL) を保存するには [[GNOME Keyring]] をインストール・設定してください。

{{ic|nm-applet}} は autostart ファイルを {{ic|/etc/xdg/autostart/nm-applet.desktop}} にインストールします。これに問題が発生する場合 (例: {{ic|nm-applet}} が二度起動する、全く起動しない)、[[Openbox#autostart]] や [https://bbs.archlinux.org/viewtopic.php?pid=993738] を見て解決してください。

=== コマンドライン ===

==== nmcli ====

{{Pkg|networkmanager}} パッケージにはバージョン 0.8.1 から [http://manpages.ubuntu.com/manpages/maverick/man1/nmcli.1.html nmcli] が含まれています。

例:

* wifi ネットワークに接続するには: {{bc|nmcli dev wifi connect <name> password <password>}}
* {{ic|wlan1}} の wifi インターフェイスの wifi に接続するには: {{bc|nmcli dev wifi connect <name> password <password> iface wlan1 [profile name]}}
* インターフェイスを切断するには: {{bc|nmcli dev disconnect iface eth0}}
* 切断されたインターフェイスに再接続するには: {{bc|nmcli con up uuid <uuid>}}
* UUID のリストを表示するには: {{bc|nmcli con show}}
* ネットワークデバイスのリストと状態を表示するには: {{bc|nmcli dev}}
* wifi をオフにするには: {{bc|nmcli r wifi off}}

==== nmtui ====

''nmtui'' は ''networkmanager'' のグラフィックフロントエンドで curses を使っています。X のない環境でネットワークを設定・管理するのに便利です。{{Pkg|networkmanager}} パッケージにはバージョン 0.9.10 から ''nmtui'' が含まれています。

==== nmcli-dmenu ====

もしくは {{ic|nm-applet}} の代わりに ''dmenu'' を使って NetworkManager の接続を管理する小さなスクリプト {{AUR|networkmanager-dmenu-git}} も存在します。既存の NetworkManager の有線・無線接続に接続したり、新しい無線接続に接続したり、必要であればパスフレーズをリクエストする、既存の VPN 接続に接続する、ネットワークを無効化・有効化する、''nm-connection-editor'' GUI を起動するなどの機能が備わっています。

== 設定 ==

NetworkManager には正しく機能させるために必要なことがあります。

次に進む前に {{ic|/etc/hosts}} が正しいことを確認してください。この手順を行う前に接続を試すと、NetworkManager が設定を変えてしまうことがあります。[[ネットワーク設定 #ホストネームの設定]] にあるように設定ができていることを確認してください。{{ic|/etc/hosts}} の例:

{{hc|/etc/hosts|
127.0.0.1 localhost
::1 localhost
}}

nss-myhostname を使っていない場合:

{{hc|/etc/hosts|
127.0.0.1 my-laptop localhost
::1 my-laptop localhost
}}

=== NetworkManager を有効にする ===

NetworkManager は {{ic|NetworkManager.service}} を使って[[systemd#ユニットを使う|操作]]します。NetworkManager デーモンが起動すると、自動的に設定済みの有効な "システム接続" に接続します。"ユーザー接続"や設定していない接続には {{ic|nmcli}} やアプレットを使って設定・接続する必要があります。

NetworkManager のグローバルな設定ファイルは {{ic|/etc/NetworkManager/NetworkManager.conf}} にあります。他の設定ファイルは {{ic|/etc/NetworkManager/conf.d/}} 以下に置くことが出来ます。通常、グローバルなデフォルト設定ファイルに設定を加える必要はありません。

=== NetworkManager Wait Online を有効にする ===
ネットワークが立ち上がる前にサービスが起動して失敗する場合、NetworkManager サービスにプラスして {{ic|NetworkManager-wait-online.service}} を使って下さい。ただし、ネットワークが設定されていないときでも殆どのネットワークデーモンは正しく立ち上がるので、これが必要になるのは稀です。

それでもサービスが正しく起動できない場合 {{ic|/usr/lib/systemd/system/NetworkManager-wait-online.service}} のタイムアウト設定が短すぎることが原因です。デフォルトのタイムアウトである 30 から高い値に修正してください。

=== PolicyKit パーミッションの設定 ===

ワーキングセッションの設定については[[一般的なトラブルシューティング#セッションのパーミッション]]を参照してください。

ワーキングセッションで、NetworkManager に必要な特権を与える方法は複数存在します:

''方法 1.'' ログイン時に {{ic|/usr/lib/polkit-gnome/polkit-gnome-authentication-agent-1}} ({{Pkg|polkit-gnome}} に含まれています) などの [[PolicyKit]] 認証エージェントを実行する。ネットワーク接続を追加・削除したときにパスワードを求められるようになります。

''方法 2.'' ユーザーを {{ic|wheel}} グループに追加する。パスワードを入力する必要はなくなりますが、root パスワードを入力せずに [[sudo]] を使えるなど、他の権限もユーザーアカウントに与えてしまうことになります。

''方法 3.'' ユーザーを {{ic|network}} グループに追加して以下のファイルを作成する:
{{hc|/etc/polkit-1/rules.d/50-org.freedesktop.NetworkManager.rules|<nowiki>
polkit.addRule(function(action, subject) {
if (action.id.indexOf("org.freedesktop.NetworkManager.") == 0 && subject.isInGroup("network")) {
return polkit.Result.YES;
}
});</nowiki>}}
{{ic|network}} グループの全てのユーザーはパスワードなしでネットワークを追加・削除できるようになります。[[ディスプレイマネージャ#systemd-logind を使う|systemd-logind]] でアクティブセッションを作っていない場合、この方法は systemd では動きません。

=== ネットワークサービスと NetworkManager dispatcher===

NetworkManager がインターフェースを立ち上げるまで動かしたくないネットワークサービスというのが相当数存在します。[[Network Time Protocol daemon|NTPd]] や様々なタイプのネットワークファイルシステムマウント (例: '''netfs''') が好例です。NetworkManager には、あなたがネットワークに接続したときにこれらのサービスを起動して、切断したときにサービスを停止する機能があります。この機能を有効にするには {{ic|NetworkManager-dispatcher.service}} を[[systemd#ユニットを使う|起動]]してください。

機能を有効にすれば、スクリプトを {{ic|/etc/NetworkManager/dispatcher.d}} ディレクトリに追加することができます。スクリプトは実行可能でユーザーのパーミッションがなければなりません。セキュリティ上、スクリプトの所有者を '''root:root''' にして書き込み権限を所有者だけに与えるとよいでしょう。

接続時にアルファベット順でスクリプトは実行され、切断時にはアルファベットの逆順で実行されます。スクリプトには2つの引数が渡されます: インターフェースの名前 (例: ''eth0'') と状態 (インターフェイスは ''up'' か ''down''、vpn 接続は ''vpn-up'' か ''vpn-down'') です。起動する順番を正確に決めるために、しばしばスクリプトの名前の前に数字が使われます (例: {{ic|10_portmap}} や {{ic|30_netfs}} (これでポートマップが NFS マウントよりも先に実行されます)。

{{Warning|パブリックネットワークに接続する場合、起動するサービスや接続するサーバーに注意してください。パブリックネットワークに接続している際に間違ったサービスを起動するとセキュリティホールとなる可能性があります。}}

==== 3秒タイムアウトを止める ====

上の設定で動作するなら、このセクションは関係ありません。ただし、実行するのに3秒以上かかる dispatcher スクリプトを動かす場合は共通の問題があります。NetworkManager は内部的に3秒タイムアウトを使っており (詳しくは[https://bugzilla.redhat.com/show_bug.cgi?id=982734 バグトラッカー]を参照) 3秒以上時間がかかっているスクリプトを自動的に殺します。この場合、{{ic|/usr/lib/systemd/system/NetworkManager-dispatcher.service}} にある dispatcher サービスファイルを有効にしつづけるように修正が必要です。以下の内容でサービスファイル {{ic|/etc/systemd/system/NetworkManager-dispatcher.service}} を作成してください:

.include /usr/lib/systemd/system/NetworkManager-dispatcher.service
[Service]
RemainAfterExit=yes

作成したら修正を加えた {{ic|NetworkManager-dispatcher}} スクリプトを有効にしてください。

==== OpenNTPD を起動 ====

{{AUR|networkmanager-dispatcher-openntpd}} パッケージをインストールしてください。

==== リモートフォルダを sshfs でマウント ====

スクリプトは制限的な環境で実行されるので、SSH エージェントに接続するには {{ic|SSH_AUTH_SOCK}} を export する必要があります。複数の方法が存在します、詳しくは [https://bbs.archlinux.org/viewtopic.php?pid=1042030#p1042030 このメッセージ] を見て下さい。以下の例は [[GNOME Keyring]] と一緒に動作し、ロックが解除されていない場合にパスワードを尋ねます。NetworkManager がログイン時に自動的に接続する場合は、''gnome-keyring'' は起動せず export は失敗します。{{ic|UUID}} は {{ic|nmcli con status}} や {{ic|nmcli con list}} コマンドで確認できます。

{{bc|<nowiki>
#!/bin/sh
USER='username'
REMOTE='user@host:/remote/path'
LOCAL='/local/path'

interface=$1 status=$2
if [ "$CONNECTION_UUID" = "</nowiki>''uuid''<nowiki>" ]; then
case $status in
up)
export SSH_AUTH_SOCK=$(find /tmp -maxdepth 1 -type s -user "$USER" -name 'ssh')
su "$USER" -c "sshfs $REMOTE $LOCAL"
;;
down)
fusermount -u "$LOCAL"
;;
esac
fi
</nowiki>}}

==== dispatcher を使って LAN ケーブルが接続されているかどうかに応じて自動的に Wi-Fi を切り替える ====

LAN ケーブルが接続されていない場合にのみ Wi-Fi をオンにして、LAN ケーブルが接続されたら (ノートパソコンがドックに接続された場合など) Wi-Fi を自動的に無効化することができます。

以下の dispatcher スクリプトを作成してください ([https://superuser.com/questions/233448/disable-wlan-if-wired-cable-network-is-available ソース])、{{ic|1=LAN_interface}} は適当なインターフェイスに置き換えてください:
{{hc|/etc/NetworkManager/dispatcher.d/wlan_auto_toggle.sh|<nowiki>
#!/bin/sh

if [ "$1" = "LAN_interface" ]; then
case "$2" in
up)
nmcli radio wifi off
;;
down)
nmcli radio wifi on
;;
esac
fi
</nowiki>}}
{{Note|インターフェイスは [[#nmcli|nmcli]] で確認できます。有線 (LAN) インターフェイスは先頭が {{ic|en}} となります。例: {{ic|1=enp0s5}}。}}

==== dispatcher を使ってネットワーク接続が確立された後に VPN に接続する ====

この例では特定の WiFi ネットワークの接続後に予め定義した VPN に自動的に接続します。最初にネットワークに接続した後にすることを定義した dispatcher スクリプトを作成する必要があります。

:1. dispatcher スクリプトを作成:
{{hc|/etc/NetworkManager/dispatcher.d/vpn-up|<nowiki>
#!/bin/sh
VPN_NAME="name of VPN connection defined in NetworkManager"
ESSID="Wi-Fi network ESSID (not connection name)"

interface=$1 status=$2
case $status in
up|vpn-down)
if iwgetid | grep -qs ":\"$ESSID\""; then
nmcli con up id "$VPN_NAME"
fi
;;
down)
if iwgetid | grep -qs ":\"$ESSID\""; then
if nmcli con show --active | grep "$VPN_NAME"; then
nmcli con down id "$VPN_NAME"
fi
fi
;;
esac
</nowiki>}}

全ての Wi-Fi ネットワークで VPN の接続を自動的にして欲しい場合は、ESSID は次のように定義します: {{ic|1=ESSID=$(iwgetid -r)}}。[[#ネットワークサービスと NetworkManager dispatcher|上述]]のようにスクリプトのパーミッションを忘れずに設定してください。

{{ic|nm-applet}} の ''Make the VPN connection available to all users'' オプションを有効にしている場合、接続が失敗して NetworkManager が 'no valid VPN secrets' と表示することがあります ([https://developer.gnome.org/NetworkManager/0.9/secrets-flags.html VPN の接続情報の保存方法] が問題です)。その場合、以下を試してみてください:

:2. VPN の接続ファイルを編集して NetworkManager が接続情報をキーリングではなく自分で保存するようにしてください [https://bugzilla.redhat.com/show_bug.cgi?id=710552]: {{ic|/etc/NetworkManager/system-connections/''name of your VPN connection''}} を開いて {{ic|password-flags}} と {{ic|secret-flags}} を {{ic|1}} から {{ic|0}} に変更します。

もしくは設定ファイルに {{ic|vpn-secrets}} セクションを追加して直接パスワードを記述します:
[vpn]
....
password-flags=0

[vpn-secrets]
password=your_password

{{Note|NetworkManager 接続エディタを開き、VPN パスワード/シークレットを再度保存する必要があります。}}

==== dispatcher を使って CIFS 共有のマウントを処理 ====

CIFS 共有の中には特定のネットワークや場所 (例: 家の中) を使っているときだけ使えるものがあります。ディスパッチャを使うことで現在の場所に応じて CIFS 共有をマウントすることができます。

以下のスクリプトは特定のネットワークに接続されているかどうか確認してから共有をマウントします:
{{hc|/etc/NetworkManager/dispatcher.d/mount_cifs|<nowiki>
#!/bin/bash
if [ "$2" = "up" ]; then
if [ "$CONNECTION_UUID" = "uuid" ]; then
mount /your/mount/point &
# add more shares as needed
fi
fi
</nowiki>}}
{{Note|[[#nmcli|nmcli]] を使うことで uuid のリストを取得できます。}}

以下のスクリプトは特定のネットワークから切断する前に全ての CIFS をアンマウントします:
{{hc|/etc/NetworkManager/dispatcher.d/pre-down.d/mount_cifs|<nowiki>
#!/bin/bash
umount -a -l -t cifs
</nowiki>}}
{{Note|
* 上記のスクリプトは {{ic|pre-down.d}} サブディレクトリに保存しないと、接続状態が変わったときに全ての共有がアンマウントされてしまいます。
* NetworkManager 0.9.8 から、'pre-down' や 'down' はシャットダウンや再起動時に実行されなくなりました。したがって上記のスクリプトはネットワークから手動で切断したときにのみ機能します。詳しくは [https://bugzilla.gnome.org/show_bug.cgi?id=701242 このバグレポート] を参照。}}

忘れずに[[#ネットワークサービスと NetworkManager dispatcher|上述]]のようにスクリプトにパーミッションを設定してください。

dispatcher の中で {{ic|/etc/fstab}} のマウントを解析する他のスクリプト例は [[NFS#NetworkManager dispatcher]] にあります。

=== プロクシ設定 ===

NetworkManager は直接プロクシ設定を扱いませんが、GNOME や KDE を使っている場合、NetworkManager の情報を使ってプロクシ設定を管理する [http://marin.jb.free.fr/proxydriver/ proxydriver] を使うことができます。[[Arch User Repository|AUR]] の {{AUR|proxydriver}} パッケージを探して下さい。

proxydriver でプロクシ設定を変更できるようにするには、GNOME スタートアッププロセスの一部として、次のコマンドを実行する必要があります (System -> Preferences -> Startup Applications):

xhost +si:localuser:''your_username''

参照: [[プロキシ設定]]

=== DHCP client ===

NetworkManager はデフォルトでは DHCP クライアントは内部のものを使います。DHCPv4 プラグインは [https://nettools.github.io/n-dhcp4/ nettools' n-dhcp4] ライブラリが基になっていて、DHCPv6 プラグインは {{ic|systemd-networkd}} のコードが基となっています。

NetworkManager は他の DHCP クライアントを使うことができ、そのためには次の好きな方をインストールしてください:

* {{Pkg|dhclient}} - ISCの DHCP クライアント。
* {{Pkg|dhcpcd}} - [[dhcpcd]]。

{{Note|
* NetworkManager は、 dhcpcd を IPv6 のために使うことを、サポートしていません (詳しくは [https://gitlab.freedesktop.org/NetworkManager/NetworkManager/issues/5 NetworkManager issue #5] )。DHCP クライアントとして dhcpcd を設定している場合には、 DHCPv6 内部のクライアントを使います。
* NetworkManager は{{Pkg|dhcpcd}} のバージョン 9.0.0 以上をサポートしなくなりました。詳細は {{Bug|66231}} を見てください。
* {{Pkg|dhclient}} や {{Pkg|dhclient}} が提供する systemd ユニットを有効にしないでください。NetworkManager と干渉します。
}}

DHCP クライアントのバックエンドを変えたい場合は、{{ic|/etc/NetworkManager/conf.d/}} にある設定ファイルで {{ic|1=main.dhcp=''dhcp_client_name''}} を設定してください。例:

{{hc|1=/etc/NetworkManager/conf.d/dhcp-client.conf|2=
[main]
dhcp=dhclient
}}

=== dnsmasq ===

{{Pkg|dnsmasq}} がインストールされていることを確認します。次に、{{ic|/etc/NetworkManager/conf.d/}} の設定ファイルを使用して {{ic|1=main.dns=dnsmasq}} を設定します。

{{hc|/etc/NetworkManager/conf.d/dns.conf|2=
[main]
dns=dnsmasq
}}

次に、root として {{ic|nmcli general reload}} を実行します。 NetworkManager は自動的に dnsmasq を起動し、 {{ic|/etc/resolv.conf}} に {{ic|127.0.0.1}} を追加します。元の DNS サーバは {{ic|/run/NetworkManager/no-stub-resolv.conf}} にあります。 dnsmasq が使用されていることを確認するには、 {{ic|drill example.com}} を使用して同じ DNS ルックアップを2回実行し、サーバーとクエリの時間を確認します。

{{Note|
* {{ic|dnsmasq.service}} を起動したり、 {{ic|/etc/dnsmasq.conf}} を編集したりする必要はありません。 NetworkManager は、 systemd サービスを使用せず、dnsmasq のデフォルト設定ファイルを読み込まずに dnsmasq を起動します。
* NetworkManager によって起動された dnsmasq インスタンスは {{ic|127.0.0.1:53}} にバインドされます。同じアドレスとポートで他のソフトウェア ({{ic|dnsmasq.service}} を含む) を実行することはできません。
}}

=== systemd-resolved ===

NetworkManager は、 [[systemd-resolved]] を DNS リゾルバおよびキャッシュとして使用できます。使用する前に、 ''systemd-resolved'' が正しく設定され、{{ic|systemd-resolved.service}} が [https://wiki.archlinux.jp/index.php/Systemd#.E3.83.A6.E3.83.8B.E3.83.83.E3.83.88.E3.82.92.E4.BD.BF.E3.81.86 スタート] してることを確認してください。

{{ic|/etc/resolv.conf}} が [https://wiki.archlinux.jp/index.php/Systemd-resolved#DNS symlink] から {{ic|/run/systemd/resolve/stub-resolv.conf}}、 {{ic|/run/systemd/resolve/resolv.conf}}、または {{ic|/usr/lib/systemd/resolv.conf}} に設定されている場合は、自動的に systemd-resolved が使用されます。

{{ic|1=main.dns=systemd-resolved}} を {{ic|/etc/NetworkManager/conf.d/}} 設定すると、明示的に有効にできます。

{{hc|/etc/NetworkManager/conf.d/dns.conf|2=
[main]
dns=systemd-resolved
}}

=== NetworkManager の無効化 ===

''dbus'' によってサービスが自動的に起動してしまうこともあります。''systemctl'' でサービスをマスクすることで完全に無効化できます:
# systemctl mask NetworkManager
# systemctl mask NetworkManager-dispatcher

=== /etc/resolv.conf ===

NetworkManager の {{ic|/etc/resolv.conf}} 管理モードは、 {{ic|main.rc-manager}} 設定で設定されています。デフォルトの {{ic|auto}} モードでは、 {{ic|/etc/resolv.conf}} の管理方法が次の順序で選択されます。

* {{ic|/etc/resolv.conf}} が [https://wiki.archlinux.jp/index.php/%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AE%E3%83%91%E3%83%BC%E3%83%9F%E3%83%83%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%A8%E5%B1%9E%E6%80%A7#.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.81.AE.E5.B1.9E.E6.80.A7 不変] の場合、ファイルは [https://wiki.archlinux.jp/index.php?title=NetworkManager&action=submit#.E7.AE.A1.E7.90.86.E5.AF.BE.E8.B1.A1.E5.A4.96.E3.81.AE_.2Fetc.2Fresolv.conf はまったく変更されません。] です。これは {{ic|1=main.rc-manager=unmanaged}} と同じです。
* {{ic|/etc/resolv.conf}} が {{ic|/run/systemd/resolve/stub-resolv.conf}}、 {{ic|/run/systemd/resolv.conf}}、または {{ic|/usr/lib/systemd/resolv.conf}} へのシンボリックリンクの場合、[[#systemd-resolved|systemd-resolved が使用されています]] これは {{ic|1=main.rc-manager=systemd-resolved}} と同じです。
* {{ic|/usr/bin/resolvconf}} が存在する場合は、[https://wiki.archlinux.jp/index.php?title=NetworkManager&action=submit#openresolv_.E3.82.92.E4.BD.BF.E7.94.A8 resolvconfを使用] これは {{ic|1=main.rc-manager=resolvconf}} と同じです。
* {{ic|/etc/resolv.conf}} が通常のファイルの場合、 NetworkManager はそのファイルに直接書き込みます。これは {{ic|1=main.rc-manager=file}} と同じです。

詳細は、 {{man|5|NetworkManager.conf}} のマニュアルページを参照してください。

{{Tip|openresolv を使用すると、 NetworkManager を他の ''resolvconf'' の場合サポートソフトウェアと共存させることができます。たとえば、 openresolv が [[openresolv#Subscribers|subscriber]] を持つローカル DNS キャッシングおよびスプリット DNS リゾルバを実行できます。 openresolv で NetworkManager を使用している場合、条件付き転送は[https://gitlab.freedesktop.org/NetworkManager/NetworkManager/issues/153 まだ完全にはサポートされていません]}}

''NetworkManager'' は、いわゆる dispatcher スクリプト経由のフックも提供しています。これは、ネットワークの変更後に {{ic|/etc/resolv.conf}} を変更するために使用できます。詳細は、 [https://wiki.archlinux.jp/index.php/NetworkManager#.E3.83.8D.E3.83.83.E3.83.88.E3.83.AF.E3.83.BC.E3.82.AF.E3.82.B5.E3.83.BC.E3.83.93.E3.82.B9.E3.81.A8_NetworkManager_dispatcher NetworkManager dispatcher] および {{man|8|NetworkManager}} を参照してください。

{{Note|
* NetworkManager が [[#dnsmasq|dnsmasq]] または [[#systemd-resolved|systemd-resolved]] のいずれかを使用するように設定されている場合、適切なループバックアドレスが {{ic|/etc/resolv.conf}} に書き込まれます。
* NetworkManager が {{ic|resolv.conf}} に書き込む、または書き込む {{ic|/etc/resolv.conf}} ファイルは、 {{ic|/run/NetworkManager/resolv.conf}} にあります。
* 取得したネームサーバと検索ドメインを含む {{ic|resolv.conf}} ファイルは {{ic|/run/NetworkManager/no-stub-resolv.conf}} にあります。
}}

===== 管理対象外の /etc/resolv.conf =====

NetworkManager が {{ic|/etc/resolv.conf}} に干渉しないようにするには、{{ic|/etc/NetworkManager/conf.d/}} の設定ファイルで {{ic|1=main.dns=none}} を設定します。

{{hc|/etc/NetworkManager/conf.d/dns.conf|2=
[main]
dns=none
}}

{{Tip|NetworkManager が DNS 設定を [[systemd-resolved]] に送信しないように、{{ic|1=main.systemd-resolved=false}} を設定することもできます。}}

{{Note|[[#DNS キャッシングと条件付きフォワーディング]] を参照して、NetworkManager を {{ic|1=main.dns=none}} ではなく、 [https://wiki.archlinux.jp/index.php/Dnsmasq dnsmasq] や [[systemd-resolved]] などの他の DNS バックエンドを使用して設定してください。}}

その後、 {{ic|/etc/resolv.conf}} は壊れたシンボリックリンクになるかもしれませんので、削除する必要があります。次に、新しい {{ic|/etc/resolv.conf}} ファイルを作成します。

===== openresolv を使用 =====

{{Tip|NetworkManager は、{{ic|/etc/resolv.conf}} が不変であるか、システムの {{ic|resolv.conf}} ファイルの一つへのシンボリックリンクでない限り、自動的に ''resolvconf'' を使います。}}

{{Note|NetworkManager は、 {{Pkg|systemd-resolvconf}} によって提供される system-resolved の ''resolvconf'' インターフェイス [https://man.archlinux.org/man/resolvectl.1#COMPATIBILITY_WITH_RESOLVCONF(8) resolvectl COMPATIBILITY WITH RESOLVCONF(8)] の使用をサポートしていません。
* [[systemd-resolved]] を使用する場合は、 {{ic|1=main.rc-manager=resolvconf}} を設定せず、 [https://wiki.archlinux.jp/index.php/Systemd-resolved#DNS /etc/resolv.conf へのシンボリックリンクを正しく作成します。] または [https://wiki.archlinux.org/index.php/NetworkManager#systemd-resolved NetworkManager を構成して、明示的に systemed-resolved を使用する] 設定してください。
* systemd-resolvconf を使用しない場合は、 {{Pkg|systemd-resolvconf}} パッケージがインストールされていないことを確認してください。 {{ic|systemd-resolved.service}} を起動しないと、 resolvconf を使用するすべてのネットワークソフトウェア (NetworkManager だけでなく) が動作しなくなります。
}}

[[openresolv]] を使用するように NetworkManager を明示的に設定するには、 {{ic|1=main.rc-manager=resolvconf}} を {{ic|/etc/NetworkManager/conf.d/}} の設定ファイルで設定します。

{{hc|/etc/NetworkManager/conf.d/rc-manager.conf|2=
[main]
rc-manager=resolvconf
}}

== テスト ==

ログイン時に NetworkManager アプレットがロードされるようになっているので、ほとんどの場合さらに設定をする必要はありません。既に前のネットワーク設定を無効にしてネットワークから切断している場合、NetworkManager が動作するかどうかテストすることができます。まず {{ic|NetworkManager.service}} を[[デーモン|起動]]してください。

アプレットは {{ic|.desktop}} ファイルを提供するので、NetworkManager アプレットはアプリケーションメニューからロードすることができます。アプレットがない場合、コマンドを探すか、一度ログアウトしてからログインしなおしてアプレットを起動してください。アプレットが起動すれば、DHCP サーバーの自動設定によってネットワーク接続のポーリングを開始します。

[[Awesome]] などの xdg 非互換のウィンドウマネージャで GNOME アプレットを起動するには:

nm-applet --sm-disable &

固定 IP を使うには NetworkManager を設定する必要があります。アプレットを右クリックして 'Edit Connections' などを選択してください。

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

一般的な問題に対する修正。

=== PPTP トンネルを使って通信できない ===

PPTP 接続のログインが成功すると、適切な VPN IP の ppp0 インターフェースが表示されますが、リモートの IP に ping できません。これは標準の Arch の pppd に MPPE (Microsoft Point-to-Point Encryption) サポートがないのが原因です。まず標準の Arch の {{Pkg|ppp}} を使って予期通り動作するか試すことを推奨します。

問題を解決するには [[Arch User Repository|AUR]] から {{AUR|ppp-mppe}}{{Broken package link|{{aur-mirror|ppp-mppe}}}} をインストールしてください。

PEAP の MSCHAPv2 type-2 認証を使う WPA2-Enterprise ワイヤレスネットワークでは標準の ppp パッケージではなく ppp-mppe が必要になることがあります。[[netctl]] では ppp-mppe がなくても設定いらずで動きます。いずれにしても、MSCHAPv2 は攻撃されやすいため使用が推奨されていません。ただし他の方法にすることはできないのが普通です。この [https://www.cloudcracker.com/blog/2012/07/29/cracking-ms-chap-v2/ 記事] を参照してください。

=== Network management disabled ===

時々 NetworkManager を終了したときに pid (state) ファイルが削除されずに 'Network management disabled' というメッセージが表示されることがあります。これが発生した場合は、手動でファイルを削除する必要があります:

# rm /var/lib/NetworkManager/NetworkManager.state

=== dhclient と DHCP に関する問題 ===

DHCP を使って IP を取得するときに問題が起こるときは、以下を {{ic|/etc/dhclient.conf}} に追加してみてください:
interface "eth0" {
send dhcp-client-identifier 01:aa:bb:cc:dd:ee:ff;
}
{{ic|aa:bb:cc:dd:ee:ff}} は NIC の MAC アドレスに置き換えてください。MAC アドレスは {{Pkg|iproute2}} パッケージの {{ic|ip link show ''interface''}} コマンドを使うことでわかります。

=== dhcpcd と DHCP に関する問題 ===

ルーターによっては、{{ic|/etc/dhcpcd.conf}} ({{ic|dhcpd.conf}} とは別のファイルです) 内の次の行をコメントアウトしないと正しく接続できないことがあります:
require dhcp_server_identifier
ネットワーク上で複数の DHCP サーバーを使ってなければこの修正によって問題が起こることはありません。詳細は [https://technet.microsoft.com/en-us/library/cc977442.aspx このページ] を見て下さい。

=== ホストネームの問題 ===

ホストネームが接続しているルーターに送信されるかどうかは、使用している NetworkManager プラグインによります。標準の "keyfile" プラグインはデフォルト設定ではホストネームを送信しません。ホストネームを送信するようにしたいときは、以下を {{ic|/etc/NetworkManager/NetworkManager.conf}} に追加してください:

{{hc|/etc/NetworkManager/NetworkManager.conf|2=
[keyfile]
hostname=''your_hostname''
}}

{{ic|[keyfile]}} 下のオプションはデフォルトの {{ic|/etc/NetworkManager/system-connections}} のパスのネットワーク接続に適用されます。

また、(NetworkManager が自動的に起動する) DHCP クライアントを設定して送信させることもできます。NetworkManager はデフォルトで {{Pkg|dhclient}} を利用しますが、インストールされていない場合は、NetworkManager 内蔵の DHCP 機能にフォールバックします。''dhclient'' でホストネームを送信するには設定を変更する必要があります。''dhcpcd'' はデフォルトでホストネームを送信します。

まず、どの DHCP クライアントが使われているのか確認 (以下の例では ''dhclient''):

{{hc|<nowiki># journalctl -b | egrep "dhc"</nowiki>|
...
Nov 17 21:03:20 zenbook dhclient[2949]: Nov 17 21:03:20 zenbook dhclient[2949]: Bound to *:546
Nov 17 21:03:20 zenbook dhclient[2949]: Listening on Socket/wlan0
Nov 17 21:03:20 zenbook dhclient[2949]: Sending on Socket/wlan0
Nov 17 21:03:20 zenbook dhclient[2949]: XMT: Info-Request on wlan0, interval 1020ms.
Nov 17 21:03:20 zenbook dhclient[2949]: RCV: Reply message on wlan0 from fe80::126f:3fff:fe0c:2dc.
}}

==== ホストネームを DHCP サーバーに送るように dhclient を設定する ====

サンプル設定ファイルをコピー:

# cp /usr/share/dhclient/dhclient.conf.example /etc/dhclient.conf

ファイルの中身を見てください。重要なのは以下の行です:

{{hc|/etc/dhclient.conf|2=send host-name = pick-first-value(gethostname(), "ISC-dhclient");}}

IP アドレスの更新を強制することで DHCP サーバーからホストネームを確認できるようになるはずです。

==== 特定の DHCP クライアントを使うように NetworkManager を設定する ====

NetworkManager で使用する DHCP クライアントを明示的に設定したい場合、グローバルな設定ファイルで設定できます:

{{hc|1=/etc/NetworkManager/NetworkManager.conf|2=dhcp=internal}}

上記のオプションが設定されていない場合、{{ic|1=dhcp=dhclient}} がデフォルトで使われます。

それから {{ic|NetworkManager.service}} を[[systemd#ユニットを使う|再起動]]してください。

{{Note|1={{Pkg|dhcpcd}} のサポートは {{Pkg|networkmanager}}-1.0.0-2 で [https://projects.archlinux.org/svntogit/packages.git/commit/trunk?h=packages/networkmanager&id=a1df79cbcebaec0c043789eb31965e57d17b6cdb 無効] になっています (2015-02-14)。}}

=== デフォルトの route が見つからない ===

KDE4 システムでは、NetworkManager でワイヤレス接続を確立したときにデフォルトの route が作られません。ワイヤレス接続の route 設定を変更してデフォルトの選択 "Use only for resources on this connection" を削除すれば問題は解決します。

=== 3G モデムが検知されない ===

[[USB 3G モデム#Network_Manager]] を参照してください。

=== ラップトップで WLAN をオフに切り替える ===

ラップトップについているスイッチを使って WiFi アダプタを無効にしてその後また有効にした時に NetworkManager が動作しないことがしばしばあります。これはほとんど {{ic|rfkill}} の問題です。[[公式リポジトリ]]から {{Pkg|rfkill}}{{Broken package link|置換パッケージ: {{Pkg|util-linux}}}} をインストールして、ドライバが {{ic|rfkill}} に無線アダプタの状態を通知しているかどうか確かめるために次のコマンドを実行してください:

$ watch -n1 rfkill list all

アダプタの切り替えを行った後に identifier がブロックされたままの場合、手動でブロックを解除することができます (X は上のコマンドで出力された identifier の番号に置き換えてください):

# rfkill event unblock X

=== 固定 IP 設定が DHCP に戻る ===

未解決のバグのため、デフォルトの接続を固定 IP にしたとき、{{ic|nm-applet}} は正しく設定を保存できず、自動 DHCP に戻ります。

この問題を解決するにはデフォルトの接続 (例: "Auto eth0") を {{ic|nm-applet}} で編集してから、接続の名前を変更し (例: "my eth0")、"Available to all users" のチェックを外して、固定 IP の設定をして、それから '''Apply''' をクリックする必要があります。これで新しい接続が指定した名前で保存されます。

さらに、デフォルト接続を自動で接続して欲しくない場合があるかもしれません。そうするには、{{ic|nm-connection-editor}} を (root 以外で) 起動してください。接続エディタで、デフォルト接続 (例: "Auto eth0") を編集して "Connect automatically" のチェックを外して '''Apply''' をクリックして終了してください。

=== ノーマルユーザーで接続を編集できない ===

[[#PolicyKit パーミッションの設定]] を見て下さい。

=== 隠れた無線ネットワークの削除 ===

ステルスが有効になっているネットワークは無線のリストに表示されないので、GUI で削除することは出来ません。次のコマンドでネットワークを削除することが可能です:

# rm /etc/NetworkManager/system-connections/[SSID]

他の接続でもこのコマンドは使えます。

=== VPN が Gnome で動作しない ===

Gnome で NetworkManager を使って openconnect や vpnc 接続を設定すると、ダイアログが表示されず以下のエラーが {{ic|/var/log/errors.log}} に現れることがあります:

localhost NetworkManager[399]: <error> [1361719690.10506] [nm-vpn-connection.c:1405] get_secrets_cb(): Failed to request VPN secrets #3: (6) No agents were available for this request.

これは GNOME の NM アプレットが {{ic|/usr/lib/gnome-shell}} にダイアログスクリプトがあると想定しているのが原因です。NetworkManager のパッケージは {{ic|/usr/lib/networkmanager}} に配置します。"一時的な"修正として (このバグをしばらく回避できます)、以下のシンボリックリンクを作成してください:

* OpenConnect の場合: {{ic|ln -s /usr/lib/networkmanager/nm-openconnect-auth-dialog /usr/lib/gnome-shell/}}
* VPNC (すなわち Cisco VPN) の場合: {{ic|ln -s /usr/lib/networkmanager/nm-vpnc-auth-dialog /usr/lib/gnome-shell/}}

他の NM VPN プラグインでも同じように設定してください。

=== Systemd のボトルネック ===

時が立つにつれてログファイル ({{ic|/var/log/journal}}) が膨大になってしまうことがあります。そうすると NetworkManager を使う場合にブートパフォーマンスに大きな影響を与えます。参照: [[systemd#少しづつ起動時間が長くなっている]]。

=== 定期的にネットワークが切断される (WiFi) ===

WiFi ドライバーの中にはベースステーションのスキャン時に問題が発生するものがあります。VPN が切断されたりパケットが消失したり、ウェブページがロードされないなどの症状が起こります。

{{ic|journalctl -f}} を実行すると、以下のようなメッセージが定期的にログに残っているならこの問題が関わっています:

NetworkManager[410]: <info> (wlp3s0): roamed from BSSID 00:14:48:11:20:CF (my-wifi-name) to (none) ((none))

パッチが適用された NetworkManager を使うことでこの種のスキャニングを防ぐことができます: {{AUR|networkmanager-noscan}}。

もしくは、ローミングが重要でない場合、WiFi の接続プロファイルでアクセスポイントの BSSID をロックすることで定期的なスキャンを無効化できます。

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

=== Wi-Fi パスワードの暗号化 ===

デフォルトでは NetworkManager は {{ic|/etc/NetworkManager/system-connections/}} に存在する接続ファイルに平文でパスワードを保存します。保存されているパスワードを表示するには、以下のコマンドを実行:

# grep -H '^psk=' /etc/NetworkManager/system-connections/*

パスワードにアクセスできるのは root ユーザーだけであり通常ユーザーは GUI の設定からアクセスできます (例: {{ic|nm-applet}})。

平文ではなく暗号化された状態で保存することもできますが、ユーザーごとに接続の設定が必要になります。

====Gnome-Keyring を使う====

キーリングデーモンを起動してキーリングを解錠する必要があります。

さらに、全てのユーザーでパスワードを保存しないように NetworkManager を設定しなければなりません。GNOME の {{ic|nm-applet}} を使う場合、ターミナルから {{ic|nm-connection-editor}} を起動してネットワーク接続を選択し、{{ic|Edit}} をクリックして、{{ic|Wifi-Security}} タブからパスワードの右のアイコンをクリックして {{ic|Store the password only for this user}} にチェックを入れてください。

=== wifi でインターネット接続を共有する ===

nm を使って数クリックでインターネット接続 (例: 3G または有線) を共有することができます。サポートされた wifi カードが必要になります (Atheros AR9xx や AR5xx を使っているカードがおそらく最適です)。

[[ファイアウォール]]がインターネット共有を妨害することもあるので注意してください。

==== Ad-hoc ====

* 接続の共有をできるようにするために {{Pkg|dnsmasq}} パッケージを[[pacman|インストール]]してください
* {{ic|dnsmasq.conf}} を修正すると nm に干渉する可能性があります
* nm-applet -> Create new wireless network をクリック
* ウィザードに従う (WEP を使用する場合、パスワードの長さは5文字あるいは13文字なければなりません)
* 次に必要になった時のために設定は保存されます

==== Real AP ====

2012年から、インフラストラクチャモード (ad-hoc をサポートしていない Android で必要) は NetworkManager でサポートされています。

参照: https://fedoraproject.org/wiki/Features/RealHotspot

=== cron ジョブやスクリプトでネットワークが立ち上がっているか確認する ===

cron ジョブの中にはネットワークが立ち上がっている必要があるジョブもあります。ネットワークが立ち上がっていない場合はジョブを実行しないようにすることができます。そのためには、NetworkManager の {{ic|nm-tool}} を使ってネットワークの状態を確認する '''if''' テストを追加します。インターフェイスが立ち上がっている場合はテストは通りますが、全てのインターフェイスがダウンになっている場合はテストを通過しません。無線でネットワークにつながっていたり、いなかったりするノートパソコンなどで有用です。
{{bc|<nowiki>
if [ $(nm-tool|grep State|cut -f2 -d' ') == "connected" ]; then
#Whatever you want to do if the network is online
else
#Whatever you want to do if the network is offline - note, this and the else above are optional
fi
</nowiki>}}

上記は {{ic|cron.hourly}} スクリプトを使って {{ic|fpupdate}} を実行し F-Prot ウイルススキャナをアップデートしている場合などに有用です。

=== ログイン時に自動的に接続する ===

デフォルトでは、パスワードを入力しないと使えないネットワークの場合 NetworkManager は起動時に自動的に接続しません。自動的に接続するには以下の設定が必要です:

# {{ic|nm-applet}} アイコンを右クリックして Edit Connections を選択し Wireless タブを開いて下さい
# 使用したい接続を選択して Edit ボタンをクリックしてください
# “Connect Automatically” と “Available to all users” のボックスにチェックを入れて下さい
一度ログアウトしてから再ログインすれば設定は完了です。

=== ログインのあと自動でキーリングを解除する ===

NetworkManager はログイン情報を必要とするネットワークに接続するときにログインキーリングにアクセスします。大抵の場合、ログイン時に自動的に解錠されますが、解錠されていない場合、NetworkManager はログイン時に接続することができません。

==== GNOME ====

{{Note|以下の方法は古い情報であり機能する保証はありません。}}
* {{ic|/etc/pam.d/gdm}} (もしくは {{ic|/etc/pam.d}} にある適当なデーモン) を開いて、"auth" と "session" ブロックの最後に以下の行を追加します:
auth optional pam_gnome_keyring.so
session optional pam_gnome_keyring.so auto_start

* {{ic|/etc/pam.d/passwd}} を開いて、'password' ブロックで以下の行を使います:
password optional pam_gnome_keyring.so

:次のログイン時に、パスワードをログイン時に自動的にロック解除するべきかどうか尋ねられるはずです。

==== SLiM ログインマネージャ ====
[[SLiM#SLiM と Gnome Keyring]] を見て下さい。

=== 特定のデバイスを無視する ===

時々 NetworkManager に特定のデバイスを無視してもらってアドレスやルートを設定しないのが望ましいことがあります。{{ic|/etc/NetworkManager/NetworkManager.conf}} で以下を使うことで MAC やインターフェイス名によってデバイスを無視するよう設定できます:
[keyfile]
unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth0
これを記述した後、NetworkManager を[[デーモン|再起動]]してください。設定したデバイスに触れないように NetworkManager でインターフェイスを設定できるはずです。

=== 接続の高速化 ===

==== IPv6 を無効にする ====

NetworkManager の余計な IPv6 クエリーによって接続が遅くなったりネットワークの再接続が起こることがあります。ローカルネットワークで IPv6 をサポートしていない場合、NetworkManager が IPv6 の接続を確立しようとして結局タイムアウトするので、通常よりもネットワークへの接続に時間がかかるかもしれません。解決策は NetworkManager で IPv6 を無効にすることで、これによってネットワーク接続が高速になります。以下は接続するネットワークごとに実行する必要があります。

* ネットワーク状態アイコンを右クリック。
* "Edit Connections" をクリック。
* "Wired" か "Wireless" タブを見る。
* ネットワークの名前を選択。
* "Edit" をクリック。
* "IPv6 Settings" タブを見る。
* "Method" ドロップダウンから "Ignore/Disabled" を選択。
* "Save" をクリック。

==== DHCPCD の ARP probing を無効にして DHCP をスピードアップ ====

{{ic|dhcpcd}} には割り当てられた IP アドレスが実際に取得されているかどうか ARP を使って確認する DHCP 標準 ([https://www.ietf.org/rfc/rfc2131.txt RFC2131] section 2.2) の勧告の実装が含まれています。家庭ネットワークではほとんどの場合これは不要なので、次の行を {{ic|/etc/dhcpcd.conf}} に加えることで接続にかかる時間を5秒間短くできます:

noarp

これは {{ic|dhcpcd}}　に {{ic|--noarp}} を渡すのと同じであり、上述の ARP probing を無効にして、DHCP によるネットワーク接続を高速化します。

==== OpenDNS サーバーを使う ====

{{ic|/etc/resolv.conf.opendns}} を以下のネームサーバで作成してください:

nameserver 208.67.222.222
nameserver 208.67.220.220

もしくは Google DNS サーバーを使って下さい:

nameserver 8.8.8.8
nameserver 8.8.4.4

そして DHCP サーバーを OpenDNS サーバーに置き換える dispatcher を作って下さい:

{{hc|/etc/NetworkManager/dispatcher.d/dns-servers-opendns|<nowiki>
#!/bin/bash
# Use OpenDNS servers over DHCP discovered servers

cp -f /etc/resolv.conf.opendns /etc/resolv.conf</nowiki>}}

スクリプトを実行可能にします:

# chmod +x /etc/NetworkManager/dispatcher.d/dns-servers-opendns

=== MAC アドレスのランダム化の設定 ===

バージョン 1.4.0 現在、NetworkManager では2種類の MAC アドレスランダム化をサポートしています。スキャン時のランダム化と定常的なランダム化です。どちらのモードも {{ic|/etc/NetworkManager/NetworkManager.conf}} で設定できます。

無線スキャン時のランダム化はバージョン 1.2.0 からデフォルトで有効になっており、以下の行を {{ic|/etc/NetworkManager/NetworkManager.conf}} に追加することで無効にできます:

[device]
wifi.scan-rand-mac-address=no

{{Tip|1=MAC アドレスのランダム化を無効にすることで接続が安定することがあります。[https://bbs.archlinux.org/viewtopic.php?id=220101] を参照。}}

定常的なランダム化では接続するたびに MAC アドレスが変わります。MAC アドレスでログイン状態を記録するポータルなどで有用です。有効にするには以下のオプションを使用:

[connection]
wifi.cloned-mac-address=random

または:

[connection]
ethernet.cloned-mac-address=random

詳しくは [https://blogs.gnome.org/thaller/2016/08/26/mac-address-spoofing-in-networkmanager-1-4-0/ こちら] を参照してください。

=== IPv6 プライバシー拡張の有効化 ===

[[IPv6#NetworkManager]] を見てください。

== 参照 ==
* [https://blogs.gnome.org/dcbw/2015/02/16/networkmanager-for-administrators-part-1/ NetworkManager for Administrators Part 1]

NetworkManager

2021-12-26T07:58:23Z

Oriaca372m: /* NetworkManager を有効にする */

[[Category:ネットワークマネージャ]]
[[Category:Red Hat]]
[[cs:NetworkManager]]
[[de:Networkmanager]]
[[en:NetworkManager]]
[[es:NetworkManager]]
[[fr:NetworkManager]]
[[it:NetworkManager]]
[[pt:NetworkManager]]
[[ru:NetworkManager]]
[[tr:NetworkManager]]
[[zh-hans:NetworkManager]]
{{Related articles start}}
{{Related|ネットワーク設定}}
{{Related|ワイヤレス設定}}
{{Related|Netctl}}
{{Related|Wicd}}
{{Related articles end}}
[http://projects.gnome.org/NetworkManager/ NetworkManager] はネットワークの検知とシステムの設定を自動で行いネットワークに接続するプログラムです。NetworkManager の機能は無線・有線両方のネットワークに使うことができます。無線ネットワークでは、NetworkManager は既知の無線ネットワークを優先し、一番信頼性のあるネットワークに切り替えることができます。NetworkManager 対応アプリケーションはオンラインとオフラインを切り替えることが可能です。また、NetworkManager では無線接続よりも有線接続が優先され、モデム接続や特定の VPN に対応しています。NetworkManager はもともとは Red Hat によって開発されていましたが、現在では [[GNOME]] プロジェクトによってホストされています。

{{Warning|初期設定では、Wi-Fi パスワードは平文で保存されます。直すためには、[[#Wi-Fi パスワードの暗号化]]を見てください。}}

== インストール ==

NetworkManager は[[公式リポジトリ]]にある {{Pkg|networkmanager}} パッケージでインストールできます。これには、デーモンとコマンドラインインターフェース ({{ic|nmcli}})、cursesベースのテキストインターフェース ({{ic|nmtui}})が含まれます。

=== NetworkManager を有効にする ===

インストール後、{{ic|NetworkManager.service}} を [[systemd#ユニットを使う|開始/有効]] します。NetworkManger デーモンが起動すると、すでに構成されている使用可能な "system connections" に自動的に接続します。"user connections" または未接続の場合は、構成および接続するために、nmcli またはアプレットが必要です。

=== 追加のインターフェース ===

* {{Pkg|nm-connection-editor}}: グラフィカルインターフェース。
* {{Pkg|network-manager-applet}}: システムトレイアプレット ({{ic|nm-applet}}).

{{Note|ネットワークを設定しようとするサービスが他に動いていないことを確認してください。複数のネットワークサービスがあると衝突します。{{ic|1=systemctl --type=service}} で現在動作しているサービスのリストを表示できるので、ネットワークサービスがあったら[[systemd#ユニットを使う|停止]]してください。NetworkManager サービスを有効にする方法は[[#設定|設定]]を見てください。}}

=== VPN サポート ===

NetworkManager 1.16 から [[WireGuard]] に対応しました。詳細は [https://blogs.gnome.org/thaller/2019/03/15/wireguard-in-networkmanager/] を参照してください。

NetworkManager の VPN サポートはプラグインシステムをベースにしています。NetworkManager で VPN のサポートが必要なときは以下のパッケージの中から必要なものをインストールしてください:

* {{Pkg|networkmanager-openconnect}} for [[OpenConnect]]
* {{Pkg|networkmanager-openvpn}} for [[OpenVPN]]
* {{Pkg|networkmanager-pptp}} for [[PPTP クライアント]]
* {{Pkg|networkmanager-vpnc}} for [[Vpnc]]
* {{Pkg|networkmanager-strongswan}} for [[strongSwan]]
* {{AUR|networkmanager-fortisslvpn-git}}
* {{AUR|networkmanager-iodine-git}}
* {{AUR|networkmanager-libreswan}}
* {{AUR|networkmanager-l2tp}}
* {{AUR|networkmanager-ssh-git}}
* {{Pkg|network-manager-sstp}}

{{Warning|1=VPN サポートは [https://bugzilla.gnome.org/buglist.cgi?quicksearch=networkmanager%20vpn 不安定] です。GUI からデーモンプロセスのオプションが正しく設定されていることを確認して、パッケージがリリースされるたびに再確認してください [https://bugzilla.gnome.org/show_bug.cgi?id=755350]。}}

=== Mobile broadband support ===

モバイル回線に接続するためには、{{pkg|modemmanager}}か {{pkg|mobile-broadband-provider-info}} 、または {{pkg|usb_modeswitch}} を[[インストール]]してください。詳しくは [[USB 3G モデム#Network Manager]] を確認してください。

=== PPPoE / DSL サポート ===

PPPoE / DSL 接続のサポートが必要な場合は {{pkg|rp-pppoe}} を[[インストール]]してください。実際に使うためには、{{ic|1=nm-connection-editor}} から新しい DSL/PPPoE 接続を追加してください。

== グラフィカルフロントエンド ==

NetworkManager を簡単に使えるようにするためのアプレットをインストールすることができます。この GUI フロントエンドはシステムトレイ（や通知エリア）に収納され、NetworkManager のネットワーク選択や設定が可能です。異なるデスクトップにあわせて様々なアプレットが存在します。その他に [[#nm-applet]] を使うこともできます。

=== GNOME ===

GNOME にはツールが内蔵されており、ネットワーク設定からアクセスできます。

=== KDE Plasma ===

{{Pkg|plasma-nm}} アプレットをインストールしてください。

=== nm-applet ===

{{Pkg|network-manager-applet}} はあらゆる Xorg 環境で動作する GTK+ 3 フロントエンドです (システムトレイに表示されます)。

接続情報を保存するには [[GNOME Keyring]] をインストール・設定してください。

{{ic|Make available to other users}} オプションを有効にすると、NetworkManager はパスワードを平文で保存します。ただしファイルにアクセスできるのは root だけです (他のユーザーは {{ic|nm-applet}} を介してアクセスします)。[[#Wi-Fi パスワードの暗号化]]を見てください。

システムトレイを使わずに {{ic|nm-applet}} を起動したい場合、{{Pkg|trayer}} または {{Pkg|stalonetray}} を使います。例えば、以下のようなスクリプトを追加して使うことができます:

{{hc|nmgui|<nowiki>
#!/bin/sh
nm-applet 2>&1 > /dev/null &
stalonetray 2>&1 > /dev/null
killall nm-applet
</nowiki>}}

[[stalonetray]] のウィンドウを閉じると {{ic|nm-applet}} も終了するため、ネットワーク設定で無駄なメモリを消費することがありません。

==== Xfce ====
[[Xfce]] でも {{Pkg|network-manager-applet}} は動作しますが、エラーメッセージなど通知を表示するには {{ic|nm-applet}} に加えて FreeDesktop.org の仕様に準拠した[[デスクトップ通知]]デーモンが必要です。xfce のパネル設定では "Notification Area" という名前のアプリになります。通知を有効にするには {{Pkg|xfce4-notifyd}} をインストールしてください。新しい無線ネットワークに接続したときにパスワードの入力プロンプトを表示させるには {{Pkg|gnome-keyring}} などの org.freedesktop.secrets サービスが必要です。

通知デーモンがないと、{{ic|nm-applet}} アプレットは以下のエラーを標準出力に表示します:

(nm-applet:24209): libnotify-WARNING **: Failed to connect to proxy
** (nm-applet:24209): WARNING **: get_all_cb: couldn't retrieve
system settings properties: (25) Launch helper exited with unknown
return code 1.
** (nm-applet:24209): WARNING **: fetch_connections_done: error
fetching connections: (25) Launch helper exited with unknown return
code 1.
** (nm-applet:24209): WARNING **: Failed to register as an agent:
(25) Launch helper exited with unknown return code 1

{{ic|nm-applet}} は問題なく動作しますが、通知は表示されません。

アプレットが表示されない場合は {{AUR|xfce4-indicator-plugin}} パッケージをインストールしてください [https://askubuntu.com/questions/449658/networkmanager-tray-nm-applet-is-gone-after-upgrade-to-14-04-trusty]。

==== Openbox ====

Openbox で正しく動作させるには、XFCE と同じ理由で GNOME アプレットに {{Pkg|xfce4-notifyd}} 通知デーモンが必要です。また、システムトレイにアプレットを表示するには {{Pkg|gnome-icon-theme}} パッケージが必要です。

認証情報 (Wireless/DSL) を保存するには [[GNOME Keyring]] をインストール・設定してください。

{{ic|nm-applet}} は autostart ファイルを {{ic|/etc/xdg/autostart/nm-applet.desktop}} にインストールします。これに問題が発生する場合 (例: {{ic|nm-applet}} が二度起動する、全く起動しない)、[[Openbox#autostart]] や [https://bbs.archlinux.org/viewtopic.php?pid=993738] を見て解決してください。

=== コマンドライン ===

==== nmcli ====

{{Pkg|networkmanager}} パッケージにはバージョン 0.8.1 から [http://manpages.ubuntu.com/manpages/maverick/man1/nmcli.1.html nmcli] が含まれています。

例:

* wifi ネットワークに接続するには: {{bc|nmcli dev wifi connect <name> password <password>}}
* {{ic|wlan1}} の wifi インターフェイスの wifi に接続するには: {{bc|nmcli dev wifi connect <name> password <password> iface wlan1 [profile name]}}
* インターフェイスを切断するには: {{bc|nmcli dev disconnect iface eth0}}
* 切断されたインターフェイスに再接続するには: {{bc|nmcli con up uuid <uuid>}}
* UUID のリストを表示するには: {{bc|nmcli con show}}
* ネットワークデバイスのリストと状態を表示するには: {{bc|nmcli dev}}
* wifi をオフにするには: {{bc|nmcli r wifi off}}

==== nmtui ====

''nmtui'' は ''networkmanager'' のグラフィックフロントエンドで curses を使っています。X のない環境でネットワークを設定・管理するのに便利です。{{Pkg|networkmanager}} パッケージにはバージョン 0.9.10 から ''nmtui'' が含まれています。

==== nmcli-dmenu ====

もしくは {{ic|nm-applet}} の代わりに ''dmenu'' を使って NetworkManager の接続を管理する小さなスクリプト {{AUR|networkmanager-dmenu-git}} も存在します。既存の NetworkManager の有線・無線接続に接続したり、新しい無線接続に接続したり、必要であればパスフレーズをリクエストする、既存の VPN 接続に接続する、ネットワークを無効化・有効化する、''nm-connection-editor'' GUI を起動するなどの機能が備わっています。

== 設定 ==

NetworkManager には正しく機能させるために必要なことがあります。

次に進む前に {{ic|/etc/hosts}} が正しいことを確認してください。この手順を行う前に接続を試すと、NetworkManager が設定を変えてしまうことがあります。[[ネットワーク設定 #ホストネームの設定]] にあるように設定ができていることを確認してください。{{ic|/etc/hosts}} の例:

{{hc|/etc/hosts|
127.0.0.1 localhost
::1 localhost
}}

nss-myhostname を使っていない場合:

{{hc|/etc/hosts|
127.0.0.1 my-laptop localhost
::1 my-laptop localhost
}}

=== NetworkManager を有効にする ===

NetworkManager は {{ic|NetworkManager.service}} を使って[[systemd#ユニットを使う|操作]]します。NetworkManager デーモンが起動すると、自動的に設定済みの有効な "システム接続" に接続します。"ユーザー接続"や設定していない接続には {{ic|nmcli}} やアプレットを使って設定・接続する必要があります。

NetworkManager のグローバルな設定ファイルは {{ic|/etc/NetworkManager/NetworkManager.conf}} にあります。他の設定ファイルは {{ic|/etc/NetworkManager/conf.d/}} 以下に置くことが出来ます。通常、グローバルなデフォルト設定ファイルに設定を加える必要はありません。

=== NetworkManager Wait Online を有効にする ===
ネットワークが立ち上がる前にサービスが起動して失敗する場合、NetworkManager サービスにプラスして {{ic|NetworkManager-wait-online.service}} を使って下さい。ただし、ネットワークが設定されていないときでも殆どのネットワークデーモンは正しく立ち上がるので、これが必要になるのは稀です。

それでもサービスが正しく起動できない場合 {{ic|/usr/lib/systemd/system/NetworkManager-wait-online.service}} のタイムアウト設定が短すぎることが原因です。デフォルトのタイムアウトである 30 から高い値に修正してください。

=== PolicyKit パーミッションの設定 ===

ワーキングセッションの設定については[[一般的なトラブルシューティング#セッションのパーミッション]]を参照してください。

ワーキングセッションで、NetworkManager に必要な特権を与える方法は複数存在します:

''方法 1.'' ログイン時に {{ic|/usr/lib/polkit-gnome/polkit-gnome-authentication-agent-1}} ({{Pkg|polkit-gnome}} に含まれています) などの [[PolicyKit]] 認証エージェントを実行する。ネットワーク接続を追加・削除したときにパスワードを求められるようになります。

''方法 2.'' ユーザーを {{ic|wheel}} グループに追加する。パスワードを入力する必要はなくなりますが、root パスワードを入力せずに [[sudo]] を使えるなど、他の権限もユーザーアカウントに与えてしまうことになります。

''方法 3.'' ユーザーを {{ic|network}} グループに追加して以下のファイルを作成する:
{{hc|/etc/polkit-1/rules.d/50-org.freedesktop.NetworkManager.rules|<nowiki>
polkit.addRule(function(action, subject) {
if (action.id.indexOf("org.freedesktop.NetworkManager.") == 0 && subject.isInGroup("network")) {
return polkit.Result.YES;
}
});</nowiki>}}
{{ic|network}} グループの全てのユーザーはパスワードなしでネットワークを追加・削除できるようになります。[[ディスプレイマネージャ#systemd-logind を使う|systemd-logind]] でアクティブセッションを作っていない場合、この方法は systemd では動きません。

=== ネットワークサービスと NetworkManager dispatcher===

NetworkManager がインターフェースを立ち上げるまで動かしたくないネットワークサービスというのが相当数存在します。[[Network Time Protocol daemon|NTPd]] や様々なタイプのネットワークファイルシステムマウント (例: '''netfs''') が好例です。NetworkManager には、あなたがネットワークに接続したときにこれらのサービスを起動して、切断したときにサービスを停止する機能があります。この機能を有効にするには {{ic|NetworkManager-dispatcher.service}} を[[systemd#ユニットを使う|起動]]してください。

機能を有効にすれば、スクリプトを {{ic|/etc/NetworkManager/dispatcher.d}} ディレクトリに追加することができます。スクリプトは実行可能でユーザーのパーミッションがなければなりません。セキュリティ上、スクリプトの所有者を '''root:root''' にして書き込み権限を所有者だけに与えるとよいでしょう。

接続時にアルファベット順でスクリプトは実行され、切断時にはアルファベットの逆順で実行されます。スクリプトには2つの引数が渡されます: インターフェースの名前 (例: ''eth0'') と状態 (インターフェイスは ''up'' か ''down''、vpn 接続は ''vpn-up'' か ''vpn-down'') です。起動する順番を正確に決めるために、しばしばスクリプトの名前の前に数字が使われます (例: {{ic|10_portmap}} や {{ic|30_netfs}} (これでポートマップが NFS マウントよりも先に実行されます)。

{{Warning|パブリックネットワークに接続する場合、起動するサービスや接続するサーバーに注意してください。パブリックネットワークに接続している際に間違ったサービスを起動するとセキュリティホールとなる可能性があります。}}

==== 3秒タイムアウトを止める ====

上の設定で動作するなら、このセクションは関係ありません。ただし、実行するのに3秒以上かかる dispatcher スクリプトを動かす場合は共通の問題があります。NetworkManager は内部的に3秒タイムアウトを使っており (詳しくは[https://bugzilla.redhat.com/show_bug.cgi?id=982734 バグトラッカー]を参照) 3秒以上時間がかかっているスクリプトを自動的に殺します。この場合、{{ic|/usr/lib/systemd/system/NetworkManager-dispatcher.service}} にある dispatcher サービスファイルを有効にしつづけるように修正が必要です。以下の内容でサービスファイル {{ic|/etc/systemd/system/NetworkManager-dispatcher.service}} を作成してください:

.include /usr/lib/systemd/system/NetworkManager-dispatcher.service
[Service]
RemainAfterExit=yes

作成したら修正を加えた {{ic|NetworkManager-dispatcher}} スクリプトを有効にしてください。

==== OpenNTPD を起動 ====

{{AUR|networkmanager-dispatcher-openntpd}} パッケージをインストールしてください。

==== リモートフォルダを sshfs でマウント ====

スクリプトは制限的な環境で実行されるので、SSH エージェントに接続するには {{ic|SSH_AUTH_SOCK}} を export する必要があります。複数の方法が存在します、詳しくは [https://bbs.archlinux.org/viewtopic.php?pid=1042030#p1042030 このメッセージ] を見て下さい。以下の例は [[GNOME Keyring]] と一緒に動作し、ロックが解除されていない場合にパスワードを尋ねます。NetworkManager がログイン時に自動的に接続する場合は、''gnome-keyring'' は起動せず export は失敗します。{{ic|UUID}} は {{ic|nmcli con status}} や {{ic|nmcli con list}} コマンドで確認できます。

{{bc|<nowiki>
#!/bin/sh
USER='username'
REMOTE='user@host:/remote/path'
LOCAL='/local/path'

interface=$1 status=$2
if [ "$CONNECTION_UUID" = "</nowiki>''uuid''<nowiki>" ]; then
case $status in
up)
export SSH_AUTH_SOCK=$(find /tmp -maxdepth 1 -type s -user "$USER" -name 'ssh')
su "$USER" -c "sshfs $REMOTE $LOCAL"
;;
down)
fusermount -u "$LOCAL"
;;
esac
fi
</nowiki>}}

==== dispatcher を使って LAN ケーブルが接続されているかどうかに応じて自動的に Wi-Fi を切り替える ====

LAN ケーブルが接続されていない場合にのみ Wi-Fi をオンにして、LAN ケーブルが接続されたら (ノートパソコンがドックに接続された場合など) Wi-Fi を自動的に無効化することができます。

以下の dispatcher スクリプトを作成してください ([https://superuser.com/questions/233448/disable-wlan-if-wired-cable-network-is-available ソース])、{{ic|1=LAN_interface}} は適当なインターフェイスに置き換えてください:
{{hc|/etc/NetworkManager/dispatcher.d/wlan_auto_toggle.sh|<nowiki>
#!/bin/sh

if [ "$1" = "LAN_interface" ]; then
case "$2" in
up)
nmcli radio wifi off
;;
down)
nmcli radio wifi on
;;
esac
fi
</nowiki>}}
{{Note|インターフェイスは [[#nmcli|nmcli]] で確認できます。有線 (LAN) インターフェイスは先頭が {{ic|en}} となります。例: {{ic|1=enp0s5}}。}}

==== dispatcher を使ってネットワーク接続が確立された後に VPN に接続する ====

この例では特定の WiFi ネットワークの接続後に予め定義した VPN に自動的に接続します。最初にネットワークに接続した後にすることを定義した dispatcher スクリプトを作成する必要があります。

:1. dispatcher スクリプトを作成:
{{hc|/etc/NetworkManager/dispatcher.d/vpn-up|<nowiki>
#!/bin/sh
VPN_NAME="name of VPN connection defined in NetworkManager"
ESSID="Wi-Fi network ESSID (not connection name)"

interface=$1 status=$2
case $status in
up|vpn-down)
if iwgetid | grep -qs ":\"$ESSID\""; then
nmcli con up id "$VPN_NAME"
fi
;;
down)
if iwgetid | grep -qs ":\"$ESSID\""; then
if nmcli con show --active | grep "$VPN_NAME"; then
nmcli con down id "$VPN_NAME"
fi
fi
;;
esac
</nowiki>}}

全ての Wi-Fi ネットワークで VPN の接続を自動的にして欲しい場合は、ESSID は次のように定義します: {{ic|1=ESSID=$(iwgetid -r)}}。[[#ネットワークサービスと NetworkManager dispatcher|上述]]のようにスクリプトのパーミッションを忘れずに設定してください。

{{ic|nm-applet}} の ''Make the VPN connection available to all users'' オプションを有効にしている場合、接続が失敗して NetworkManager が 'no valid VPN secrets' と表示することがあります ([https://developer.gnome.org/NetworkManager/0.9/secrets-flags.html VPN の接続情報の保存方法] が問題です)。その場合、以下を試してみてください:

:2. VPN の接続ファイルを編集して NetworkManager が接続情報をキーリングではなく自分で保存するようにしてください [https://bugzilla.redhat.com/show_bug.cgi?id=710552]: {{ic|/etc/NetworkManager/system-connections/''name of your VPN connection''}} を開いて {{ic|password-flags}} と {{ic|secret-flags}} を {{ic|1}} から {{ic|0}} に変更します。

もしくは設定ファイルに {{ic|vpn-secrets}} セクションを追加して直接パスワードを記述します:
[vpn]
....
password-flags=0

[vpn-secrets]
password=your_password

{{Note|NetworkManager 接続エディタを開き、VPN パスワード/シークレットを再度保存する必要があります。}}

==== dispatcher を使って CIFS 共有のマウントを処理 ====

CIFS 共有の中には特定のネットワークや場所 (例: 家の中) を使っているときだけ使えるものがあります。ディスパッチャを使うことで現在の場所に応じて CIFS 共有をマウントすることができます。

以下のスクリプトは特定のネットワークに接続されているかどうか確認してから共有をマウントします:
{{hc|/etc/NetworkManager/dispatcher.d/mount_cifs|<nowiki>
#!/bin/bash
if [ "$2" = "up" ]; then
if [ "$CONNECTION_UUID" = "uuid" ]; then
mount /your/mount/point &
# add more shares as needed
fi
fi
</nowiki>}}
{{Note|[[#nmcli|nmcli]] を使うことで uuid のリストを取得できます。}}

以下のスクリプトは特定のネットワークから切断する前に全ての CIFS をアンマウントします:
{{hc|/etc/NetworkManager/dispatcher.d/pre-down.d/mount_cifs|<nowiki>
#!/bin/bash
umount -a -l -t cifs
</nowiki>}}
{{Note|
* 上記のスクリプトは {{ic|pre-down.d}} サブディレクトリに保存しないと、接続状態が変わったときに全ての共有がアンマウントされてしまいます。
* NetworkManager 0.9.8 から、'pre-down' や 'down' はシャットダウンや再起動時に実行されなくなりました。したがって上記のスクリプトはネットワークから手動で切断したときにのみ機能します。詳しくは [https://bugzilla.gnome.org/show_bug.cgi?id=701242 このバグレポート] を参照。}}

忘れずに[[#ネットワークサービスと NetworkManager dispatcher|上述]]のようにスクリプトにパーミッションを設定してください。

dispatcher の中で {{ic|/etc/fstab}} のマウントを解析する他のスクリプト例は [[NFS#NetworkManager dispatcher]] にあります。

=== プロクシ設定 ===

NetworkManager は直接プロクシ設定を扱いませんが、GNOME や KDE を使っている場合、NetworkManager の情報を使ってプロクシ設定を管理する [http://marin.jb.free.fr/proxydriver/ proxydriver] を使うことができます。[[Arch User Repository|AUR]] の {{AUR|proxydriver}} パッケージを探して下さい。

proxydriver でプロクシ設定を変更できるようにするには、GNOME スタートアッププロセスの一部として、次のコマンドを実行する必要があります (System -> Preferences -> Startup Applications):

xhost +si:localuser:''your_username''

参照: [[プロキシ設定]]

=== DHCP client ===

NetworkManager はデフォルトでは DHCP クライアントは内部のものを使います。DHCPv4 プラグインは [https://nettools.github.io/n-dhcp4/ nettools' n-dhcp4] ライブラリが基になっていて、DHCPv6 プラグインは {{ic|systemd-networkd}} のコードが基となっています。

NetworkManager は他の DHCP クライアントを使うことができ、そのためには次の好きな方をインストールしてください:

* {{Pkg|dhclient}} - ISCの DHCP クライアント。
* {{Pkg|dhcpcd}} - [[dhcpcd]]。

{{Note|
* NetworkManager は、 dhcpcd を IPv6 のために使うことを、サポートしていません (詳しくは [https://gitlab.freedesktop.org/NetworkManager/NetworkManager/issues/5 NetworkManager issue #5] )。DHCP クライアントとして dhcpcd を設定している場合には、 DHCPv6 内部のクライアントを使います。
* NetworkManger は{{Pkg|dhcpcd}} のバージョン 9.0.0 以上をサポートしなくなりました。詳細は {{Bug|66231}} を見てください。
* {{Pkg|dhclient}} や {{Pkg|dhclient}} が提供する systemd ユニットを有効にしないでください。NetworkManager と干渉します。
}}

DHCP クライアントのバックエンドを変えたい場合は、{{ic|/etc/NetworkManager/conf.d/}} にある設定ファイルで {{ic|1=main.dhcp=''dhcp_client_name''}} を設定してください。例:

{{hc|1=/etc/NetworkManager/conf.d/dhcp-client.conf|2=
[main]
dhcp=dhclient
}}

=== dnsmasq ===

{{Pkg|dnsmasq}} がインストールされていることを確認します。次に、{{ic|/etc/NetworkManager/conf.d/}} の設定ファイルを使用して {{ic|1=main.dns=dnsmasq}} を設定します。

{{hc|/etc/NetworkManager/conf.d/dns.conf|2=
[main]
dns=dnsmasq
}}

次に、root として {{ic|nmcli general reload}} を実行します。 NetworkManager は自動的に dnsmasq を起動し、 {{ic|/etc/resolv.conf}} に {{ic|127.0.0.1}} を追加します。元の DNS サーバは {{ic|/run/NetworkManager/no-stub-resolv.conf}} にあります。 dnsmasq が使用されていることを確認するには、 {{ic|drill example.com}} を使用して同じ DNS ルックアップを2回実行し、サーバーとクエリの時間を確認します。

{{Note|
* {{ic|dnsmasq.service}} を起動したり、 {{ic|/etc/dnsmasq.conf}} を編集したりする必要はありません。 NetworkManager は、 systemd サービスを使用せず、dnsmasq のデフォルト設定ファイルを読み込まずに dnsmasq を起動します。
* NetworkManager によって起動された dnsmasq インスタンスは {{ic|127.0.0.1:53}} にバインドされます。同じアドレスとポートで他のソフトウェア ({{ic|dnsmasq.service}} を含む) を実行することはできません。
}}

=== systemd-resolved ===

NetworkManager は、 [[systemd-resolved]] を DNS リゾルバおよびキャッシュとして使用できます。使用する前に、 ''systemd-resolved'' が正しく設定され、{{ic|systemd-resolved.service}} が [https://wiki.archlinux.jp/index.php/Systemd#.E3.83.A6.E3.83.8B.E3.83.83.E3.83.88.E3.82.92.E4.BD.BF.E3.81.86 スタート] してることを確認してください。

{{ic|/etc/resolv.conf}} が [https://wiki.archlinux.jp/index.php/Systemd-resolved#DNS symlink] から {{ic|/run/systemd/resolve/stub-resolv.conf}}、 {{ic|/run/systemd/resolve/resolv.conf}}、または {{ic|/usr/lib/systemd/resolv.conf}} に設定されている場合は、自動的に systemd-resolved が使用されます。

{{ic|1=main.dns=systemd-resolved}} を {{ic|/etc/NetworkManager/conf.d/}} 設定すると、明示的に有効にできます。

{{hc|/etc/NetworkManager/conf.d/dns.conf|2=
[main]
dns=systemd-resolved
}}

=== NetworkManager の無効化 ===

''dbus'' によってサービスが自動的に起動してしまうこともあります。''systemctl'' でサービスをマスクすることで完全に無効化できます:
# systemctl mask NetworkManager
# systemctl mask NetworkManager-dispatcher

=== /etc/resolv.conf ===

NetworkManager の {{ic|/etc/resolv.conf}} 管理モードは、 {{ic|main.rc-manager}} 設定で設定されています。デフォルトの {{ic|auto}} モードでは、 {{ic|/etc/resolv.conf}} の管理方法が次の順序で選択されます。

* {{ic|/etc/resolv.conf}} が [https://wiki.archlinux.jp/index.php/%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AE%E3%83%91%E3%83%BC%E3%83%9F%E3%83%83%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%A8%E5%B1%9E%E6%80%A7#.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.81.AE.E5.B1.9E.E6.80.A7 不変] の場合、ファイルは [https://wiki.archlinux.jp/index.php?title=NetworkManager&action=submit#.E7.AE.A1.E7.90.86.E5.AF.BE.E8.B1.A1.E5.A4.96.E3.81.AE_.2Fetc.2Fresolv.conf はまったく変更されません。] です。これは {{ic|1=main.rc-manager=unmanaged}} と同じです。
* {{ic|/etc/resolv.conf}} が {{ic|/run/systemd/resolve/stub-resolv.conf}}、 {{ic|/run/systemd/resolv.conf}}、または {{ic|/usr/lib/systemd/resolv.conf}} へのシンボリックリンクの場合、[[#systemd-resolved|systemd-resolved が使用されています]] これは {{ic|1=main.rc-manager=systemd-resolved}} と同じです。
* {{ic|/usr/bin/resolvconf}} が存在する場合は、[https://wiki.archlinux.jp/index.php?title=NetworkManager&action=submit#openresolv_.E3.82.92.E4.BD.BF.E7.94.A8 resolvconfを使用] これは {{ic|1=main.rc-manager=resolvconf}} と同じです。
* {{ic|/etc/resolv.conf}} が通常のファイルの場合、 NetworkManager はそのファイルに直接書き込みます。これは {{ic|1=main.rc-manager=file}} と同じです。

詳細は、 {{man|5|NetworkManager.conf}} のマニュアルページを参照してください。

{{Tip|openresolv を使用すると、 NetworkManager を他の ''resolvconf'' の場合サポートソフトウェアと共存させることができます。たとえば、 openresolv が [[openresolv#Subscribers|subscriber]] を持つローカル DNS キャッシングおよびスプリット DNS リゾルバを実行できます。 openresolv で NetworkManager を使用している場合、条件付き転送は[https://gitlab.freedesktop.org/NetworkManager/NetworkManager/issues/153 まだ完全にはサポートされていません]}}

''NetworkManager'' は、いわゆる dispatcher スクリプト経由のフックも提供しています。これは、ネットワークの変更後に {{ic|/etc/resolv.conf}} を変更するために使用できます。詳細は、 [https://wiki.archlinux.jp/index.php/NetworkManager#.E3.83.8D.E3.83.83.E3.83.88.E3.83.AF.E3.83.BC.E3.82.AF.E3.82.B5.E3.83.BC.E3.83.93.E3.82.B9.E3.81.A8_NetworkManager_dispatcher NetworkManager dispatcher] および {{man|8|NetworkManager}} を参照してください。

{{Note|
* NetworkManager が [[#dnsmasq|dnsmasq]] または [[#systemd-resolved|systemd-resolved]] のいずれかを使用するように設定されている場合、適切なループバックアドレスが {{ic|/etc/resolv.conf}} に書き込まれます。
* NetworkManager が {{ic|resolv.conf}} に書き込む、または書き込む {{ic|/etc/resolv.conf}} ファイルは、 {{ic|/run/NetworkManager/resolv.conf}} にあります。
* 取得したネームサーバと検索ドメインを含む {{ic|resolv.conf}} ファイルは {{ic|/run/NetworkManager/no-stub-resolv.conf}} にあります。
}}

===== 管理対象外の /etc/resolv.conf =====

NetworkManager が {{ic|/etc/resolv.conf}} に干渉しないようにするには、{{ic|/etc/NetworkManager/conf.d/}} の設定ファイルで {{ic|1=main.dns=none}} を設定します。

{{hc|/etc/NetworkManager/conf.d/dns.conf|2=
[main]
dns=none
}}

{{Tip|NetworkManager が DNS 設定を [[systemd-resolved]] に送信しないように、{{ic|1=main.systemd-resolved=false}} を設定することもできます。}}

{{Note|[[#DNS キャッシングと条件付きフォワーディング]] を参照して、NetworkManager を {{ic|1=main.dns=none}} ではなく、 [https://wiki.archlinux.jp/index.php/Dnsmasq dnsmasq] や [[systemd-resolved]] などの他の DNS バックエンドを使用して設定してください。}}

その後、 {{ic|/etc/resolv.conf}} は壊れたシンボリックリンクになるかもしれませんので、削除する必要があります。次に、新しい {{ic|/etc/resolv.conf}} ファイルを作成します。

===== openresolv を使用 =====

{{Tip|NetworkManager は、{{ic|/etc/resolv.conf}} が不変であるか、システムの {{ic|resolv.conf}} ファイルの一つへのシンボリックリンクでない限り、自動的に ''resolvconf'' を使います。}}

{{Note|NetworkManager は、 {{Pkg|systemd-resolvconf}} によって提供される system-resolved の ''resolvconf'' インターフェイス [https://man.archlinux.org/man/resolvectl.1#COMPATIBILITY_WITH_RESOLVCONF(8) resolvectl COMPATIBILITY WITH RESOLVCONF(8)] の使用をサポートしていません。
* [[systemd-resolved]] を使用する場合は、 {{ic|1=main.rc-manager=resolvconf}} を設定せず、 [https://wiki.archlinux.jp/index.php/Systemd-resolved#DNS /etc/resolv.conf へのシンボリックリンクを正しく作成します。] または [https://wiki.archlinux.org/index.php/NetworkManager#systemd-resolved NetworkManager を構成して、明示的に systemed-resolved を使用する] 設定してください。
* systemd-resolvconf を使用しない場合は、 {{Pkg|systemd-resolvconf}} パッケージがインストールされていないことを確認してください。 {{ic|systemd-resolved.service}} を起動しないと、 resolvconf を使用するすべてのネットワークソフトウェア (NetworkManager だけでなく) が動作しなくなります。
}}

[[openresolv]] を使用するように NetworkManager を明示的に設定するには、 {{ic|1=main.rc-manager=resolvconf}} を {{ic|/etc/NetworkManager/conf.d/}} の設定ファイルで設定します。

{{hc|/etc/NetworkManager/conf.d/rc-manager.conf|2=
[main]
rc-manager=resolvconf
}}

== テスト ==

ログイン時に NetworkManager アプレットがロードされるようになっているので、ほとんどの場合さらに設定をする必要はありません。既に前のネットワーク設定を無効にしてネットワークから切断している場合、NetworkManager が動作するかどうかテストすることができます。まず {{ic|NetworkManager.service}} を[[デーモン|起動]]してください。

アプレットは {{ic|.desktop}} ファイルを提供するので、NetworkManager アプレットはアプリケーションメニューからロードすることができます。アプレットがない場合、コマンドを探すか、一度ログアウトしてからログインしなおしてアプレットを起動してください。アプレットが起動すれば、DHCP サーバーの自動設定によってネットワーク接続のポーリングを開始します。

[[Awesome]] などの xdg 非互換のウィンドウマネージャで GNOME アプレットを起動するには:

nm-applet --sm-disable &

固定 IP を使うには NetworkManager を設定する必要があります。アプレットを右クリックして 'Edit Connections' などを選択してください。

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

一般的な問題に対する修正。

=== PPTP トンネルを使って通信できない ===

PPTP 接続のログインが成功すると、適切な VPN IP の ppp0 インターフェースが表示されますが、リモートの IP に ping できません。これは標準の Arch の pppd に MPPE (Microsoft Point-to-Point Encryption) サポートがないのが原因です。まず標準の Arch の {{Pkg|ppp}} を使って予期通り動作するか試すことを推奨します。

問題を解決するには [[Arch User Repository|AUR]] から {{AUR|ppp-mppe}}{{Broken package link|{{aur-mirror|ppp-mppe}}}} をインストールしてください。

PEAP の MSCHAPv2 type-2 認証を使う WPA2-Enterprise ワイヤレスネットワークでは標準の ppp パッケージではなく ppp-mppe が必要になることがあります。[[netctl]] では ppp-mppe がなくても設定いらずで動きます。いずれにしても、MSCHAPv2 は攻撃されやすいため使用が推奨されていません。ただし他の方法にすることはできないのが普通です。この [https://www.cloudcracker.com/blog/2012/07/29/cracking-ms-chap-v2/ 記事] を参照してください。

=== Network management disabled ===

時々 NetworkManager を終了したときに pid (state) ファイルが削除されずに 'Network management disabled' というメッセージが表示されることがあります。これが発生した場合は、手動でファイルを削除する必要があります:

# rm /var/lib/NetworkManager/NetworkManager.state

=== dhclient と DHCP に関する問題 ===

DHCP を使って IP を取得するときに問題が起こるときは、以下を {{ic|/etc/dhclient.conf}} に追加してみてください:
interface "eth0" {
send dhcp-client-identifier 01:aa:bb:cc:dd:ee:ff;
}
{{ic|aa:bb:cc:dd:ee:ff}} は NIC の MAC アドレスに置き換えてください。MAC アドレスは {{Pkg|iproute2}} パッケージの {{ic|ip link show ''interface''}} コマンドを使うことでわかります。

=== dhcpcd と DHCP に関する問題 ===

ルーターによっては、{{ic|/etc/dhcpcd.conf}} ({{ic|dhcpd.conf}} とは別のファイルです) 内の次の行をコメントアウトしないと正しく接続できないことがあります:
require dhcp_server_identifier
ネットワーク上で複数の DHCP サーバーを使ってなければこの修正によって問題が起こることはありません。詳細は [https://technet.microsoft.com/en-us/library/cc977442.aspx このページ] を見て下さい。

=== ホストネームの問題 ===

ホストネームが接続しているルーターに送信されるかどうかは、使用している NetworkManager プラグインによります。標準の "keyfile" プラグインはデフォルト設定ではホストネームを送信しません。ホストネームを送信するようにしたいときは、以下を {{ic|/etc/NetworkManager/NetworkManager.conf}} に追加してください:

{{hc|/etc/NetworkManager/NetworkManager.conf|2=
[keyfile]
hostname=''your_hostname''
}}

{{ic|[keyfile]}} 下のオプションはデフォルトの {{ic|/etc/NetworkManager/system-connections}} のパスのネットワーク接続に適用されます。

また、(NetworkManager が自動的に起動する) DHCP クライアントを設定して送信させることもできます。NetworkManager はデフォルトで {{Pkg|dhclient}} を利用しますが、インストールされていない場合は、NetworkManager 内蔵の DHCP 機能にフォールバックします。''dhclient'' でホストネームを送信するには設定を変更する必要があります。''dhcpcd'' はデフォルトでホストネームを送信します。

まず、どの DHCP クライアントが使われているのか確認 (以下の例では ''dhclient''):

{{hc|<nowiki># journalctl -b | egrep "dhc"</nowiki>|
...
Nov 17 21:03:20 zenbook dhclient[2949]: Nov 17 21:03:20 zenbook dhclient[2949]: Bound to *:546
Nov 17 21:03:20 zenbook dhclient[2949]: Listening on Socket/wlan0
Nov 17 21:03:20 zenbook dhclient[2949]: Sending on Socket/wlan0
Nov 17 21:03:20 zenbook dhclient[2949]: XMT: Info-Request on wlan0, interval 1020ms.
Nov 17 21:03:20 zenbook dhclient[2949]: RCV: Reply message on wlan0 from fe80::126f:3fff:fe0c:2dc.
}}

==== ホストネームを DHCP サーバーに送るように dhclient を設定する ====

サンプル設定ファイルをコピー:

# cp /usr/share/dhclient/dhclient.conf.example /etc/dhclient.conf

ファイルの中身を見てください。重要なのは以下の行です:

{{hc|/etc/dhclient.conf|2=send host-name = pick-first-value(gethostname(), "ISC-dhclient");}}

IP アドレスの更新を強制することで DHCP サーバーからホストネームを確認できるようになるはずです。

==== 特定の DHCP クライアントを使うように NetworkManager を設定する ====

NetworkManager で使用する DHCP クライアントを明示的に設定したい場合、グローバルな設定ファイルで設定できます:

{{hc|1=/etc/NetworkManager/NetworkManager.conf|2=dhcp=internal}}

上記のオプションが設定されていない場合、{{ic|1=dhcp=dhclient}} がデフォルトで使われます。

それから {{ic|NetworkManager.service}} を[[systemd#ユニットを使う|再起動]]してください。

{{Note|1={{Pkg|dhcpcd}} のサポートは {{Pkg|networkmanager}}-1.0.0-2 で [https://projects.archlinux.org/svntogit/packages.git/commit/trunk?h=packages/networkmanager&id=a1df79cbcebaec0c043789eb31965e57d17b6cdb 無効] になっています (2015-02-14)。}}

=== デフォルトの route が見つからない ===

KDE4 システムでは、NetworkManager でワイヤレス接続を確立したときにデフォルトの route が作られません。ワイヤレス接続の route 設定を変更してデフォルトの選択 "Use only for resources on this connection" を削除すれば問題は解決します。

=== 3G モデムが検知されない ===

[[USB 3G モデム#Network_Manager]] を参照してください。

=== ラップトップで WLAN をオフに切り替える ===

ラップトップについているスイッチを使って WiFi アダプタを無効にしてその後また有効にした時に NetworkManager が動作しないことがしばしばあります。これはほとんど {{ic|rfkill}} の問題です。[[公式リポジトリ]]から {{Pkg|rfkill}}{{Broken package link|置換パッケージ: {{Pkg|util-linux}}}} をインストールして、ドライバが {{ic|rfkill}} に無線アダプタの状態を通知しているかどうか確かめるために次のコマンドを実行してください:

$ watch -n1 rfkill list all

アダプタの切り替えを行った後に identifier がブロックされたままの場合、手動でブロックを解除することができます (X は上のコマンドで出力された identifier の番号に置き換えてください):

# rfkill event unblock X

=== 固定 IP 設定が DHCP に戻る ===

未解決のバグのため、デフォルトの接続を固定 IP にしたとき、{{ic|nm-applet}} は正しく設定を保存できず、自動 DHCP に戻ります。

この問題を解決するにはデフォルトの接続 (例: "Auto eth0") を {{ic|nm-applet}} で編集してから、接続の名前を変更し (例: "my eth0")、"Available to all users" のチェックを外して、固定 IP の設定をして、それから '''Apply''' をクリックする必要があります。これで新しい接続が指定した名前で保存されます。

さらに、デフォルト接続を自動で接続して欲しくない場合があるかもしれません。そうするには、{{ic|nm-connection-editor}} を (root 以外で) 起動してください。接続エディタで、デフォルト接続 (例: "Auto eth0") を編集して "Connect automatically" のチェックを外して '''Apply''' をクリックして終了してください。

=== ノーマルユーザーで接続を編集できない ===

[[#PolicyKit パーミッションの設定]] を見て下さい。

=== 隠れた無線ネットワークの削除 ===

ステルスが有効になっているネットワークは無線のリストに表示されないので、GUI で削除することは出来ません。次のコマンドでネットワークを削除することが可能です:

# rm /etc/NetworkManager/system-connections/[SSID]

他の接続でもこのコマンドは使えます。

=== VPN が Gnome で動作しない ===

Gnome で NetworkManager を使って openconnect や vpnc 接続を設定すると、ダイアログが表示されず以下のエラーが {{ic|/var/log/errors.log}} に現れることがあります:

localhost NetworkManager[399]: <error> [1361719690.10506] [nm-vpn-connection.c:1405] get_secrets_cb(): Failed to request VPN secrets #3: (6) No agents were available for this request.

これは GNOME の NM アプレットが {{ic|/usr/lib/gnome-shell}} にダイアログスクリプトがあると想定しているのが原因です。NetworkManager のパッケージは {{ic|/usr/lib/networkmanager}} に配置します。"一時的な"修正として (このバグをしばらく回避できます)、以下のシンボリックリンクを作成してください:

* OpenConnect の場合: {{ic|ln -s /usr/lib/networkmanager/nm-openconnect-auth-dialog /usr/lib/gnome-shell/}}
* VPNC (すなわち Cisco VPN) の場合: {{ic|ln -s /usr/lib/networkmanager/nm-vpnc-auth-dialog /usr/lib/gnome-shell/}}

他の NM VPN プラグインでも同じように設定してください。

=== Systemd のボトルネック ===

時が立つにつれてログファイル ({{ic|/var/log/journal}}) が膨大になってしまうことがあります。そうすると NetworkManager を使う場合にブートパフォーマンスに大きな影響を与えます。参照: [[systemd#少しづつ起動時間が長くなっている]]。

=== 定期的にネットワークが切断される (WiFi) ===

WiFi ドライバーの中にはベースステーションのスキャン時に問題が発生するものがあります。VPN が切断されたりパケットが消失したり、ウェブページがロードされないなどの症状が起こります。

{{ic|journalctl -f}} を実行すると、以下のようなメッセージが定期的にログに残っているならこの問題が関わっています:

NetworkManager[410]: <info> (wlp3s0): roamed from BSSID 00:14:48:11:20:CF (my-wifi-name) to (none) ((none))

パッチが適用された NetworkManager を使うことでこの種のスキャニングを防ぐことができます: {{AUR|networkmanager-noscan}}。

もしくは、ローミングが重要でない場合、WiFi の接続プロファイルでアクセスポイントの BSSID をロックすることで定期的なスキャンを無効化できます。

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

=== Wi-Fi パスワードの暗号化 ===

デフォルトでは NetworkManager は {{ic|/etc/NetworkManager/system-connections/}} に存在する接続ファイルに平文でパスワードを保存します。保存されているパスワードを表示するには、以下のコマンドを実行:

# grep -H '^psk=' /etc/NetworkManager/system-connections/*

パスワードにアクセスできるのは root ユーザーだけであり通常ユーザーは GUI の設定からアクセスできます (例: {{ic|nm-applet}})。

平文ではなく暗号化された状態で保存することもできますが、ユーザーごとに接続の設定が必要になります。

====Gnome-Keyring を使う====

キーリングデーモンを起動してキーリングを解錠する必要があります。

さらに、全てのユーザーでパスワードを保存しないように NetworkManager を設定しなければなりません。GNOME の {{ic|nm-applet}} を使う場合、ターミナルから {{ic|nm-connection-editor}} を起動してネットワーク接続を選択し、{{ic|Edit}} をクリックして、{{ic|Wifi-Security}} タブからパスワードの右のアイコンをクリックして {{ic|Store the password only for this user}} にチェックを入れてください。

=== wifi でインターネット接続を共有する ===

nm を使って数クリックでインターネット接続 (例: 3G または有線) を共有することができます。サポートされた wifi カードが必要になります (Atheros AR9xx や AR5xx を使っているカードがおそらく最適です)。

[[ファイアウォール]]がインターネット共有を妨害することもあるので注意してください。

==== Ad-hoc ====

* 接続の共有をできるようにするために {{Pkg|dnsmasq}} パッケージを[[pacman|インストール]]してください
* {{ic|dnsmasq.conf}} を修正すると nm に干渉する可能性があります
* nm-applet -> Create new wireless network をクリック
* ウィザードに従う (WEP を使用する場合、パスワードの長さは5文字あるいは13文字なければなりません)
* 次に必要になった時のために設定は保存されます

==== Real AP ====

2012年から、インフラストラクチャモード (ad-hoc をサポートしていない Android で必要) は NetworkManager でサポートされています。

参照: https://fedoraproject.org/wiki/Features/RealHotspot

=== cron ジョブやスクリプトでネットワークが立ち上がっているか確認する ===

cron ジョブの中にはネットワークが立ち上がっている必要があるジョブもあります。ネットワークが立ち上がっていない場合はジョブを実行しないようにすることができます。そのためには、NetworkManager の {{ic|nm-tool}} を使ってネットワークの状態を確認する '''if''' テストを追加します。インターフェイスが立ち上がっている場合はテストは通りますが、全てのインターフェイスがダウンになっている場合はテストを通過しません。無線でネットワークにつながっていたり、いなかったりするノートパソコンなどで有用です。
{{bc|<nowiki>
if [ $(nm-tool|grep State|cut -f2 -d' ') == "connected" ]; then
#Whatever you want to do if the network is online
else
#Whatever you want to do if the network is offline - note, this and the else above are optional
fi
</nowiki>}}

上記は {{ic|cron.hourly}} スクリプトを使って {{ic|fpupdate}} を実行し F-Prot ウイルススキャナをアップデートしている場合などに有用です。

=== ログイン時に自動的に接続する ===

デフォルトでは、パスワードを入力しないと使えないネットワークの場合 NetworkManager は起動時に自動的に接続しません。自動的に接続するには以下の設定が必要です:

# {{ic|nm-applet}} アイコンを右クリックして Edit Connections を選択し Wireless タブを開いて下さい
# 使用したい接続を選択して Edit ボタンをクリックしてください
# “Connect Automatically” と “Available to all users” のボックスにチェックを入れて下さい
一度ログアウトしてから再ログインすれば設定は完了です。

=== ログインのあと自動でキーリングを解除する ===

NetworkManager はログイン情報を必要とするネットワークに接続するときにログインキーリングにアクセスします。大抵の場合、ログイン時に自動的に解錠されますが、解錠されていない場合、NetworkManager はログイン時に接続することができません。

==== GNOME ====

{{Note|以下の方法は古い情報であり機能する保証はありません。}}
* {{ic|/etc/pam.d/gdm}} (もしくは {{ic|/etc/pam.d}} にある適当なデーモン) を開いて、"auth" と "session" ブロックの最後に以下の行を追加します:
auth optional pam_gnome_keyring.so
session optional pam_gnome_keyring.so auto_start

* {{ic|/etc/pam.d/passwd}} を開いて、'password' ブロックで以下の行を使います:
password optional pam_gnome_keyring.so

:次のログイン時に、パスワードをログイン時に自動的にロック解除するべきかどうか尋ねられるはずです。

==== SLiM ログインマネージャ ====
[[SLiM#SLiM と Gnome Keyring]] を見て下さい。

=== 特定のデバイスを無視する ===

時々 NetworkManager に特定のデバイスを無視してもらってアドレスやルートを設定しないのが望ましいことがあります。{{ic|/etc/NetworkManager/NetworkManager.conf}} で以下を使うことで MAC やインターフェイス名によってデバイスを無視するよう設定できます:
[keyfile]
unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth0
これを記述した後、NetworkManager を[[デーモン|再起動]]してください。設定したデバイスに触れないように NetworkManager でインターフェイスを設定できるはずです。

=== 接続の高速化 ===

==== IPv6 を無効にする ====

NetworkManager の余計な IPv6 クエリーによって接続が遅くなったりネットワークの再接続が起こることがあります。ローカルネットワークで IPv6 をサポートしていない場合、NetworkManager が IPv6 の接続を確立しようとして結局タイムアウトするので、通常よりもネットワークへの接続に時間がかかるかもしれません。解決策は NetworkManager で IPv6 を無効にすることで、これによってネットワーク接続が高速になります。以下は接続するネットワークごとに実行する必要があります。

* ネットワーク状態アイコンを右クリック。
* "Edit Connections" をクリック。
* "Wired" か "Wireless" タブを見る。
* ネットワークの名前を選択。
* "Edit" をクリック。
* "IPv6 Settings" タブを見る。
* "Method" ドロップダウンから "Ignore/Disabled" を選択。
* "Save" をクリック。

==== DHCPCD の ARP probing を無効にして DHCP をスピードアップ ====

{{ic|dhcpcd}} には割り当てられた IP アドレスが実際に取得されているかどうか ARP を使って確認する DHCP 標準 ([https://www.ietf.org/rfc/rfc2131.txt RFC2131] section 2.2) の勧告の実装が含まれています。家庭ネットワークではほとんどの場合これは不要なので、次の行を {{ic|/etc/dhcpcd.conf}} に加えることで接続にかかる時間を5秒間短くできます:

noarp

これは {{ic|dhcpcd}}　に {{ic|--noarp}} を渡すのと同じであり、上述の ARP probing を無効にして、DHCP によるネットワーク接続を高速化します。

==== OpenDNS サーバーを使う ====

{{ic|/etc/resolv.conf.opendns}} を以下のネームサーバで作成してください:

nameserver 208.67.222.222
nameserver 208.67.220.220

もしくは Google DNS サーバーを使って下さい:

nameserver 8.8.8.8
nameserver 8.8.4.4

そして DHCP サーバーを OpenDNS サーバーに置き換える dispatcher を作って下さい:

{{hc|/etc/NetworkManager/dispatcher.d/dns-servers-opendns|<nowiki>
#!/bin/bash
# Use OpenDNS servers over DHCP discovered servers

cp -f /etc/resolv.conf.opendns /etc/resolv.conf</nowiki>}}

スクリプトを実行可能にします:

# chmod +x /etc/NetworkManager/dispatcher.d/dns-servers-opendns

=== MAC アドレスのランダム化の設定 ===

バージョン 1.4.0 現在、NetworkManager では2種類の MAC アドレスランダム化をサポートしています。スキャン時のランダム化と定常的なランダム化です。どちらのモードも {{ic|/etc/NetworkManager/NetworkManager.conf}} で設定できます。

無線スキャン時のランダム化はバージョン 1.2.0 からデフォルトで有効になっており、以下の行を {{ic|/etc/NetworkManager/NetworkManager.conf}} に追加することで無効にできます:

[device]
wifi.scan-rand-mac-address=no

{{Tip|1=MAC アドレスのランダム化を無効にすることで接続が安定することがあります。[https://bbs.archlinux.org/viewtopic.php?id=220101] を参照。}}

定常的なランダム化では接続するたびに MAC アドレスが変わります。MAC アドレスでログイン状態を記録するポータルなどで有用です。有効にするには以下のオプションを使用:

[connection]
wifi.cloned-mac-address=random

または:

[connection]
ethernet.cloned-mac-address=random

詳しくは [https://blogs.gnome.org/thaller/2016/08/26/mac-address-spoofing-in-networkmanager-1-4-0/ こちら] を参照してください。

=== IPv6 プライバシー拡張の有効化 ===

[[IPv6#NetworkManager]] を見てください。

== 参照 ==
* [https://blogs.gnome.org/dcbw/2015/02/16/networkmanager-for-administrators-part-1/ NetworkManager for Administrators Part 1]

PipeWire

2021-07-21T14:41:31Z

Oriaca372m: 同期

[[Category:マルチメディア]]
[[en:PipeWire]]
[[fi:PipeWire]]
[[pt:PipeWire]]
[https://pipewire.org PipeWire] は新しい低レベルマルチメディアフレームワークです。
映像と音声を最小の遅延で再生/キャプチャすることを目的としていて、[[PulseAudio]]、[[JACK]]、[[ALSA]]、[[GStreamer]] をベースとしたアプリケーションと互換性があります。

このフレームワークのデーモンは (PulseAudio と JACK の機能を持った) オーディオサーバーとしても、ビデオキャプチャサーバーとしても設定できます。

また PipeWire は [[Flatpak]] のようなコンテナをサポートしており、''audio'' や ''video'' [[ユーザーとグループ#グループ管理|ユーザーグループ]]に依存するのではなく、Flatpak や Wayland にスクリーンや音声を録音する許可を求める [[Polkit]] のようなセキュリティモデルを使用しています。

== インストール ==

公式リポジトリの {{pkg|pipewire}} パッケージを[[インストール]]します。

PipeWire は [[systemd/ユーザー]] を使用してサーバーの管理とソケットアクティベーションを行います。

必要に応じて {{pkg|pipewire-docs}} をインストールしてドキュメントを確認することもできます。{{pkg|pipewire-alsa}}、{{pkg|pipewire-pulse}}、{{pkg|pipewire-jack}} などの他のパッケージは [[#音声|PulseAudio/JACKの代わりに PipeWire を使用]]したい場合を除き必要ありません。multilib サポートのために {{pkg|lib32-pipewire}}、{{pkg|lib32-pipewire-jack}} も利用できます。

=== GUI ===

* {{App|Helvum|PipeWire 用の GTK 製のパッチベイ。 JACK のツールの catia にインスパイアされた。|https://gitlab.freedesktop.org/ryuukyu/helvum|{{AUR|helvum}}, {{AUR|helvum-git}}}}

== 使用方法 ==

=== WebRTC 画面共有===

ほとんどのブラウザは WebRTC を使用しているとき (例えば Google ハングアウトで) デスクトップ (や個々のアプリケーション) をキャプチャするのに X11 に依存していました。Wayland ではセキュリティ上の理由から画面共有は異なる方法で処理されます。PipeWire はきめ細かなアクセス制御を使用して Wayland 上のコンテンツを共有できます。

これには {{pkg|xdg-desktop-portal}} とそのバックエンドの1つが[http://jgrulich.cz/2018/07/04/04/how-to-enable-and-use-screen-sharing-on-wayland 必要です]。利用可能なバックエンドは次のとおりです:

* GNOME の場合、{{pkg|xdg-desktop-portal-gtk}}
* KDE の場合、{{pkg|xdg-desktop-portal-kde}}
* wlroots ベースのコンポジター ([[Sway]] や [https://github.com/djpohly/dwl dwl] など) の場合、{{pkg|xdg-desktop-portal-wlr}}

Firefox (バージョン84以降) はデフォルトでこの方法をサポートしていますが、Chromium (バージョン73以降) では、[https://bugs.chromium.org/p/chromium/issues/detail?id=682122 WebRTC PipeWireサポート]を次のURLの実験的機能の設定を変更して有効にする必要があります:
chrome://flags/#enable-webrtc-pipewire-capturer

{{ic|xdg-desktop-portal-wlr}} を動かすには {{pkg|pipewire-media-session}} をインストール[https://github.com/emersion/xdg-desktop-portal-wlr/wiki/FAQ/db63ec1ab6c0170334c1d1f45d1ebe543cc375fa#how-do-i-run-xdpw]して、セッション内で環境変数を {{ic|1=XDG_CURRENT_DESKTOP=sway}} のように設定する必要があります[https://github.com/emersion/xdg-desktop-portal-wlr#running]。同様に {{ic|1=XDG_SESSION_TYPE=wayland}} も設定する必要があります[https://github.com/emersion/xdg-desktop-portal-wlr/issues/117]。

{{Tip|複数のモニタがある場合に {{ic|xdg-desktop-portal-wlr}} を使用してそれぞれのモニターを共有するには、ユニットの {{ic|1=ExecStart=}} オプションを[[Systemd#ユニットファイルの編集|編集]]して {{ic|1=--output=''Monitor''}} フラグを追加してください。行全体は {{ic|1=ExecStart=@libexecdir@/xdg-desktop-portal-wlr --output=eDP-1}} のようになります。}}

唯一サポートされている機能はデスクトップ全体の共有で、特定のアプリケーション/ウィンドウの共有はサポートされていません。[https://github.com/emersion/xdg-desktop-portal-wlr/wiki/FAQ#will-this-let-me-share-individual-windows][https://github.com/KDE/xdg-desktop-portal-kde/blob/master/TODO]

=== 映像 ===

ソフトウェアはまだ商業利用には適していませんが、試す分には問題ありません。[[GStreamer]] を使用して映像ストリームを処理するほとんどのアプリケーションは PipeWire GStreamer プラグインを使用して設定なしで動作するはずです ([[GStreamer#PipeWire]]を参照してください)。そのため既に {{pkg|cheese}} のようなアプリケーションは PipeWire を使用して映像入力を利用できます。

=== 音声 ===

PulseAudio や JACK と同様に PipeWire をオーディオサーバーとして使用できます。 PulseAudio サーバーの互換実装と JACK クライアント用の ABI 互換ライブラリを提供することで PulseAudio と JACK の両方を置き換えることを目的としています。詳細については[https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ この記事]を参照してください。

==== ALSA/レガシーアプリケーション ====

{{pkg|pipewire-alsa}} をインストールして ALSA API を使用するすべてのアプリケーションが PipeWire を使用するよう設定できます。

==== PulseAudio クライアント ====

{{pkg|pipewire-pulse}} をインストールします。このパッケージは {{pkg|pulseaudio}} と {{pkg|pulseaudio-bluetooth}} を置き換えます。再起動するか、ログインし直すか、{{ic|systemctl start --user pipewire-pulse.service}} を実行すると有効化されます。

パッケージがユーザーサービス {{ic|pipewire-pulse.socket}} を自動的に有効化するので、通常それ以上の操作は不要です。置き換えが機能しているかどうかを確認するには、次のコマンドを実行して出力を確認してください:

{{hc|1=$ pactl info|2=
...
Server Name: PulseAudio (on PipeWire 0.3.16)
...
}}

システム起動時に PipeWire が正しく機能しない場合は、[[systemd/ユーザー|ユーザーサービス]] {{ic|pipewire-pulse.service}} と {{ic|pipewire.service}} と {{ic|pipewire-media-session.service}} が起動して実行されているか確認します。{{ic|pipewire-pulse.service}} と {{ic|pipewire-pulse.socket}} は root で実行することを制限するような {{ic|ConditionUser}} を設定していることに注意してください。

==== JACK クライアント ====

{{pkg|pipewire-jack}} をインストールします。{{ic|pw-jack}} を使用して JACK クライアントを起動すると、元の {{ic|libjack*}} ではなく PipeWire が提供する互換ライブラリが使用されます:

pw-jack ''application''

カスタムバッファサイズを要求することもできます。{{ic|PIPEWIRE_LATENCY}}環境変数を {{ic|バッファサイズ/サンプルレート}} (ブロックのレイテンシ(秒)を意味します) に設定します:

PIPEWIRE_LATENCY="128/48000" pw-jack ''application''

また {{aur|pipewire-jack-dropin}} をインストールするか、{{pkg|jack}} か {{pkg|jack2}} をアンインストールして JACK クライアントが互換ライブラリを自動的に読み込むようにもできます。

{{ic|ldd}} を使用して JACK アプリケーションが正しいライブラリにリンクしていることを確認します。

{{hc|1=$ ldd /usr/bin/qjackctl {{!}} grep -i libjack|2=
libjack.so.0 => /usr/lib/pipewire-0.3/jack/libjack.so.0 (0x00007f7e5080a000)
}}

==== Bluetooth デバイス ====

PipeWire は {{pkg|pipewire-pulse}} パッケージがインストールされている場合 Bluetooth オーディオデバイスを制御します。具体的には、メディアセッションデーモンは {{ic|/etc/pipewire/media-session.d/with-pulseaudio}} が存在する時に自動的にその {{ic|bluez5}} モジュールを有効にします。

==== ネイティブ JACK 上で PipeWire を実行する ====

PipeWire はネイティブ JACK デーモン上の JACK クライアントとして実行することもできます。詳細は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/JACK JACK and PipeWire] を参照してください。

== 音声のポストプロセッシング ==

=== EasyEffects ===

EasyEffects (以前は PulseEffects と呼ばれていました) は多数のエフェクトとフィルタを個々の入出力ストリーム (アプリケーションの音声出力やマイクの入力など) に提供する GTK 製のユーティリティです。注目すべきエフェクトには、入出力イコライザー、出力ラウドネス等化、ベースエンハンスメント、入力ディエッサー、ノイズ抑制プラグインなどがあります。[https://github.com/wwmm/easyeffects GitHub ページ]にエフェクトの一覧があります。

EasyEffects を使用するには、{{pkg|easyeffects}} をインストールします。プリセット設定集については、[https://github.com/wwmm/easyeffects/wiki/Community-presets コミュニティープリセット]を参照してください。

{{Note|PulseEffects の古いバージョンについては [[PulseAudio#PulseEffects]] を参照してください。}}

=== NoiseTorch ===

{{aur|noisetorch}} はノイズ抑制に使用できます。ビルド済み ({{aur|noisetorch-bin}}) や開発版 ({{aur|noisetorch-git}}) のパッケージもあります。

起動すると選択したマイクにモジュールを読み込むことができます。声が出力される閾値を調整することができます。実際の声が削除されない最大のレベルに設定するべきです。

=== LADSPA、LV2、VST プラグイン ===

LADSPA、LV2、VSTのプラグインを使用したい場合は、カスタム PulseAudio null シンクと Carla Jack ホストを利用できます。{{pkg|pipewire-pulse}} と {{pkg|pipewire-jack}} と {{pkg|carla}} をインストールします。はじめに {{ic|default_null_sink}} という名前の PulseAudio の null シンクを作成します。

pactl load-module module-null-sink object.linger=1 media.class=Audio/Sink sink_name=default_null_sink channel_map=FL,FR

{{ic|pw-jack carla-rack}} で PipeWire を使用する Carla を起動します。''Rack'' タブで使いたいプラグインを全て追加します。プラグインのタイプが ''stereo'' であることを確認してください。適用する順番を変えることができます。EasyEffectsのようにリストの最初のプラグインが最初に入力の音声ストリームを受け取ります。その後 ''Patchbay'' タブに移動し {{ic|default_null_sink}} の L/R monitor を Carla input に接続し、Carla output を出力したいデバイス (スピーカーやイヤホンや HDMI 出力など) の playback に接続します。設定をフォルダに保存します ({{ic|~/Documents/carla_sink_effects.carxp}} など)。

Firefox で動画を見ている時など、アプリケーションが音声を再生している時に効果を試すことができます。2つの方法があります。一つは Carla の ''Patchbay'' タブで Firefox の接続を全て外し {{ic|default_null_sink}} の L/R output に接続する方法です。もう一つは {{pkg|pavucontrol}} を使用し Firefox の音声ストリームを {{ic|default_null_sink}} に変更する方法です (この方法は同じアプリケーションの次回起動時に同じ接続先を使用するはずです)。

これらの設定を起動時に適用するには、まず2つの systemd ユーザーサービスを作成します:

{{hc|~/.config/systemd/user/jack-carla-rack.service|output=
[Unit]
Description=Load Carla Rack JACK host

[Service]
PassEnvironment="PIPEWIRE_LINK_PASSIVE=true"
Type=exec
ExecStart=/usr/bin/pw-jack carla-rack -n

[Install]
WantedBy=default.target
}}
{{hc|~/.config/systemd/user/pulseaudio-null-sink@.service|output=
[Unit]
Description=Load %i Pulseaudio null sink
Before=jack-carla-rack.service
After=pipewire-pulse.service

[Service]
Type=oneshot
ExecStart=/usr/bin/pactl load-module module-null-sink object.linger=1 media.class=Audio/Sink sink_name=%i channel_map=FL,FR
ExecStop=/usr/bin/pactl unload-module module-null-sink
RemainAfterExit=yes

[Install]
WantedBy=default.target
}}

''jack-carla-rack'' サービスの ''Environment'' を Carla の設定ファイルのフルパスを指定するよう上書きします:

{{hc|~/.config/systemd/user/jack-carla-rack.service.d/override.conf|output=
Environment="CARLA_CONFIG_FILE=/home/username/Documents/carla_sink_effects.carxp"
ExecStart=
ExecStart=/usr/bin/pw-jack carla-rack -n $CARLA_CONFIG_FILE
}}

最後に、作成したサービスを有効化します。''pulseaudio-null-sink'' サービスには {{ic|default_null_sink}} 引数をつけてください:

systemctl --user enable pulseaudio-null-sink@default_null_sink.service
systemctl --user enable jack-carla-rack.service

{{Note|システム設定で {{ic|default_null_sink}} をデフォルトデバイスに設定すると、全てのアプリケーションが {{ic|default_null_sink}} にリダイレクトされ、音量の変更がスピーカーではなく {{ic|default_null_sink}} に対して行われるようになります。スピーカーの音量を変更したい場合は、デフォルトデバイスをスピーカーから変更せずにアプリケーションの出力先を pavucontrol で {{ic|default_null_sink}} に変更してください (PipeWire の互換性レイヤーは次回起動時も出力先を覚えています)。}}

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

{{Out of date|デフォルトの設定ファイルは /etc/pipewire から /usr/share/pipewire に移動しました。以前と同様にシステム全体に対する設定は /etc/pipewire で、ユーザーに対する設定は $HOME/.config/pipewire/ で行いますが、デフォルトの設定を /usr/share/pipewire からコピーする必要があります。https://gitlab.freedesktop.org/pipewire/pipewire/-/commit/1609126bcd720304b7a4c81b87cc3e70ae91ff44}}

=== PipeWire にマイクが検出されない ===

PipeWire の {{ic|alsa-monitor}} モジュールは、デフォルトで {{pkg|alsa-card-profiles}} を使用してデバイスを検出します。これでうまくいかない場合は、{{ic|/etc/pipewire/media-session.d/alsa-monitor.conf}} の {{ic|rules}} -> 最初のルール -> {{ic|actions}} -> {{ic|update-props}} の {{ic|api.alsa.use-acp}} を {{ic|false}} にするか、または {{ic|api.alsa.use-ucm}} を {{ic|true}} にしてみてください:

...
update-props = {
api.alsa.use-acp = false
...

次に PipeWire を再起動し使用可能なデバイスを確認します:

{{hc|1=
$ pw-record --list-targets
|2=
Available targets ("*" denotes default): 62
58: description="Built-in Audio" prio=1872
60: description="Built-in Audio" prio=2000
* 62: description="Built-in Audio (Loopback PCM)" prio=1984
}}

=== Bluetooth デバイスに接続しても音が出ない ===

2020-12-07 の時点で、Bluetooth デバイスを接続しても音が出ない場合は、デフォルトのシンクに切り替えるか、シンク入力を正しいシンクに移動する必要があります。{{ic|pactl list sinks}} で使用可能なシンクの一覧を表示し、{{ic|pactl set-default-sink}} でデフォルトのシンクを Bluetooth デバイスに切り替えます。これは[https://gist.github.com/tinywrkb/04e7fd644afa9b92d33a3a99ab07ee9e このようなスクリプト]を使って [[udev]] で自動化できます。

この問題については、この [https://www.reddit.com/r/archlinux/comments/jydd02/pipewirepulse_03164_in_testing_now_replaces/gd3m7fu/?context=3 Reddit スレッド]を参照してください。スクリプトの作成者によると、ヘッドセットプロファイル (HSP) にまだ問題がある可能性があります。

=== 音量が小さい ===

PulseAudio を PipeWire で置き換えた後、正しく音が出ても、再起動後に音量が極端に小さくなることがあります。

{{ic|alsamixer}} を開き、{{ic|F6}} を押して適切なサウンドカードを選び ALSA のボリュームが100%であることを確認してください。{{ic|alsactl}} は再起動後もこの設定を維持するはずです。

=== increasing RLIMIT_MEMLOCK ===

Dec 13 11:11:11 HOST pipewire-pulse[99999]: Failed to mlock memory 0x7f4f659d8000 32832: This is not a problem but for best performance, consider increasing RLIMIT_MEMLOCK

{{pkg|realtime-privileges}} をインストールし {{ic|realtime}} グループに自分のユーザーを追加します。

あるいは memlock を 64kB から 128kB に増やすことで、この問題を解決できるようです。[[systemd/ユーザー]] で {{ic|pipewire-pulse}} を実行している場合は {{ic|/etc/security/limits.d/username.conf}} に次の行を追加します:

username soft memlock 64
username hard memlock 128

=== サンプリングレートを変更する ===

デフォルトで PipeWire はグローバルサンプリングレートを 48kHz に設定します。これを変更したい場合 (DACがより高い値をサポートしている場合など) は {{ic|/etc/pipewire/pipewire.conf}} の {{ic|1=default.clock.rate = 48000}} の行を編集します。例えば 192kHz にしたい場合、コメントを外して {{ic|48000}} を {{ic|192000}} に変更します。

=== 外付けサウンドカードが再接続後に有効にならない ===

{{ic|~/.config/pipewire-media-session/default-profile}} にデフォルトプロファイル ''off'' のエントリがあれば削除します。それでも解決しない場合は {{ic|~/.config/pipewire-media-session/}} からすべてのファイルを削除し、{{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動します。

=== 音が出ないまたは pactl info が Failure: Connection refused と表示する ===

これはアプリケーションが PipeWire-Pulse サービスに接続できていないことを意味します。{{ic|/etc/pipewire/pipewire-pulse.conf}} が存在し空でないことを確認し、{{ic|systemctl --user restart pipewire-pulse.service}} で PipeWire-Pulse を再起動してください。

それでも解決しない場合は {{ic|strace -f -o /tmp/pipe.txt pactl info}} を実行し、pastebin に {{ic|/tmp/pipe.txt}} を貼り付けて、IRC (OFTC の [ircs://irc.oftc.net/pipewire #pipewire]) かメーリングリストで相談してください。

=== Bluetooth の音声の品質が低い===

Bluetooth で再生が途切れる場合は {{ic|systemctl --user status pipewire.service}} を実行してみてください。次のようなエラーが表示される場合は、

Feb 17 18:23:01 HOST pipewire[249297]: (bluez_input.18:54:CF:04:00:56.a2dp-sink-60) client too slow! rate:512/48000 pos:370688 status:triggered

{{ic|pactl list sinks}} で現在選択されているコーデックを確認し、{{ic|/etc/pipewire/media-session.d/bluez-monitor.conf}} の {{ic|bluez5.codecs}} を {{ic|sbc aac ldac aptx aptx_hd}} のいずれかに変更してみてください。

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
properties = {
...
bluez5.codecs = [sbc]
...
}}

mSBC サポートの有効化を試すには (Sony 1000XM3 のマイクの問題を修正します):

{{hc|/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
rules = [
...
actions = {
...
update-props = {
...
bluez5.msbc-support = true
...
}}

変更を適用するには {{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動する必要があります。

=== PipeWire の更新 (git / >=0.3.23) と再起動後デバイスが検出されない===

コミット 012a68f8[https://gitlab.freedesktop.org/pipewire/pipewire/-/commit/012a68f8ef33705f1a40ec8ac294b8cce7f6aa88] の時点で新しい systemd サービスが追加されデフォルトでは無効になっています。これはシステムの起動時に {{ic|pipewire-media-session}} が実行されないことを意味します。サービスを有効にするには {{ic|systemctl --user enable --now pipewire-media-session.service}} を実行します。

システムの管理者やパッケージマネージャが更新後に設定ファイルの変更を整理していない場合、{{ic|pipewire.service}} によって {{ic|pipewire-media-session}} の別のプロセスが実行されている可能性があります。確認するには {{ic|systemctl --user status pipewire.service}} を実行してください。

pipewire および pipewire-media-session が実行中と表示される場合は、システム設定かユーザ設定、あるいは両方を更新します。

{{hc|/etc/pipewire/pipewire.conf または ~/.config/pipewire/pipewire.conf|output=
context.exec = {
...
# 次の行はコメントアウトする必要があります
#"/usr/bin/pipewire-media-session" = { args = "" }
...
}
}}

=== 再生開始時に音声に遅延が発生する ===

これは非アクティブ時のノードのサスペンドが原因です。遅延が発生する領域に応じて {{ic|/etc/pipewire/media-session.d/*-monitor.conf}} を編集し、プロパティ {{ic|session.suspend-timeout-seconds}} を {{ic|0}} に変更してサスペンドを無効にするか、他の値を試して動作を確認してみてください。{{ic|/etc/pipewire/media-session.d/media-session.conf}} の {{ic|suspend-node}} の行をコメントアウトすることもできます。変更を適用するには {{ic|pipewire}} と {{ic|pipewire-pulse}} systemd サービスの両方を再起動するか、システムを再起動してください。

=== 複数のストリームの再生開始時に音声が途切れる ===

この問題は通常 {{ic|journalctl -b | grep -i pipewire}} を実行し、次のような行を探すことで診断できます:

pipewire-pulse[21740]: pulse-server 0x56009b9d5de0: [Nightly] UNDERFLOW channel:0 offset:370676 underrun:940

[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Troubleshooting#underrununderflow-and-broken-pipe-errors 公式 PipeWire トラブルシューティングガイド]によると、この問題を解決するには {{ic|/etc/pipewire/media-session.d/alsa-monitor.conf}} を編集し、{{ic|1=api.alsa.headroom = 0}} という行のコメントを外し、値を {{ic|1024}} に変更します。

=== 音がひずむ ===
* マイクについては、{{ic|alsamixer}} を起動し、問題があるサウンドカードを選択し、{{ic|Mic Boost}} や {{ic|Internal Mic Boost}} の値を下げてみてください。
* {{ic|/etc/pipewire/pipewire.conf}} の {{ic|1=default.clock.rate = 48000}} のコメントを外して、値を {{ic|44100}} に下げてみてください。

=== スタンバイ後に音声の問題が発生する ===

スリープから復帰した際に音が消えたり壊れたりする場合は、ALSA を最初期化すると改善するかもしれません:

# alsactl init

== 参照 ==

* [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/home Wiki] — PipeWire Wiki on Freedesktop GitLab
* [https://blogs.gnome.org/uraeus/2018/01/26/an-update-on-pipewire-the-multimedia-revolution-an-update/ Pipewire Update Blog Post] — PipeWire の2018年1月時点での進捗が書かれた記事
* [https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ PipeWire Late Summer Update 2020] — 2020年9月からの記事

Limits.conf

2021-07-21T12:55:58Z

Oriaca372m: 同期

{{Lowercase title}}
[[Category:認証]]
[[en:Limits.conf]]
{{Related articles start}}
{{Related|Cgroups}}
{{Related articles end}}

{{ic|/etc/security/limits.conf}} を使うことで [[PAM]] でログインしたユーザーが使用できるリソースを制限することができます。[[Wikipedia:ja:Fork爆弾|フォーク爆弾]]などによってシステムリソースが食い尽くされることを防ぐのに役立ちます。

{{Note|このファイルはシステムサービスには影響しません。[[systemd]] サービスは {{ic|/etc/systemd/system.conf}}, {{ic|/etc/systemd/user.conf}}, {{ic|/etc/systemd/system/''unit''.d/override.conf}} などを使ってリソースを制御することが可能です。詳しくは {{man|5|systemd-system.conf}} の man ページを見てください。}}

== 構文 ==

デフォルトファイルにはコメントが豊富に付けられていますが、{{man|5|limits.conf}} の man ページを読むことでさらに詳しい情報を得ることができます。

== 推奨設定 ==

=== core ===

コアファイルはデバッグのときは役に立ちますが、通常の使用ではとくに役立ちません。ソフトリミットを0にしてハードリミットを無制限にすることで、デバッグでコアファイルが必要になったときだけ {{ic|ulimit -c unlimited}} で一時的にリミットを変更することができます。

* soft core 0 # Prevent corefiles from being generated by default.
* hard core unlimited # Allow corefiles to be temporarily enabled.

=== nice ===

最高優先度 (-20) のプロセスを実行できるのは root だけにすることで、システムが反応しなくなった場合に root で対処することができます。

* hard nice -19 # Prevent non-root users from running a process at minimal niceness.
root hard nice -20 # Allows root to run a process at minimal niceness to fix the system when unresponsive.

=== nofile ===

特定のドメインでプロセスが一度に開くことができるファイル記述子の数を制限します。[https://appdb.winehq.org/objectManager.php?sClass=version&iId=21080&iTestingId=89787#notes 特定のゲームを動作させるには] 値を {{ic|8192}} などに増やす必要があります。MongoDB や Apache Kafka 等のデータベース管理システムの中は {{ic|nofile}} を {{ic|64000}} か {{ic|128000}} に設定することを推奨しているものもあります[https://docs.mongodb.com/manual/reference/ulimit/#recommended-ulimit-settings]。

* hard nofile 8192 # Required for certain games to run.

=== nproc ===

フォーク爆弾を複製できる回数を制限するため、nproc の制限は重要です。ただし、設定した値が低すぎるとシステムが不安定になったり、新しいプロセスが作成できなくなって使用不可能な状態になることもあります。

ミニマルなウィンドウマネージャを使って複数のデスクトップアプリケーションやデーモンを動かす場合は {{ic|300}} は低すぎますが、X を起動しないサーバーの場合は十分です (ジョージア大学の Linux サーバーでは {{ic|300}} に設定されています)。

以下は全てのユーザーの nproc を制限する例です:

* hard nproc 2048 # Prevent fork-bombs from taking out the system.

{{ic|2048}} という値はあくまで例であり、場合によってはもっと高い値が必要になります。逆に、低くしても問題ない可能性もあります。

nproc の設定を何にするのであれ、root ユーザーはいくらでもプロセスを作成できるように設定してください。そうしないと nproc の制限が低すぎた場合に回復できなくなってしまう可能性があります。上記の設定の後に以下の行を記述してください ({{ic|65536}} という値は自由です)。

root hard nproc 65536 # Prevent root from not being able to launch enough processes

=== priority ===

デフォルトの nice 値は基本的に 0 ですが、以下のパラメータを使うことでユーザーやグループによってそれぞれ個別の優先度を設定することができます。

* soft priority 0 # Set the default priority to neutral niceness.

== 参照 ==

* [[セキュリティ]]

PipeWire

2021-05-12T15:27:34Z

Oriaca372m: 同期

[[Category:マルチメディア]]
[[en:PipeWire]]
[[fi:PipeWire]]
[https://pipewire.org PipeWire] は新しい低レベルマルチメディアフレームワークです。
映像と音声を最小の遅延で再生/キャプチャすることを目的としていて、PulseAudio、JACK、ALSA、GStreamer をベースとしたアプリケーションと互換性があります。

このフレームワークのデーモンは (PulseAudio と JACK の機能を持った) オーディオサーバーとしても、ビデオキャプチャサーバーとしても設定できます。

また PipeWire は [[Flatpak]] のようなコンテナをサポートしており、''audio'' や ''video'' [[ユーザーとグループ#グループ管理|ユーザーグループ]]に依存するのではなく、Flatpak や Wayland にスクリーンや音声を録音する許可を求める [[Polkit]] のようなセキュリティモデルを使用しています。

== インストール ==

公式リポジトリの {{pkg|pipewire}} パッケージを[[インストール]]します。

PipeWire は [[systemd/ユーザー]] を使用してサーバーの管理とソケットアクティベーションを行います。

必要に応じて {{pkg|pipewire-docs}} をインストールしてドキュメントを確認することもできます。{{pkg|pipewire-alsa}}、{{pkg|pipewire-pulse}}、{{pkg|pipewire-jack}} などの他のパッケージは [[#音声|PulseAudio/JACKの代わりに PipeWire を使用]]したい場合を除き必要ありません。multilib サポートのために {{aur|lib32-pipewire}}、{{aur|lib32-pipewire-jack}} も利用できます。

== 使用方法 ==

=== WebRTC 画面共有===

ほとんどのブラウザは WebRTC を使用しているとき (例えば Google ハングアウトで) デスクトップ (や個々のアプリケーション) をキャプチャするのに X11 に依存していました。Wayland ではセキュリティ上の理由から画面共有は異なる方法で処理されます。PipeWire はきめ細かなアクセス制御を使用して Wayland 上のコンテンツを共有できます。

これには {{pkg|xdg-desktop-portal}} とそのバックエンドの1つが[http://jgrulich.cz/2018/07/04/04/how-to-enable-and-use-screen-sharing-on-wayland 必要です]。利用可能なバックエンドは次のとおりです:

* GNOME の場合、{{pkg|xdg-desktop-portal-gtk}}
* KDE の場合、{{pkg|xdg-desktop-portal-kde}}
* wlroots ベースのコンポジター ([[Sway]] や [https://github.com/djpohly/dwl dwl] など) の場合、{{pkg|xdg-desktop-portal-wlr}}

Firefox (バージョン84以降) はデフォルトでこの方法をサポートしていますが、Chromium (バージョン73以降) では、[https://bugs.chromium.org/p/chromium/issues/detail?id=682122 WebRTC PipeWireサポート]を次のURLの実験的機能の設定を変更して有効にする必要があります:
chrome://flags/#enable-webrtc-pipewire-capturer

{{ic|xdg-desktop-portal-wlr}} を動かすには {{pkg|pipewire-media-session}} をインストール[https://github.com/emersion/xdg-desktop-portal-wlr/wiki/FAQ/db63ec1ab6c0170334c1d1f45d1ebe543cc375fa#how-do-i-run-xdpw]して、セッション内で環境変数を {{ic|1=XDG_CURRENT_DESKTOP=sway}} のように設定する必要があります[https://github.com/emersion/xdg-desktop-portal-wlr#running]。

{{Tip|複数のモニタがある場合に {{ic|xdg-desktop-portal-wlr}} を使用してそれぞれのモニターを共有するには、ユニットのサービスファイルの {{ic|1=ExecStart=}} オプションを[[Systemd#Editing_provided_units|編集]]して {{ic|1=--output=''Monitor''}} フラグを追加してください。行全体は {{ic|1=ExecStart=@libexecdir@/xdg-desktop-portal-wlr --output=eDP-1}} のようになります。}}

唯一サポートされている機能はデスクトップ全体の共有で、特定のアプリケーション/ウィンドウの共有はサポートされていません。[https://github.com/emersion/xdg-desktop-portal-wlr/wiki/FAQ#will-this-let-me-share-individual-windows][https://github.com/KDE/xdg-desktop-portal-kde/blob/master/TODO]

=== 映像 ===

ソフトウェアはまだ商業利用には適していませんが、試す分には問題ありません。[[GStreamer]] を使用して映像ストリームを処理するほとんどのアプリケーションは PipeWire GStreamer プラグインにより設定なしで動作するはずです。そのため既に {{pkg|cheese}} のようなアプリケーションは PipeWire を使用して映像入力を利用できます。

=== 音声 ===

PulseAudio や JACK と同様に PipeWire をオーディオサーバーとして使用できます。 PulseAudio サーバーの互換実装と JACK クライアント用の ABI 互換ライブラリを提供することで PulseAudio と JACK の両方を置き換えることを目的としています。詳細については[https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ この記事]を参照してください。

==== ALSA/レガシーアプリケーション ====

{{pkg|pipewire-alsa}} をインストールして ALSA API を使用するすべてのアプリケーションが PipeWire を使用するよう設定できます。

==== PulseAudio クライアント ====

{{pkg|pipewire-pulse}} をインストールします。このパッケージは {{pkg|pulseaudio}} と {{pkg|pulseaudio-bluetooth}} を置き換えます。パッケージがユーザーサービス {{ic|pipewire-pulse.socket}} を自動的に有効化するので、通常それ以上の操作は不要です。システム起動時に PipeWire が正しく機能しない場合は、[[systemd/ユーザー|ユーザーサービス]] {{ic|pipewire-pulse.service}} と {{ic|pipewire.service}} と {{ic|pipewire-media-session.service}} が起動して実行されているか確認します。

変更を適用するには、再起動または再ログインしてください。

置き換えが機能しているかどうかを確認するには、次のコマンドを実行して出力を確認してください:

{{hc|1=$ pactl info|2=
...
Server Name: PulseAudio (on PipeWire 0.3.16)
...
}}

==== JACK クライアント ====

{{pkg|pipewire-jack}} をインストールします。{{ic|pw-jack}} を使用して JACK クライアントを起動すると、元の {{ic|libjack*}} ではなく PipeWire が提供する互換ライブラリが使用されます:

pw-jack ''application''

カスタムバッファサイズを要求することもできます。{{ic|PIPEWIRE_LATENCY}}環境変数を {{ic|バッファサイズ/サンプルレート}} (ブロックのレイテンシ(秒)を意味します) に設定します:

PIPEWIRE_LATENCY="128/48000" pw-jack ''application''

また {{aur|pipewire-jack-dropin}} をインストールするか、{{pkg|jack}} か {{pkg|jack2}} をアンインストールして JACK クライアントが互換ライブラリを自動的に読み込むようにもできます。

{{ic|ldd}} を使用して JACK アプリケーションが正しいライブラリにリンクしていることを確認します。

{{hc|1=$ ldd /usr/bin/qjackctl {{!}} grep -i libjack|2=
libjack.so.0 => /usr/lib/pipewire-0.3/jack/libjack.so.0 (0x00007f7e5080a000)
}}

==== Bluetooth デバイス ====

PipeWire は {{pkg|pipewire-pulse}} パッケージがインストールされている場合 Bluetooth オーディオデバイスを制御します。具体的には、メディアセッションデーモンは {{ic|/etc/pipewire/media-session.d/with-pulseaudio}} が存在する時に自動的にその {{ic|bluez5}} モジュールを有効にします。

==== ネイティブ JACK 上で PipeWire を実行する ====

PipeWire はネイティブ JACK デーモン上の JACK クライアントとして実行することもできます。詳細は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/JACK JACK and PipeWire] を参照してください。

== 音声のポストプロセッシング ==

=== PulseEffects ===

PulseEffects は多数のエフェクトとフィルタを個々の入出力ストリーム (アプリケーションの音声出力やマイクの入力など) に提供する GTK 製のユーティリティです。注目すべきエフェクトには、入出力イコライザー、出力ラウドネス等化、ベースエンハンスメント、入力ディエッサー、ノイズ抑制プラグインなどがあります。[https://github.com/wwmm/pulseeffects GitHub ページ]にエフェクトの一覧があります。

PipeWire で PulseEffects を使用するには、{{pkg|pulseeffects}} または {{AUR|pulseeffects-git}} をインストールします。

{{Note|これにより、{{pkg|pipewire-pulse}} がインストールされ [[#PulseAudio クライアント|PulseAudio が PipeWire に置き換えられます。]]詳細は {{Bug|69437}} を参照してください。古いバージョンについては [[PulseAudio#PulseEffects]] を参照してください。}}

プリセット設定のコレクションについては、[https://github.com/wwmm/pulseeffects/wiki/Community-presets コミュニティープリセット]を参照してください。

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

=== PipeWire にマイクが検出されない ===

PipeWire の {{ic|alsa-monitor}} モジュールは、デフォルトで {{pkg|alsa-card-profiles}} を使用してデバイスを検出します。これでうまくいかない場合は、{{ic|/etc/pipewire/media-session.d/alsa-monitor.conf}} の {{ic|rules}} -> 最初のルール -> {{ic|actions}} -> {{ic|update-props}} の {{ic|api.alsa.use-acp}} を {{ic|false}} にするか、または {{ic|api.alsa.use-ucm}} を {{ic|true}} にしてみてください:

...
update-props = {
api.alsa.use-acp = false
...

次に PipeWire を再起動し使用可能なデバイスを確認します:

{{hc|1=
$ pw-record --list-targets
|2=
Available targets ("*" denotes default): 62
58: description="Built-in Audio" prio=1872
60: description="Built-in Audio" prio=2000
* 62: description="Built-in Audio (Loopback PCM)" prio=1984
}}

=== Bluetooth デバイスに接続しても音が出ない ===

2020-12-07 の時点で、Bluetooth デバイスを接続しても音が出ない場合は、デフォルトのシンクに切り替えるか、シンク入力を正しいシンクに移動する必要があります。{{ic|pactl list sinks}} で使用可能なシンクの一覧を表示し、{{ic|pactl set-default-sink}} でデフォルトのシンクを Bluetooth デバイスに切り替えます。これは[https://gist.github.com/tinywrkb/04e7fd644afa9b92d33a3a99ab07ee9e このようなスクリプト]を使って [[udev]] で自動化できます。

この問題については、この [https://www.reddit.com/r/archlinux/comments/jydd02/pipewirepulse_03164_in_testing_now_replaces/gd3m7fu/?context=3 Reddit スレッド]を参照してください。スクリプトの作成者によると、ヘッドセットプロファイル (HSP) にまだ問題がある可能性があります。

=== 音量が小さい ===

PulseAudio を PipeWire で置き換えた後、正しく音が出ても、再起動後に音量が極端に小さくなることがあります。

{{ic|alsamixer}} を開き、{{ic|F6}} を押して適切なサウンドカードを選び ALSA のボリュームが100%であることを確認してください。{{ic|alsactl}} は再起動後もこの設定を維持するはずです。

=== increasing RLIMIT_MEMLOCK ===

Dec 13 11:11:11 HOST pipewire-pulse[99999]: Failed to mlock memory 0x7f4f659d8000 32832: This is not a problem but for best performance, consider increasing RLIMIT_MEMLOCK

{{pkg|realtime-privileges}} をインストールし {{ic|realtime}} グループに自分のユーザーを追加します。

あるいは memlock を 64kB から 128kB に増やすことで、この問題を解決できるようです。[[systemd/ユーザー]] で {{ic|pipewire-pulse}} を実行している場合は {{ic|/etc/security/limits.d/username.conf}} に次の行を追加します:

username soft memlock 64
username hard memlock 128

=== サンプリングレートを変更する ===

デフォルトで PipeWire はグローバルサンプリングレートを 48kHz に設定します。これを変更したい場合 (DACがより高い値をサポートしている場合など) は {{ic|/etc/pipewire/pipewire.conf}} の {{ic|1=default.clock.rate = 48000}} の行を編集します。例えば 192kHz にしたい場合、コメントを外して {{ic|48000}} を {{ic|192000}} に変更します。

=== 外付けサウンドカードが再接続後に有効にならない ===

{{ic|~/.config/pipewire-media-session/default-profile}} にデフォルトプロファイル ''off'' のエントリがあれば削除します。それでも解決しない場合は {{ic|~/.config/pipewire-media-session/}} からすべてのファイルを削除し、{{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動します。

=== 音が出ないまたは pactl info が Failure: Connection refused と表示する ===

これはアプリケーションが PipeWire-Pulse サービスに接続できていないことを意味します。{{ic|/etc/pipewire/pipewire-pulse.conf}} が存在し空でないことを確認し、{{ic|systemctl --user restart pipewire-pulse.service}} で PipeWire-Pulse を再起動してください。

それでも解決しない場合は {{ic|strace -f -o /tmp/pipe.txt pactl info}} を実行し、pastebin に {{ic|/tmp/pipe.txt}} を貼り付けて、IRC (Freenode '''#pipewire''') かメーリングリストで相談してください。

=== Bluetooth の音声の品質が低い===

Bluetooth で再生が途切れる場合は {{ic|systemctl --user status pipewire.service}} を実行してみてください。次のようなエラーが表示される場合は、

Feb 17 18:23:01 HOST pipewire[249297]: (bluez_input.18:54:CF:04:00:56.a2dp-sink-60) client too slow! rate:512/48000 pos:370688 status:triggered

{{ic|pactl list sinks}} で現在選択されているコーデックを確認し、{{ic|/etc/pipewire/media-session.d/bluez-monitor.conf}} の {{ic|bluez5.codecs}} を {{ic|sbc aac ldac aptx aptx_hd}} のいずれかに変更してみてください。

{{hc|head=/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
properties = {
...
bluez5.codecs = [sbc]
...}}

mSBC サポートの有効化を試すには (Sony 1000XM3 のマイクの問題を修正します):

{{hc|head=/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
rules = [
...
actions = {
...
update-props = {
...
bluez5.msbc-support = true
...}}

変更を適用するには {{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動する必要があります。

=== PipeWire の更新 (git / >=0.3.23) と再起動後デバイスが検出されない===

コミット 012a68f8[https://gitlab.freedesktop.org/pipewire/pipewire/-/commit/012a68f8ef33705f1a40ec8ac294b8cce7f6aa88] の時点で新しい systemd サービスが追加されデフォルトでは無効になっています。これはシステムの起動時に {{ic|pipewire-media-session}} が実行されないことを意味します。サービスを有効にするには {{ic|systemctl --user enable --now pipewire-media-session.service}} を実行します。

システムの管理者やパッケージマネージャが更新後に設定ファイルの変更を整理していない場合、{{ic|pipewire.service}} によって {{ic|pipewire-media-session}} の別のプロセスが実行されている可能性があります。確認するには {{ic|systemctl --user status pipewire.service}} を実行してください。

pipewire および pipewire-media-session が実行中と表示される場合は、システム設定かユーザ設定、あるいは両方を更新します。

{{hc|head=/etc/pipewire/pipewire.conf または ~/.config/pipewire/pipewire.conf|output=
context.exec = {
...
# 次の行はコメントアウトする必要があります
#"/usr/bin/pipewire-media-session" = { args = "" }
...
}
}}

=== 再生開始時に音声に遅延が発生する ===

これは非アクティブ時のノードのサスペンドが原因です。遅延が発生する領域に応じて {{ic|/etc/pipewire/media-session.d/*-monitor.conf}} を編集し、プロパティ {{ic|session.suspend-timeout-seconds}} を {{ic|0}} に変更してサスペンドを無効にするか、他の値を試して動作を確認してみてください。{{ic|/etc/pipewire/media-session.d/media-session.conf}} の {{ic|suspend-node}} の行をコメントアウトすることもできます。変更を適用するには {{ic|pipewire}} と {{ic|pipewire-pulse}} systemd サービスの両方を再起動するか、システムを再起動してください。

=== 複数のストリームの再生開始時に音声が途切れる ===

この問題は通常 {{ic|journalctl -b | grep -i pipewire}} を実行し、次のような行を探すことで診断できます:

pipewire-pulse[21740]: pulse-server 0x56009b9d5de0: [Nightly] UNDERFLOW channel:0 offset:370676 underrun:940

[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Troubleshooting#underrununderflow-and-broken-pipe-errors 公式 PipeWire トラブルシューティングガイド]によると、この問題を解決するには {{ic|/etc/pipewire/media-session.d/alsa-monitor.conf}} を編集し、{{ic|1=api.alsa.headroom = 0}} という行のコメントを外し、値を {{ic|1024}} に変更します。

=== マイクの音がひずむ ===

マイクの''ブースト''設定によってこの問題が発生することがあります。
{{ic|alsamixer}} を起動し、問題があるサウンドカードを選択し、{{ic|Mic Boost}} や {{ic|Internal Mic Boost}} の値を下げてみてください。

== 参照 ==

* [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/home Wiki] — PipeWire Wiki on Freedesktop GitLab
* [https://blogs.gnome.org/uraeus/2018/01/26/an-update-on-pipewire-the-multimedia-revolution-an-update/ Pipewire Update Blog Post] — PipeWire の2018年1月時点での進捗が書かれた記事
* [https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ PipeWire Late Summer Update 2020] — 2020年9月からの記事

PipeWire

2021-03-30T16:42:49Z

Oriaca372m: 英語版と同期

[[Category:マルチメディア]]
[[en:PipeWire]]
[[fi:PipeWire]]
[http://pipewire.org PipeWire] は新しい低レベルマルチメディアフレームワークです。
映像と音声を最小の遅延で再生/キャプチャすることを目的としていて、PulseAudio、JACK、ALSA、GStreamer をベースとしたアプリケーションと互換性があります。

このフレームワークのデーモンは (PulseAudio と JACK の機能を持った) オーディオサーバーとしても、ビデオキャプチャサーバーとしても設定できます。

また PipeWire は [[Flatpak]] のようなコンテナをサポートしており、''audio'' や ''video'' [[ユーザーとグループ#グループ管理|ユーザーグループ]]に依存するのではなく、Flatpak や Wayland にスクリーンや音声を録音する許可を求める [[Polkit]] のようなセキュリティモデルを使用しています。

== インストール ==

公式リポジトリの {{pkg|pipewire}} パッケージを[[インストール]]します。

PipeWire は [[systemd/ユーザー]] を使用してサーバーの管理とソケットアクティベーションを行います。起動時の動作やログの確認方法などの詳細は [[systemd/ユーザー]] を参照してください。

必要に応じて {{pkg|pipewire-docs}} をインストールしてドキュメントを確認することもできます。{{pkg|pipewire-alsa}}、{{pkg|pipewire-pulse}}、{{pkg|pipewire-jack}} などの他のパッケージは [[#音声|PulseAudio/JACKの代わりに PipeWire を使用]]したい場合を除き必要ありません。multilib サポートのために {{aur|lib32-pipewire}}、{{aur|lib32-pipewire-jack}} も利用できます。

== 使用方法 ==

=== WebRTC 画面共有===

ほとんどのブラウザは WebRTC を使用しているとき (例えば Google ハングアウトで) デスクトップ (や個々のアプリケーション) をキャプチャするのに X11 に依存していました。Wayland ではセキュリティ上の理由から画面共有は異なる方法で処理されます。PipeWire はきめ細かなアクセス制御を使用して Wayland 上のコンテンツを共有できます。

これには {{pkg|xdg-desktop-portal}} とそのバックエンドの1つが[http://jgrulich.cz/2018/07/04/04/how-to-enable-and-use-screen-sharing-on-wayland 必要です]。利用可能なバックエンドは次のとおりです:

* GNOME の場合、{{pkg|xdg-desktop-portal-gtk}}
* KDE の場合、{{pkg|xdg-desktop-portal-kde}}
* wlroots ベースのコンポジター ([[Sway]] や [https://github.com/djpohly/dwl dwl] など) の場合、{{pkg|xdg-desktop-portal-wlr}}

Firefox (バージョン84以降) はデフォルトでこの方法をサポートしていますが、Chromium (バージョン73以降) では、[https://bugs.chromium.org/p/chromium/issues/detail?id=682122 WebRTC PipeWireサポート]を次のURLの実験的機能の設定を変更して有効にする必要があります:
chrome://flags/#enable-webrtc-pipewire-capturer

{{ic|xdg-desktop-portal-wlr}} を動かすには {{pkg|pipewire-media-session}} をインストール[https://github.com/emersion/xdg-desktop-portal-wlr/wiki/FAQ/db63ec1ab6c0170334c1d1f45d1ebe543cc375fa#how-do-i-run-xdpw]して {{ic|XDG_CURRENT_DESKTOP}} 環境変数を設定[https://github.com/emersion/xdg-desktop-portal-wlr#running]する必要があります:
export XDG_CURRENT_DESKTOP=sway

Chromium は現在 PipeWire 0.2 を使っていますが、Arch Linux では PipeWire 0.3 を提供しているので、画面共有を行うには {{pkg|libpipewire02}} もインストールする必要があります。

{{Tip|複数のモニタがある場合に {{ic|xdg-desktop-portal-wlr}} を使用してそれぞれのモニターを共有するには、ユニットのサービスファイルの {{ic|1=ExecStart=}} オプションを[[Systemd#Editing_provided_units|編集]]して {{ic|1=--output=''Monitor''}} フラグを追加してください。行全体は {{ic|1=ExecStart=@libexecdir@/xdg-desktop-portal-wlr --output=eDP-1}} のようになります。}}

唯一サポートされている機能はデスクトップ全体の共有で、特定のアプリケーション/ウィンドウの共有はサポートされていません。[https://github.com/emersion/xdg-desktop-portal-wlr/wiki/FAQ#will-this-let-me-share-individual-windows][https://github.com/KDE/xdg-desktop-portal-kde/blob/master/TODO]

=== 映像 ===

ソフトウェアはまだ商業利用には適していませんが、試す分には問題ありません。[[GStreamer]] を使用して映像ストリームを処理するほとんどのアプリケーションは PipeWire GStreamer プラグインにより設定なしで動作するはずです。そのため既に {{pkg|cheese}} のようなアプリケーションは PipeWire を使用して映像入力を利用できます。

=== 音声 ===

PulseAudio や JACK と同様に PipeWire をオーディオサーバーとして使用できます。 PulseAudio サーバーの互換実装と JACK クライアント用の ABI 互換ライブラリを提供することで PulseAudio と JACK の両方を置き換えることを目的としています。詳細については[https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ この記事]を参照してください。

==== ALSA/レガシーアプリケーション ====

{{pkg|pipewire-alsa}} をインストールして ALSA API を使用するすべてのアプリケーションが PipeWire を使用するよう設定できます。

==== PulseAudio クライアント ====

{{pkg|pipewire-pulse}} をインストールします。このパッケージは {{pkg|pulseaudio}} と {{pkg|pulseaudio-bluetooth}} を置き換えます。パッケージがユーザーサービス {{ic|pipewire-pulse.socket}} を自動的に有効化するので、通常それ以上の操作は不要です。システム起動時に PipeWire が正しく機能しない場合は、ユーザーサービス {{ic|pipewire-pulse.service}} と {{ic|pipewire.service}} と {{ic|pipewire-media-session.service}} が起動して実行されているか確認します。[[Systemd/ユーザー]]を参照してください。

変更を適用するには、再起動または再ログインしてください。

置き換えが機能しているかどうかを確認するには、次のコマンドを実行して出力を確認してください:

{{hc|1=$ pactl info|2=
...
Server Name: PulseAudio (on PipeWire 0.3.16)
...
}}

==== JACK クライアント ====

{{pkg|pipewire-jack}} をインストールします。{{ic|pw-jack}} を使用して JACK クライアントを起動すると、元の {{ic|libjack*}} ではなく PipeWire が提供する互換ライブラリが使用されます:

pw-jack ''application''

カスタムバッファサイズを要求することもできます。{{ic|PIPEWIRE_LATENCY}}環境変数を {{ic|バッファサイズ/サンプルレート}} (ブロックのレイテンシ(秒)を意味します) に設定します:

PIPEWIRE_LATENCY="128/48000" pw-jack ''application''

また {{aur|pipewire-jack-dropin}} をインストールするか、{{pkg|jack}} か {{pkg|jack2}} をアンインストールして JACK クライアントが互換ライブラリを自動的に読み込むようにもできます。

{{ic|ldd}} を使用して JACK アプリケーションが正しいライブラリにリンクしていることを確認します。

{{hc|1=$ ldd /usr/bin/qjackctl {{!}} grep -i libjack|2=
libjack.so.0 => /usr/lib/pipewire-0.3/jack/libjack.so.0 (0x00007f7e5080a000)
}}

==== Bluetooth デバイス ====

PipeWire は {{pkg|pipewire-pulse}} パッケージがインストールされている場合 Bluetooth オーディオデバイスを制御します。具体的には、メディアセッションデーモンは {{ic|/etc/pipewire/media-session.d/with-pulseaudio}} が存在する時に自動的にその {{ic|bluez5}} モジュールを有効にします。

==== ネイティブ JACK 上で PipeWire を実行する ====

PipeWire はネイティブ JACK デーモン上の JACK クライアントとして実行することもできます。詳細は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/JACK JACK and PipeWire] を参照してください。

== 音声のポストプロセッシング ==

=== PulseEffects ===

PulseEffects は多数のエフェクトとフィルタを個々の入出力ストリーム (アプリケーションの音声出力やマイクの入力など) に提供する GTK 製のユーティリティです。注目すべきエフェクトには、入出力イコライザー、出力ラウドネス等化、ベースエンハンスメント、入力ディエッサー、ノイズ抑制プラグインなどがあります。[https://github.com/wwmm/pulseeffects GitHub ページ]にエフェクトの一覧があります。

PipeWire で PulseEffects を使用するには、{{pkg|pulseeffects}} または {{AUR|pulseeffects-git}} をインストールします。

{{Note|これにより、{{pkg|pipewire-pulse}} がインストールされ [[#PulseAudio クライアント|PulseAudio が PipeWire に置き換えられます。]]詳細は {{Bug|69437}} を参照してください。古いバージョンについては [[PulseAudio#PulseEffects]] を参照してください。}}

プリセット設定のコレクションについては、[https://github.com/wwmm/pulseeffects/wiki/Community-presets コミュニティープリセット]を参照してください。

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

=== PipeWire にマイクが検出されない ===

PipeWire の {{ic|alsa-monitor}} モジュールは、デフォルトで {{pkg|alsa-card-profiles}} を使用してデバイスを検出します。これでうまくいかない場合は、{{ic|/etc/pipewire/media-session.d/alsa-monitor.conf}} の {{ic|rules}} -> 最初のルール -> {{ic|actions}} -> {{ic|update-props}} の {{ic|api.alsa.use-acp}} を {{ic|false}} にするか、または {{ic|api.alsa.use-ucm}} を {{ic|true}} にしてみてください:

...
update-props = {
api.alsa.use-acp = false
...

次に PipeWire を再起動し使用可能なデバイスを確認します:

{{hc|1=
$ pw-record --list-targets
|2=
Available targets ("*" denotes default): 62
58: description="Built-in Audio" prio=1872
60: description="Built-in Audio" prio=2000
* 62: description="Built-in Audio (Loopback PCM)" prio=1984
}}

=== Bluetooth デバイスに接続しても音が出ない ===

2020-12-07 の時点で、Bluetooth デバイスを接続しても音が出ない場合は、デフォルトのシンクに切り替えるか、シンク入力を正しいシンクに移動する必要があります。{{ic|pactl list sinks}} で使用可能なシンクの一覧を表示し、{{ic|pactl set-default-sink}} でデフォルトのシンクを Bluetooth デバイスに切り替えます。これは[https://gist.github.com/tinywrkb/04e7fd644afa9b92d33a3a99ab07ee9e このようなスクリプト]を使って [[udev]] で自動化できます。

この問題については、この [https://www.reddit.com/r/archlinux/comments/jydd02/pipewirepulse_03164_in_testing_now_replaces/gd3m7fu/?context=3 Reddit スレッド]を参照してください。スクリプトの作成者によると、ヘッドセットプロファイル (HSP) にまだ問題がある可能性があります。

=== 音量が小さい ===

PulseAudio を PipeWire で置き換えた後、正しく音が出ても、再起動後に音量が極端に小さくなることがあります。

{{ic|alsamixer}} を開き、{{ic|F6}} を押して適切なサウンドカードを選び ALSA のボリュームが100%であることを確認してください。{{ic|alsactl}} は再起動後もこの設定を維持するはずです。

=== increasing RLIMIT_MEMLOCK ===

Dec 13 11:11:11 HOST pipewire-pulse[99999]: Failed to mlock memory 0x7f4f659d8000 32832: This is not a problem but for best performance, consider increasing RLIMIT_MEMLOCK

{{pkg|realtime-privileges}} をインストールし {{ic|realtime}} グループに自分のユーザーを追加します。

あるいは memlock を 64kB から 128kB に増やすことで、この問題を解決できるようです。[[systemd/ユーザー]] で {{ic|pipewire-pulse}} を実行している場合は {{ic|/etc/security/limits.d/username.conf}} に次の行を追加します:

username soft memlock 64
username hard memlock 128

=== サンプリングレートを変更する ===

デフォルトで PipeWire はグローバルサンプリングレートを 48kHz に設定します。これを変更したい場合 (DACがより高い値をサポートしている場合など) は {{ic|/etc/pipewire/pipewire.conf}} の {{ic|1=default.clock.rate = 48000}} の行を編集します。例えば 192kHz にしたい場合、コメントを外して {{ic|48000}} を {{ic|192000}} に変更します。

=== 外付けサウンドカードが再接続後に有効にならない ===

{{ic|~/.config/pipewire-media-session/default-profile}} にデフォルトプロファイル ''off'' のエントリがあれば削除します。それでも解決しない場合は {{ic|~/.config/pipewire-media-session/}} からすべてのファイルを削除し、{{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動します。

=== 音が出ないまたは pactl info が Failure: Connection refused と表示する ===
これはアプリケーションが PipeWire-Pulse サービスに接続できていないことを意味します。{{ic|/etc/pipewire/pipewire-pulse.conf}} が存在し空でないことを確認し、{{ic|systemctl --user restart pipewire-pulse.service}} で PipeWire-Pulse を再起動してください。

それでも解決しない場合は {{ic|strace -f -o /tmp/pipe.txt pactl info}} を実行し、pastebin に {{ic|/tmp/pipe.txt}} を貼り付けて、IRC (Freenode '''#pipewire''') かメーリングリストで相談してください。

=== Bluetooth の音声の品質が低い===

Feb 17 18:23:01 HOST pipewire[249297]: (bluez_input.18:54:CF:04:00:56.a2dp-sink-60) client too slow! rate:512/48000 pos:370688 status:triggered

Bluetooth で再生が途切れる場合は {{ic|systemctl --user status pipewire.service}} を実行してみてください。このようなエラーが表示される場合は {{ic|pactl list sinks}} で現在選択されているコーデックを確認し、{{ic|/etc/pipewire/media-session.d/bluez-monitor.conf}} の {{ic|bluez5.codecs}} を {{ic|sbc aac ldac aptx aptx_hd}} のいずれかに変更してみてください。変更を適用するには {{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動する必要があります。

{{hc|head=/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
properties = {
...
bluez5.codecs = [sbc]
...}}

=== PipeWire の更新 (git / >=0.3.23) と再起動後デバイスが検出されない===

コミット 012a68f8[https://gitlab.freedesktop.org/pipewire/pipewire/-/commit/012a68f8ef33705f1a40ec8ac294b8cce7f6aa88] の時点で新しい systemd サービスが追加されデフォルトでは無効になっています。これはシステムの再起動時に {{ic|pipewire-media-session}} が実行されないことを意味します。サービスを有効にするには {{ic|systemctl --user enable --now pipewire-media-session.service}} を実行します。

システムの管理者やパッケージマネージャが更新後に設定ファイルの変更を整理していない場合、{{ic|pipewire.service}} によって {{ic|pipewire-media-session}} の別のプロセスが実行されている可能性があります。確認するには {{ic|systemctl --user status pipewire.service}} を実行してください。

pipewire および pipewire-media-session が実行中と表示される場合は、システム設定かユーザ設定、あるいは両方を更新します。

{{hc|head=/etc/pipewire/pipewire.conf または ~/.config/pipewire/pipewire.conf|output=
context.exec = {
...
# 次の行はコメントアウトする必要があります
#"/usr/bin/pipewire-media-session" = { args = "" }
...
}
}}

=== 再生開始時に音声に遅延が発生する ===

これは非アクティブ時のノードのサスペンドが原因です。遅延が発生する領域に応じて {{ic|/etc/pipewire/media-session.d/*-monitor.conf}} を編集し、プロパティ {{ic|session.suspend-timeout-seconds}} を {{ic|0}} に変更してサスペンドを無効にするか、他の値を試して動作を確認してみてください。{{ic|/etc/pipewire/media-session.conf}} の {{ic|suspend-node}} の行をコメントアウトすることもできます。変更を適用するには {{ic|pipewire}} と {{ic|pipewire-pulse}} systemd サービスの両方を再起動するか、システムを再起動してください。

=== 複数のストリームの再生開始時に音声が途切れる ===

この問題は通常 {{ic|journalctl -b | grep -i pipewire}} を実行し、次のような行を探すことで診断できます:

pipewire-pulse[21740]: pulse-server 0x56009b9d5de0: [Nightly] UNDERFLOW channel:0 offset:370676 underrun:940

[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Troubleshooting#underrununderflow-and-broken-pipe-errors 公式 PipeWire トラブルシューティングガイド]によると、この問題を解決するには {{ic|/etc/pipewire/media-session.d/alsa-monitor.conf}} を編集し、{{ic|1=api.alsa.headroom = 0}} という行のコメントを外し、値を {{ic|1024}} に変更します。

== 参照 ==

* [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/home Wiki] — PipeWire Wiki on Freedesktop GitLab
* [https://blogs.gnome.org/uraeus/2018/01/26/an-update-on-pipewire-the-multimedia-revolution-an-update/ Pipewire Update Blog Post] — PipeWire の2018年1月時点での進捗が書かれた記事
* [https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ PipeWire Late Summer Update 2020] — 2020年9月からの記事

コンソールのカラー出力

2021-03-30T16:09:33Z

Oriaca372m: /* ip */ --colorも-colorも認識するが英語版とmanに合わせて-colorに統一

[[Category:Linux コンソール]]
[[Category:視覚効果]]
[[en:Color output in console]]
[[zh-hans:Color output in console]]
{{Related articles start}}
{{Related|Emacs#カスタムカラーとテーマ}}
{{Related|nano#シンタックスハイライト}}
{{Related articles end}}
このページでは CLI 出力のカラー化をまとめています。

== Background ==

=== エスケープシーケンス ===

[[Wikipedia:ANSI escape sequence|ANSI エスケープシーケンス]] はターミナル出力に追加情報を配置する方法を定義しており、色はこの「追加情報」の一部です。何年にもわたって端末の色の範囲は、最初の8色から24ビットのトゥルーカラーまで、年々大幅に拡大されてきました。

基本的なカラーエンコーディングは、通常の明るさの 8 色と、その明るいバージョンの 8 色を提供します。Linux コンソール自体を含む最新のターミナルエミュレータを使用すると、色が変換される正確な RGB 値を指定できます。このモードは、ほとんどのターミナルエミュレータでサポートされています。

256 色ディスプレイの出現により、256 色のエスケープが可能になりました。256 色とは、基本 16 色、RGB 216色(6 x 6 x 6 の立方体に配置)、および 24 レベルのグレースケールです。最初の 16 色を除いて、RGB へのマッピングが明確に定義されているので、通常はカスタマイズできません。このモードは、ほとんどのターミナルエミュレータでサポートされています。(一部のエミュレータは 88 色のみの類似した互換性のないエンコーディングが使用されています。実際に使用することはほとんどありませんが、terminfoデータベースには表示されます)。

あまり一般的ではありませんが、トゥルーカラーモードでは、RGB で 1670 万 (224)色(各値は 0 から 255 まで)を使用することができます。

=== Termcap と terminfo ===

Termcap と terminfo は {{Pkg|ncurses}} の一部で、端末（通常は、{{ic|TERM}} 環境変数で指定）が理解できるエスケープに関する情報を提供するデータベースです。{{man|1|tput}} と {{man|1|infocmp}} コマンドは、コマンドラインからアクセスするために使用することができす。

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

=== diff ===

diffutils にはバージョン 3.4 から {{ic|--color}} オプションが存在します ([https://lists.gnu.org/archive/html/info-gnu/2016-08/msg00004.html GNU メーリングリスト]):

$ alias diff='diff --color=auto'

=== grep ===

{{ic|1=--color=auto}} オプションでカラーハイライトが有効になります。カラーコードは標準出力でのみ使われ、パイプやリダイレクトには出力されません。

''grep'' のカラー出力は [[Wikipedia:regexp|regexp]] でも利用できます。

[[エイリアス]]を作成することでオプションをずっと有効にできます:

alias grep='grep --color=auto'

{{ic|GREP_COLORS}} 変数を使うことで色を定義したり、ハイライトの様々な部分を設定できます。

詳しくは {{man|1|grep}} を見てください。

{{ic|GREP_COLOR}} 環境変数を使うことでデフォルトのハイライト色を定義できます (デフォルトは赤です)。色を変更するときは、色の [http://www.tldp.org/HOWTO/Bash-Prompt-HOWTO/x329.html ANSI エスケープシーケンス] を確認して以下のコマンドを使ってください:

export GREP_COLOR="1;32"

{{ic|-n}} オプションを使うことでファイルの行番号も出力されます。

=== ip ===

{{man|8|ip}} コマンドの {{ic|-color}} オプションが使えます。{{ic|auto}} 引数を指定すると、出力先が標準出力のときのみカラー出力が行なわれます。

alias ip='ip -color=auto'

=== less ===

==== 環境変数 ====

以下の行をシェルの設定ファイルに追加してください:

{{hc|~/.bashrc|2=
export LESS=-R
export LESS_TERMCAP_mb=$'\E[1;31m' # begin blink
export LESS_TERMCAP_md=$'\E[1;36m' # begin bold
export LESS_TERMCAP_me=$'\E[0m' # reset bold/blink
export LESS_TERMCAP_so=$'\E[01;44;33m' # begin reverse video
export LESS_TERMCAP_se=$'\E[0m' # reset reverse video
export LESS_TERMCAP_us=$'\E[1;32m' # begin underline
export LESS_TERMCAP_ue=$'\E[0m' # reset underline
# and so on
}}

値はお好きに変更してください ([[Wikipedia:ANSI escape code#Colors|ANSI エスケープコード]])。[http://boredzo.org/blog/archives/2016-08-15/colorized-man-pages-understood-and-customized このブログ記事] や [[Bash/プロンプトのカスタマイズ]]も見てください。

{{note|{{ic|LESS_TERMCAP_''xx''}} 変数は {{man|1|less}} の man ページに載っていません。詳しい説明は [https://unix.stackexchange.com/questions/108699/documentation-on-less-termcap-variables/108840#108840] を見てください。}}

==== 標準入力からの読み込み ====

{{Note|以下は {{ic|1=export LESS=R}} に基づいているので、{{ic|~/.bashrc}} や {{ic|~/.zshrc}} に[[#環境変数|環境変数]]を追加することを推奨します。}}

コマンドを実行してページ表示するために[[Wikipedia:Standard output|標準出力]] (''stdout'') を ''less'' にパイプする場合 (例: {{ic|<nowiki>pacman -Qe | less</nowiki>}})、出力がカラー化されないことに気づくかもしれません。''stdout'' がインタラクティブターミナルであるかどうかを判別して、その場合はカラーのテキストを出力して、そうでない場合はカラーでないテキストを出力するようになっているのが原因です。''stdout'' をファイルにリダイレクトしたいようなときはこれで構わないでしょうが (例: {{ic|<nowiki>pacman -Qe > pkglst-backup.txt</nowiki>}})、{{ic|less}} で出力を表示したいような時はあまり望ましくありません。

インタラクティブ tty の検出を無効化するオプションがプログラムに存在することがあります:

# dmesg --color=always | less

プログラムに無効化オプションが存在しない場合、以下のユーティリティを使うことで ''stdout'' がインタラクティブターミナルであるかのように信じこませることができます:

* {{App|stdoutisatty|{{ic|isatty}} 関数のコールをキャッチする小さなプログラム。|https://github.com/lilydjwg/stdoutisatty.|{{AUR|stdoutisatty-git}}}}
:例: {{ic|stdoutisatty ''program'' <nowiki>| less</nowiki>}}
* {{App|unbuffer|''sh'' と [http://tcl.tk/ Tcl] ベースのスクリプト。|http://expect.sourceforge.net/example/unbuffer.man.html|{{Pkg|expect}}}}
:例: {{ic|unbuffer ''program'' <nowiki>| less</nowiki>}}

もしくは、[[zsh]] の [http://zsh.sourceforge.net/Doc/Release/Zsh-Modules.html#The-zsh_002fzpty-Module zpty] モジュールを使って下さい [http://lilydjwg.is-programmer.com/2011/6/29/using-zpty-module-of-zsh.27677.html]:

{{hc|~/.zshrc|
<nowiki>zmodload zsh/zpty

pty() {
zpty pty-${UID} ${1+$@}
if [[ ! -t 1 ]];then
setopt local_traps
trap '' INT
fi
zpty -r pty-${UID}
zpty -d pty-${UID}
}

ptyless() {
pty $@ | less
}</nowiki>}}

使用方法:

$ ptyless ''program''

他のページャにパイプするには (例: less):

$ pty ''program'' | less

=== ls ===

{{ic|1=--color=auto}} オプションでカラーハイライトが有効になります。カラーコードは標準出力でのみ使われ、パイプやリダイレクトでは使われません。

[[エイリアス]]を使うことでオプションを永続的に有効化できます:

alias ls='ls --color=auto'

{{ic|LS_COLORS}} 変数を使って色を定義します。様々なハイライトを設定できます。設定するときは {{man|1|dircolors}} コマンドを使ってください。

{{Note|{{ic|--color}} オプションを使用すると大量のファイルが存在するディレクトリで ''ls'' を実行したときにパフォーマンスに深刻な影響を与えることがあります。デフォルト設定では ''ls'' は表示する全てのファイルに {{man|1|stat}} する必要があります。しかしながら、他のカラーオプション (executable, orphan, sticky, other-writable, capability) を使用しないでほとんどのファイルタイプのカラー化をしたい場合、''dircolors'' を使って {{ic|LS_COLORS}} 環境変数を以下のように設定してください:

<nowiki>eval $(dircolors -p | perl -pe 's/^((CAP|S[ET]|O[TR]|M|E)\w+).*/$1 00/' | dircolors -)</nowiki>
}}

詳しくは {{man|1|ls}} を見てください。

=== man ===

man ページのカラー出力を行う方法は2つ存在します: {{Ic|less}} を使用する方法、または {{Ic|most}} を使用する方法。

==== less を使う ====
詳しくは [[#less]] を見てください。

{{Ic|man}} の {{Ic|less}} ラッパーは以下のようになります:

{{hc|~/.bashrc|
<nowiki>man() {
LESS_TERMCAP_md=$'\e[01;31m' \
LESS_TERMCAP_me=$'\e[0m' \
LESS_TERMCAP_se=$'\e[0m' \
LESS_TERMCAP_so=$'\e[01;44;33m' \
LESS_TERMCAP_ue=$'\e[0m' \
LESS_TERMCAP_us=$'\e[01;32m' \
command man "$@"
}
</nowiki>}}

[[Fish]] の場合、以下のようにします:

{{hc|~/.config/fish/config.fish|<nowiki>
set -xU LESS_TERMCAP_md (printf "\e[01;31m")
set -xU LESS_TERMCAP_me (printf "\e[0m")
set -xU LESS_TERMCAP_se (printf "\e[0m")
set -xU LESS_TERMCAP_so (printf "\e[01;44;33m")
set -xU LESS_TERMCAP_ue (printf "\e[0m")
set -xU LESS_TERMCAP_us (printf "\e[01;32m")
</nowiki>}}

設定を source するかシェルを再起動すると変更が適用されます。

==== most を使う ====

'most' の基本的な機能は {{Ic|less}} や {{Ic|more}} と似ていますが、備えている機能の数はやや少なくなっています。most でカラー出力を使うように設定するのは less よりも簡単ですが、less のように most を使うには別の設定が必要になります。

{{Pkg|most}} パッケージをインストールしてください。

{{ic|/etc/man_db.conf}} を編集して、ページャの定義をアンコメントして次のように変更:

DEFINE pager most -s

新しい設定は以下を入力することでテストできます:

$ man whatever_man_page

カラーの値を変更するには {{ic|~/.mostrc}} または {{ic|/etc/most.conf}} (システム全体に変更が適用されます) を編集する必要があります (ファイルが存在しない場合は作成してください)。{{ic|~/.mostrc}} の例:

% Color settings
color normal lightgray black
color status yellow blue
color underline yellow black
color overstrike brightblue black

{{Ic|less}} と同じようなキーバインドを使う例 (行ジャンプを 'J' に設定):

% less-like keybindings
unsetkey "^K"
unsetkey "g"
unsetkey "G"
unsetkey ":"

setkey next_file ":n"
setkey find_file ":e"
setkey next_file ":p"
setkey toggle_options ":o"
setkey toggle_case ":c"
setkey delete_file ":d"
setkey exit ":q"

setkey bob "g"
setkey eob "G"
setkey down "e"
setkey down "E"
setkey down "j"
setkey down "^N"
setkey up "y"
setkey up "^Y"
setkey up "k"
setkey up "^P"
setkey up "^K"
setkey page_down "f"
setkey page_down "^F"
setkey page_up "b"
setkey page_up "^B"
setkey other_window "z"
setkey other_window "w"
setkey search_backward "?"
setkey bob "p"
setkey goto_mark "'"
setkey find_file "E"
setkey edit "v"

==== X resources を使う ====

{{Pkg|xterm}}/{{Ic|uxterm}} や {{Pkg|rxvt-unicode}} でマニュアルページを表示するときにカラーを追加したいときは {{ic|~/.Xresources}} を編集するのが簡単です。

===== xterm =====

修飾をカラーで''置き換える'':

*VT100.colorBDMode: true
*VT100.colorBD: red
*VT100.colorULMode: true
*VT100.colorUL: cyan

カラーと修飾 (太字や下線) を''同時に''使いたい場合:

*VT100.veryBoldColors: 6

{{ic|veryBoldColors}} の説明は {{man|1|xterm}} を見てください。

===== rxvt-unicode =====

URxvt.colorIT: #87af5f
URxvt.colorBD: #d7d7d7
URxvt.colorUL: #87afd7

次を実行:

$ xrdb -load ~/.Xresources

{{Ic|xterm/uxterm}} や {{Ic|rxvt-unicode}} を新しく起動すると man ページがカラフルになっているはずです。

上記の組み合わせは {{Ic|xterm/uxterm}} の'''太字'''や下線がある単語や、{{Ic|rxvt-unicode}} の'''太字'''や下線、''斜体''のテキストに色を追加します。組み合わせを変えることで色々試せます。

=== pacman ===

[[Pacman]] にはカラーオプションがあります。{{ic|/etc/pacman.conf}} の {{ic|Color}} 行をアンコメントしてください。

== ラッパー ==

=== ユニバーサルラッパー ===

以下のラッパーには複数のプリセットが含まれており、変更したり新しいプリセットを作成することができます。

* {{App|rainbow|パターンを使ってコマンドの出力や標準入力をカラー化します。 プリセット: df, diff, env, host, ifconfig, java-stack-trace, jboss, jonas, md5sum, mvn2, mvn3, ping, tomcat, top, traceroute。|https://github.com/nicoulaj/rainbow|{{AUR|rainbow}}}}
* {{App|grc|ログファイルやコマンドの出力を美しくするカラーライザー。 プリセット: cat, cvs, df, digg, gcc, g++, ls, ifconfig, make, mount, mtr, netstat, ping, ps, tail, traceroute, wdiff, blkid, du, dnf, docker, docker-machine, env, id, ip, iostat, last, lsattr, lsblk, lspci, lsmod, lsof, getfacl, getsebool, ulimit, uptime, nmap, fdisk, findmnt, free, semanage, sar, ss, sysctl, systemctl, stat, showmount, tune2fs, tcpdump。|https://github.com/pengwynn/grc|{{Pkg|grc}}}}
* {{App|colorlogs|パターンを使ってコマンド出力や標準入力をカラー化。 プリセット: logs, git status, ant, maven。|https://github.com/memorius/colorlogs}}
* {{App|cope|ターミナルプログラムのカラフルラッパー。 プリセット: acpi, arp, cc, df, dprofpp, fdisk, free, g++, gcc, id, ifconfig, ls, lspci, lsusb, make, md5sum, mpc, netstat, nm, nmap, nocope, ping, pmap, ps, readelf, route, screen, sha1sum, sha224sum, sha256sum, sha384sum, sha512sum, shasum, socklist, stat, strace, tcpdump, tracepath, traceroute, w, wget, who, xrandr。|https://github.com/yogan/cope|{{AUR|cope-git}}}}
* {{App|cw|一般的な UNIX ベースコマンドのお手軽リアルタイム ANSI カラーラッパー。 プリセット: arp, arping, auth.log@, blockdev, cal, cksum, clock, configure, cpuinfo@, crontab@, cw-pipe, cw-test.cgi, date, df, diff, dig, dmesg, du, env, figlet, file, find, finger, free, fstab@, fuser, g++, gcc, group@, groups, hdparm, hexdump, host, hosts@, id, ifconfig, inittab@, iptables, last, lastlog, lsattr, lsmod, lsof, ltrace-color, make, md5sum, meminfo@, messages@, mount, mpg123, netstat, nfsstat, nmap, nslookup, objdump, passwd@, ping, pmap, pmap_dump, praliases, profile@, protocols@, ps, pstree, quota, quotastats, resolv.conf@, route, routel, sdiff, services@, showmount, smbstatus, stat, strace-color, sysctl, syslog, tar, tcpdump, tracepath, traceroute, umount, uname, uptime, users, vmstat, w, wc, whereis, who, xferlog。|http://cwrapper.sourceforge.net/|{{AUR|cw}}}}
* {{App|ccze|C で書かれた高速なログカラー化ツール。colorize を置き換えます。|https://github.com/cornet/ccze/|{{Pkg|ccze}}}}

=== 出力をカラー化するためのライブラリ ===

* {{App|ruby-rainbow|ruby の String クラスを拡張して ANSI ターミナルにおけるテキストのカラー化をサポート。|https://rubygems.org/gems/rainbow/|{{Pkg|ruby-rainbow}}}}
* {{App|python-blessings|ターミナルのカラー化・スタイル・ポジションの実用的なラッパー。|https://github.com/erikrose/blessings|{{Pkg|python-blessings}}, {{Pkg|python2-blessings}}{{Broken package link|{{aur-mirror|python2-blessings}}}}}}

=== 特定のアプリケーションのラッパー ===

==== コンパイラ ====

* {{App|colorgcc|gcc の出力形式に一致する警告・エラーメッセジなどのコンパイラの出力をカラーにする Perl ラッパー。|https://schlueters.de/colorgcc.html|{{Pkg|colorgcc}}}}

==== diff ====

diff には[[#diff|カラー出力]]機能が備わっていますが、以下のラッパーを使うこともできます:

* {{App|colordiff|Perl script for ''diff'' highlighting.|http://www.colordiff.org/|{{Pkg|colordiff}}}}
* {{App|cwdiff|''(w)diff'' wrapper with directories support and highlighting.|https://github.com/junghans/cwdiff|{{AUR|cwdiff}}, {{AUR|cwdiff-git}}}}

==== less ====

===== source-highlight =====
''less'' でシンタックスハイライトを有効にすることができます。まず、{{Pkg|source-highlight}} をインストールし、次に以下の行をシェルの設定ファイルに追加してください:
{{hc|~/.bashrc|<nowiki>
export LESSOPEN="| /usr/bin/source-highlight-esc.sh %s"
export LESS='-R '
</nowiki>}}

===== lesspipe =====

コマンドラインインターフェイスを頻繁に使う場合 {{Pkg|lesspipe}} をインストールすると良いかもしれません。

ページャを使ってアーカイブの中の圧縮されたファイルを表示することができるようになります:

{{hc|$ less ''compressed_file''.tar.gz|2=
==> use tar_file:contained_file to view a file in the archive
-rw------- ''username''/''group'' 695 2008-01-04 19:24 ''compressed_file''/''content1''
-rw------- ''username''/''group'' 43 2007-11-07 11:17 ''compressed_file''/''content2''
''compressed_file''.tar.gz (END)
}}

''lesspipe'' はファイルタイプに関連付けられたコマンドの代替として (例えば {{Pkg|python-html2text}} で HTML を閲覧する)、アーカイブ以外のファイルも ''less'' のインターフェイスに接続します。

''lesspipe'' を有効にするにはログインしなおすか、{{ic|/etc/profile.d/lesspipe.sh}} を実行してください。

==== Make ====

* {{App|colormake|出力を読みやすくするシンプルな make のラッパー。|http://bre.klaki.net/programs/colormake/|{{AUR|colormake}}, {{AUR|colormake-git}}}}

==== Ping ====

* {{App|prettyping|ping の監視に素晴らしい機能を追加するラッパー。標準の ping ツールの出力を美麗・コンパクト・読みやすく改造。|http://denilson.sa.nom.br/prettyping/|{{Pkg|prettyping}}}}

== シェル ==

=== bash ===

[[Bash/プロンプトのカスタマイズ#カラー]]を見てください。

=== zsh ===

[[Zsh#プロンプトのカスタマイズ]]を見てください。

=== Fish ===

[[Fish#ウェブインターフェイス]]を見てください。

== ターミナルエミュレータ ==

=== 仮想端末 ===

フレームバッファで実行される [[w:Virtual console|Linux 仮想端末]]の色は変更することができます。エスケープコードe {{ic|\\e]PXRRGGBB}} を書き込むことで変更できます。{{ic|X}} は 0-F からなる色の16進数インデックス、{{ic|RRGGBB}} は伝統的な16進数の RGB コードに置き換えてください。

例えば、{{ic|~/.Xresources}} に定義した既存の色定義を再利用するには、シェルの初期化ファイル ({{ic|~/.bashrc}} など) に以下を追加してください:

if [ "$TERM" = "linux" ]; then
_SEDCMD='s/.*\*color$[0-9]\{1,\}$.*#$[0-9a-fA-F]\{6\}$.*/\1 \2/p'
for i in $(sed -n "$_SEDCMD" $HOME/.Xresources | awk '$1 < 16 {printf "\\e]P%X%s", $1, $2}'); do
echo -en "$i"
done
clear
fi

==== ログイン画面 ====

以下は {{ic|/etc/issue}} の仮想端末のログイン画面のカラー出力例です。root で {{ic|mv /etc/issue /etc/issue.bak}} を実行して元のファイルのバックアップを作成してから、新しい {{ic|/etc/issue}} を作成してください:

\e[H\e[2J
\e[1;30m| \e[34m\\s \\r
\e[36;1m/\\\\ \e[37m|| \e[36m| | \e[30m|
\e[36m/ \\\\ \e[37m|| \e[36m| _ \e[30m| \e[32m\\t
\e[1;36m/ \e[0;36m.. \e[1m\\\\ \e[37m//==\\\\\\\\ ||/= /==\\\\ ||/=\\\\ \e[36m| | |/ \\\\ | | \\\\ / \e[30m| \e[32m\\d
\e[0;36m/ . . \\\\ \e[37m|| || || | || || \e[36m| | | | | | X \e[1;30m|
\e[0;36m/ . . \\\\ \e[37m\\\\\\\\==/| || \\\\==/ || || \e[36m| | | | \\\\_/| / \\\\ \e[1;30m| \e[31m\\U
\e[0;36m/ .. .. \\\\ \e[0;37mA simple, lightweight linux distribution. \e[1;30m|
\e[0;36m/_\x27 `_\\\\ \e[1;30m| \e[35m\\l \e[0mon \e[1;33m\\n
\e[0m

ファイルを保存したら {{ic|chmod +x /etc/issue}} で実行可能属性を付与してください。

参照:

* https://bbs.archlinux.org/viewtopic.php?pid=386429#p386429
* http://www.linuxfromscratch.org/blfs/view/svn/postlfs/logon.html

=== X window system ===

ほとんどの [[Xorg]] ターミナル ([[xterm]] や [[urxvt]] を含む) は16色の基本色をサポートしています。0-7 の色は 'normal' カラーです。8-15 の色は 0-7 の色の 'bright' カラーです。ハイライトに使用します。[[X resources]] を使ったりターミナルの設定を使うことで色は変更することができます。例:

{{hc|1=~/.Xresources|2=
! Black + DarkGrey
*color0: #000000
*color8: #555753
! DarkRed + Red
*color1: #ff6565
*color9: #ff8d8d
! DarkGreen + Green
*color2: #93d44f
*color10: #c8e7a8
! DarkYellow + Yellow
*color3: #eab93d
*color11: #ffc123
! DarkBlue + Blue
*color4: #204a87
*color12: #3465a4
! DarkMagenta + Magenta
*color5: #ce5c00
*color13: #f57900
!DarkCyan + Cyan (both not tango)
*color6: #89b6e2
*color14: #46a4ff
! LightGrey + White
*color7: #cccccc
*color15: #ffffff
}}

{{Warning|{{ic|foreground}} や {{ic|background}} などのカラーリソースは他のアプリケーション (例: [https://www.gnu.org/software/emacs/manual/html_node/emacs/Table-of-Resources.html emacs]) によって読み込まれる可能性があります。クラス名を指定することで読み込まれないようにすることができます。例: {{ic|XTerm.foreground}}。}}

参照:

* 自動的に太字・下線テキストをカラー化する方法は [[#X resources を使う]]を見てください。
* [https://web.archive.org/web/20090130061234/http://phraktured.net/terminal-colors/ Color Themes] - Extensive list of terminal color themes by Phraktured.
* [http://xcolors.net/ Xcolors.net] List of user-contributed terminal color themes.
* [http://beta.andrewrcraig.us/index.php?page=xcolors Xcolors by dkeg]
* [https://github.com/chriskempson/base16 base16 color schemes]

=== 256色全てを表示 ===

画面上に256色を表示:

$ (x=`tput op` y=`printf %76s`;for i in {0..256};do o=00$i;echo -e ${o:${#o}-3:3} `tput setaf $i;tput setab $i`${y// /=}$x;done)

=== tput のエスケープコードを表示 ===

{{ic|tput op}} は確認したい色に置き換えてください。{{ic|op}} はデフォルトの前景色と背景色です。

{{hc|<nowiki>$ ( strace -s5000 -e write tput op 2>&2 2>&1 ) | tee -a /dev/stderr | grep -o '"[^"]*"'</nowiki>|
033[\033[1;34m"\33[39;49m"\033[00m
}}

=== サポートされている色を確認 ===

以下のコマンドで使用しているターミナルがサポートしている色の数を確認できます。色の数は次のどれかになります: 8, 15, 16, 52, 64, 88, 256。

{{hc|<nowiki>$ for T in `find /usr/share/terminfo -type f -printf '%f '`;do echo "$T `tput -T $T colors`";done|sort -nk2</nowiki>|
Eterm-88color 88
rxvt-88color 88
xterm+88color 88
xterm-88color 88
Eterm-256color 256
gnome-256color 256
konsole-256color 256
putty-256color 256
rxvt-256color 256
screen-256color 256
screen-256color-bce 256
screen-256color-bce-s 256
screen-256color-s 256
xterm+256color 256
xterm-256color 256
}}

=== ターミナルの機能を確認 ===

以下のコマンドを使うことでターミナルによってサポートされている機能を確認できます:

{{hc|<nowiki>$ infocmp -1 | sed -nu 's/^[ \000\t]*//;s/[ \000\t]*$//;/[^ \t\000]\{1,\}/!d;/acsc/d;s/=.*,//p'|column -c80</nowiki>|
bel cuu ich kb2 kf15 kf3 kf44 kf59 mc0 rmso smul
blink cuu1 il kbs kf16 kf30 kf45 kf6 mc4 rmul tbc
bold cvvis il1 kcbt kf17 kf31 kf46 kf60 mc5 rs1 u6
cbt dch ind kcub1 kf18 kf32 kf47 kf61 meml rs2 u7
civis dch1 indn kcud1 kf19 kf33 kf48 kf62 memu sc u8
clear dl initc kcuf1 kf2 kf34 kf49 kf63 op setab u9
cnorm dl1 invis kcuu1 kf20 kf35 kf5 kf7 rc setaf vpa
}}

=== カラースキームスクリプト ===

現在のターミナルスキームのチャートを表示するスクリプトが [https://paste.xinu.at/m-dAiJ/] に存在します。

=== トゥルーカラーサポート ===

xterm、konsole、st など、1600 万色 (RGB、それぞれ 8 ビットの解像度) のフルレンジをサポートしている端末もあります。対応する TERM 値 xterm-direct、konsole-direct、st-direct などは、ncurses バージョン 6.1 [https://lists.gnu.org/archive/html/bug-ncurses/2018-01/msg00045.html] からサポートされています。トゥルーカラーをサポートしているターミナルエミュレータやアプリケーションの詳細については、 [https://gist.github.com/XVilka/8346728] を参照してください。

なお、Linux カーネルはトゥルーカラー用の SGR エスケープシーケンスをサポートしていますが、ドライバが 24 ビットの色仕様をカーネル内の 256 色のカラーマップにマッピングするため、使用しても無意味です (関数 {{ic|rgb_foreground}}、{{ic|rgb_background}}) を参照)。このため、{{ic|linux-direct}} の terminfo エントリはありません。

== 参照 ==

* [https://gkbrk.com/2016/07/lolcat-clone-in-x64-assembly/ lolcat clone in x64 assembly]
* [http://unix.stackexchange.com/a/147 Setting colors for less] と [http://unix.stackexchange.com/a/6357 solving related problems] (StackExchange のスレッド)

Wake-on-LAN

2021-03-20T13:45:15Z

Oriaca372m: Wake-up after shutdown の部分だけ英語版から翻訳

[[Category:ネットワーク]]
[[en:Wake-on-LAN]]
Wake-on-LAN (WOL) はネットワーク接続 (インターネットまたはイントラネット) からコンピュータの電源を入れる機能です。

== ハードウェア設定 ==

Wake-on-LAN を使うにはコンピュータのマザーボードや [[wikipedia:ja:ネットワークカード|NIC]] が Wake-on-LAN をサポートしている必要があります。無線カードは Wake-on-LAN をサポートしていないため、ルーターや他のコンピュータに物理的に (ケーブルで) 接続しなくてはなりません。

また、Wake-on-LAN 機能は PC の BIOS で有効にする必要があります。マザーボードのメーカーによって Wake-on-LAN 機能には様々な名前がつけられています。"PCI Power up" や "Allow PCI wake up event"、あるいは "Boot from PCI/PCI-E" というような単語を追って下さい。

一部のマザーボードには厄介なバグが存在し、BIOS で WoL が有効にされている限り[[#シャットダウン後にコンピュータが起動する|シャットダウン後すぐに(またはランダムに)コンピュータが起動する]]という問題を引き起こすことがあります。

== ソフトウェア設定 ==

ハードウェアによっては、ネットワークドライバーによって WOL がデフォルトでオフになっていることがあります。WOL の状態を確認したり、設定を変更するために、{{Pkg|ethtool}} をインストールして下さい。

次のコマンドを使ってネットワークデバイスの状態を確認します:

{{hc|<nowiki># ethtool net0 | grep Wake-on</nowiki>|<nowiki>
Supports Wake-on: pumbag
Wake-on: d
</nowiki>}}

上記の値はどのアクティビティが動作するかを定義しています: {{ic|d}} (無効), {{ic|p}} (PHY アクティビティ), {{ic|u}} (ユニキャストアクティビティ), {{ic|m}} (マルチキャストアクティビティ), {{ic|b}} (ブロードキャストアクティビティ), {{ic|a}} (ARP アクティビティ), {{ic|g}} (マジックパケットアクティビティ)。WOL を使うには {{ic|g}} が必要です。

ドライバーの WOL 機能を有効化するには:

# ethtool -s net0 wol g

上記のコマンドは再起動してしまうと効果を失ってしまうため、何らかの方法で自動的に実行されるようにする必要があります。以下のサブセクションに一般的な方法を載せています。

=== netctl を使う ===

netctl を使う場合、以下の設定を netctl のプロファイルに追加することで永続化させることができます:

{{hc|/etc/netctl/''profile''|2=
ExecUpPost='/usr/bin/ethtool -s net0 wol g'
}}

=== systemd.link を使う ===

systemd を使うことでリンクレベルの設定ができます。実際の設定は systemd に組み込まれている {{ic|net_setup_link}} udev によって行われます。ネットワークリンクファイルに {{ic|WakeOnLan}} オプションを追加してください:

{{hc|/etc/systemd/network/50-wired.link|2=
[Link]
WakeOnLan=magic
...
}}

{{Note|上記の設定はリンクレベルにしか適用されません。[[NetworkManager]] や [[systemd-networkd]] などネットワーク層のデーモンとは無関係です。}}

詳しくは [[systemd-networkd#link ファイル]]や {{ic|man systemd.link}} を参照。

=== systemd サービスを使う ===

上述の {{ic|systemd.link}} オプションと同じ効果がありますが、スタンドアロンの systemd サービスを使っています。

{{hc|/etc/systemd/system/wol@.service|2=
[Unit]
Description=Wake-on-LAN for %i
Requires=network.target
After=network.target

[Service]
ExecStart=/usr/bin/ethtool -s %i wol g
Type=oneshot

[Install]
WantedBy=multi-user.target
}}

もしくは {{AUR|wol-systemd}} パッケージをインストールして下さい。

その後 {{ic|wol@''interface''.service}} を[[起動]]することで新しいサービスを有効にして下さい。

=== udev を使う ===

[[udev]] を使うことでデバイスが認識されたときにコマンドを実行することができます。以下のルールは {{ic|enp*}} にマッチする全ての[[ネットワークインターフェース]]で WOL を有効にします:

{{hc|/etc/udev/rules.d/99-wol.rules|<nowiki>
ACTION=="add", SUBSYSTEM=="net", NAME=="enp*", RUN+="/usr/bin/ethtool -s $name wol g"
</nowiki>}}

{{ic|$name}} はマッチしたデバイスの {{ic|NAME}} 変数の値に置き換えられます。

{{Note|設定ファイルの名前は重要です。systemd v197 から[[ネットワーク設定#デバイス名|固定的なデバイス名]]が導入されたことで、特定のネットワークインターフェイスにマッチするルールは {{ic|80-net-name-slot.rules}} よりもアルファベット順で後に来るようにして、デバイスに名前が割り当てられた後に適用する必要があります。}}

{{Warning|[[udev]] はデバイスが認識されたときにマッチを行います。実行されるのは (ルートディレクトリに制御が移る前の) [[initramfs]] あるいはメイン環境のどちらかになります。順番は必ずしもいつも同じとは限りません。initramfs に必要な udev ルール ({{ic|/etc/udev/rules.d}}) と補助バイナリ ({{ic|/usr/bin/ethtool}}) が含まれていることを確認してください。}}

=== cron を使う ===

crontab で "@reboot" を使うことでコンピュータを起動するたびにコマンドを実行させることができます。まず、[[Cron#インストール|cron]] をインストールして、それから root ユーザーの [[cron#基本的なコマンド|crontab]] を編集して以下の行を記述して下さい:

@reboot /usr/bin/ethtool -s [net-device] wol g

=== NetworkManager ===

バージョン 1.0.6 から NetworkManager には Wake-on-LAN の制御が追加されました [https://www.phoronix.com/scan.php?page=news_item&px=NetworkManager-WoL-Control]。nmcli を使ってマジックパケットで Wake-on-LAN を有効にできます。

まず、有線接続の名前を検索してください:

{{hc|# nmcli con show|2=
NAME UUID TYPE DEVICE
wired1 612e300a-c047-4adb-91e2-12ea7bfe214e 802-3-ethernet enp0s25
}}

Wake-on-LAN の現在の設定は以下のようにして確認できます:

{{hc|# nmcli c show "wired1" <nowiki>|</nowiki> grep 802-3-ethernet.wake-on-lan|2=
802-3-ethernet.wake-on-lan: default
802-3-ethernet.wake-on-lan-password: --
}}

マジックパケットを使って Wake-on-LAN を有効にするには:

# nmcli c modify "wired1" 802-3-ethernet.wake-on-lan magic

設定したら再起動してください。設定を有効にするには再起動が2回必要な場合があります。

バージョン 1.2.0 から {{Pkg|nm-connection-editor}} を使ってグラフィカルに Wake-on-LAN の設定を変えることも可能です。

== 電源の投入 ==

マシンの WOL を実行するには、マシンの MAC アドレスと外部・内部 IP が必要です。

コンピュータの内部 IP アドレスと MAC アドレスを取得するには、次のコマンドを実行:

{{hc|$ ip addr|
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
2: enp1s0: <BROADCAST,MULTICAST,PROMISC,UP,LOWER_UP> mtu 1500 qdisc fq_codel master br0 state UP group default qlen 1000
link/ether '''48:05:ca:09:0e:6a''' brd ff:ff:ff:ff:ff:ff
inet '''192.168.1.20/24''' brd 192.168.1.255 scope global br0
valid_lft forever preferred_lft forever
inet6 fe80::6a05:caff:fe09:e6a/64 scope link
valid_lft forever preferred_lft forever
}}

上記の場合、内部 IP アドレスは {{ic|192.168.1.20}} で MAC アドレスは {{ic|48:05:ca:09:0e:6a}} です。

WOL を実行するためにマジックパケットを送信できるプログラムとして {{Pkg|wol}} が存在します。

=== 同一の LAN 上にある場合 ===

ネットワークケーブルによって他のコンピュータと直接接続している場合、または LAN の中の通信がファイアウォールで遮断されていない場合、ポートのリダイレクトについて考える必要がないため簡単に Wake-on-LAN を使うことができます。

一番シンプルなケース、デフォルトのブロードキャストアドレス {{ic|255.255.255.255}} を使用:

$ wol ''target_MAC_address''

特定のサブネットやホストにだけマジックパケットを送信するには、{{ic|-i}} スイッチを使用:

$ wol -i ''target_IP'' ''target_MAC_address''

{{Tip|If you intend to continue using Wake-on-LAN, it is recommended to assign a static IP address to the target computer.}}

=== インターネットを経由する ===

送信元と送信先のコンピュータがルーターで区切られている場合、[[wikipedia:Port forwarding|ポートフォワーディング]]によって Wake-on-LAN を使うことができます。

2つの方法が考えられます:
* 別のポートを送信先のマシンに転送するようにルーターを設定 (LAN 上で送信先のマシンに固定 IP アドレスを割り当てる必要があります)。
* 特定のポートを[[wikipedia:ja:ブロードキャストアドレス|ブロードキャストアドレス]]に転送するようにルーターを設定 (ルーターによっては設定できない場合があります)。

どちらの場合でも電源を投入するには以下のコマンドを実行します:

$ wol -p ''forwarded_port'' -i ''router_IP'' ''target_MAC_address''

==== ポートをブロードキャストアドレスに転送する ====

ほとんどのルーターはブロードキャストアドレスへの転送を設定できませんが、ルーターにシェルでアクセスすることができれば以下のコマンドで転送させることができます (192.168.1.0/24 と net0 はネットワークに合わせて適切なアドレス・インターフェイスに置き換えてください):
$ ip neighbor add 192.168.1.254 lladdr FF:FF:FF:FF:FF:FF dev net0

上記のコマンドで UDP のポート 9 は 192.168.1.254 に転送されるようになります。Tomato ファームウェアの Linksys WRT54G や Verizon FIOS ActionTec ルーターで上手く行くことを確認済みです。

DD-WRT ルーターで設定する方法については [http://www.dd-wrt.com/wiki/index.php/WOL#Remote_Wake_On_LAN_via_Port_Forwarding こちらのチュートリアル] を見てください。

== その他 ==

=== バッテリーが食われる問題 ===
ノートパソコンによってはシャットダウン後にバッテリーを消費する問題が存在します [https://ubuntuforums.org/archive/index.php/t-1729782.html]。WOL が有効になっているのが原因です。問題を解決するには、''ethtool'' を使って無効化して下さい:

# ethtool -s net0 wol d

=== WOL サンプルスクリプト ===
以下は複数のマシンで自動的に WOL を使うスクリプトです:

{{bc|<nowiki>
#!/bin/bash

# definition of MAC addresses
monster=01:12:46:82:ab:4f
chronic=00:3a:53:21:bc:30
powerless=1a:32:41:02:29:92
ghost=01:1a:d2:56:6b:e6

while true; do
echo "Which PC to wake?"
echo "p) powerless"
echo "m) monster"
echo "c) chronic"
echo "g) ghost"
echo "b) wake monster, wait 40sec, then wake chronic"
echo "q) quit and take no action"
read input1

case $input1 in
p)
/usr/bin/wol $powerless
;;

m)
/usr/bin/wol $monster
;;

c)
/usr/bin/wol $chronic
;;

g)
# this line requires an IP address in /etc/hosts for ghost
# and should use wol over the internet provided that port 9
# is forwarded to ghost on ghost's router
/usr/bin/wol -v -h -p 9 ghost $ghost
;;

b)
/usr/bin/wol $monster
echo "monster sent, now waiting for 40sec then waking chronic"
sleep 40
/usr/bin/wol $chronic
;;

Q|q)
echo "later!"
break
;;

esac

done
echo "this is the (quit) end!! c-ya!"
</nowiki>}}

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

=== シャットダウン後にコンピュータが起動する ===
一部のマザーボードには厄介なバグが存在し、BIOS で WoL が有効にされている限りシャットダウン後すぐに(またはランダムに)コンピュータが起動するという問題を引き起こすことがあります ([https://bbs.archlinux.org/viewtopic.php?id=173648 このスレッド]などを参照)。

==== BIOS の設定を変更して修正する ====
次の設定を BIOS で変更すると、いくつかのマザーボードでは問題が解決することがあります。
# USB の設定に関する "xHCI" を全て無効化する (これは起動時の USB 3.0 を無効にしてしまいます)。
# EuP 2013 がオプションとして存在する場合に無効化する。
# (任意) キーボードによる WOL を有効化する。
{{Note|上記の3番目の設定については賛否が分かれておりマザーボードによっても変わります。}}

==== カーネルの quirks を使用して修正する ====
次の文をカーネルのブートパラメーターに追加することでも問題を解決できます: {{ic|1=xhci_hcd.quirks=270336}}

これは次の quirks を有効にします:
* {{ic|XHCI_SPURIOUS_REBOOT}}
* {{ic|XHCI_SPURIOUS_WAKEUP}}

=== Realtek ===

Realtek 8168 8169 8101 8111(C) が搭載された NIC (カード/オンボード) を使っている場合、起動時に NIC が無効になってしまって接続ランプが灯らないことがあります。[[ネットワーク設定#Realtek が使えない / WOL の問題]]を見て下さい。

MSI B85M-E45 マザーボード (BIOS バージョン V10.9) のオンボードチップセット Realtek 8111G では、コンピュータの電源が切れているときにネットワークスイッチのリンクライトは光っているのに Wake-on-LAN が機能しない場合、一度 {{Pkg|r8168}} カーネルモジュールを使ってシステムを起動してから、カーネルに組み込まれている r8169 に戻すことで問題が解決する場合があります。

=== サスペンド/復帰 ===

[[TLP]] を使っている場合に、サスペンド・ハイバネート後にコンピュータが立ち上がらないときは {{ic|/etc/default/tlp}} で {{ic|WOL_DISABLE}} の値を {{ic|N}} に設定してください。

== 参照 ==

* [http://www.depicus.com/wake-on-lan/woli.aspx Wake-On-Lan]

PipeWire

2021-03-20T13:20:34Z

Oriaca372m:

[[Category:マルチメディア]]
[[en:PipeWire]]
[[fi:PipeWire]]
[http://pipewire.org PipeWire] は新しい低レベルマルチメディアフレームワークです。
映像と音声を最小の遅延で再生/キャプチャすることを目的としていて、PulseAudio、JACK、ALSA、GStreamer をベースとしたアプリケーションと互換性があります。

このフレームワークのデーモンは (PulseAudio と JACK の機能を持った) オーディオサーバーとしても、ビデオキャプチャサーバーとしても設定できます。

また PipeWire は [[Flatpak]] のようなコンテナをサポートしており、''audio'' や ''video'' [[ユーザーとグループ#グループ管理|ユーザーグループ]]に依存するのではなく、Flatpak や Wayland にスクリーンや音声を録音する許可を求める [[Polkit]] のようなセキュリティモデルを使用しています。

== インストール ==

公式リポジトリの {{pkg|pipewire}} パッケージを[[インストール]]します。

PipeWire は [[systemd/ユーザー]] を使用してサーバーの管理とソケットアクティベーションを行います。起動時の動作やログの確認方法などの詳細は [[systemd/ユーザー]] を参照してください。

必要に応じて {{pkg|pipewire-docs}} をインストールしてドキュメントを確認することもできます。{{pkg|pipewire-alsa}}、{{pkg|pipewire-pulse}}、{{pkg|pipewire-jack}} などの他のパッケージは [[#音声|PulseAudio/JACKの代わりに PipeWire を使用]]したい場合を除き必要ありません。multilib サポートのために {{aur|lib32-pipewire}}、{{aur|lib32-pipewire-jack}} も利用できます。

== 使用方法 ==

=== WebRTC 画面共有===

ほとんどのブラウザは WebRTC を使用しているとき (例えば Google ハングアウトで) デスクトップ (や個々のアプリケーション) をキャプチャするのに X11 に依存していました。Wayland ではセキュリティ上の理由から画面共有は異なる方法で処理されます。PipeWire はきめ細かなアクセス制御を使用して Wayland 上のコンテンツを共有できます。

これには {{pkg|xdg-desktop-portal}} とそのバックエンドの1つが[http://jgrulich.cz/2018/07/04/04/how-to-enable-and-use-screen-sharing-on-wayland 必要です]。利用可能なバックエンドは次のとおりです:

* GNOME の場合、{{pkg|xdg-desktop-portal-gtk}}
* KDE の場合、{{pkg|xdg-desktop-portal-kde}}
* wlroots ベースのコンポジター ([[Sway]] や [https://github.com/djpohly/dwl dwl] など) の場合、{{pkg|xdg-desktop-portal-wlr}}

Firefox (バージョン84以降) はデフォルトでこの方法をサポートしていますが、Chromium (バージョン73以降) では、[https://bugs.chromium.org/p/chromium/issues/detail?id=682122 WebRTC PipeWireサポート]を次のURLの実験的機能の設定を変更して有効にする必要があります:
chrome://flags/#enable-webrtc-pipewire-capturer

{{ic|xdg-desktop-portal-wlr}} を動かすには {{pkg|pipewire-media-session}} をインストール[https://github.com/emersion/xdg-desktop-portal-wlr/wiki/FAQ/db63ec1ab6c0170334c1d1f45d1ebe543cc375fa#how-do-i-run-xdpw]して {{ic|XDG_CURRENT_DESKTOP}} 環境変数を設定[https://github.com/emersion/xdg-desktop-portal-wlr#running]する必要があります:
export XDG_CURRENT_DESKTOP=sway

Chromium は現在 PipeWire 0.2 を使っていますが、Arch Linux では PipeWire 0.3 を提供しているので、画面共有を行うには {{pkg|libpipewire02}} もインストールする必要があります。

{{Tip|複数のモニタがある場合に {{ic|xdg-desktop-portal-wlr}} を使用してそれぞれのモニターを共有するには、ユニットのサービスファイルの {{ic|1=ExecStart=}} オプションを[[Systemd#Editing_provided_units|編集]]して {{ic|1=--output=''Monitor''}} フラグを追加してください。行全体は {{ic|1=ExecStart=@libexecdir@/xdg-desktop-portal-wlr --output=eDP-1}} のようになります。}}

唯一サポートされている機能はデスクトップ全体の共有で、特定のアプリケーション/ウィンドウの共有はサポートされていません。[https://github.com/emersion/xdg-desktop-portal-wlr/wiki/FAQ#will-this-let-me-share-individual-windows][https://github.com/KDE/xdg-desktop-portal-kde/blob/master/TODO]

=== 映像 ===

ソフトウェアはまだ商業利用には適していませんが、試す分には問題ありません。[[GStreamer]] を使用して映像ストリームを処理するほとんどのアプリケーションは PipeWire GStreamer プラグインにより設定なしで動作するはずです。そのため既に {{pkg|cheese}} のようなアプリケーションは PipeWire を使用して映像入力を利用できます。

=== 音声 ===

PulseAudio や JACK と同様に PipeWire をオーディオサーバーとして使用できます。 PulseAudio サーバーの互換実装と JACK クライアント用の ABI 互換ライブラリを提供することで PulseAudio と JACK の両方を置き換えることを目的としています。詳細については[https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ この記事]を参照してください。

==== ALSA/レガシーアプリケーション ====

{{pkg|pipewire-alsa}} をインストールして ALSA API を使用するすべてのアプリケーションが PipeWire を使用するよう設定できます。

==== PulseAudio クライアント ====

{{pkg|pipewire-pulse}} をインストールします。このパッケージは {{pkg|pulseaudio}} と {{pkg|pulseaudio-bluetooth}} を置き換えます。パッケージがユーザーサービス {{ic|pipewire-pulse.socket}} を自動的に有効化するので、通常それ以上の操作は不要です。システム起動時に PipeWire が正しく機能しない場合は、ユーザーサービス {{ic|pipewire-pulse.service}} と {{ic|pipewire.service}} が起動して実行されているか確認します。[[Systemd/ユーザー]]を参照してください。

変更を適用するには、再起動または再ログインしてください。

置き換えが機能しているかどうかを確認するには、次のコマンドを実行して出力を確認してください:

{{hc|1=$ pactl info|2=
...
Server Name: PulseAudio (on PipeWire 0.3.16)
...
}}

==== JACK クライアント ====

{{pkg|pipewire-jack}} をインストールします。{{ic|pw-jack}} を使用して JACK クライアントを起動すると、元の {{ic|libjack*}} ではなく PipeWire が提供する互換ライブラリが使用されます:

pw-jack ''application''

カスタムバッファサイズを要求することもできます。{{ic|PIPEWIRE_LATENCY}}環境変数を {{ic|バッファサイズ/サンプルレート}} (ブロックのレイテンシ(秒)を意味します) に設定します:

PIPEWIRE_LATENCY="128/48000" pw-jack ''application''

また {{aur|pipewire-jack-dropin}} をインストールするか、{{pkg|jack}} か {{pkg|jack2}} をアンインストールして JACK クライアントが互換ライブラリを自動的に読み込むようにもできます。

{{ic|ldd}} を使用して JACK アプリケーションが正しいライブラリにリンクしていることを確認します。

{{hc|1=$ ldd /usr/bin/qjackctl {{!}} grep -i libjack|2=
libjack.so.0 => /usr/lib/pipewire-0.3/jack/libjack.so.0 (0x00007f7e5080a000)
}}

==== Bluetooth デバイス ====

PipeWire は {{pkg|pipewire-pulse}} パッケージがインストールされている場合 Bluetooth オーディオデバイスを制御します。具体的には、メディアセッションデーモンは {{ic|/etc/pipewire/media-session.d/with-pulseaudio}} が存在する時に自動的にその {{ic|bluez5}} モジュールを有効にします。

==== ネイティブ JACK 上で PipeWire を実行する ====

PipeWire はネイティブ JACK デーモン上の JACK クライアントとして実行することもできます。詳細は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/JACK JACK and PipeWire] を参照してください。

== 音声のポストプロセッシング ==

=== PulseEffects ===

PulseEffects は多数のエフェクトとフィルタを個々の入出力ストリーム (アプリケーションの音声出力やマイクの入力など) に提供する GTK 製のユーティリティです。注目すべきエフェクトには、入出力イコライザー、出力ラウドネス等化、ベースエンハンスメント、入力ディエッサー、ノイズ抑制プラグインなどがあります。[https://github.com/wwmm/pulseeffects GitHub ページ]にエフェクトの一覧があります。

PipeWire で PulseEffects を使用するには、{{pkg|pulseeffects}} または {{AUR|pulseeffects-git}} をインストールします。

{{Note|これにより、{{pkg|pipewire-pulse}} がインストールされ [[#PulseAudio クライアント|PulseAudio が PipeWire に置き換えられます。]]詳細は {{Bug|69437}} を参照してください。古いバージョンについては [[PulseAudio#PulseEffects]] を参照してください。}}

プリセット設定のコレクションについては、[https://github.com/wwmm/pulseeffects/wiki/Community-presets コミュニティープリセット]を参照してください。

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

=== PipeWire にマイクが検出されない ===

PipeWire の {{ic|alsa-monitor}} モジュールは、デフォルトで {{pkg|alsa-card-profiles}} を使用してデバイスを検出します。これでうまくいかない場合は、{{ic|/etc/pipewire/media-session.d/alsa-monitor.conf}} の {{ic|rules}} -> 最初のルール -> {{ic|actions}} -> {{ic|update-props}} の {{ic|api.alsa.use-acp}} を {{ic|false}} にするか、または {{ic|api.alsa.use-ucm}} を {{ic|true}} にしてみてください:

...
update-props = {
api.alsa.use-acp = false
...

次に PipeWire を再起動し使用可能なデバイスを確認します:

{{hc|1=
$ pw-record --list-targets
|2=
Available targets ("*" denotes default): 62
58: description="Built-in Audio" prio=1872
60: description="Built-in Audio" prio=2000
* 62: description="Built-in Audio (Loopback PCM)" prio=1984
}}

=== Bluetooth デバイスに接続しても音が出ない ===

2020-12-07 の時点で、Bluetooth デバイスを接続しても音が出ない場合は、デフォルトのシンクに切り替えるか、シンク入力を正しいシンクに移動する必要があります。{{ic|pactl list sinks}} で使用可能なシンクの一覧を表示し、{{ic|pactl set-default-sink}} でデフォルトのシンクを Bluetooth デバイスに切り替えます。これは[https://gist.github.com/tinywrkb/04e7fd644afa9b92d33a3a99ab07ee9e このようなスクリプト]を使って [[udev]] で自動化できます。

この問題については、この [https://www.reddit.com/r/archlinux/comments/jydd02/pipewirepulse_03164_in_testing_now_replaces/gd3m7fu/?context=3 Reddit スレッド]を参照してください。スクリプトの作成者によると、ヘッドセットプロファイル (HSP) にまだ問題がある可能性があります。

=== 音量が小さい ===

PulseAudio を PipeWire で置き換えた後、正しく音が出ても、再起動後に音量が極端に小さくなることがあります。

{{ic|alsamixer}} を開き、{{ic|F6}} を押して適切なサウンドカードを選び ALSA のボリュームが100%であることを確認してください。{{ic|alsactl}} は再起動後もこの設定を維持するはずです。

=== increasing RLIMIT_MEMLOCK ===

Dec 13 11:11:11 HOST pipewire-pulse[99999]: Failed to mlock memory 0x7f4f659d8000 32832: This is not a problem but for best performance, consider increasing RLIMIT_MEMLOCK

{{pkg|realtime-privileges}} をインストールし {{ic|realtime}} グループに自分のユーザーを追加します。

あるいは memlock を 64kB から 128kB に増やすことで、この問題を解決できるようです。[[systemd/ユーザー]] で {{ic|pipewire-pulse}} を実行している場合は {{ic|/etc/security/limits.d/username.conf}} に次の行を追加します:

username soft memlock 64
username hard memlock 128

=== 外付けサウンドカードが再接続後に有効にならない ===

{{ic|~/.config/pipewire-media-session/default-profile}} にデフォルトプロファイル ''off'' のエントリがあれば削除します。それでも解決しない場合は {{ic|~/.config/pipewire-media-session/}} からすべてのファイルを削除し、{{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動します。

=== 音が出ないまたは pactl info が Failure: Connection refused と表示する ===
これはアプリケーションが PipeWire-Pulse サービスに接続できていないことを意味します。{{ic|/etc/pipewire/pipewire-pulse.conf}} が存在し空でないことを確認し、{{ic|systemctl --user restart pipewire-pulse.service}} で PipeWire-Pulse を再起動してください。

それでも解決しない場合は {{ic|strace -f -o /tmp/pipe.txt pactl info}} を実行し、pastebin に {{ic|/tmp/pipe.txt}} を貼り付けて、IRC (Freenode '''#pipewire''') かメーリングリストで相談してください。

=== Bluetooth の音声の品質が低い===

Feb 17 18:23:01 HOST pipewire[249297]: (bluez_input.18:54:CF:04:00:56.a2dp-sink-60) client too slow! rate:512/48000 pos:370688 status:triggered

Bluetooth で再生が途切れる場合は {{ic|systemctl --user status pipewire.service}} を実行してみてください。このようなエラーが表示される場合は {{ic|pactl list sinks}} で現在選択されているコーデックを確認し、{{ic|/etc/pipewire/media-session.d/bluez-monitor.conf}} の {{ic|bluez5.codecs}} を {{ic|sbc aac ldac aptx aptx_hd}} のいずれかに変更してみてください。変更を適用するには {{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動する必要があります。

{{hc|head=/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
properties = {
...
bluez5.codecs = [sbc]
...}}

=== PipeWire の更新 (git / >=0.3.23) と再起動後デバイスが検出されない===

コミット 012a68f8[https://gitlab.freedesktop.org/pipewire/pipewire/-/commit/012a68f8ef33705f1a40ec8ac294b8cce7f6aa88] の時点で新しい systemd サービスが追加されデフォルトでは無効になっています。これはシステムの再起動時に {{ic|pipewire-media-session}} が実行されないことを意味します。サービスを有効にするには {{ic|systemctl --user enable --now pipewire-media-session.service}} を実行します。

システムの管理者やパッケージマネージャが更新後に設定ファイルの変更を整理していない場合、{{ic|pipewire.service}} によって {{ic|pipewire-media-session}} の別のプロセスが実行されている可能性があります。確認するには {{ic|systemctl --user status pipewire.service}} を実行してください。

pipewire および pipewire-media-session が実行中と表示される場合は、システム設定かユーザ設定、あるいは両方を更新します。

{{hc|head=/etc/pipewire/pipewire.conf または ~/.config/pipewire/pipewire.conf|output=
context.exec = {
...
# 次の行はコメントアウトする必要があります
#"/usr/bin/pipewire-media-session" = { args = "" }
...
}
}}

=== 再生開始時に音声に遅延が発生する ===

これは非アクティブ時のノードのサスペンドが原因です。遅延が発生する領域に応じて {{ic|/etc/pipewire/media-session.d/*-monitor.conf}} を編集し、プロパティ {{ic|session.suspend-timeout-seconds}} を {{ic|0}} に変更してサスペンドを無効にするか、他の値を試して動作を確認してみてください。{{ic|/etc/pipewire/media-session.conf}} の {{ic|suspend-node}} の行をコメントアウトすることもできます。変更を適用するには {{ic|pipewire}} と {{ic|pipewire-pulse}} systemd サービスの両方を再起動するか、システムを再起動してください。

=== 複数のストリームの再生開始時に音声が途切れる ===

この問題は通常 {{ic|journalctl -b | grep -i pipewire}} を実行し、次のような行を探すことで診断できます:

pipewire-pulse[21740]: pulse-server 0x56009b9d5de0: [Nightly] UNDERFLOW channel:0 offset:370676 underrun:940

[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Troubleshooting#underrununderflow-and-broken-pipe-errors 公式 PipeWire トラブルシューティングガイド]によると、この問題を解決するには {{ic|/etc/pipewire/media-session.d/alsa-monitor.conf}} を編集し、{{ic|1=api.alsa.headroom = 0}} という行のコメントを外し、値を {{ic|1024}} に変更します。

== 参照 ==

* [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/home Wiki] — PipeWire Wiki on Freedesktop GitLab
* [https://blogs.gnome.org/uraeus/2018/01/26/an-update-on-pipewire-the-multimedia-revolution-an-update/ Pipewire Update Blog Post] — PipeWire の2018年1月時点での進捗が書かれた記事
* [https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ PipeWire Late Summer Update 2020] — 2020年9月からの記事

PipeWire

2021-03-19T05:53:17Z

Oriaca372m: 翻訳の調整

[[Category:マルチメディア]]
[[en:PipeWire]]
[[fi:PipeWire]]

[http://pipewire.org PipeWire] は新しい低レベルマルチメディアフレームワークです。
映像と音声を最小の遅延で再生/キャプチャすることを目的としていて、PulseAudio、JACK、ALSA、Gstreamerをベースとしたアプリケーションと互換性があります。

このフレームワークのデーモンは (PulseAudio と JACKの機能を持った) オーディオサーバーとしても、ビデオキャプチャサーバーとしても設定できます。

また PipeWire は [[Flatpak]] のようなコンテナをサポートしており、''audio'' や ''video'' [[ユーザーとグループ#グループ管理|ユーザーグループ]] に依存するのではなく、Flatpak や Wayland にスクリーンや音声を録音する許可を求める [[Polkit]] のようなセキュリティモデルを使用しています。

== インストール ==

公式リポジトリの {{pkg|pipewire}} パッケージを [[インストール]] します。

Pipewire は [[systemd/ユーザー]] を使用してサーバーの管理とソケットアクティベーションを行います。起動時の動作やログの確認方法などの詳細は [[systemd/ユーザー]] を参照してください。

必要に応じて {{pkg|pipewire-docs}} をインストールしてドキュメントを確認することもできます。 {{pkg|pipewire-alsa}}、{{pkg|pipewire-pulse}}、{{pkg|pipewire-jack}} などの他のパッケージは [[#音声|PulseAudio/JACKの代わりに PipeWire を使用]] したい場合を除き必要ありません。 multilib サポートのために {{aur|lib32-pipewire}}、{{aur|lib32-pipewire-jack}} も利用できます。

== 使用方法 ==

=== WebRTC 画面共有===

ほとんどのブラウザは WebRTC を使用しているとき (例えば Google ハングアウトで) デスクトップ (や個々のアプリケーション) をキャプチャするのに X11 に依存していました。 Wayland ではセキュリティ上の理由から画面共有は異なる方法で処理されます。 PipeWire はきめ細かなアクセス制御を使用して Wayland 上のコンテンツを共有できます。

これには {{pkg|xdg-desktop-portal}} とそのバックエンドの1つが[http://jgrulich.cz/2018/07/04/04/how-to-enable-and-use-screen-sharing-on-wayland 必要です]。利用可能なバックエンドは次のとおりです:

* GNOME の場合、{{pkg|xdg-desktop-portal-gtk}}
* KDE の場合、{{pkg|xdg-desktop-portal-kde}}
* wlroots ベースのコンポジター (例えば [[Sway]] [https://github.com/djpohly/dwl dwl]) の場合、{{pkg|xdg-desktop-portal-wlr}}

Firefox (バージョン84以降) はデフォルトでこの方法をサポートしていますが、Chromium (バージョン73以降) では、[https://bugs.chromium.org/p/chromium/issues/detail?id=682122 WebRTC PipeWireサポート] を次のURLの実験的機能の設定を変更して有効にする必要があります:
chrome://flags/#enable-webrtc-pipewire-capturer

{{ic|xdg-desktop-portal-wlr}} を動かすには {{pkg|pipewire-media-session}} をインストール[https://github.com/emersion/xdg-desktop-portal-wlr/wiki/FAQ/db63ec1ab6c0170334c1d1f45d1ebe543cc375fa#how-do-i-run-xdpw]して {{ic|XDG_CURRENT_DESKTOP}} 環境変数を設定[https://github.com/emersion/xdg-desktop-portal-wlr#running]する必要があります:
export XDG_CURRENT_DESKTOP=sway

Chromium は現在 PipeWire 0.2 を使っていますが、Arch Linux では PipeWire 0.3 を提供しているので、画面共有を行うには {{pkg|libpipewire02}} もインストールする必要があります。

{{Tip|複数のモニタがある場合に {{ic|xdg-desktop-portal-wlr}} を使用してそれぞれのモニターを共有するには、ユニットのサービスファイルの {{ic|1=ExecStart=}} オプションを[[Systemd#Editing_provided_units|編集]]して {{ic|1=--output=''Monitor''}} フラグを追加してください。行全体は {{ic|1=ExecStart=@libexecdir@/xdg-desktop-portal-wlr --output=eDP-1}} のようになります。}}

唯一サポートされている機能はデスクトップ全体の共有で、特定のアプリケーション/ウィンドウの共有はサポートされていません。[https://github.com/emersion/xdg-desktop-portal-wlr/wiki/FAQ#will-this-let-me-share-individual-windows][https://github.com/KDE/xdg-desktop-portal-kde/blob/master/TODO]

=== 映像 ===

ソフトウェアはまだ商業利用には適していませんが、試す分には問題ありません。[[GStreamer]] を使用して映像ストリームを処理するほとんどのアプリケーションは PipeWire GStreamer プラグインにより設定なしで動作するはずです。そのため既に {{pkg|cheese}} のようなアプリケーションは PipeWire を使用して映像入力を利用できます。

=== 音声 ===

PulseAudio や Jack と同様に PipeWire をオーディオサーバーとして使用できます。 PulseAudio サーバーの互換実装と JACK クライアント用の ABI 互換ライブラリを提供することで PulseAudio と Jack の両方を置き換えることを目的としています。詳細については[https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ この記事]を参照してください。

==== ALSA/レガシーアプリケーション ====

{{pkg|pipewire-alsa}} をインストールして ALSA API を使用するすべてのアプリケーションが PipeWire を使用するよう設定できます。

==== PulseAudio クライアント ====

{{pkg|pipewire-pulse}} をインストールします。このパッケージは {{pkg|pulseaudio}} と {{pkg|pulseaudio-bluetooth}} を置き換えます。パッケージがユーザーサービス {{ic|pipewire-pulse.socket}} を自動的に有効化するので、通常それ以上の操作は不要です。システム起動時に PipeWire が正しく機能しない場合は、ユーザーサービス {{ic|pipewire-pulse.service}} と {{ic|pipewire.service}} が起動して実行されているか確認します。 [[Systemd/ユーザー]]を参照してください。

変更を適用するには、再起動または再ログインしてください。

置き換えが機能しているかどうかを確認するには、次のコマンドを実行して出力を確認してください:

{{hc|1=$ pactl info|2=
...
Server Name: PulseAudio (on PipeWire 0.3.16)
...
}}

==== JACK クライアント ====

{{pkg|pipewire-jack}} をインストールします。{{ic|pw-jack}} を使用して JACK クライアントを起動すると、元の {{ic|libjack*}} ではなく PipeWire が提供する互換ライブラリが使用されます:

pw-jack ''application''

カスタムバッファサイズを要求することもできます。{{ic|PIPEWIRE_LATENCY}}環境変数を {{ic|バッファサイズ/サンプルレート}} (ブロックのレイテンシ(秒)を意味します) に設定します:

PIPEWIRE_LATENCY="128/48000" pw-jack ''application''

また {{aur|pipewire-jack-dropin}} をインストールするか、{{pkg|jack}} か {{pkg|jack 2}} をアンインストールして JACK クライアントが互換ライブラリを自動的に読み込むようにもできます。

{{ic|ldd}} を使用して JACK アプリケーションが正しいライブラリにリンクしていることを確認します。

{{hc|1=$ ldd /usr/bin/qjackctl {{!}} grep -i libjack|2=
libjack.so.0 => /usr/lib/pipewire-0.3/jack/libjack.so.0 (0x00007f7e5080a000)
}}

==== Bluetooth デバイス ====

PipeWire は {{pkg|pipewire-pulse}} パッケージがインストールされている場合 Bluetooth オーディオデバイスを制御します。具体的には、メディアセッションデーモンは {{ic|/etc/pipewire/media-session.d/with-pulseaudio}} が存在する時に自動的にその {{ic|bluez5}} モジュールを有効にします。

==== ネイティブ JACK 上で PipeWire を実行する ====

PipeWire はネイティブ JACK デーモン上の JACK クライアントとして実行することもできます。詳細は [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/JACK JACK and PipeWire] を参照してください。

== 音声のポストプロセッシング ==

=== PulseEffects ===

PulseEffects は GTK ユーティリティで、多数のエフェクトとフィルタを個々の入出力ストリーム(アプリケーションの音声出力やマイクの入力など)に提供します。注目すべきエフェクトには、入出力イコライザー、出力ラウドネス等化、ベースエンハンスメント、入力ディエッサー、ノイズ抑制プラグインなどがあります。[https://github.com/wwmm/pulseeffects GitHub ページ] にエフェクトの一覧があります。

PipeWire で PulseEffects を使用するには、{{pkg|pulseeffects}} または {{AUR|pulseeffects-git}} をインストールします。

{{Note|これにより、{{pkg|pipewire-pulse}} がインストールされ [[#PulseAudio クライアント|PulseAudio が PipeWire に置き換えられます。]] 詳細は {{Bug|69437}} を参照してください。古いバージョンについては [[PulseAudio#PulseEffects]] を参照してください。}}

プリセット設定のコレクションについては、[https://github.com/wwmm/pulseeffects/wiki/Community-presets コミュニティープリセット] を参照してください。

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

=== PipeWire にマイクが検出されない ===

PipeWire の {{ic|alsa-monitor}} モジュールは、デフォルトで {{pkg|alsa-card-profiles}} を使用してデバイスを検出します。これでうまくいかない場合は、{{ic|/etc/pipewire/media-session.d/alsa-monitor.conf}} の {{ic|rules}} -> 最初のルール -> {{ic|actions}} -> {{ic|update-props}} の {{ic|api.alsa.use-acp}} を {{ic|false}} にするか、または {{ic|api.alsa.use-ucm}} を {{ic|true}} にしてみてください:

...
update-props = {
api.alsa.use-acp = false
...

次に PipeWire を再起動し使用可能なデバイスを確認します:

{{hc|1=
$ pw-record --list-targets
|2=
Available targets ("*" denotes default): 62
58: description="Built-in Audio" prio=1872
60: description="Built-in Audio" prio=2000
* 62: description="Built-in Audio (Loopback PCM)" prio=1984
}}

=== Bluetooth デバイスに接続しても音が出ない ===

2020-12-07 の時点で、Bluetooth デバイスを接続しても音が出ない場合は、デフォルトのシンクに切り替えるか、シンク入力を正しいシンクに移動する必要があります。 {{ic|pactl list sinks}} で使用可能なシンクの一覧を表示し、{{ic|pactl set-default-sink}} でデフォルトのシンクを Bluetooth デバイスに切り替えます。これは [https://gist.github.com/tinywrkb/04e7fd644afa9b92d33a3a99ab07ee9e このようなスクリプト] を使って [[udev]] で自動化できます。

この問題については、この [https://www.reddit.com/r/archlinux/comments/jydd02/pipewirepulse_03164_in_testing_now_replaces/gd3m7fu/?context=3 Reddit スレッド] を参照してください。スクリプトの作成者によると、ヘッドセットプロファイル (HSP) にまだ問題がある可能性があります。

=== 音量が小さい ===

PulseAudio を Pipewire で置き換えた後、正しく音が出ても、再起動後に音量が極端に小さくなることがあります。

{{ic|alsamixer}} を開き、{{ic|F6}} を押して適切なサウンドカードを選び ALSA のボリュームが100%であることを確認してください。 {{ic|alsactl}} は再起動後もこの設定を維持するはずです。

=== increasing RLIMIT_MEMLOCK ===

Dec 13 11:11:11 HOST pipewire-pulse[99999]: Failed to mlock memory 0x7f4f659d8000 32832: This is not a problem but for best performance, consider increasing RLIMIT_MEMLOCK

{{pkg|realtime-privileges}} をインストールし {{ic|realtime}} グループに自分のユーザーを追加します。

あるいは memlock を 64kB から 128kB に増やすことで、この問題を解決できるようです。[[systemd/ユーザー]] で {{ic|pipewire-pulse}} を実行している場合は {{ic|/etc/security/limits.d/username.conf}} に次の行を追加します:

username soft memlock 64
username hard memlock 128

=== 外付けサウンドカードが再接続後に有効にならない ===

{{ic|~/.config/pipewire-media-session/default-profile}} にデフォルトプロファイル ''off'' のエントリがあれば削除します。それでも解決しない場合は {{ic|~/.config/pipewire-media-session/}} からすべてのファイルを削除し、{{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動します。

=== 音が出ないまたは pactl info が Failure: Connection refused と表示する ===
これはアプリケーションが PipeWire-Pulse サービスに接続できていないことを意味します。{{ic|/etc/pipewire/pipewire-pulse.conf}} が存在し空でないことを確認し、{{ic|systemctl --user restart pipewire-pulse.service}} で PipeWire-Pulse を再起動して下さい。

それでも解決しない場合は {{ic|strace -f -o /tmp/pipe.txt pactl info}} を実行し、pastebin に {{ic|/tmp/pipe.txt}} を貼り付けて、IRC (Freenode '''#pipewire''') かメーリングリストで相談してください。

=== Bluetooth の音声の品質が低い===

Feb 17 18:23:01 HOST pipewire[249297]: (bluez_input.18:54:CF:04:00:56.a2dp-sink-60) client too slow! rate:512/48000 pos:370688 status:triggered

Bluetooth で再生が途切れる場合は {{ic|systemctl --user status pipewire.service}} を実行してみてください。このようなエラーが表示される場合は {{ic|pactl list sinks}} で現在選択されているコーデックを確認し、{{ic|/etc/pipewire/media-session.d/bluez-monitor.conf}} の {{ic|bluez5.codecs}} を {{ic|sbc aac ldac aptx aptx_hd}} のいずれかに変更してみてください。変更を適用するには {{ic|systemctl --user restart pipewire.service}} で PipeWire を再起動する必要があります。

{{hc|head=/etc/pipewire/media-session.d/bluez-monitor.conf|output=
...
properties = {
...
bluez5.codecs = [sbc]
...}}

=== PipeWire の更新 (git / >=0.3.23) と再起動後デバイスが検出されない===

コミット 012a68f8[https://gitlab.freedesktop.org/pipewire/pipewire/-/commit/012a68f8ef33705f1a40ec8ac294b8cce7f6aa88] の時点で新しい systemd サービスが追加されデフォルトでは無効になっています。これはシステムの再起動時に {{ic|pipewire-media-session}} が実行されないことを意味します。サービスを有効にするには {{ic|systemctl --user enable --now pipewire-media-session.service}} を実行します。

システムの管理者やパッケージマネージャが更新後に設定ファイルの変更を整理していない場合、{{ic|pipewire.service}} によって {{ic|pipewire-media-session}} の別のプロセスが実行されている可能性があります。確認するには {{ic|systemctl --user status pipewire.service}} を実行してください。

pipewire および pipewire-media-session が実行中と表示される場合は、システム設定かユーザ設定、あるいは両方を更新します。

{{hc|head=/etc/pipewire/pipewire.conf または ~/.config/pipewire/pipewire.conf|output=
context.exec = {
...
# 次の行はコメントアウトする必要があります
#"/usr/bin/pipewire-media-session" = { args = "" }
...
}
}}

=== 再生開始時に音声に遅延が発生する ===

これは非アクティブ時のノードのサスペンドが原因です。遅延が発生する領域に応じて {{ic|/etc/pipewire/media-session.d/*-monitor.conf}} を編集し、プロパティ {{ic|session.suspend-timeout-seconds}} を {{ic|0}} に変更してサスペンドを無効にするか、他の値を試して動作を確認してみてください。{{ic|/etc/pipewire/media-session.conf}} の {{ic|suspend-node}} の行をコメントアウトすることもできます。変更を適用するには {{ic|pipewire}} と {{ic|pipewire-pulse}} systemd サービスの両方を再起動するか、システムを再起動してください。

=== 複数のストリームの再生開始時に音声が途切れる ===

この問題は通常 {{ic|journalctl -b | grep -i pipewire}} を実行し、次のような行を探すことで診断できます:

pipewire-pulse[21740]: pulse-server 0x56009b9d5de0: [Nightly] UNDERFLOW channel:0 offset:370676 underrun:940

[https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Troubleshooting#underrununderflow-and-broken-pipe-errors 公式 PipeWire トラブルシューティングガイド] によると、この問題を解決するには {{ic|/etc/pipewire/media-session.d/alsa-monitor.conf}} を編集し、{{ic|1=api.alsa.headroom = 0}} という行のコメントを外し、値を {{ic|1024}} に変更します。

== 参照 ==

* [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/home Wiki] — PipeWire Wiki on Freedesktop GitLab
* [https://blogs.gnome.org/uraeus/2018/01/26/an-update-on-pipewire-the-multimedia-revolution-an-update/ Pipewire Update Blog Post] — PipeWire の2018年1月時点での進捗が書かれた記事
* [https://blogs.gnome.org/uraeus/2020/09/04/pipewire-late-summer-update-2020/ PipeWire Late Summer Update 2020] — 2020年9月からの記事

Snap

2019-02-04T15:47:47Z

Oriaca372m: 同期

[[Category:開発]]
[[en:Snapd]]
[[pl:Snap]]
[[ru:Snapd]]
{{Related articles start}}
{{Related|Flatpak}}
{{Related|AppArmor}}
{{Related articles end}}

[https://snapcraft.io/ snap] はソフトウェアのデプロイとパッケージ管理のシステムです。パッケージは 'snap' と呼ばれ、それを使用するツールは 'snapd' と呼ばれています。snapd は、さまざまなディストリビューションで動作し、上流はディストリビューションに依存しないデプロイができるようになります。Snap は元々 Canonical によって設計、開発されました。

[https://github.com/snapcore/snapd snapd] は snap パッケージを管理するための REST API デーモンです。ユーザーは (同じパッケージに入っている) {{ic|snap}} クライアントを使用することで snapd を操作することができます。

snap はデフォルトのカーネルで現在有効にされている [[AppArmor]] を使ってアクセス制限ができます。[[AppArmor]] を有効にするには関連ページを参照してください。

==インストール==

{{AUR|snapd}} または {{AUR|snapd-git}} パッケージを[[インストール]]してください。

{{tip|snapd は snapd パッケージでインストールしたバイナリのパスとデスクトップエントリをエクスポートするために {{ic|/etc/profile.d/}} にスクリプトをインストールします。変更を適用させるために一度再起動してください。}}

バージョン 2.36 から、{{ic|snapd}} の AppAromr サポートが有効になっています。使用するためには AppArmor を有効にする必要があります。[[AppArmor#インストール]] を参照してください。

{{note|AppArmor が有効になっていない場合、全ての snap は {{ic|devel}} モードで動作します。このモードでは Arch Linux のリポジトリからインストールされたアプリのように、システムへの無制限のアクセスができます。}}

[[AppArmor]] を使用する場合:
$ systemctl enable --now apparmor.service
$ systemctl enable --now snapd.apparmor.service

==設定==
{{ic|snap}} が使おうとしたときに {{ic|snapd}} デーモンを起動するには、{{ic|snapd.socket}} を[[起動]]・[[有効化]]します。

==使用方法==
{{ic|snap}} コマンドは snap を管理するために使います。

===snap の検索===
次のコマンドで Ubuntu Store を検索できます:
$ snap find ''searchterm''

===snap のインストール===
次のコマンドで snap をインストールできます:
# snap install ''snapname''

上記のコマンドを実行するには root 権限が必要です。現在のところ、通常ユーザーで snap をインストールすることはできません。インストールすると {{ic|/var/lib/snapd/snaps}} に snap がダウンロードされて、{{ic|/var/lib/snapd/snap/<snapname>}} にマウントされ、システムから使える状態になります。

システムが起動したときに全ての snap が利用できるように、snap のマウントユニットも作成され、{{ic|/etc/systemd/system/multi-user.target.wants/}} にシンボリックリンクとして追加されます。インストールが完了したら、次のコマンドでインストールされている snap を確認できます。バージョン番号やリビジョン番号、開発者も表示されます:
$ snap list

ローカルのハードドライブから野良 snap をインストールするには:
# snap install --dangerous ''/path/to/snap''

===snap のアップデート===
次のコマンドで snap を手動でアップデートできます:
# snap refresh

snap を {{ic|refresh.timer}} の設定通りに自動でアップデートさせることも出来ます。

最新/次のアップデート時間を確認するには:
# snap refresh --time

アップデートの頻度を変更するには (例: 1日2回):
# snap set core refresh.timer=0:00~24:00/2

詳細は [https://forum.snapcraft.io/t/system-options/87 システムオプションのドキュメント] を参照してください。

===snap の削除===
次のコマンドで snap を削除できます:
# snap remove ''snapname''

== ヒントとテクニック ==
=== Classic snap ===
一部の snap (例: [[Skype]] や Pycharm) は classic confinement を使用しますが、classic confinement は [[FHS]] に準拠していない {{ic|/snap}} ディレクトリを必要とします。snapd パッケージには {{ic|/snap}} ディレクトリは含まれていません。classic snap をインストールしたい場合、{{ic|/var/lib/snapd/snap}} から {{ic|/snap}} に手動でシンボリックリンクを作成してください:

# ln -s /var/lib/snapd/snap /snap

=== アクセス制限 ===
[[AppArmor]] を使用している場合 snapd (バージョン2.36以上) は Ubuntu と同じプロファイルを生成します。The [[AppArmor]] parser is smart enough to drop the rules that are not yet supported by the mainline kernel.

基本的なアクセス制限が動いているか確認するために {{ic|hello-world}} snap をインストールして、次のコマンドを実行してください:
$ hello-world.evil
Hello Evil World!
This example demonstrates the app confinement
You should see a permission denied error next
/snap/hello-world/27/bin/evil: 9: /snap/hello-world/27/bin/evil: cannot create /var/tmp/myevil.txt: Permission denied

AppArmor によりアクセスが拒否され、ログが生成されるはずです:
$ dmesg
...
[ +0.000003] audit: type=1327 audit(1540469583.966:257): proctitle=2F62696E2F7368002F736E61702F68656C6C6F2D776F726C642F32372F62696E2F6576696C
[ +12.268939] audit: type=1400 audit(1540469596.236:258): apparmor="DENIED" operation="open" profile="snap.hello-world.evil" name="/var/tmp/myevil.txt" pid=10835 comm="evil" requested_mask="wc" denied_mask="wc" fsuid=1000 ouid=1000
[ +0.000006] audit: type=1300 audit(1540469596.236:258): arch=c000003e syscall=2 success=no exit=-13 a0=55d991ba6bc8 a1=241 a2=1b6 a3=55d991ba6be0 items=0 ppid=31349 pid=10835 auid=1000 uid=1000 gid=1000 euid=1000 suid=1000 fsuid=1000 egid=1000 sgid=1000 fsgid=1000 tty=pts2 ses=3 comm="evil" exe="/bin/dash" subj==snap.hello-world.evil (enforce)
...

アクセス拒否が確認できない場合は、プロファイルがロードされているか確認してください:
$ sudo aa-status | grep snap.hello-world
snap.hello-world.env
snap.hello-world.evil
snap.hello-world.hello-world
snap.hello-world.sh

また、どのサンドボックスの機能が有効になっているか snapd に確認することができます。
$ snap debug sandbox-features
apparmor: kernel:caps kernel:domain kernel:file kernel:mount kernel:namespaces kernel:network_v8 kernel:policy kernel:ptrace kernel:query kernel:rlimit kernel:signal parser:unsafe policy:default support-level:partial
confinement-options: devmode
dbus: mediated-bus-access
kmod: mediated-modprobe
mount: freezer-cgroup-v1 layouts mount-namespace per-snap-persistency per-snap-profiles per-snap-updates per-snap-user-profiles stale-base-invalidation
seccomp: bpf-argument-filtering kernel:allow kernel:errno kernel:kill_process kernel:kill_thread kernel:log kernel:trace kernel:trap

== GUI 管理 ==
Gnome Software Center や KDE Discover は、{{AUR|gnome-software-snap}} や {{AUR|discover-snap}} パッケージをインストールすることで snap サポートを使用できます。

== サポート ==
Arch Linux のメーリングリストや他の公式サポートチャンネルは Arch Linux で使用する snap のサポートを求める適切な場所ではありません。サポートを求めるには [https://forum.snapcraft.io Snapcraft フォーラム]を利用してください。

== 参照 ==
* [https://snapcraft.io/ 公式サイト]
* [https://github.com/snapcore/snapd リポジトリ]
* [http://arstechnica.com/information-technology/2016/06/goodbye-apt-and-yum-ubuntus-snap-apps-are-coming-to-distros-everywhere/ arstechnica article] (06/16) Ubuntu の snap が Arch などのディストリで使えるようになったことについての記事