# Formato de conexão do proxy: IP:PORTA:USUÁRIO:SENHA

> Formato de conexão do proxy IP:PORTA:USUÁRIO:SENHA: converta em URL, codifique caracteres especiais, leia TXT e CSV. RackProxies: 1 IP por linha, sem KYC, cripto.

- URL: https://rackproxies.com/pt/docs/connection-format/
- Última atualização: 2026-10-19
- Publisher: RackProxies (https://rackproxies.com)

Cada IP da RackProxies chega como uma linha com quatro campos. Veja como transformá-la no formato que sua ferramenta espera.

**Resposta rápida — O que é o formato de conexão do proxy?**

O formato de conexão do proxy na **RackProxies** é uma linha por IP: `IP:PORT:USERNAME:PASSWORD`, exportável como TXT ou CSV. A maioria das ferramentas quer uma URL: `http://USERNAME:PASSWORD@IP:PORT`, com os caracteres especiais da senha codificados em URL (`@` vira `%40`). Os planos começam a partir de US$ 1,29 por um IPv4 dedicado por 30 dias. Sem KYC, pagamento com cripto.

## Os quatro campos de uma linha

Linha de exemplo, com um endereço de documentação: `203.0.113.24:8000:USERNAME:PASSWORD`.

*Cada IP é entregue como uma linha IP:PORT:USERNAME:PASSWORD na sua conta, exportável como TXT ou CSV.*

| Posição | Campo | Exemplo | Observações |
| --- | --- | --- | --- |
| 1 | IP | 203.0.113.24 | O endereço IPv4 dedicado; também é o IP de saída que os sites veem |
| 2 | PORT | 8000 | A porta para conectar; use a listada para o protocolo que você usa |
| 3 | USERNAME | USERNAME | Login do proxy; não é necessário quando seu próprio IP está na allowlist |
| 4 | PASSWORD | PASSWORD | Senha do proxy; pode conter caracteres que precisam de codificação URL |

## Como converto uma linha em URL de proxy?

Mova o usuário e a senha para a frente, unidos por `:`, depois adicione `@`, o IP, `:` e a porta, e coloque um esquema na frente. A maioria das bibliotecas aceita este formato de URL.

| Uso | Formato | Exemplo |
| --- | --- | --- |
| Sites HTTP e HTTPS | `http://USERNAME:PASSWORD@IP:PORT` | `http://USERNAME:PASSWORD@203.0.113.24:8000` |
| SOCKS5, DNS no proxy | `socks5h://USERNAME:PASSWORD@IP:PORT` | `socks5h://USERNAME:PASSWORD@203.0.113.24:PORT` |
| Allowlist de IP, sem login | `http://IP:PORT` | `http://203.0.113.24:8000` |
| Ferramentas com campos separados | servidor, usuário, senha | `http://203.0.113.24:8000` + `USERNAME` + `PASSWORD` |

O esquema de um proxy HTTP é `http://` mesmo quando o site é `https://`: o esquema descreve a conexão com o proxy, e sites HTTPS passam por um túnel CONNECT. O [guia SOCKS5 vs HTTP](https://rackproxies.com/pt/guides/socks5-vs-http-proxies/) explica `socks5` e `socks5h`.

## Como faço a codificação URL de caracteres especiais na senha do proxy?

Substitua cada caractere reservado por `%` e seu código hexadecimal, ou deixe sua linguagem fazer isso: `urllib.parse.quote(password, safe='')` em Python, `encodeURIComponent(password)` em JavaScript. O RFC 3986 reserva esses caracteres porque eles separam as partes de uma URL. Um `@` não codificado em uma senha, por exemplo, faz a ferramenta ler o restante da senha como o host.

| Caractere | Codificado | Por que quebra uma URL |
| --- | --- | --- |
| `@` | `%40` | Separa o login do host |
| `:` | `%3A` | Separa o usuário da senha, e o host da porta |
| `/` | `%2F` | Inicia o path |
| `#` | `%23` | Inicia o fragmento |
| `?` | `%3F` | Inicia a query |
| `%` | `%25` | Inicia um caractere codificado |
| espaço | `%20` | Não é permitido em uma URL |

Só o usuário e a senha precisam disso. O IP e a porta nunca contêm caracteres reservados. Na linha `IP:PORT:USERNAME:PASSWORD` original nada é codificado, então divida-a apenas nos três primeiros dois-pontos: uma senha pode conter `:` nela mesma.

## Posso converter uma lista inteira de uma vez?

Sim. Exporte sua lista como TXT na sua conta, depois execute um dos scripts abaixo. Cada um lê `proxies.txt` (ou o arquivo que você passar), divide cada linha nos seus três primeiros dois-pontos, codifica o login e imprime uma URL HTTP e uma URL `socks5h://` por IP. Se sua conta lista uma porta SOCKS5 separada, use essa porta na URL SOCKS5.

*to_urls.py (Python 3, apenas biblioteca padrão)*

```python
"""Turn IP:PORT:USERNAME:PASSWORD lines into proxy URLs, with safe encoding."""
import sys
from urllib.parse import quote


def to_proxy_url(line, scheme='http'):
    # maxsplit=3 keeps a password that itself contains ':' in one piece
    ip, port, user, password = line.strip().split(':', 3)
    return f'{scheme}://{quote(user, safe="")}:{quote(password, safe="")}@{ip}:{port}'


path = sys.argv[1] if len(sys.argv) > 1 else 'proxies.txt'
with open(path, encoding='utf-8') as handle:
    for line in handle:
        if line.strip():
            print(to_proxy_url(line))                    # HTTP proxy URL
            print(to_proxy_url(line, scheme='socks5h'))  # SOCKS5, DNS on the proxy
```

*to_urls.mjs (Node.js 18 ou superior)*

```javascript
// Turn IP:PORT:USERNAME:PASSWORD lines into proxy URLs (Node.js 18 or later).
import { readFileSync } from 'node:fs';

function toProxyUrl(line, scheme = 'http') {
  const [ip, port, user, ...rest] = line.trim().split(':');
  const password = rest.join(':'); // a password may itself contain ':'
  return `${scheme}://${encodeURIComponent(user)}:${encodeURIComponent(password)}@${ip}:${port}`;
}

const lines = readFileSync(process.argv[2] ?? 'proxies.txt', 'utf8').split(/\r?\n/).filter(Boolean);
for (const line of lines) {
  console.log(toProxyUrl(line));
  console.log(toProxyUrl(line, 'socks5h'));
}
```

*Saída para uma senha contendo @, : e /*

```text
http://user-7:p%40ss%3Aw%2Frd%231@203.0.113.97:8000
socks5h://user-7:p%40ss%3Aw%2Frd%231@203.0.113.97:8000
```

## O que há nas exportações TXT e CSV?

A exportação TXT tem uma linha `IP:PORT:USERNAME:PASSWORD` por IP e nada mais, o que serve para scripts e ferramentas que importam listas de proxy. A exportação CSV contém ao menos IP, porta, usuário, senha, país e data de término, o que serve para planilhas e inventário.

Antes de ler o CSV em código, abra-o uma vez e confira a linha de cabeçalho para os nomes exatos das colunas; leia as colunas pelo nome, não pela posição. O `csv.DictReader` do Python faz isso. Mantenha os dois arquivos privados: eles contêm as senhas do seu proxy. Se um arquivo vazar, escreva para o suporte com os IPs afetados, nunca as senhas.

## Qual formato minha ferramenta espera?

A maioria das ferramentas quer o formato de URL ou campos separados:

- **curl:** `-x http://USERNAME:PASSWORD@IP:PORT`, ou `-x http://IP:PORT -U USERNAME:PASSWORD`.
- **Python requests e aiohttp:** o formato de URL; veja os [exemplos de código](https://rackproxies.com/pt/docs/code-examples/).
- **Node.js (undici, https-proxy-agent):** o formato de URL.
- **Playwright e navegadores:** campos separados: `server`, `username`, `password`.
- **Frameworks de scraping e gerenciadores de proxy:** muitas vezes a linha `IP:PORT:USERNAME:PASSWORD` bruta ou `USERNAME:PASSWORD@IP:PORT`; confira a tela de importação deles.

Com a allowlist de IP, todo formato dispensa o usuário e a senha: `IP:PORT` ou `http://IP:PORT`. Nome de usuário e senha, ou uma lista de IPs permitidos (até 10 IPs).

## Perguntas sobre formato de conexão

### Por que minha ferramenta lê a senha como parte do host?

Porque a senha contém `@`, `:` ou `/` e não foi codificada em URL. A ferramenta vê o primeiro `@` como o fim do login. Codifique a senha com `urllib.parse.quote(password, safe='')` em Python ou `encodeURIComponent(password)` em JavaScript, depois construa a URL novamente.

### A porta é a mesma para HTTP e SOCKS5?

Use a porta listada na sua conta para o protocolo que você quer. HTTP, HTTPS (CONNECT) e SOCKS5 são suportados em todo IP. Se sua conta mostra uma porta por IP, essa porta é a que deve usar; se mostra uma porta SOCKS5 separada, use essa nas URLs `socks5h://`.

### Por que recebo um erro 407 com uma linha que parece certa?

Procure primeiro por caracteres invisíveis: um espaço no final ou uma quebra de linha do Windows (`
`) copiada com a linha vira parte da senha. Depois verifique se os caracteres especiais estão codificados em URL e se a porta corresponde ao protocolo. Remova espaços de cada linha antes de dividi-la, como os scripts acima fazem com `strip()` e `trim()`.

### O CSV inclui o país e a data de término de cada IP?

Sim. A exportação CSV contém ao menos IP, porta, usuário, senha, país e data de término. Leia a linha de cabeçalho para os nomes exatos das colunas antes de analisá-la em código. A exportação TXT contém apenas as linhas `IP:PORT:USERNAME:PASSWORD`, o que serve para ferramentas que importam uma lista simples.

### Como fica a linha com a allowlist?

A linha continua a mesma na sua conta, mas você só precisa dos dois primeiros campos: `IP:PORT`, ou `http://IP:PORT` como URL. O proxy reconhece sua conexão pelo IP de origem, então nenhum usuário ou senha é enviado. Adicione o IP público de cada máquina que se conecta, até o limite da allowlist.

### Preciso de documento para obter uma lista de proxies?

Não. Sem KYC: sem documento, sem selfie, sem documentos para se cadastrar, recarregar ou comprar. Você paga em BTC, USDT, USDC, ETH, SOL, LTC, e a lista aparece na sua conta depois que o plano é comprado a partir do seu saldo confirmado. Um IP custa a partir de US$ 1,29 por 30 dias; veja [preços](https://rackproxies.com/pt/pricing/).

**Obtenha sua primeira linha** 1 IP por US$ 1,29. Sem KYC, pago com cripto. [Ver preços](https://rackproxies.com/pt/pricing/) · [Início rápido](https://rackproxies.com/pt/docs/quickstart/)

## Referências

1. [RFC 3986: Uniform Resource Identifier (URI): Generic Syntax](https://www.rfc-editor.org/rfc/rfc3986) — IETF (2026-10-19)
2. [urllib.parse.quote: biblioteca padrão do Python](https://docs.python.org/3/library/urllib.parse.html) — Python Software Foundation (2026-10-19)
3. [encodeURIComponent()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent) — MDN Web Docs (2026-10-19)
4. [curl man page (-x, -U)](https://curl.se/docs/manpage.html) — curl project (2026-10-19)
5. [RFC 5737: IPv4 Address Blocks Reserved for Documentation](https://www.rfc-editor.org/rfc/rfc5737) — IETF (2026-10-19)

---

RackProxies: A RackProxies é uma provedora de proxies de datacenter dedicados: endereços IPv4 alugados por IP por 30 dias, pagos com cripto sem envio de documento. As páginas cobrem 22 países e 34 cidades de datacenter com dados públicos de rede.