> 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/integrations/pt-br/proxy-integrations/residential-proxies-guides/oxy-proxy-extension-for-chrome.md).

# Oxy® Proxy Extension for Chrome

[**Oxy**® **Extensão de Proxy**](https://oxylabs.io/products/chrome-proxy-extension) é uma extensão de gerenciamento de proxy para Chrome. É gratuita e funciona com qualquer provedor de proxy de sua escolha.​

Este guia rápido mostra como integrar Oxylabs [**Residential Proxies**](https://oxylabs.io/products/residential-proxy-pool).

### Configuração

{% stepper %}
{% step %}
[**Baixar**](https://chrome.google.com/webstore/detail/oxylabs-proxy-extension/infajoaodhhdogakhloedbppcbeajhoo) e clique no ícone da extensão para abrir o aplicativo.

<figure><img src="/files/6244866bc3252a4261c52f36c745f18318744dc7" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Clique no **+Adicionar novo proxy** botão.

<figure><img src="/files/7e9d877570c38de909daf257a8b82e9bd1cc2c94" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Uma nova guia será aberta, onde você poderá **configurar seu perfil de proxy**.

Preencha os detalhes da seguinte forma:

<table data-header-hidden data-full-width="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Nome</strong></td><td><code>Nome do projeto</code></td></tr><tr><td><strong>Protocolo</strong></td><td><code>HTTP</code> ou <code>HTTPS</code></td></tr><tr><td><strong>Domínio</strong></td><td><code>pr.oxylabs.io</code></td></tr><tr><td><strong>Porta</strong></td><td><code>7777</code></td></tr><tr><td><strong>Nome de usuário</strong></td><td><code>customer-USERNAME</code></td></tr><tr><td><strong>Senha</strong></td><td><code>PASSWORD</code></td></tr></tbody></table>

{% hint style="warning" %}
Certifique-se de adicionar a `customer-` parte ao seu nome de usuário.
{% endhint %}
{% endstep %}

{% step %}
Clique **Salvar alterações**.

<figure><img src="/files/35b6c0810e9d6d993c39f27ac7d3ad02f54a11ba" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Abra a extensão conforme mostrado na primeira etapa e clique em **Conectar**.

<figure><img src="/files/1ffdcfe99c8e5287e9e0c415adf2c591a8d641d3" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

Pronto. Agora você está usando proxies com endereços IP rotativos automaticamente.

### Configurações de geolocalização

Residential Proxies oferecem controle preciso sobre a geolocalização (país, estado, cidade etc.) quando você modifica o host, a porta ou o nome de usuário com parâmetros adicionais. Veja os exemplos abaixo:

<table><thead><tr><th width="155.90625">Parâmetro de proxy</th><th width="529.2734375">Exemplo</th></tr></thead><tbody><tr><td><a href="https://developers.oxylabs.io/proxies/residential-proxies/location-settings/select-country#country-specific-entry-nodes">Nó de entrada do país</a></td><td><p><strong>Host:</strong> <code>us-pr.oxylabs.io</code></p><p><strong>Porta:</strong> <code>10000</code></p></td></tr><tr><td><a href="https://developers.oxylabs.io/proxies/residential-proxies/location-settings/select-country">País</a></td><td><strong>Nome de usuário:</strong> <code>customer-USERNAME-cc-DE</code></td></tr><tr><td><a href="https://developers.oxylabs.io/proxies/residential-proxies/location-settings/select-city">Cidade</a></td><td><strong>Nome de usuário:</strong> <code>customer-USERNAME-cc-US-city-los_angeles</code></td></tr><tr><td><a href="https://developers.oxylabs.io/proxies/residential-proxies/location-settings/select-state">Estado</a></td><td><strong>Nome de usuário:</strong> <code>customer-USERNAME-st-us_california</code></td></tr><tr><td><a href="https://developers.oxylabs.io/proxies/residential-proxies/location-settings/continent">Continente</a></td><td><strong>Nome de usuário:</strong> <code>customer-USERNAME-cn-NA</code></td></tr><tr><td><a href="https://developers.oxylabs.io/proxies/residential-proxies/location-settings/zip-postal-code">CEP/Código postal</a></td><td><strong>Nome de usuário:</strong> <code>customer-USERNAME-cc-US-postalcode-90012</code></td></tr><tr><td><a href="https://developers.oxylabs.io/proxies/residential-proxies/location-settings/asn-targeting?_gl=1*vng9vk*_gcl_au*MTk4NzE4NjcwMS4xNzU0OTg4MDgw">Segmentação de ASN</a></td><td><strong>Nome de usuário:</strong> <code>customer-USERNAME-ASN-21928</code></td></tr></tbody></table>

### Sessões estáticas

[Entradas fixas específicas por país](broken://pages/7de4fbe3e677324473f331ec969aa479490e1a06) permitem que você use o mesmo endereço IP por até 10 minutos. Por exemplo, se você inserir `us-pr.oxylabs.io` como o **Domínio** e `10001` como o **Porta**você receberá o nó de saída dos EUA com uma sessão persistente.

Além disso, você pode [controlar suas sessões](broken://pages/3f44d46a1ddc0dbd73ac1b872ed444a17db6bc1d) atribuindo uma string alfanumérica aleatória ao `sessid-` parâmetro. Este parâmetro deve ser **adicionado ao seu nome de usuário**, por exemplo, `customer-USERNAME-sessid-123`:

<figure><img src="/files/cd2a23a2da238b95bc115aad60414c4fe3592294" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Com essa abordagem, você pode usar o mesmo endereço IP por **até 1440 minutos** (24 horas) adicionando o `sesstime` parâmetro, por exemplo: `customer-USERNAME-sessid-123-sesstime-1440`.
{% endhint %}

Depois de salvar as alterações, abra a janela da extensão e conecte-se ao proxy recém-criado.

<figure><img src="/files/d411479847de36e75d614b39b7e42066d71aef6a" alt="" width="375"><figcaption></figcaption></figure>

### Lista de permissões

Se você não quiser usar proxies ao acessar sites específicos, pode adicioná-los a uma lista de permissões. Abra a extensão e clique em **Gerenciar proxies**, e então abra a **Lista global de exceções**.&#x20;

<figure><img src="/files/43bfc118bc9eea7825105cb0ae2212be0e511c50" alt=""><figcaption></figcaption></figure>

Por exemplo, se quiser deixar de usar proxies para `https://ip.oxylabs.io/`, você deve inserir o endereço assim: `https://ip.oxylabs.io` ou `ip.oxylabs.io`. Ao visitar este site, você verá seu endereço IP normal em vez de um IP de proxy.

{% hint style="warning" %}
Depois de salvar as alterações, desconecte e reconecte o proxy para ativar a lista de permissões.
{% endhint %}

### Erros comuns

Use as etapas de solução de problemas abaixo para corrigir erros comuns da extensão ao usar Oxylabs ou proxies de outros provedores.

<details>

<summary><strong>Proxies não estão conectando</strong></summary>

Tente **desconectar** e **reconectar** seus proxies na extensão. Se o problema persistir, passe para a próxima etapa abaixo.

</details>

<details>

<summary><strong>Credenciais de proxy incorretas</strong></summary>

Verifique o proxy **nome de usuário** e **senha** que você inseriu estão corretos e correspondem às credenciais atribuídas pelo seu provedor de proxy.

Para Oxylabs Residential Proxies, certifique-se de usar o **do usuário do proxy** nome de usuário e a senha que você criou no Oxylabs [painel](https://dashboard.oxylabs.io/). Você sempre pode editar essas credenciais no painel acessando **Meus produtos** → **Datacenter Proxies** → [**Usuários**](https://dashboard.oxylabs.io/?route=/overview/residential-proxies/users).

</details>

<details>

<summary><strong>Nome de usuário inválido sem acrescentar <code>customer-</code></strong></summary>

Oxylabs Residential Proxies **exigem que você acrescente** a `customer-` string ao nome de usuário do usuário do proxy. Por exemplo, se seu nome de usuário for `john_TFTdL`, então você deve inserir seu nome de usuário como `customer-john_TFTdL`.

</details>

<details>

<summary><strong>Domínio ou porta de proxy inválidos</strong></summary>

Certifique-se de estar usando um domínio de proxy e um número de porta válidos **conforme atribuídos pelo seu provedor de proxy**.

Um endereço de domínio válido para Oxylabs Residential Proxies é `pr.oxylabs.io` e porta `7777`. Verifique as portas válidas em nossa documentação visitando as[ pontos de entrada específicos por país](https://developers.oxylabs.io/proxies/residential-proxies/location-settings/select-country#table-of-entry-points) e [pontos de entrada persistentes](https://developers.oxylabs.io/proxies/residential-proxies/session-control/sticky-proxy-entry-nodes) páginas.

</details>

<details>

<summary><strong>Porta de proxy fora do intervalo</strong></summary>

Verifique se você inseriu uma **porta de proxy que não esteja fora do intervalo**. Para Oxylabs Residential Proxies, consulte estas listas de [pontos de entrada específicos por país](https://developers.oxylabs.io/proxies/residential-proxies/location-settings/select-country#table-of-entry-points) e [pontos de entrada persistentes](https://developers.oxylabs.io/proxies/residential-proxies/session-control/sticky-proxy-entry-nodes).

</details>

<details>

<summary><strong>Extensão não funciona</strong></summary>

Se a extensão não estiver funcionando por algum motivo, tente **desinstalá-la** e **reinstalá-la** por meio da [Chrome Web Store](https://chromewebstore.google.com/detail/oxylabs-proxy-extension/infajoaodhhdogakhloedbppcbeajhoo) ou das configurações do navegador.

</details>

<details>

<summary><strong>Desative a VPN de terceiros</strong></summary>

Desative uma Rede Privada Virtual (VPN) de terceiros, se estiver usando uma. Ela pode entrar em conflito com a Oxy® Proxy Extension.

</details>

Este guia também está disponível para [Datacenter Proxies](/integrations/pt-br/proxy-integrations/datacenter-proxies-guides/oxy-proxy-extension-for-chrome.md), [ISP Proxies](/integrations/pt-br/proxy-integrations/isp-proxies-guides/oxy-proxy-extension-for-chrome.md), [Mobile Proxies](/integrations/pt-br/proxy-integrations/mobile-proxies-guides/oxy-proxy-extension-for-chrome-1.md), [Enterprise](/integrations/pt-br/proxy-integrations/dedicated-datacenter-proxies-guides/enterprise/oxy-proxy-manager.md) e [Autoatendimento Dedicated Datacenter Proxies](/integrations/pt-br/proxy-integrations/dedicated-datacenter-proxies-guides/self-service/oxy-proxy-extension-for-chrome.md).

Você também pode conferir nosso aplicativo gratuito [**Oxy**® **aplicativo Proxy Manager**](https://oxylabs.io/products/proxy-manager-app) para Android. Ele permite adicionar e gerenciar proxies com facilidade, além de alternar entre vários IPs com uma conexão simples com um clique.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.oxylabs.io/integrations/pt-br/proxy-integrations/residential-proxies-guides/oxy-proxy-extension-for-chrome.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.