> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/documentation/pt-br/comecar/quick-start-proxies.md).

# Início rápido: Proxies

Comece a usar os Proxies da Oxylabs em apenas alguns minutos com um guia simples passo a passo.

{% hint style="success" %}
Já está familiarizado com o básico? Confira [documentação de proxy](/products/pt-br/proxies.md) ou nosso prático [hub de integração](/integrations/pt-br/proxy-integrations.md).
{% endhint %}

A Oxylabs oferece uma variedade de tipos de Proxies projetados para raspagem de dados de alto desempenho e melhor acesso à web. Embora os casos de uso para Residential Proxies, Datacenter Proxies e ISP Proxies sejam diferentes, a lógica principal de integração é quase idêntica.

Siga o guia passo a passo abaixo para começar a usar os Proxies da Oxylabs em apenas alguns minutos:

{% stepper %}
{% step %}

### Configuração e credenciais

1. **Crie uma conta:** Inscreva-se no [Painel da Oxylabs](https://dashboard.oxylabs.io/).
2. **Adicione uma instância de produto:** Clique em **+ Add product instance** e selecione sua solução de Proxies (Residential Proxies, Mobile Proxies, Datacenter Proxies ou ISP Proxies)
3. **Configure seus Proxies:** Escolha o tipo de proxy, o nome da instância, (se um tipo baseado em IP tiver sido escolhido, [configure seus IPs](/documentation/pt-br/dashboard/gerenciamento-de-produtos-de-ip.md#docs-internal-guid-26b69515-7fff-79cb-231a-7643f96de4a1)), as configurações de autenticação e crie a instância.
4. **Obtenha as credenciais:** Clique no seu produto de Proxies na tabela de instâncias de visão geral e confirme as credenciais de usuário do seu proxy.

{% hint style="info" %}
Para testar nossos Proxies gratuitamente, resgate um crédito de US$ 5 [de boas-vindas](/documentation/pt-br/dashboard/cobranca-baseada-em-creditos.md#free-credits-welcome-credit).
{% endhint %}
{% endstep %}

{% step %}

### Sua primeira solicitação

A maneira mais eficiente de testar sua conexão é com um comando cURL. Copie o modelo abaixo e substitua os placeholders pelos valores de **Detalhes do proxy** em **Etapa 3**.

```bash
curl -x ENDPOINT:PORT -U "PREFIX-USERNAME:PASSWORD" https://ip.oxylabs.io/location
```

{% endstep %}

{% step %}

### Detalhes do proxy

Encontre seu produto específico abaixo para identificar os detalhes de conexão corretos:

<table><thead><tr><th width="172">Tipo de proxy</th><th width="150">Endpoint</th><th width="115">Porta rotativa</th><th width="125">Prefixo de nome de usuário</th><th width="127">Porta estática</th></tr></thead><tbody><tr><td>Residential</td><td><code>pr.oxylabs.io</code></td><td><code>7777</code></td><td><code>customer-</code></td><td>(use <code>sessid-</code>)</td></tr><tr><td>Mobile</td><td><code>pr.oxylabs.io</code></td><td><code>7777</code></td><td><code>customer-</code></td><td>(use <code>sessid-</code>)</td></tr><tr><td>Datacenter</td><td><code>dc.oxylabs.io</code></td><td><code>8000</code></td><td><code>user-</code></td><td><code>8001</code> e superiores</td></tr><tr><td>Datacenter Dedicado</td><td><code>ddc.oxylabs.io</code></td><td><code>8000</code></td><td><code>user-</code></td><td><code>8001</code> e superiores</td></tr><tr><td>ISP</td><td><code>isp.oxylabs.io</code></td><td><code>8000</code></td><td><code>user-</code></td><td><code>8001</code> e superiores</td></tr><tr><td>ISP dedicado</td><td><code>disp.oxylabs.io</code></td><td><code>8000</code></td><td><code>user-</code></td><td><code>8001</code> e superiores</td></tr></tbody></table>

{% hint style="success" %}
Se você adquiriu Dedicated Datacenter Proxies (Enterprise) por meio da nossa Equipe de Vendas, você pode se conectar via IP Direto (por exemplo, `1.2.3.4:60000` para HTTP ou `1.2.3.4:1180` para SOCKS5) ou usar o endpoint fornecido pelo seu Gerente de Conta. O nome de usuário não requer prefixo.
{% endhint %}
{% endstep %}

{% step %}

### Personalizando sua solicitação

Depois que a conexão básica estiver funcionando, você pode personalizar sua sessão ou segmentação geográfica:

* **Para direcionar um país:**
  * Residential/Mobile: Adicione `-cc-US` à sua string de nome de usuário (ajuste o código do país conforme necessário).
  * DC/ISP compartilhado: Adicione `-country-US` à sua string de nome de usuário (ajuste o código do país conforme necessário).
  * Dedicado (DC/ISP): Use a porta atribuída a um IP no país de destino (consulte a lista de Proxies no seu painel).
* **Para manter uma sessão estática:**
  * Residential Proxies / Mobile Proxies: Adicione `-sessid-qwerty123` ao final da sua string de nome de usuário.
  * Todos os outros tipos: altere a porta (por exemplo, use `8001` para o IP nº 1, `8002` para o IP nº 2, etc.).
* **Para alterar os protocolos:**
  * HTTP / HTTPS / SOCKS5: Altere o prefixo de conexão no seu cliente (`http://`, `https://`, ou `socks5h://`) seguindo com endpoints padrão.
  * HTTP/3 e UDP: Direcione as requisições por meio de [MASQUE](/products/pt-br/proxies/residential-proxies/protocols.md#http-3) em `masque.oxylabs.io:50000` (somente Residential Proxies).
    {% endstep %}
    {% endstepper %}

### Próximos passos

Agora que você confirmou sua conexão, veja onde seguir:

* **Precisa de recursos avançados?** Veja a lista completa de recursos de cada tipo em [Produtos](/products/pt-br/proxies.md) seção.
* **Usando ferramentas de terceiros?** Encontre guias passo a passo para Selenium, Playwright, navegadores privados, gerenciadores de Proxies e muito mais em [Integrações](/integrations/pt-br/proxy-integrations.md) seção.
* **HTTP/3 e UDP nativo (MASQUE):** Se seus endpoints de destino exigirem conexões nativas HTTP/3 ou QUIC, consulte o [Guia de Integração MASQUE](/products/pt-br/proxies/residential-proxies/protocols.md#http-3) para mais detalhes de configuração.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/documentation/pt-br/comecar/quick-start-proxies.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
