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


名前

apt-transport-http - ハイパーテキスト転送プロトコル (HTTP) 経由でダウンロードするための APT トランスポート

説明

この APT トランスポートにより、ハイパーテキスト転送プロトコル (HTTP) 経由でアクセスされるリポジトリの使用が可能になります。これはデフォルトで利用可能であり、おそらくすべてのトランスポートの中で最もよく使用されます。トランスポートはユーザーによって直接呼び出されることはなく、ユーザー構成に基づいて APT ツールによって使用されることに注意してください。

HTTP は暗号化されていないトランスポート プロトコルであり、リモート サーバー (またはプロキシ) との通信全体が、一般に「中間者」(MITM) と呼ばれる十分に能力のある攻撃者によって監視される可能性があることを意味します。ただし、APT のデータ セキュリティ モデルは選択された転送方法に依存しないため、そのような攻撃者が通信を変更してシステムのセキュリティを侵害することはできません。これについてはapt-secure(8) で詳しく説明されています。利用可能な転送方法の概要はsources.list(5) に記載されています。

オプション

apt.conf(5) ファイルにさまざまなオプションを設定して、プロキシ設定から特定のサーバー制限の回避策に至るまで、その動作を変更できます。

プロキシ構成

環境変数 http_proxy はシステム全体の設定でサポートされています。 APT に固有のプロキシは、Acquire::http::Proxy オプションを使用して設定できます。特定のホストにのみ使用するプロキシは、Acquire::http::Proxy::host 経由で指定できます。以下で詳しく説明するプロキシ自動検出を使用すると、さらにきめ細かい制御を実現できます。これらのオプションはすべて、URI 形式 scheme://[[user][:pass]@]host を使用します。 [:ポート]/。サポートされている URI スキームは、socks5h (リモート DNS 解決を備えた SOCKS5)、http、および https です。認証の詳細は、URI に直接含めるのではなく、apt_auth.conf(5) を介して指定できます。

さまざまな APT 構成オプションは、プロキシを使用しないことを意味する特別な値 DIRECT をサポートしています。環境変数 no_proxy も同じ目的でサポートされています。

さらに、HTTP/1.1 準拠のプロキシ キャッシュによるキャッシュ制御には 3 つの設定が提供されています。 Acquire::http::No-Cache は、いかなる状況でもキャッシュされた応答を使用しないようにプロキシに指示します。 Acquire::http::Max-Age は、プロキシのキャッシュ内のインデックス ファイルの許容最大存続期間 (秒単位) を設定します。 Acquire::http::No-Store は、プロキシが要求されたアーカイブ ファイルをキャッシュに保存しないことを指定します。これは、プロキシが (大きな) .deb ファイルでキャッシュを汚染するのを防ぐために使用できます。

自動プロキシ構成

Acquire::http::Proxy-Auto-Detect を使用して、使用する HTTP プロキシを検出する外部コマンドを指定できます。最初で唯一のパラメータは、ホスト固有の構成を可能にするために、接続するホストを示す URI です。 APT は、コマンドが事前に指定された URI 形式で 1 行として標準出力にプロキシを出力することを期待します。プロキシを使用しない場合は DIRECT という単語を出力します。出力がない場合は、一般的なプロキシ設定を使用する必要があることを示します。

ホスト固有のプロキシ構成が Acquire::http::Proxy::host 経由ですでに設定されている場合、ホストには自動検出が使用されないことに注意してください。

実装例については、squid-deb-proxy-client(1) および auto-apt-proxy(1) パッケージを参照してください。

このオプションは、従来のオプション名 Acquire::http::ProxyAutoDetect よりも優先されます。

接続構成

Acquire::http::Timeout オプションは、メソッドで使用されるタイムアウト タイマーを設定します。この値は、接続およびデータ タイムアウトに適用されます。

使用される帯域幅は、1 秒あたりのキロバイト単位の整数値を受け入れる Acquire::http::Dl-Limit を使用して制限できます。デフォルト値は 0 で、制限が無効になり、利用可能な帯域幅をすべて使用しようとします。このオプションは、複数のサーバーからの同時にダウンロードを暗黙的に無効にすることに注意してください。

Acquire::http::Pipeline-Depth 設定を使用すると、HTTP パイプライン (RFC 2616 セクション 8.1.2.2) を有効にすることができます。高遅延接続の場合。パイプラインで送信されるリクエストの数を指定します。 APT は、実行時に誤動作する Web サーバーとプロキシを検出して回避しようとしますが、Web サーバーとプロキシが HTTP/1.1 仕様に準拠していないことがわかっている場合は、値を 0 に設定することでパイプラインを無効にすることができます。値 10 でデフォルトで有効になります。 。

Acquire::http::AllowRedirect は、APT がリダイレクトに従うかどうかを制御します。これはデフォルトで有効になっています。

一部のプロキシでは、クライアントが既知の識別子を使用する場合にのみクライアントのアクセスを許可するため、Acquire::http::User-Agent を使用して http ダウンロード メソッドに別のユーザー エージェントを設定できます。

Acquire::http::SendAccept はデフォルトで有効になっており、ファイル拡張子のないリクエストに対して Accept: text/* ヘッダー フィールドをサーバーに送信して、サーバーがコンテンツ ネゴシエーションを試行するのを防ぎます。

例

Acquire::http {
	Proxy::example.org "DIRECT";
	Proxy "socks5h://apt:pass@127.0.0.1:9050";
	Proxy-Auto-Detect "/usr/local/bin/apt-http-proxy-auto-detect";
	No-Cache "true";
	Max-Age "3600";
	No-Store "true";
	Timeout "10";
	Dl-Limit "42";
	Pipeline-Depth "0";
	AllowRedirect "false";
	User-Agent "My APT-HTTP";
	SendAccept "false";
};

関連項目

apt.conf(5) apt_auth.conf(5) sources.list(5)

バグ

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

著者

APT チーム

ノート

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