Executando contêineres Docker atrás de um proxy HTTP autenticado
Pela equipe de engenharia da ProxyV4 · Updated:
A configuração de proxy no Docker começa com uma pergunta: qual tráfego deve passar pelo proxy? O Docker tem três caminhos distintos (sua aplicação em execução, o docker build e o daemon baixando imagens), e cada um lê o proxy de um local diferente. Ajuste isso corretamente e cada contêiner em um mesmo host poderá sair pelo seu próprio endereço IPv4 da ProxyV4, mantendo a tabela de roteamento do host intacta.
ENV 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
Três locais onde o Docker lê as configurações de proxy
Definir uma variável em um escopo não afeta os outros dois. Uma surpresa comum é ver o docker pull funcionando enquanto a aplicação dentro do contêiner ainda sai pelo IP do próprio host, ou o inverso.
| Tráfego | Onde configurar | Conteúdo típico |
|---|---|---|
| Sua aplicação dentro de um contêiner em execução | docker run -e HTTP_PROXY=... ou no bloco environment: do Compose | Requisições de scraper, chamadas de API, tarefas de automação |
Comandos durante o docker build | --build-arg HTTP_PROXY=http://user:pass@ip:port | Downloads via apt, pip e npm em etapas RUN |
| O próprio daemon do Docker | /etc/systemd/system/docker.service.d/http-proxy.conf | docker pull e docker push em registries |
Um IP por contêiner
Como as variáveis de runtime ficam no ambiente de cada contêiner, um único VPS pode executar, por exemplo, dez workers, onde cada um possui um valor de http://user:pass@ip:port diferente. Cada worker exibe seu próprio endereço de saída para os sites que visita e, como um IPv4 privado da ProxyV4 é alugado exclusivamente para um único cliente, o tráfego de mais ninguém compartilha esse endereço.
Mantenha um arquivo .env por serviço ou um serviço do Compose por proxy, permitindo identificar rapidamente qual IP pertence a cada tarefa. Ao renovar, você pode manter os mesmos endereços, sem precisar alterar nada nesses arquivos.
Variáveis que mantêm a stack funcionando
Se o docker pull ainda fizer conexão direta ou um contêiner não conseguir acessar seu próprio banco de dados após essas alterações, a página de proxy não funcionando analisa cada camada do Docker em ordem.
- Defina os nomes em maiúsculas (
HTTP_PROXY,HTTPS_PROXY,NO_PROXY) e em minúsculas (http_proxy,https_proxy,no_proxy); diferentes ferramentas e runtimes procuram por grafias distintas - Coloque em
NO_PROXYo nome de cada serviço do Compose que sua aplicação acessa, por exemploNO_PROXY=localhost,127.0.0.1,redis,postgres, para que o tráfego de banco de dados e cache permaneça na rede bridge em vez de ser enviado ao proxy - Use o esquema
http://também paraHTTPS_PROXY; o cliente abre um túnel CONNECT e os sites HTTPS continuam criptografados - Não escreva senhas de proxy em um
DockerfilecomENV: elas vão parar nas camadas da imagem. Injete-as em tempo de execução a partir do.envou do arquivo Compose
Passo a passo
- 1
Converta a linha do pedido em uma URL de proxy
Seu pedido da ProxyV4 lista
ip:port:user:pass; reescreva comohttp://user:pass@ip:port, manualmente ou com o conversor de formato de proxy. - 2
Adicione as variáveis ao serviço
No
docker-compose.yml, sob a seçãoenvironment:do serviço, definaHTTP_PROXY,HTTPS_PROXY,http_proxy,https_proxyeNO_PROXY=localhost,127.0.0.1,redis,db. - 3
Recrie o contêiner
Alterações de ambiente só se aplicam a novos contêineres, portanto execute
docker compose up -dpara recriar o serviço. - 4
Verifique o IP de saída a partir de dentro
Execute
docker exec -it <container> curl -s https://proxyv4.com/api/my-ip. O endereço retornado deve ser o IP do proxy, não o do host.
Perguntas frequentes
Após adicionar o HTTP_PROXY, minha aplicação não consegue acessar o Redis ou Postgres. Por quê?
O cliente HTTP agora está enviando requisições para redis ou db ao proxy externo, que não consegue resolver esses nomes internos. Liste-os em NO_PROXY (e no_proxy), por exemplo NO_PROXY=localhost,127.0.0.1,redis,db, e depois recrie o contêiner.
Cada contêiner em um mesmo servidor pode usar um proxy diferente?
Sim. Atribua a cada serviço, ou a cada arquivo .env, seu próprio valor http://user:pass@ip:port. Os contêineres compartilham o host, mas saem para a internet com IPs separados.
Por que definir as variáveis de proxy duas vezes, em maiúsculas e minúsculas?
Não há um padrão único. Ferramentas baseadas na libcurl leem http_proxy e https_proxy em minúsculas, enquanto muitas ferramentas em Go e Node leem os nomes em maiúsculas. Definir ambos cobre tudo dentro da imagem.
O docker pull usa as variáveis que defini no Compose?
Não. Os pulls são feitos pelo daemon, que lê seu proxy do drop-in do systemd em /etc/systemd/system/docker.service.d/http-proxy.conf, e não dos ambientes dos contêineres.
Fontes
Um IPv4 privado dedicado para cada contêiner
IPv4 privado ilimitado em 7 países, além de ISP estático nos EUA e Vietnã, liberado automaticamente após o pagamento. Sem pedido mínimo.
Ver preços ao vivo de Singapura