Toda credencial de proxy tem quatro partes. Entender o papel de cada uma resolve a maioria dos problemas de acesso antes de eles acontecerem.
As quatro informações
| Campo | O que é | Exemplo |
|---|---|---|
| Host | Endereço do servidor de proxy | p1.exemplo.com |
| Porta | Porta correspondente ao protocolo | 8000 |
| Usuário | Identificador da sua credencial | pbx_a1b2c3 |
| Senha | Chave de acesso | xY7k... |
Host e porta dizem para onde conectar. Usuário e senha provam que você tem direito de usar aquele proxy.
Onde encontrar no painel
Acesse Meus proxies e abra o proxy desejado. A tela mostra os quatro campos com botão de cópia individual, além de formatos prontos para colar.
Use sempre o botão de cópia. Selecionar com o mouse é a causa número um de espaço em branco colado no fim da credencial — e um espaço invisível gera exatamente a mesma mensagem de erro que uma senha errada.
Formatos por tipo de ferramenta
Diferentes ferramentas esperam a credencial de formas diferentes. Os quatro formatos mais pedidos:
Campos separados — navegadores antidetecção, clientes gráficos:
Host: p1.exemplo.com
Porta: 8000
Usuário: pbx_a1b2c3
Senha: sua-senha
String com dois-pontos — importação em lote:
p1.exemplo.com:8000:pbx_a1b2c3:sua-senha
URL de conexão — bibliotecas HTTP, variáveis de ambiente:
http://pbx_a1b2c3:[email protected]:8000
socks5://pbx_a1b2c3:[email protected]:8000
Variáveis de ambiente — containers, scripts, CI:
export HTTP_PROXY="http://pbx_a1b2c3:[email protected]:8000"
export HTTPS_PROXY="http://pbx_a1b2c3:[email protected]:8000"
export NO_PROXY="localhost,127.0.0.1"
O painel oferece esses formatos com botão de cópia, para você não precisar montar a string à mão.
Caracteres especiais na senha
Se a senha contém caracteres como @, :, / ou #, e você a coloca dentro de uma URL, ela precisa ser codificada. O @ é o caso crítico: ele é justamente o separador entre credencial e host, então uma senha com @ quebra a URL.
Codificações mais comuns:
| Caractere | Codificado |
|---|---|
@ |
%40 |
: |
%3A |
/ |
%2F |
# |
%23 |
| espaço | %20 |
Em campos separados isso não é necessário — o problema só existe no formato de URL.
Por que usamos credencial e não autorização por IP
Autorização por IP significa cadastrar previamente os endereços que podem usar o proxy. É mais restritivo, mas tem um custo prático alto: cada vez que você troca de rede — sai do escritório, usa 4G, sobe uma VPS nova — precisa cadastrar o novo endereço antes de conseguir conectar.
Com autenticação por credencial, o mesmo proxy funciona de casa, do celular, de um servidor e de uma máquina virtual, sem cadastro prévio. Para operações que rodam em mais de um lugar, a diferença de conveniência é grande.
Erros de acesso e o que significam
407 Proxy Authentication Required — usuário ou senha errados, ausentes ou com espaço extra. Recopie do painel.
Conexão recusada — não é autenticação. É host ou porta incorretos, ou porta que não corresponde ao protocolo selecionado.
Timeout — a requisição não chegou ao proxy. Pode ser firewall local, rede corporativa bloqueando a porta, ou host digitado errado.
Funciona em uma ferramenta e falha em outra — quase sempre formato. A ferramenta que falha provavelmente espera um formato diferente do que você colou.
Parou de funcionar de repente — verifique se o plano está vigente e se a senha foi alterada no painel sem atualizar as ferramentas.
Boas práticas
- Trate a credencial como senha: ela dá acesso ao seu proxy e ao seu consumo
- Não compartilhe em grupo ou canal aberto
- Se precisa dar acesso a alguém do time, prefira criar um proxy separado a compartilhar o mesmo
- Ao encerrar um contrato de terceiro, troque a senha pelo painel
- Em repositório de código, use variável de ambiente — nunca credencial no arquivo versionado