「Reflector」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(同期)
(序文を修正)
 
(4人の利用者による、間の14版が非表示)
12行目: 12行目:
 
{{Related|Pacman}}
 
{{Related|Pacman}}
 
{{Related articles end}}
 
{{Related articles end}}
[https://xyne.archlinux.ca/projects/reflector/ Reflector] は [https://www.archlinux.org/mirrors/status/ MirrorStatus] ページから最新のミラーリストを取得して、ミラーを速度でソートし、{{ic|/etc/pacman.d/mirrorlist}} ファイルを上書きするスクリプトです。
+
[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時点における最新版

関連記事

ReflectorArch Linux Mirror Status ページから最新のミラーリストを取得して、フィルタリングおよび速度でソートし、/etc/pacman.d/mirrorlist ファイルを上書きする Python スクリプトです。

インストール

reflector パッケージをインストールしてください。

使用方法

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

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

# reflector --help

サンプル

reflector(1) § EXAMPLES を参照してください。サンプルは /etc/pacman.d/mirrorlist を上書きします。root として実行する必要があります。​

ヒント: ワールドワイドサーバーを含めるには、country フラグに空の文字列を渡します。例えば、フランス、ドイツおよびワールドワイドミラーを含めるには、--country 'France,Germany,' を使用します。[1]

自動化

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有効化 すればミラーリストが起動時に更新されます。

ノート: reflector.service は、network-online.target を介して設定されるネットワーク待機サービスに依存します。

Systemd タイマー

バージョン2020.8 以降、Reflector は systemd/タイマー (reflector.timer) を提供しており、 Reflector#Systemd サービス reflector.service を毎週開始します。スケジュールは reflector.timer編集 することで変更できます。

まず、Reflector#Systemd サービス の説明に従って、設定ファイルを編集します。設定ファイルを更新した後、reflector.timer有効化 してください。

ミラーリストをスケジュールより先に更新するには、reflector.servicestart してください。

Pacman フック

pacman-mirrorlist は定期的に更新されず、世界の一部のミラーが追加または削除されたという理由だけで reflector を呼び出します。代わりにタイマーベースの自動化を使いましょう。もし mirrorlist.pacnew を全くインストールしたくない場合は、pacman.confNoExtract を使って下さい。

参照