'\" t
.\" Title: apt-transport-http
.\" Author: Equipa do APT
.\" Generator: DocBook XSL Stylesheets vsnapshot
.\" Date: 04\ \&Abril\ \&2019
.\" Manual: APT
.\" Source: APT 2.9.5
.\" Language: Portuguese
.\"
.TH "APT\-TRANSPORT\-HTTP" "1" "04\ \&Abril\ \&2019" "APT 2.9.5" "APT"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NOME"
apt-transport-http \- Transporte do APT para descarregar via Hypertext Transfer Protocol (HTTP)
.SH "DESCRI\(,C\(~AO"
.PP
Este transporte do APT permite o uso de reposit\('orios acedidos via Hypertext Transfer Protocol (HTTP)\&. Est\('a dispon\('ivel por predefini\(,c\(~ao e \('e provavelmente o mais usado de todos os transportes\&. Note que um transporte nunca chamado directamente por um utilizador mas \('e usado pelas ferramentas do APT baseadas na configura\(,c\(~ao do utilizador\&.
.PP
HTTP \('e um protocolo de transporte n\(~ao encriptado o que significa que toda a comunica\(,c\(~ao com o servidor remoto (ou proxy) pode ser observada por um atacante com capacidades suficientes que geralmente \('e referido por "man in the middle" (MITM)\&. No entanto, tal atacante
\fIn\(~ao\fR
consegue modificar a comunica\(,c\(~ao para comprometer a seguran\(,ca do seu sistema, pois o modelo de seguran\(,ca dos dados do APT \('e independente do m\('etodo de transporte escolhido\&. Isto est\('a explicado em detalhe em
\fBapt-secure\fR(8)\&. Uma vis\(~ao geral dos m\('etodos de transporte dispon\('iveis \('e dada em
\fBsources.list\fR(5)\&.
.SH "OP\(,C\(~OES"
.PP
V\('arias op\(,c\(~oes podem ser definidas num ficheiro
\fBapt.conf\fR(5)
para modificar este comportamento, indo de configura\(,c\(~ao de proxy at\('e maneiras de contornar limita\(,c\(~oes espec\('ificas de servidores\&.
.SS "Configura\(,c\(~ao do Proxy"
.PP
A vari\('avel de ambiente
\fBhttp_proxy\fR
\('e suportada pela configura\(,c\(~ao de todo o sistema\&. Proxies espec\('ificos para o APT podem ser configurados via op\(,c\(~ao
Acquire::http::Proxy\&. Proxies que devem ser usados apenas para certas m\('aquinas podem ser especificados via
Acquire::http::Proxy::\fIm\('aquina\fR\&. At\('e um controle mais afinado pode ser obtido via auto\-detec\(,c\(~ao de proxy, detalhado mais abaixo\&. Todas estas op\(,c\(~oes usam o formato URI
\fIesquema\fR://[[\fIutilizador\fR][:\fIpalavra\-passe\fR]@]\fImaquina\fR[:\fIporto\fR]/\&. OS esquemas URI suportados s\(~ao
socks5h
(SOCKS5 com resolu\(,c\(~ao DNS remota),
http
e
https\&. Os detalhes de autentica\(,c\(~ao podem ser fornecidos via
\fBapt_auth.conf\fR(5)
em vez de os incluir directamente no URI\&.
.PP
as v\('arias op\(,c\(~oes de configura\(,c\(~ao do APT suportam o valor especial
DIRECT
significando que nenhum proxy dever\('a ser usado\&. A vari\('avel de ambiente
\fBno_proxy\fR
\('e tamb\('em suportada para o mesmo objectivo\&.
.PP
Mais ainda, existem tr\(^es defini\(,c\(~oes disponibilizadas para controle de cache como caches de proxy compat\('iveis com HTTP/1\&.1\&.
Acquire::http::No\-Cache
diz ao proxy para n\(~ao usar a sua resposta em cache sob nenhumas circunst\(^ancias,
Acquire::http::Max\-Age
define a idade m\('axima permitida (em segundos) de um ficheiro \('indice na cache do proxy\&.
Acquire::http::No\-Store
especifica que o proxy n\(~ao deve armazenar os ficheiros de arquivo pedidos na sua cache, o que pode ser usado para prevenir que o proxy polua a sua cache com (grandes) ficheiros \&.deb\&.
.SS "Configura\(,c\(~ao do Proxy Autom\('atica"
.PP
Acquire::http::Proxy\-Auto\-Detect
pode ser usado para especificar um comando externo para descobrir o proxy HTTP a usar\&. O primeiro e \('unico par\(^ametro \('e um URL que aponta para a m\('aquina a contactar para permitir uma configura\(,c\(~ao espec\('ifica para essa m\('aquina\&. O APT espera que o comando forne\(,ca o resultado do proxy no stdout numa \('unica linha no formato URI anteriormente especificado ou a palavra
DIRECT
se n\(~ao dever\('a ser usado nenhum proxy\&. Nenhum resultado fornecido indica que devem ser usadas as defini\(,c\(~oes de proxy gen\('ericas\&.
.PP
Note que a auto\-detec\(,c\(~ao n\(~ao ser\('a usada para uma m\('aquina se uma configura\(,c\(~ao de proxy espec\('ifica de m\('aquina j\('a estiver definida via
Acquire::http::Proxy::\fIm\('aquina\fR\&.
.PP
Veja os pacotes
\fBsquid-deb-proxy-client\fR(1)
e
\fBauto-apt-proxy\fR(1)
para exemplos de implementa\(,c\(~oes\&.
.PP
Esta op\(,c\(~ao toma preced\(^encia sobre a op\(,c\(~ao antiga de nome
Acquire::http::ProxyAutoDetect\&.
.SS "Configura\(,c\(~ao de Liga\(,c\(~ao"
.PP
A op\(,c\(~ao
Acquire::http::Timeout
define o tempo limite usado por este m\('etodo, este valor aplica\-se \(`a liga\(,c\(~ao assim como os tempos de limite de dados\&.
.PP
A largura de banda usada pode ser limitada com
Acquire::http::Dl\-Limit
que aceita valores inteiros em kilobytes por segundo\&. O valor predefinido \('e 0 que desactiva o limite e tenta usar toda a largura de banda dispon\('ivel\&. Note que esta op\(,c\(~ao implicitamente desactiva a descarga a partir de m\('ultiplos servidores ao mesmo tempo\&.
.PP
A defini\(,c\(~ao
Acquire::http::Pipeline\-Depth
pode ser usada para activar o \*(Aqpipelining\*(Aq de HTTP (RFC 2616 sec\(,c\(~ao 8\&.1\&.2\&.2) a qual pode ser ben\('efica por exemplo em liga\(,c\(~oes de alta lat\(^encia\&. Especifica quantos pedidos s\(~ao enviados num pipeline\&. O APT tenta detectar e contornar servidores web e proxies com comportamentos impr\('oprios durante a sua execu\(,c\(~ao, mas se voc\(^e sabe que o seu n\(~ao est\('a em conformidade com a especifica\(,c\(~ao HTTP/1\&.1, a liga\(,c\(~ao via pipe pode ser desactivada ao definir o valor para 0\&. Por predefini\(,c\(~ao est\('a activado com o valor 10\&.
.PP
Acquire::http::AllowRedirect
controla se o APT ir\('a seguir os redirecionamentos, o que est\('a activo por predefini\(,c\(~ao\&.
.PP
Acquire::http::User\-Agent
pode ser usado para definir um Utilizador\-Agente diferente para o m\('etodo de download por http, porque alguns proxies apenas permitem acesso a clientes se o cliente usar um identificador conhecido\&.
.PP
Acquire::http::SendAccept
est\('a activa por predefini\(,c\(~ao e envia um campo de cabe\(,calho
Accept: text/*
para o servidor para pedidos sem extens\(~ao do ficheiro para prevenir que o servidor tente negocia\(,c\(~ao de conte\('udo\&.
.SH "EXEMPLOS"
.sp
.if n \{\
.RS 4
.\}
.nf
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";
};
.fi
.if n \{\
.RE
.\}
.SH "VEJA TAMB\('EM"
.PP
\fBapt.conf\fR(5)
\fBapt_auth.conf\fR(5)
\fBsources.list\fR(5)
.SH "BUGS"
.PP
\m[blue]\fBp\('agina de bugs do APT\fR\m[]\&\s-2\u[1]\d\s+2\&. Se deseja reportar um bug no APT, por favor veja
/usr/share/doc/debian/bug\-reporting\&.txt
ou o comando
\fBreportbug\fR(1)\&.
.SH "TRADU\(,C\(~AO"
.PP
A tradu\(,c\(~ao Portuguesa foi feita por Am\('erico Monteiro
de 2009 a 2012\&. A tradu\(,c\(~ao foi revista pela equipa de tradu\(,c\(~oes portuguesas da Debian
\&.
.PP
Note que este documento traduzido pode conter partes n\(~ao traduzidas\&. Isto \('e feito propositadamente, para evitar perdas de conte\('udo quando a tradu\(,c\(~ao est\('a atrasada relativamente ao conte\('udo original\&.
.SH "AUTOR"
.PP
\fBEquipa do APT\fR
.RS 4
.RE
.SH "NOTAS"
.IP " 1." 4
p\('agina de bugs do APT
.RS 4
\%https://bugs.debian.org/src:apt
.RE