Como Configurar Proxy no Ubuntu e Debian, Camada por Camada
Pela equipe de engenharia da ProxyV4 · Updated:
Configurar um proxy no Ubuntu envolve, na prática, quatro etapas distintas, pois o Linux não possui uma chave única para proxy. O shell lê variáveis de ambiente, o APT consulta seu próprio diretório de configuração, os serviços do systemd utilizam drop-ins de unidade e a interface GNOME usa o gsettings. Configure apenas as camadas necessárias; os exemplos abaixo consideram um proxy HTTP(S) da ProxyV4 com usuário e senha.
export http_proxy=http://user:pass@ip:port https_proxy=http://user:pass@ip:port- 1 IPUS$ 1,85
- 3+ IPsUS$ 1,70
- 10+ IPsUS$ 1,60
- 25+ IPsUS$ 1,50
- 50+ IPsUS$ 1,40
- 100+ IPsUS$ 1,30
- 200+ IPsUS$ 1,20
- 500+ IPsUS$ 1,10
- 1 IPUS$ 1,85
- 3+ IPsUS$ 1,70
- 10+ IPsUS$ 1,60
- 25+ IPsUS$ 1,50
- 50+ IPsUS$ 1,40
- 100+ IPsUS$ 1,30
- 200+ IPsUS$ 1,20
- 500+ IPsUS$ 1,10
Configuração de proxy APT com usuário e senha
Para fazer o apt usar um proxy autenticado, crie /etc/apt/apt.conf.d/80proxy com o usuário e a senha dentro da URL do proxy. O APT lê este arquivo a cada execução, com ou sem sudo, e ignora as variáveis do seu shell:
sudo tee /etc/apt/apt.conf.d/80proxy > /dev/null << 'EOF'
Acquire::http::Proxy "http://USER:PASS@IP:PORT/";
Acquire::https::Proxy "http://USER:PASS@IP:PORT/";
EOF
sudo chmod 600 /etc/apt/apt.conf.d/80proxy
# verifique o que o APT usará e depois teste
apt-config dump | grep -i proxy
sudo apt updateCada linha deve terminar com ponto e vírgula, e qualquer senha contendo @, : ou # deve ser codificada em porcentagem (@ vira %40). Se o apt update parar em 407 Proxy Authentication Required, as credenciais no arquivo estão incorretas; consulte a página do erro 407.
APT através de um proxy SOCKS5
Versões recentes do APT (Ubuntu 18.04 ou superior) também aceitam uma URL SOCKS5 nas mesmas chaves, por exemplo Acquire::http::Proxy "socks5h://USER:PASS@IP:PORT";. A ordem deve estar no modo SOCKS5 ou dual, o que exclui IPs do Vietnã (apenas HTTP). Se a sua versão do APT recusar o esquema, use o formato HTTP acima.
Proxy para apenas um comando
Para testar sem alterar a configuração, passe a opção diretamente na linha de comando: sudo apt -o Acquire::http::Proxy="http://USER:PASS@IP:PORT/" update. Nada é salvo.
Qual arquivo controla cada programa
A maioria dos relatos de "meu proxy é ignorado" no Linux ocorre por definir o valor correto no local errado. Duas regras explicam quase todos os casos: o sudo descarta o ambiente do seu usuário por padrão, e serviços do systemd nunca leem o ~/.bashrc.
| Camada | Onde é definido | Quem lê | Duração |
|---|---|---|---|
| Shells de login | ~/.bashrc ou /etc/profile.d/proxy.sh | curl, wget, python, git, node | A cada novo shell de login |
| Sessões PAM | /etc/environment | Todas as sessões de usuário | Entre reinicializações |
| APT | /etc/apt/apt.conf.d/80proxy | apt update, apt install | Permanente, para o APT |
| Unidades do systemd | /etc/systemd/system/<svc>.service.d/proxy.conf | Daemon do Docker, seus próprios serviços | Após daemon-reload e reinicialização |
Variáveis de shell para curl, wget e scripts
Defina as variáveis em letras minúsculas e maiúsculas: curl e wget consultam http_proxy, enquanto outros ambientes só verificam HTTP_PROXY. A lista no_proxy mantém loopback e faixas privadas fora do proxy.
# /etc/profile.d/proxy.sh - shells e ferramentas CLI
sudo tee /etc/profile.d/proxy.sh > /dev/null << 'EOF'
export http_proxy="http://USER:PASS@IP:PORT"
export https_proxy="http://USER:PASS@IP:PORT"
export HTTP_PROXY="http://USER:PASS@IP:PORT"
export HTTPS_PROXY="http://USER:PASS@IP:PORT"
export no_proxy="localhost,127.0.0.1,::1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16"
export NO_PROXY="$no_proxy"
EOF
source /etc/profile.d/proxy.shCodifique caracteres especiais da senha em porcentagem aqui também. O APT possui seu próprio arquivo, descrito acima.
Serviços gerenciados pelo systemd
Um daemon iniciado pelo systemd visualiza apenas variáveis declaradas em sua própria unidade. Insira-as em um drop-in, recarregue e reinicie o serviço. O guia do Docker cobre o daemon do Docker e contêineres em detalhes.
# /etc/systemd/system/<svc>.service.d/proxy.conf
[Service]
Environment="HTTP_PROXY=http://USER:PASS@IP:PORT"
Environment="HTTPS_PROXY=http://USER:PASS@IP:PORT"
Environment="NO_PROXY=localhost,127.0.0.1"
sudo systemctl daemon-reload
sudo systemctl restart <svc>sudo, servidores compartilhados e interface gráfica
- sudo: execute
sudo -E curl ...para manter suas variáveis exportadas, ou torne isso permanente comDefaults env_keep += "http_proxy https_proxy HTTP_PROXY HTTPS_PROXY no_proxy NO_PROXY"adicionado viasudo visudo. - Credenciais em máquinas multiusuário: esses arquivos armazenam a senha do proxy em texto puro. Bloqueie as permissões, por exemplo com
sudo chmod 600 /etc/apt/apt.conf.d/80proxy. - Desktop GNOME: Configurações → Rede → Proxy de rede → Manual, ou
gsettings set org.gnome.system.proxy mode 'manual'junto com as chaves de host e porta emorg.gnome.system.proxy.http.
Testes e solução de problemas
Após recarregar o perfil, curl -s https://api.ipify.org deve exibir o IP do proxy em vez do endereço local do servidor. Para ver o relatório completo de país e operadora, cole o IP na consulta de IP. Os guias de curl e Python requests trazem alternativas por comando para quando não quiser usar proxy no shell inteiro.
- `407 Proxy Authentication Required`: credenciais erradas ou caractere especial não codificado na senha; consulte a página do erro 407.
- apt funciona apenas com sudo -E: o arquivo 80proxy não existe ou tem erro de sintaxe (cada linha precisa terminar com ponto e vírgula).
- Conexões travam: o tráfego de saída na porta do proxy pode estar bloqueado pelo firewall do servidor; confira causas de firewall.
Passo a passo
- 1
Dê ao APT seu próprio arquivo de proxy
Como o sudo apt update ignora as variáveis do shell, crie /etc/apt/apt.conf.d/80proxy com Acquire::http::Proxy e Acquire::https::Proxy, conferindo depois com apt-config dump.
- 2
Crie /etc/profile.d/proxy.sh
Exporte http_proxy, https_proxy e no_proxy em minúsculas e HTTP_PROXY, HTTPS_PROXY e NO_PROXY em maiúsculas para que qualquer ferramenta de CLI os encontre.
- 3
Adicione drop-ins do systemd onde for necessário
Para cada serviço que precise do proxy, crie um drop-in proxy.conf com as linhas Environment, execute daemon-reload e reinicie a unidade.
- 4
Confirme o IP de saída
Execute
source /etc/profile.d/proxy.she depoiscurl -s https://api.ipify.org; o retorno deve ser o endereço IP do seu proxy.
Perguntas frequentes
É realmente necessário definir http_proxy e HTTP_PROXY?
Sim. Utilitários como curl e wget utilizam variáveis minúsculas, enquanto outros reconhecem apenas maiúsculas. Configurar ambos evita falhas de conexão.
Por que o sudo apt update não utiliza o meu proxy?
O sudo limpa as variáveis de ambiente por segurança a menos que você utilize -E. Um arquivo em /etc/apt/apt.conf.d/ garante que o APT use o proxy sempre.
Como configuro o proxy na interface gráfica do Ubuntu?
Acesse Configurações → Rede → Proxy de rede e selecione Manual, ou ajuste via gsettings em org.gnome.system.proxy.
Vale a pena usar um proxy estático em um servidor Linux?
Sim, especialmente se uma API remota ou parceiro exigir liberação de IP em lista de permissões. Um IPv4 dedicado mantém o mesmo endereço a cada renovação, evitando bloqueios.
Fontes
Proxies de IP fixo para servidores e scripts
HTTP(S) com usuário e senha, tráfego ilimitado em IPv4 dedicado e o mesmo endereço mantido a cada renovação.
Comparar preços