「Reflector」の版間の差分
(同期) |
Kusanaginoturugi (トーク | 投稿記録) (序文を修正) |
||
(4人の利用者による、間の14版が非表示) | |||
12行目: | 12行目: | ||
{{Related|Pacman}} |
{{Related|Pacman}} |
||
{{Related articles end}} |
{{Related articles end}} |
||
− | [https://xyne.archlinux.ca/projects/reflector/ Reflector] は [https:// |
+ | [https://xyne.archlinux.ca/projects/reflector/ Reflector] は [https://archlinux.org/mirrors/status/ Arch Linux Mirror Status] ページから最新のミラーリストを取得して、フィルタリングおよび速度でソートし、{{ic|/etc/pacman.d/mirrorlist}} ファイルを上書きする Python スクリプトです。 |
== インストール == |
== インストール == |
||
28行目: | 28行目: | ||
=== サンプル === |
=== サンプル === |
||
+ | {{man|1|reflector|EXAMPLES}} を参照してください。サンプルは {{ic|/etc/pacman.d/mirrorlist}} を上書きします。root として実行する必要があります。{{Tip|1=ワールドワイドサーバーを含めるには、country フラグに空の文字列を渡します。例えば、フランス、ドイツおよびワールドワイドミラーを含めるには、{{ic|--country 'France,Germany,'}} を使用します。[https://bbs.archlinux.org/viewtopic.php?pid=1975404#p1975404]}} |
||
+ | == 自動化 == |
||
− | 以下のコマンドは同期が一番新しい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 サービス === |
=== Systemd サービス === |
||
+ | サービスは、{{ic|/etc/xdg/reflector/reflector.conf}} で指定されたパラメータを使用し Reflector を実行します。このファイルのデフォルトのオプションは、例として示しています。 |
||
− | {{hc|/etc/systemd/system/reflector.service|<nowiki> |
||
− | [Unit] |
||
− | Description=Pacman mirrorlist update |
||
+ | たとえば、HTTPS をサポートし、上書き {{ic|/etc/pacman.d/mirrorlist}} する最新の5つのミラーを日本とオーストラリアから選択するには、次のコマンドを使用します。 |
||
− | [Service] |
||
− | Type=oneshot |
||
− | ExecStart=/usr/bin/reflector --protocol https --latest 30 --number 20 --sort rate --save /etc/pacman.d/mirrorlist |
||
− | </nowiki>}} |
||
+ | {{hc|/etc/xdg/reflector/reflector.conf| |
||
− | {{ic|reflector.service}} を[[起動]]すればミラーリストが更新されます。 |
||
+ | --save /etc/pacman.d/mirrorlist |
||
+ | --country Japan,Australia |
||
+ | --protocol https |
||
+ | --latest 5 |
||
+ | }} |
||
+ | {{ic|reflector.service}} を [[有効化]] すればミラーリストが起動時に更新されます。 |
||
− | コンピュータが起動するたびにミラーリストを更新するには以下のサービスを有効にしてください。 |
||
+ | {{Note|{{ic|reflector.service}} は、[[systemd#ネットワークが稼働した後にサービスを実行する|network-online.target]] を介して設定されるネットワーク待機サービスに依存します。}} |
||
− | {{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 タイマー === |
=== Systemd タイマー === |
||
+ | バージョン2020.8 以降、Reflector は [[systemd/タイマー]] ({{ic|reflector.timer}}) を提供しており、 [[Reflector#Systemd サービス]] {{ic|reflector.service}} を毎週開始します。スケジュールは {{ic|reflector.timer}} を [https://wiki.archlinux.jp/index.php/Systemd#.E3.83.A6.E3.83.8B.E3.83.83.E3.83.88.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.81.AE.E7.B7.A8.E9.9B.86 編集] することで変更できます。 |
||
− | {{ic|reflector.service}} を一週間ごとに実行したい場合: |
||
+ | まず、[[Reflector#Systemd サービス]] の説明に従って、設定ファイルを編集します。設定ファイルを更新した後、{{ic|reflector.timer}} を [[有効化]] してください。 |
||
− | {{hc|/etc/systemd/system/reflector.timer|<nowiki> |
||
− | [Unit] |
||
− | Description=Run reflector weekly |
||
+ | ミラーリストをスケジュールより先に更新するには、{{ic|reflector.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 start] してください。 |
||
− | [Timer] |
||
− | OnCalendar=weekly |
||
− | RandomizedDelaySec=12h |
||
− | Persistent=true |
||
+ | === Pacman フック === |
||
− | [Install] |
||
− | WantedBy=timers.target |
||
− | </nowiki>}} |
||
− | |||
− | 作成したら {{ic|reflector.timer}} を[[起動]]してください。 |
||
− | |||
− | ==== AUR パッケージ ==== |
||
− | |||
− | {{AUR|reflector-timer}} パッケージを使って ''reflector'' を毎週実行することもできます。 |
||
+ | {{Pkg|pacman-mirrorlist}} は定期的に更新されず、世界の一部のミラーが追加または削除されたという理由だけで reflector を呼び出します。代わりにタイマーベースの自動化を使いましょう。もし {{ic|mirrorlist.pacnew}} を全くインストールしたくない場合は、{{ic|pacman.conf}} で {{ic|NoExtract}} を使って下さい。 |
||
− | デフォルト設定: |
||
− | {{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>}} |
||
+ | * [https://bbs.archlinux.org/viewtopic.php?id=115714 Reflector Arch Linux フォーラムのスレッド] |
||
− | インストールしたら {{ic|reflector.timer}} を[[有効化]]してください。 |
||
+ | * [https://xyne.archlinux.ca/projects/reflector/ 変更ログを含むアップストリームプロジェクトページ] |
2023年4月13日 (木) 14:43時点における最新版
Reflector は Arch Linux Mirror Status ページから最新のミラーリストを取得して、フィルタリングおよび速度でソートし、/etc/pacman.d/mirrorlist
ファイルを上書きする Python スクリプトです。
インストール
使用方法
利用できるコマンドを表示するには、次のコマンドを実行:
# reflector --help
サンプル
reflector(1) § EXAMPLES を参照してください。サンプルは /etc/pacman.d/mirrorlist
を上書きします。root として実行する必要があります。
自動化
Systemd サービス
サービスは、/etc/xdg/reflector/reflector.conf
で指定されたパラメータを使用し Reflector を実行します。このファイルのデフォルトのオプションは、例として示しています。
たとえば、HTTPS をサポートし、上書き /etc/pacman.d/mirrorlist
する最新の5つのミラーを日本とオーストラリアから選択するには、次のコマンドを使用します。
/etc/xdg/reflector/reflector.conf
--save /etc/pacman.d/mirrorlist --country Japan,Australia --protocol https --latest 5
reflector.service
を 有効化 すればミラーリストが起動時に更新されます。
Systemd タイマー
バージョン2020.8 以降、Reflector は systemd/タイマー (reflector.timer
) を提供しており、 Reflector#Systemd サービス reflector.service
を毎週開始します。スケジュールは reflector.timer
を 編集 することで変更できます。
まず、Reflector#Systemd サービス の説明に従って、設定ファイルを編集します。設定ファイルを更新した後、reflector.timer
を 有効化 してください。
ミラーリストをスケジュールより先に更新するには、reflector.service
を start してください。
Pacman フック
pacman-mirrorlist は定期的に更新されず、世界の一部のミラーが追加または削除されたという理由だけで reflector を呼び出します。代わりにタイマーベースの自動化を使いましょう。もし mirrorlist.pacnew
を全くインストールしたくない場合は、pacman.conf
で NoExtract
を使って下さい。