# Usuários de proxy

> URL: https://foura.ai/pt/docs/dashboard/proxy
> Updated: 2026-10-28
> Index: https://foura.ai/llms.txt

A página Proxy (barra lateral > Proxy, em **Access**) é onde você cria usuários de proxy e obtém a connection string exata para colar em qualquer cliente que aceite uma URL de proxy. Ela serve de interface para a [porta de proxy](https://foura.ai/docs/api/proxy-port): seu tráfego sai de uma das saídas da FourA, com a rede, o país e o comportamento de sessão que você escolher. Túneis e tráfego contam no seu plano, da mesma forma que a API. Em um plano vendido por créditos, a porta tem seus próprios gigabytes inclusos, exibidos em Usage & Limits e recarregados na página Billing.

## Criando um usuário de proxy

1. Abra **Proxy** na barra lateral.
2. Clique em **Create proxy user**.
3. Dê um nome a ele (até 60 caracteres). O nome serve apenas para você diferenciá-los.
4. Escolha um **Owner**. A seleção aparece apenas se você pertencer a uma organização e oferece **Personal (me)** mais cada organização em que você está. Criar a partir de uma lista filtrada assume como padrão o proprietário já visível na tela.
5. Clique em **Create**.

Uma caixa de diálogo mostra o nome de usuário e a senha gerados com um botão de cópia em cada um. Você não escolhe nenhum dos dois: o nome de usuário precisa ficar livre de traços, pois um traço inicia uma opção na [gramática de nome de usuário](https://foura.ai/docs/api/proxy-port#options-ride-in-the-username), e a senha é uma string aleatória forte. Ambos podem ser exibidos novamente mais tarde, portanto não há nada para anotar. Se a senha de um usuário de proxy não puder ser exibida, o painel responde com `This password cannot be shown. Rotate it to get a new one.`

## Pessoal ou pertencente a uma organização

Um usuário de proxy pessoal é somente seu e o tráfego dele conta no seu plano. Um pertencente a uma organização é compartilhado com todos nela, e o tráfego dele conta no plano de quem for o proprietário dessa organização, exatamente como funciona a API key de uma organização.

O que cada função pode fazer com o usuário de proxy de uma organização:

| Ação | Membro | Administrador | Proprietário |
|--------|--------|-------|-------|
| Usar, ler a senha, criar novos | Sim | Sim | Sim |
| Nova senha, desativar, excluir, alterar segmentação salva | Não | Sim | Sim |
| Transferir para fora da organização | Não | Não | Sim |

A leitura é um direito de membro por um motivo: uma credencial que a equipe não consegue ler é uma credencial que a equipe não consegue usar, e a alternativa é uma credencial pessoal que fatura o desenvolvedor silenciosamente. Rotacionar uma senha não é, porque isso quebra todos os arquivos de configuração nos quais a credencial já foi colada. Transferir para fora move a cobrança para o plano do próprio destinatário, portanto fica restrito apenas ao proprietário.

Um filtro de **Owner** aparece acima da lista assim que você pertence a uma organização: **Everything**, **Personal** ou uma organização. Ele segue a mesma escolha do filtro Owner em Overview, Metrics, Activity e API Keys. Consulte [Organizações](https://foura.ai/docs/dashboard/teams-and-orgs).

## A lista

| Coluna | O que mostra |
|--------|---------------|
| Nome | O nome que você definiu |
| Proprietário | Pessoal, ou a organização proprietária |
| Nome de usuário | A parte de credencial do nome de usuário do proxy |
| Segmentação | Em texto, o que este usuário responde por padrão: rede, país e tudo salvo em Segmentação |
| Status | Ativo ou desativado |
| Criado em | Quando foi criado |
| Último uso | Quando transportou tráfego pela última vez, com precisão de minutos |

Cada linha exibe apenas as ações permitidas pela sua função:

- **String de conexão** abre a página individual do usuário (veja abaixo).
- **Mostrar senha** exibe a senha em uma caixa de diálogo.
- **Desativar** impede a autenticação do usuário em até um minuto; **Ativar** restaura o acesso.
- O menu contém **Nova senha**, que mantém o nome de usuário e substitui a senha (qualquer serviço que ainda utilize a antiga para de funcionar imediatamente), **Transferir**, que move o usuário entre você e uma organização mantendo nome de usuário, senha e segmentação salvos, e **Excluir**, que remove o usuário permanentemente.

Clique no cabeçalho de uma coluna para ordenar por Nome, Proprietário, Status, Criado em ou Último uso. Ordenar por Proprietário na visualização Tudo agrupa os itens pessoais.

## A página de string de conexão

Clique em **String de conexão** em uma linha e a página exibirá apenas esse usuário, dividida em duas abas.

### Aba String de conexão

As linhas para colar, atualizadas em tempo real conforme você altera as opções em Segmentação. Escolha o formato no menu de seleção à direita:

| Formato | Estrutura |
|--------|-------|
| URL | `http://user:password@proxy.foura.ai:34004` |
| host:port:user:pass | `proxy.foura.ai:34004:user:password` |

A senha fica oculta até você clicar em **Mostrar senha**; o botão **Copiar** em uma linha sempre copia o valor real. Abaixo das linhas, uma frase descreve o comportamento da string (por exemplo, "Rede premium, DE, Sofia, 10 min"), e trechos em curl, Python e Node mostram a primeira linha em ação.

Com sessões do tipo **Sticky** e contagem maior que um, a aba lista uma linha por endereço, cada uma com seu próprio nome de sessão gerado. **Novos nomes** gera novamente toda a lista, fornecendo um novo conjunto de endereços caso o destino tenha bloqueado os anteriores, e **Copiar tudo** copia todas as linhas.

### Aba Segmentação

Dois cartões, com as configurações disponíveis dentro do cartão selecionado:

- **Rede compartilhada**: saídas da própria FourA, incluídas no seu plano. Escolha um **País** (a rede compartilhada é selecionada apenas por país, sem divisões menores). Marque **Usar uma saída premium se a rede compartilhada não puder atender à solicitação** para ativar o fallback; ele só é acionado se o seu plano incluir tráfego premium com franquia disponível, ficando desmarcado por padrão.
- **Rede premium**: endereços residenciais, debitados do tráfego premium do seu plano. **País** libera **Região** e **Rede (ASN)**, e uma região libera **Cidade**. **Dispositivo** permite filtrar por Windows, Android, iOS ou macOS.

Abaixo de ambos os cartões, os controles de sessão se aplicam à rede que você escolheu:

| Controle | O que faz |
|---------|--------------|
| Session type | **Rotating** fornece um novo endereço por conexão. **Sticky** mantém um endereço fixo. |
| How many | Apenas Sticky. Uma linha por endereço, até 100 nesta tela. |
| Session name | Apenas Sticky, para um único endereço. Conexões que compartilham um nome compartilham um endereço. Se deixado vazio, um nome é gerado. |
| Rotating interval | Apenas Sticky na rede premium. Por quanto tempo um endereço é mantido, em minutos ou horas, de 3 minutos a 24 horas. |

As listas de países vêm dos pontos de saída que a FourA realmente possui, portanto, um país oferecido possui endereços ativos por trás dele.

### Salvando padrões

Tudo na aba Targeting se aplica apenas à string de conexão na tela, até que você clique em **Save as defaults**. O direcionamento salvo passa a ser o que o usuário de proxy responde em cada conexão, a coluna Targeting na lista indica isso em texto, e a string de conexão é reduzida apenas à credencial básica mais o que diferir dos valores salvos. Qualquer coisa que você adicionar ao nome de usuário ainda tem prioridade para aquela conexão específica.

O salvamento é recusado quando a combinação não pode funcionar, como uma cidade na rede compartilhada ou um fallback na rede premium, de modo que um usuário de proxy não possa ser armazenado em um estado que recuse todas as conexões.

Um padrão premium salvo consome apenas enquanto o tráfego premium do seu plano durar. Quando ele se esgota, uma conexão que depende do padrão salvo é atendida a partir da rede compartilhada e o túnel ainda abre, enquanto uma conexão que especifica `-network-premium` no nome de usuário é recusada com um erro 403. A [proxy port reference](https://foura.ai/docs/api/proxy-port) aborda ambos os casos.

No usuário de proxy de uma organização, salvar padrões é uma ação de administrador ou proprietário. Redirecionar o direcionamento salvo redireciona silenciosamente o tráfego de toda a organização, e é por isso que essa opção fica ao lado da senha.

## Onde estão os números

A página Proxy cria e configura credenciais. Ela não traz estatísticas. O volume transferido por cada usuário de proxy fica nas três páginas de relatórios, com a chave **Product** definida como Proxy:

- [Overview](https://foura.ai/docs/dashboard/overview): túneis, tráfego, tempo de configuração e túneis abertos simultaneamente
- [Metrics](https://foura.ai/docs/dashboard/metrics): o painel Usage por usuário de proxy, destino, país de saída, IP do cliente ou resultado
- [Activity](https://foura.ai/docs/dashboard/activity-log): uma linha por túnel na última hora
- [Usage & Limits](https://foura.ai/docs/dashboard/quota): uma aba **Proxy users** com este período de faturamento por credencial

## Dicas

- Atribua a cada job seu próprio proxy user. Um usuário em uso diário mostra isso em **Last Used**, e uma credencial vazada pode ser desativada ou receber uma nova senha sem afetar as outras.
- Vai controlar um navegador através da porta? Use uma sticky session. O carregamento de uma página abre dezenas de conexões e, sem uma sessão, cada uma sairia de um endereço diferente.
- O formato `host:port:user:pass` é o que a maioria dos gerenciadores de proxy importa. O formato de URL é o que o curl e as bibliotecas HTTP aceitam.
- O downloader de uma empresa deve usar um proxy user da organização, não de uma pessoa física. Uma credencial pessoal para de funcionar no dia em que a pessoa sai e é faturada para ela.
- Túneis abertos simultaneamente e aberturas por minuto dependem do seu plano e são contabilizados para a conta, portanto, um segundo proxy user não concede uma franquia adicional.

## Relacionado

- [Proxy Port](https://foura.ai/docs/api/proxy-port): Host, porta, todas as opções de username, códigos de resposta e limites
- [Usage & Limits](https://foura.ai/docs/dashboard/quota): Tráfego comum e premium em relação ao seu plano, por proxy user
- [How Your Plan Is Metered](https://foura.ai/docs/guides/plans-and-metering): De onde vêm os gigabytes da porta
- [Managing API Keys](https://foura.ai/docs/dashboard/api-keys): O outro tipo de credencial, para a API JSON
- [Organizations](https://foura.ai/docs/dashboard/teams-and-orgs): Funções, membros e para quem o uso é faturado