apt-transport-mirror - リファレンスマニュアル、オプション、コマンド例


名前

apt-transport-mirror - より自動化されたミラー選択のための APT トランスポート

説明

この APT トランスポートは、独自にローカルまたはリモート リポジトリにアクセスするためのプロトコルを実装していませんが、ミラーリストを取得し、すべてのリクエストをこのリストから選択されたミラーにリダイレクトし、apt-transport-http などの他のトランスポート経由でミラーにアクセスします。 (1)。基本機能は apt 0.7.24 から利用可能ですが、トランスポートとそのサポートされる機能が完全に作り直された apt 1.6 まで文書化されていませんでした。トランスポートはユーザーによって直接呼び出されることはなく、ユーザー構成に基づいて APT ツールによって使用されることに注意してください。

ミラーを介したファイルの取得が失敗した場合、このメソッドは、ファイルが取得されるかリストにミラーが残らなくなるまで、リストから別の可能なミラーを自動的に試行し、サーバーのダウンタイムや同様の問題を透過的に処理します。

トランスポートのセキュリティへの影響は、ミラーリストの取得に使用されるトランスポートと、トランスポートによる選択されたミラーへのアクセスに関連するトランスポートに関連するセキュリティ上の考慮事項によって異なります。

オプション

現在、このトランスポートには構成オプションがありません。ミラーの選択は、ミラーリストで提供されるミラーと、APT が取得する必要があるファイルに完全に基づいて行われます。

ミラーリスト形式

ミラーリストには、ミラーの URI を指定する 1 つ以上の行が含まれます。空行とハッシュ文字 (#) で始まる行は無視されます。 URI は常に、このミラーに使用されるトランスポートを定義する URI スキームで始まります。たとえば、URI が http:で始まる場合、責任のあるトランスポートはapt-transport-http(1) となり、URI の残りの部分の形式に特定の要件が必要になる場合があります。

ミラーに関するメタデータは、URI とタブで区切って同じ行に指定できます。メタデータの複数の項目自体は、タブまたはスペースで区切ることができます。 (これは、apt 1.6 以上でのみ利用できる高度な機能です。以前の apt バージョンでは、この機能を使用したミラーリストの解析に失敗します。)

apt 1.6 以降、圧縮ミラーリストの使用もサポートされています。ミラーリストのファイル名では、使用する圧縮アルゴリズムを指定する必要があることに注意してください。ファイルの内容に基づく自動検出はありません。

メタデータによるミラー選択

形式で指定されているように、ミラーには追加のメタデータを添付して、このメタデータと一致しないファイルを取得するためにミラーが選択されるのを防ぐことができます。このようにして、ミラーリストは次のようにすることができます。特定のアーキテクチャのみを提供する部分ミラーが含まれており、APT はリストにないアーキテクチャを必要とするファイルに対して別のミラーを自動的に選択します。サポートされているのは、アーキテクチャの制限 (arch)、リリースのコード名 (codename)、ファイルが存在するリポジトリのコンポーネント (component)、ファイルが適用される言語 (lang)、リリースのスイート名 (suite)、およびファイル(タイプ)。

ミラーのフォールバック順序

メタデータ キーの優先順位によってミラーに優先順位が指定されていない場合、ミラーに接続される順序はランダムになります。特定のミラー セットを別のセットを試行する前に最初に試行する必要がある場合は、優先順位を明示的に設定できます。最小番号のミラーが最初に試行されます。明示的な優先順位が設定されていないミラーは、デフォルトで可能な最大の番号が設定されるため、最後に試行されます。同じ優先度を持つミラー間の選択は、やはりランダムです。

ミラーリストで許可されるトランスポート

ミラーリスト内のトランスポートの可用性と選択は、APT クライアントがミラーリストにアクセスする方法によって制限されます。ファイルやコピーなどのローカル トランスポートが使用されている場合、ミラーリストにはローカル ソースも含めることができますが、http 経由でアクセスされるミラーリストには含めることができません。さらに、ミラーリストには、ミラーリストや他のラッピング トランスポート (apt-transport-tor など) を含めることはできません。ミラー方式でこれらのトランスポートを使用する方法については、これらのトランスポートのドキュメントを参照してください。

1.6 より前の apt バージョンは http 以外のトランスポートをサポートしていないことに注意してください。

例

基本的な例

クライアントが 3 つのミラーのいずれかを選択するミラー メソッド (>= 0.7.24) を備えたすべての apt バージョンでサポートされている基本的なミラーリストの例:

http://ftp.de.debian.org/debian/
http://ftp.us.debian.org/debian/
http://deb.debian.org/debian/

このコンテンツを含むファイルがマシン上に /etc/apt/mirrorlist.txt として保存されていると仮定すると、sources.list(5) (apt 1.6 以降) で次のように使用できます。

deb mirror+file:/etc/apt/mirrorlist.txt bookworm main

ミラー メソッドのすべてのバージョンは、HTTP 経由でアクセスできるミラーリストをサポートしているため、http://apt.example.org/mirror.lst で入手できると仮定すると、上記のsources.list エントリは代わりに次のように記述できます。

deb mirror://apt.example.org/mirror.lst bookworm main

apt 1.6 以降は、均一性を保つためにミラーよりもミラー + http の使用を優先する必要があることに注意してください。機能は同じです。

メタデータで強化されたミラー選択の例

フォーマット定義で説明したように、1.6 より前の apt バージョンはこれをサポートしておらず、ミラーリストの解析に失敗します。ミラーリストの例は、選択のいくつかの側面を示すために意図的に複雑になっています。次のセットアップが想定されています。 最初のミラーは、ファイル メソッド経由でアクセスできるローカル ミラーですが、不完全な可能性があります。 2 番目のミラーには優れた接続がありますが、amd64 などのアーキテクチャに関連するファイルのみが含まれているという点では部分的なミラーです。残りのミラーは平均的なミラーであり、以前のミラーが機能しなかった場合にのみ連絡する必要があります。

file:/srv/local/debian/mirror/	priority:1 type:index
http://partial.example.org/mirror/	priority:2 arch:amd64 arch:all type:deb
http://ftp.us.debian.org/debian/	type:deb
http://ftp.de.debian.org/debian/	type:deb
https://deb.debian.org/debian/

このミラーリストを使用したセットアップでは、ミラーリスト自体がファイルのようなローカル トランスポート経由でアクセスされることを前提として、最初のミラーを使用してすべてのインデックス ファイルがダウンロードされます。そうでない場合、ミラーにアクセスできない場合、または要求されたファイルがミラーに含まれていない場合は、ファイルのタイプに応じて選択される別のミラーがファイルの取得に使用されます。インデックス ファイルは、インデックス ファイルの最後のミラーによって提供されます。アーキテクチャ amd64 のパッケージは 2 番目のパッケージと、たとえば 2 番目のパッケージによって提供されます。最後の 3 つのうちの 1 つによるアーキテクチャ i386。

バグ

APT バグページ[1]。 APT のバグを報告したい場合は、/usr/share/doc/debian/bug-reporting.txt またはreportbug(1) コマンドを参照してください。

著者

APT チーム

ノート

1. APT バグページ: http://bugs.debian.org/src:apt