Desenvolvedores
Para qual protocolo apontar um cliente e qual esquema, socks5 ou socks5h, definir nele depois que o proxy for alternado.
O SOCKS5 é um protocolo de proxy na camada de transporte: ele abre uma conexão em seu nome e move bytes, sem ler nem reescrever o que há dentro deles. Todo proxy ISP estático que vendemos pode ser alternado entre HTTP e SOCKS5 no pedido que você já possui.
Trocar de protocolo não é um produto diferente: você troca o proxy que já possui, pelo painel ou pela API, e o pedido é atualizado com a nova porta e as novas credenciais para conectar.
Em resumo: O SOCKS5 é um protocolo de proxy, não um tipo de endereço: ele repassa uma conexão TCP sem ler nem reescrever o que há dentro. Todo proxy residencial estático (ISP) vendido pela ProxyJam funciona em HTTP, que transporta HTTPS, ou em SOCKS5, e você alterna entre eles no pedido que já possui; depois da troca, conecte com a porta e as credenciais que o pedido mostra.
O SOCKS5 transporta tudo para o que o seu cliente consegue abrir uma conexão TCP, inclusive tráfego que um proxy HTTP não consegue encaminhar, e passa os bytes sem tocar neles. Isso o torna a escolha natural para um cliente de banco de dados, uma sessão SSH ou qualquer ferramenta que não fale HTTP. O que ele não faz é mudar o que o endereço é. O protocolo de proxy é falado entre o seu cliente e o proxy; o site na outra ponta enxerga uma conexão vinda do endereço do proxy, mais os cabeçalhos que um proxy HTTP tenha decidido acrescentar. Então a pergunta que vale fazer não é qual protocolo comprar. É a qual rede o endereço pertence, e aí a resposta é um provedor de internet identificado, 23 deles nos Estados Unidos.
A versão 5 do SOCKS foi publicada em 1996 como RFC 1928, um protocolo para repassar as conexões de um cliente por um servidor proxy. Ela ampliou a versão 4 do SOCKS com UDP, uma estrutura para métodos de autenticação e destinos informados como nomes de domínio ou endereços IPv6. Um cliente oferece os métodos de autenticação que aceita e o servidor escolhe um; depois o cliente pede uma conexão de saída (CONNECT), uma porta de escuta (BIND) ou um retransmissor UDP (UDP ASSOCIATE). O login por usuário e senha é uma especificação curta à parte, a RFC 1929, que envia a senha em texto puro — então mantenha criptografado o tráfego dentro do túnel onde isso importa.
A opção de nome de domínio é justamente a escolha entre os esquemas socks5 e socks5h. O manual do curl descreve --socks5 como usar o proxy “but resolve the hostname locally”, e --socks5-hostname como a variante que deixa “the proxy resolve the hostname”. Em uma URL de proxy, socks5:// dá o primeiro comportamento e socks5h:// o segundo, como mostra a tabela do Everything curl. Um proxy HTTP que transporta HTTPS normalmente recebe o nome: uma requisição CONNECT informa o host e a porta de destino, e o proxy abre o túnel até eles (RFC 9110, seção 9.3.6). O retransmissor UDP faz parte da especificação do SOCKS5, mas as implementações divergem nele; as perguntas frequentes abaixo explicam o que isso significa nos nossos proxies.
Se você já tem um login SSH em um servidor, você tem um proxy SOCKS5 sem precisar comprar um. ssh -N -D 1080 user@server configura o que o manual do ssh do OpenBSD chama de encaminhamento de portas “dinâmico” local, na camada de aplicação: o ssh escuta na porta 1080 da sua máquina e “will act as a SOCKS server”, levando cada conexão pelo canal SSH criptografado e abrindo-a a partir da máquina remota. O -N limita-se ao encaminhamento, sem shell remoto. Aponte um cliente para socks5h://127.0.0.1:1080 e o tráfego dele sai do servidor.
A diferença para um proxy SOCKS5 comprado está em por onde a conexão sai. Por um túnel SSH, o site na outra ponta enxerga o endereço do servidor SSH e a rede a que esse servidor pertence, que, para um servidor alugado, costuma ser a de uma empresa de hospedagem. O SSH criptografa o trecho entre você e o servidor; do servidor ao site, o tráfego é o que já era. Um proxy da ProxyJam alternado para SOCKS5 sai por um endereço na rede de um provedor de internet identificado, escolhido por país e operadora na compra, e você se conecta a ele diretamente, com a porta e as credenciais do pedido, sem SSH no meio e sem um servidor próprio para manter.
Então as duas opções respondem a perguntas diferentes. Um túnel por SSH envia o tráfego para fora de uma máquina que você já controla. Um proxy SOCKS5 em um endereço ISP serve para o trabalho em que o próprio endereço de saída importa, isto é, qual rede aparece quando alguém o consulta.
Três trocas curtas, em nenhuma delas o proxy entende o seu tráfego.
Seu cliente cumprimenta o proxy e combina a autenticação. Ele oferece os métodos que aceita; o proxy indica o que quer. Nos nossos endereços é usuário e senha, ou nada, se você liberou o seu próprio IP na lista de permitidos.
Seu cliente pede um destino. Um host e uma porta, enviados como endereço ou como nome. Enviar o nome é o caso interessante: quem o resolve é o proxy, então a consulta sai da rede do proxy e não da sua.
Depois disso o proxy só move bytes. Ele não analisa o conteúdo, não adiciona cabeçalhos nem sabe se está carregando uma página web, uma sessão de banco de dados ou uma transferência de e-mail. Essa indiferença é a razão de escolher SOCKS5 em vez de um proxy HTTP.
| Proxy HTTP | HTTPS via CONNECT | SOCKS5 | |
|---|---|---|---|
| O que pode transportar | Somente requisições HTTP | Um túnel TCP para o host e a porta indicados | Qualquer fluxo TCP |
| O proxy lê o conteúdo? | Sim — ele analisa a requisição | Não, depois que o túnel é aberto | Não, em nenhum momento |
| Pode alterar seus cabeçalhos? | Sim — ele os repassa e pode acrescentar os seus, como o Via | Não, depois que o túnel é aberto | Não — ele não tem a noção de cabeçalho |
| Onde o hostname é resolvido | No proxy | No proxy — o CONNECT informa o host | À sua escolha, em qualquer das pontas |
| Suporte típico nos clientes | Universal em ferramentas HTTP | Universal em ferramentas HTTP | Comum em ferramentas de linha de comando; algumas bibliotecas exigem um pacote extra |
| Mais indicado para | Requisições web simples | Navegação e scraping HTTPS comuns | Protocolos que não são web e tráfego misto |
Para qual protocolo apontar um cliente e qual esquema, socks5 ou socks5h, definir nele depois que o proxy for alternado.
Para qual protocolo apontar um cliente e como alternar o proxy que você já possui pelo painel ou pela API.
Pelo painel ou com uma chamada de API no pedido; alterar apenas o cliente não basta. O proxy pode ficar indisponível por pouco tempo enquanto a troca acontece.
Não reutilize os valores com que você se conectava em HTTP.
socks5h://USERNAME:PASSWORD@HOST:PORT para que o proxy resolva os hostnames, ou socks5:// para resolvê-los do seu lado.
curl -x socks5h://USERNAME:PASSWORD@HOST:PORT https://example.com/.
No Python, o requests precisa do extra de SOCKS, pip install requests[socks], para que uma URL de proxy socks5h:// funcione.
import requests
# HOST, PORT, USERNAME, PASSWORD come with your order (dashboard or API)
proxy = "http://USERNAME:PASSWORD@HOST:PORT"
proxies = {
"http": proxy,
"https": proxy,
}
response = requests.get(
"https://example.com/",
proxies=proxies,
)
print(response.status_code)
# HOST, PORT, USERNAME, PASSWORD come with your order (dashboard or API)
curl -x http://USERNAME:PASSWORD@HOST:PORT \
https://example.com/
import axios from "axios";
import { HttpsProxyAgent } from "https-proxy-agent";
// HOST, PORT, USERNAME, PASSWORD come with your order (dashboard or API)
const proxy = "http://USERNAME:PASSWORD@HOST:PORT";
const agent = new HttpsProxyAgent(proxy);
const response = await axios.get(
"https://example.com/",
{
httpAgent: agent,
httpsAgent: agent,
},
);
console.log(response.status);
package main
import (
"fmt"
"net/http"
"net/url"
)
func main() {
// HOST, PORT, USERNAME, PASSWORD come with your order (dashboard or API)
proxy, _ := url.Parse(
"http://USERNAME:PASSWORD@HOST:PORT")
client := &http.Client{Transport: &http.Transport{
Proxy: http.ProxyURL(proxy),
}}
res, _ := client.Get("https://example.com/")
fmt.Println(res.Status)
}
Os exemplos abaixo conectam por HTTP, o protocolo com que um pedido começa. Para usar SOCKS5, primeiro troque o próprio proxy, pelo painel ou com uma chamada de API; o pedido passa então a mostrar a porta e as credenciais a usar daí em diante. No cliente, mude o esquema para socks5, ou socks5h se você quiser que o proxy resolva o hostname, com essa porta e essas credenciais — o Python precisa do requests[socks] para isso, e o Node.js de um agente SOCKS no lugar do HTTPS.
As respostas abaixo afirmam os termos em que vendemos, e cada uma que o faz leva ao documento que nos obriga a eles.
O SOCKS5 é um protocolo de proxy definido na RFC 1928 que atua na camada de transporte. Seu cliente pede ao proxy que abra uma conexão com um host e uma porta, o proxy a abre e, a partir daí, repassa bytes nos dois sentidos sem interpretá-los. Como nunca analisa o que transporta, não se limita ao tráfego web — qualquer coisa que rode sobre TCP pode passar por ele.
Um proxy HTTP entende HTTP. Ele lê a linha da requisição e os cabeçalhos, e pode adicionar, remover ou reescrevê-los, e por isso alguns proxies se anunciam discretamente em um cabeçalho que você não definiu. O SOCKS5 não tem nenhuma noção de cabeçalho: ele enxerga um destino e um fluxo de bytes. Se o seu tráfego não é HTTP, ou se você prefere que nada no meio possa editá-lo, o SOCKS5 é o indicado.
Não, e o proxy HTTP também não. O SOCKS5 autentica você no proxy e depois repassa bytes. A especificação permite que um método de autenticação acrescente a própria proteção, mas a autenticação por usuário e senha (RFC 1929) envia a senha em texto puro e não protege nada depois dela. Se o tráfego interno é HTTPS ou SSH, ele já é criptografado de ponta a ponta e o proxy não consegue lê-lo. Se o tráfego interno é texto simples, continua texto simples, então não trate o SOCKS5 como uma camada de criptografia.
S5 é abreviação de SOCKS5. Na ProxyJam é o mesmo proxy ISP estático que você já possui, alternado de HTTP para SOCKS5 no pedido, sem pedido separado e sem cobrança pela troca.
Ele muda quem faz a consulta de DNS. Com socks5, seu cliente resolve o hostname localmente e pede ao proxy que se conecte ao endereço resultante. Com socks5h, seu cliente envia o nome e o proxy o resolve. Isso importa de duas formas: seu próprio resolvedor nunca vê quais hosts você visita, e você recebe a resposta que a rede do proxy recebe, que para um hostname que varia por região muitas vezes não é a resposta que você teria em casa.
O UDP ASSOCIATE está na RFC 1928; se um determinado cliente ou servidor o implementa varia, então confira as duas pontas em vez de presumir. Não publicamos suporte a UDP para os nossos proxies, então conte com TCP e pergunte ao suporte antes de construir qualquer coisa que dependa de UDP.
Não. Você alterna o proxy que já possui entre HTTP, que também transporta HTTPS, e SOCKS5 — pelo painel ou com uma chamada à API no mesmo pedido. Não é apenas uma configuração do cliente: a troca é feita no proxy, o pedido é atualizado com o novo protocolo, a nova porta e as novas credenciais, e o proxy pode ficar indisponível por pouco tempo enquanto isso acontece. O proxy continua seu durante todo o período que você pagou, a renovação mantém o mesmo endereço, e um IP com defeito confirmado, informado em até 24 horas após o pagamento, é reembolsado conforme a Política de Reembolso. Termos de Serviço
--socks5 resolve o hostname localmente, --socks5-hostname deixa o proxy resolvê-losocks5:// e socks5h:// em uma URL de proxy, e qual ponta resolve o hostname-D configura o encaminhamento dinâmico local de portas, com o ssh atuando como servidor SOCKS4 e SOCKS5, e -N encaminha portas sem executar um comando remoto