Reflectorのソースを表示

[[Category:パッケージ管理]]
[[en:Reflector]]
[[es:Reflector]]
[[fr:Reflector]]
[[it:Reflector]]
[[ko:Reflector]]
[[pl:Reflector]]
[[ru:Reflector]]
[[zh-hans:Reflector]]
{{Related articles start}}
{{Related|ミラー}}
{{Related|Pacman}}
{{Related articles end}}
[https://xyne.archlinux.ca/projects/reflector/ Reflector] は [https://www.archlinux.org/mirrors/status/ MirrorStatus] ページから最新のミラーリストを取得して、ミラーを速度でソートし、{{ic|/etc/pacman.d/mirrorlist}} ファイルを上書きするスクリプトです。

== インストール ==

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

== 使用方法 ==

{{Warning|
* 最初に {{ic|/etc/pacman.d/mirrorlist}} ファイルをバックアップしておいてください。
* [[Pacman]] で同期とアップデートをする前に {{ic|/etc/pacman.d/mirrorlist}} には信頼できないエントリが含まれていないようにしてください。}}

利用できるコマンドを表示するには、次のコマンドを実行:
 # reflector --help

=== サンプル ===

以下のコマンドは同期が一番新しい5つのミラーを取り出して、速度でソートし、{{ic|/etc/pacman.d/mirrorlist}} ファイルを上書きします:

 # reflector --verbose --latest 5 --sort rate --save /etc/pacman.d/mirrorlist

以下のコマンドは、最近同期が行われた HTTP または HTTPS ミラー200個を選択して、ダウンロード速度でソートし、{{ic|/etc/pacman.d/mirrorlist}} ファイルを上書きします:

 # reflector --latest 200 --protocol http --protocol https --sort rate --save /etc/pacman.d/mirrorlist

以下のコマンドはアメリカに存在する、12時間以内に同期が行われた HTTPS ミラーを選択して、ダウンロード速度でソートし、{{ic|/etc/pacman.d/mirrorlist}} ファイルを上書きします:

 # reflector --country 'United States' --age 12 --protocol https --sort rate --save /etc/pacman.d/mirrorlist

== 自動化 ==

=== Pacman フック ===

pacman フックを作成して {{Pkg|pacman-mirrorlist}} が更新されるたびに ''reflector'' を実行して {{ic|.pacnew}} ファイルを削除するように設定できます:

{{hc|/etc/pacman.d/hooks/mirrorupgrade.hook|<nowiki>
[Trigger]
Operation = Upgrade
Type = Package
Target = pacman-mirrorlist

[Action]
Description = Updating pacman-mirrorlist with reflector and removing pacnew...
When = PostTransaction
Depends = reflector
Exec = /bin/sh -c "reflector --country 'United States' --latest 200 --age 24 --sort rate --save /etc/pacman.d/mirrorlist;  rm -f /etc/pacman.d/mirrorlist.pacnew"
</nowiki>}}
''reflector'' の引数は適宜書き換えてください。

pacman フックについて詳しくは [[Pacman#フック]]を参照。

=== Systemd サービス ===

{{hc|/etc/systemd/system/reflector.service|<nowiki>
[Unit]
Description=Pacman mirrorlist update

[Service]
Type=oneshot
ExecStart=/usr/bin/reflector --protocol https --latest 30 --number 20 --sort rate --save /etc/pacman.d/mirrorlist
</nowiki>}}

{{ic|reflector.service}} を[[起動]]すればミラーリストが更新されます。

コンピュータが起動するたびにミラーリストを更新するには以下のサービスを有効にしてください。

{{hc|/etc/systemd/system/reflector.service|<nowiki>
[Unit]
Description=Pacman mirrorlist update
Requires=network-online.target
After=network-online.target

[Service]
Type=oneshot
ExecStart=/usr/bin/reflector --protocol https --latest 30 --number 20 --sort rate --save /etc/pacman.d/mirrorlist

[Install]
RequiredBy=multi-user.target
</nowiki>}}

{{ic|network.target}} がネットワーク状態を正確に反映するように [https://www.freedesktop.org/wiki/Software/systemd/NetworkTarget/ 適当なサービスを有効化] してください。

=== Systemd タイマー ===

{{ic|reflector.service}} を一週間ごとに実行したい場合:

{{hc|/etc/systemd/system/reflector.timer|<nowiki>
[Unit]
Description=Run reflector weekly

[Timer]
OnCalendar=weekly
RandomizedDelaySec=12h
Persistent=true

[Install]
WantedBy=timers.target
</nowiki>}}

作成したら {{ic|reflector.timer}} を[[起動]]してください。

==== AUR パッケージ ====

{{AUR|reflector-timer}}{{Broken package link|パッケージが存在しません}} パッケージを使って ''reflector'' を毎週実行することもできます。

デフォルト設定:
{{hc|/usr/share/reflector-timer/reflector.conf|<nowiki>
AGE=6
COUNTRY=Germany
LATEST=30
NUMBER=20
SORT=rate
</nowiki>}}

設定を上書きするには {{ic|/etc/conf.d/reflector.conf}} を編集:
{{hc|/etc/conf.d/reflector.conf|<nowiki>
COUNTRY=US
</nowiki>}}

インストールしたら {{ic|reflector.timer}} を[[有効化]]してください。

== 参照 ==

* [https://bbs.archlinux.org/viewtopic.php?id=115714 Reflector Arch Linux フォーラムのスレッド]
* [https://xyne.archlinux.ca/projects/reflector/ 変更ログを含むアップストリームプロジェクトページ]