Pi-holeのソースを表示

[[Category:ドメインネームシステム]]
[[en:Pi-hole]]
{{Related articles start}}
{{Related|Dnsmasq}}
{{Related|Lighttpd}}
{{Related|Nginx}}
{{Related articles end}}

[https://github.com/pi-hole/pi-hole GitHub の Pi-hole の README.md] より:
:Pi-Hole™ は広告を排除する DNS ウェブサーバーです。広告ドメインに問い合わせがきた場合、広告の代わりに小さなウェブページや GIF が返されるようになります。

:gravity.sh によって多数のソースから広告のドメインを取得して1600万以上のエントリからなるリストが作られます (mahakala リストを使用した場合)。スクリプトは pihole コマンドで制御できます。pihole でどのようなコマンドが実行できるのか確認するには pihole -h を実行してください。

この wiki ページではメインプロジェクトで公式にサポートされていない Arch Linux で Pi-hole を動作させるための設定や使用方法を説明します。バグや問題については、サーバーパッケージは [https://aur.archlinux.org/packages/pi-hole-server/ pi-hole-server の AUR ページ] を、スタンドアロンパッケージは [https://aur.archlinux.org/packages/pi-hole-standalone/ pi-hole-standalone の AUR ページ] を参照してください。

== Pi-hole サーバー ==

=== インストール ===

{{Aur|pi-hole-ftl}} と {{AUR|pi-hole-server}} を[[インストール]]してください。

=== 初期設定 ===
==== Dnsmasq ====
dnsmasq を設定することで DNS クエリを解決して pi-hole で直接広告を管理することができます。

''dnsmasq を既に使っている場合'': {{ic|/etc/dnsmasq.conf}} を編集して最後の行をコメントアウトして {{ic|/etc/dnsmasq.d}} ディレクトリに存在する pi-hole の設定ファイルを指定してください:

 # sed -i 's|#conf-dir=/etc/dnsmasq.d/,\*.conf|conf-dir=/etc/dnsmasq.d/,\*.conf|' /etc/dnsmasq.conf

''dnsmasq を使ったことがない場合'': 元の設定ファイルを pi-hole-server に含まれているファイルに置き換えてください:
 # cp /etc/pihole/configs/dnsmasq.main /etc/dnsmasq.conf

必要であれば、{{ic|dnsmasq.service}} を[[有効化]]して再起動してください。Pi-hole を LAN の DNS とする必要があります。ルーターを DNS として使っている場合、Pi-hole が動作しているマシンの IP アドレスを使うようにルーターの DNS を再設定してください。ルーターの設定についてはこの記事では扱いませんが、必須の作業です。

==== ウェブサーバー ====

Pi-hole のウェブインターフェイスとしてウェブサーバーを使うことができます。

{{Note|Pi-hole は必ずしもウェブインターフェイスを必要としません。様々なコマンドが CLI インターフェイスから使うことができます。}}

上流では公式に {{Pkg|lighttpd}} をサポートしており設定ファイルを用意しています。AUR パッケージには {{Pkg|nginx}} の設定ファイルも含まれており、すぐに使うことができます。他のウェブサーバーでも webUI を使うことはできますが、サポートはされていません。

どのウェブサーバーを使うにせよ以下の設定を編集して sockets 拡張を有効にする必要があります:
{{hc|/etc/php/php.ini|2=
[...]
extension=sockets.so
[...]
}}

===== Lighttpd =====
{{Pkg|lighttpd}} と {{Pkg|php-cgi}} を[[インストール]]してください。元の設定ファイルをバックアップして pi-hole の設定ファイルをコピーしてください:
 # cp /etc/lighttpd/lighttpd.conf /etc/lighttpd/lighttpd.orig
 # cp /etc/pihole/configs/lighttpd.conf /etc/lighttpd/lighttpd.conf
必要であれば {{ic|lighttpd.service}} を[[起動]]・[[有効化]]してください。

===== Nginx =====
{{Pkg|nginx}} または {{Pkg|nginx-mainline}} と {{Pkg|php-fpm}} を[[インストール]]してください。

{{ic|/etc/php/php-fpm.d/www.conf}} を編集して listen ディレクティブを以下のように変更してください:
 listen = 127.0.0.1:9000  

{{ic|/etc/nginx/nginx.conf}} を編集して ''http'' セクションに以下を記述してください:
 gzip            on;
 gzip_min_length 1000;
 gzip_proxied    expired no-cache no-store private auth;
 gzip_types      text/plain application/xml application/json application/javascript application/octet-stream text/css;
 include /etc/nginx/conf.d/*.conf;

パッケージに含まれている pi-hole の設定をコピー:
 # mkdir /etc/nginx/conf.d
 # cp /etc/pihole/configs/nginx.pi-hole.conf /etc/nginx/conf.d/

必要であれば {{ic|nginx.service}} と {{ic|php-fpm.service}} を[[起動]]・[[有効化]]してください。

=== 設定のアップデート ===
{{Tip|アップデートしたときに dnsmasq やウェブサーバーの設定ファイルが変わっていない場合、このセクションの手順を実行する必要はありません。}}
dnsmasq の設定ファイルをアップデート:

 # [ -f /etc/dnsmasq.orig ] && cp /etc/pihole/configs/dnsmasq.main /etc/dnsmasq.conf

lighttpd の設定ファイルをアップデート:

 # [ -f /etc/lighttpd/lighttpd.orig ] && cp /etc/pihole/configs/lighttpd.conf /etc/lighttpd/lighttpd.conf

nginx の設定ファイルをアップデート:

 # cp /etc/pihole/configs/nginx.pi-hole.conf /etc/nginx/conf.d/

=== ウェブインターフェイス ===

Pi-hole ウェブインターフェイスを使うことで、{{pkg|dnsmasq}} を様々に設定したり、Pi-hole のコマンドを実行したり、ホワイトリスト・ブラックリストを制御したり、広告フィルタリングを監視したりすることができます。ウェブインターフェイスに接続:

 http://<IP/Hostname of Pi-hole machine>/admin/

または:

 http://pi.hole/admin

=== FTL ===

FTL は Pi-hole プロジェクトのひとつで、Pi-hole の DNS クエリのログのフロントエンドとなるデータベースのようなラッパーあるいは API です。FTL は {{ic|/etc/pihole/pihole-FTL.conf}} で設定できます。詳しくは [https://github.com/pi-hole/FTL#ftls-config-file プロジェクトドキュメント] を読んでください。

== Pi-hole スタンドアロン ==

Arch Linux の Pi-hole スタンドアロン版はモバイル端末で pi-hole サービスを使うために生まれました。[http://dlaa.me/blog/post/skyhole Sky-hole の記事] も参照。

=== インストール ===

{{AUR|pi-hole-standalone}} パッケージを[[インストール]]してください。

=== 初期設定 ===
==== Dnsmasq ====

上の [[#Dnsmasq]] セクションと同じように設定してください。

==== Openresolve ====

{{ic|/etc/resolvconf.conf}} を編集して name_servers 行をアンコメントして resolvconf を更新してください:

 # sed -i 's|#name_servers=127.0.0.1|name_servers=127.0.0.1|' /etc/resolvconf.conf
 # resolvconf -u

ホストネームの解決でローカルホストに問い合わせて {{Pkg|dnsmasq}} が使われるようになります。

=== 設定のアップデート ===

{{Tip|アップデートしたときに dnsmasq の設定ファイルが変わっていない場合、このセクションの手順を実行する必要はありません。}}
dnsmasq の設定ファイルをアップデート:

 # [ -f /etc/dnsmasq.orig ] && cp /etc/pihole/configs/dnsmasq.main /etc/dnsmasq.conf

== 参照 ==

* [https://pi-hole.net/ Pi-hole ホームページ]
* [https://github.com/pi-hole/pi-hole Pi-hole GitHub Page]
* [https://github.com/pi-hole/FTL Pi-hole FTL GitHub Page]
* [http://dlaa.me/blog/post/skyhole Sky-Hole, the basic idea under Pi-hole standalone]