Proxy autenticado

Alguns clientes da Oystr têm preferido configurar um proxy autenticado em vez de utilizar uma VPN. Essa abordagem permite que nossos robôs do Presto se conectem à infraestrutura do cliente de forma segura e eficiente.

Passo a Passo para Configuração do Proxy

1. Rodar o container com o proxy

O cliente deve rodar o seguinte comando em sua máquina, utilizando nosso container pré-configurado:

docker run --name proxy -v /opt/oystr:/opt/oystr/ -p 8888:8888 -d leandrocruz/oystr-tinyproxy:v1.0.0

Esse comando irá:

Criar e rodar um container chamado proxy;
Mapear a pasta local /opt/oystr para dentro do container;
Expor a porta 8888 para acesso externo.

2. Criar o arquivo de configuração

Na pasta local /opt/oystr o cliente deve criar um arquivo chamado tinyproxy.cfg com o seguinte conteúdo:

Port 8888
Listen 0.0.0.0
Timeout 600
DisableViaHeader Yes
BasicAuth oystr-bot SENHA

O container roda um proxy http autenticado na porta 8888

Importante:

SENHA deve ser substituída pela senha de autenticação que o cliente deverá criar e nos informar para ser usado pela nossa solução para autenticar os robôs na infraestrutura do cliente.
A configuração define que o proxy ficará escutando na porta 8888 em todas as interfaces de rede (0.0.0.0).

3. Garantir o acesso externo

A porta 8888 precisa estar publicamente acessível na infraestrutura do cliente, para que os robôs do Presto consigam se conectar ao proxy.

4. Testar o funcionamento do proxy

Após a configuração, o cliente deve executar o seguinte comando para verificar se o proxy está funcionando corretamente:

curl --proxy http://oystr-bot:SENHA@IP:8888 http://ipinfo.io

Substitua:

SENHA pela senha de autenticação fornecida;
IP pelo endereço IP público ou interno da máquina onde o proxy foi configurado (ou do gateway).

Se o comando retornar um JSON com as informações do IP da infraestrutura do cliente, significa que o proxy está configurado corretamente.

✅ Exemplo de retorno esperado:

{
    "city": "São Paulo",
    "country": "BR",
    "hostname": "customer.splobra1.pop.starlinkisp.net",
    "ip": "216.234.208.75",
    "loc": "-23.5475,-46.6361",
    "org": "AS14593 Space Exploration Technologies Corporation",
    "postal": "01000-000",
    "readme": "https://ipinfo.io/missingauth",
    "region": "São Paulo",
    "timezone": "America/Sao_Paulo"
}

⚠️ Importante

Enquanto esse teste não for bem-sucedido, os robôs do Presto não conseguirão utilizar o proxy do cliente.

Suporte

Em caso de dúvidas ou dificuldades durante a configuração, entre em contato com nosso time de suporte técnico.

Revision #1
Created 5 August 2026 13:35:49 by Flávio Santos
Updated 5 August 2026 13:36:15 by Flávio Santos