apt-transport-http - manual de referência, opções, exemplos de comandos


NOME

apt-transport-http - Transporte APT para download via Hypertext Transfer Protocol (HTTP)

DESCRIÇÃO

Este transporte APT permite o uso de repositórios acessados via Hypertext Transfer Protocol (HTTP). Ele está disponível por padrão e provavelmente o mais usado de todos os transportes. Observe que um transporte nunca é chamado diretamente por um usuário, mas usado por ferramentas APT com base na configuração do usuário.

HTTP é um protocolo de transporte não criptografado, o que significa que toda a comunicação com o servidor remoto (ou proxy) pode ser observada por um invasor suficientemente capaz, comumente referido como "man in the middle" (MITM). No entanto, tal invasor não pode modificar a comunicação para comprometer a segurança do seu sistema, pois o modelo de segurança de dados do APT é independente do método de transporte escolhido. Isso é explicado em detalhes em apt-secure(8). Uma visão geral dos métodos de transporte disponíveis é fornecida em sources.list(5).

OPÇÕES

Várias opções podem ser definidas em um arquivo apt.conf(5) para modificar seu comportamento, variando de configuração de proxy a soluções alternativas para limitações específicas do servidor.

Configuração de Proxy

A variável de ambiente http_proxy é suportada para configuração de todo o sistema. Proxies específicos para APT podem ser configurados através da opção Acquire::http::Proxy. Proxies que devem ser usados somente para certos hosts podem ser especificados via Acquire::http::Proxy::host. Um controle ainda mais refinado pode ser obtido por meio da detecção automática de proxy, detalhada mais abaixo. Todas essas opções usam o formato URI scheme://[[user][:pass]@]host [:porta]/. Os esquemas de URI suportados são meias5h (SOCKS5 com resolução DNS remota), http e https. Os detalhes de autenticação podem ser fornecidos via apt_auth.conf(5) em vez de incluí-los diretamente no URI.

As várias opções de configuração do APT suportam o valor especial DIRECT, o que significa que nenhum proxy deve ser usado. A variável de ambiente no_proxy também é suportada para o mesmo propósito.

Além disso, há três configurações fornecidas para controle de cache com caches de proxy compatíveis com HTTP/1.1: Acquire::http::No-Cache informa ao proxy para não usar sua resposta em cache em nenhuma circunstância. Acquire::http::Max-Age define a idade máxima permitida (em segundos) de um arquivo de índice no cache do proxy. Acquire::http::No-Store especifica que o proxy não deve armazenar os arquivos compactados solicitados em seu cache, o que pode ser usado para evitar que o proxy polua seu cache com (grandes) arquivos .deb.

Configuração Automática de Proxy

Acquire::http::Proxy-Auto-Detect pode ser usado para especificar um comando externo para descobrir o proxy HTTP a ser usado. O primeiro e único parâmetro é um URI que indica o host a ser contatado, para permitir a configuração específica do host. O APT espera que o comando gere o proxy em stdout como uma única linha no formato URI especificado anteriormente ou a palavra DIRECT se nenhum proxy deve ser usado. Nenhuma saída indica que as configurações genéricas de proxy devem ser usadas.

Observe que a detecção automática não será usada para um host se uma configuração de proxy específica do host já estiver definida por meio de Acquire::http::Proxy::host.

Veja os pacotes squid-deb-proxy-client(1) e auto-apt-proxy(1) para exemplos de implementações.

Esta opção tem precedência sobre o nome da opção herdada Acquire::http::ProxyAutoDetect.

Configuração de conexão

A opção Acquire::http::Timeout define o timer de timeout usado pelo método; esse valor se aplica à conexão, bem como ao tempo limite de dados.

A largura de banda usada pode ser limitada com Acquire::http::Dl-Limit que aceita valores inteiros em kilobytes por segundo. O valor padrão é 0 que desativa o limite e tenta usar toda a largura de banda disponível. Observe que esta opção desativa implicitamente o download de vários servidores ao mesmo tempo.

A configuração Acquire::http::Pipeline-Depth pode ser usada para ativar o pipelining HTTP (RFC 2616 seção 8.1.2.2) que pode ser benéfico, por exemplo, em conexões de alta latência. Ele especifica quantas solicitações são enviadas em um pipeline. O APT tenta detectar e contornar servidores web e proxies que se comportam mal em tempo de execução, mas se você souber que o seu não está em conformidade com a especificação HTTP/1.1, o pipelining pode ser desativado definindo o valor como 0. Ele é ativado por padrão com o valor 10 .

Acquire::http::AllowRedirect controla se o APT seguirá os redirecionamentos, que é ativado por padrão.

Acquire::http::User-Agent pode ser usado para definir um User-Agent diferente para o método de download http, pois alguns proxies permitem acesso para clientes somente se o cliente usar um identificador conhecido.

Acquire::http::SendAccept é ativado por padrão e envia um campo de cabeçalho Accept: text/* para o servidor para solicitações sem extensões de arquivo para evitar que o servidor tente negociação de conteúdo.

EXEMPLOS

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";
};

VEJA TAMBÉM

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

INSETOS

Página de bug do APT[1]. Se você deseja reportar um bug no APT, por favor veja /usr/share/doc/debian/bug-reporting.txt ou o comando reportbug(1).

AUTOR

Equipe APT

NOTAS

1. Página de bug do APT: http://bugs.debian.org/src:apt