---
title: "Primeiros passos"
description: "Como instalar o Potatso no iPhone ou iPad, adicionar seu primeiro servidor por link, assinatura, arquivo ou código QR, permitir a VPN e conectar."
---

> Documentation Index
> Fetch the complete documentation index at: https://potatso.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Primeiros passos

O Potatso funciona em iPhone e iPad com iOS 17 ou posterior. Para usá-lo, você precisa de pelo menos um servidor proxy: um link de compartilhamento, uma URL de assinatura ou um arquivo de configuração do seu provedor, ou os dados de um servidor que você mesmo mantém.

Na primeira vez que você abre o Potatso, ele guia a configuração em quatro etapas: dar nome a um perfil, adicionar seus servidores, escolher uma rota e permitir a VPN. Esta página segue essas etapas e depois mostra como conectar.

## Instalar o Potatso {#install}

Baixe o [Potatso na App Store](https://apps.apple.com/app/id1239860606) e abra-o. Toque em **Começar**.

## Dê um nome ao perfil {#name}

Um perfil reúne seus servidores, grupos de proxies, regras e ajustes de DNS. Digite um nome, ou toque em uma das sugestões, e toque em **Continuar**. Você pode mudar o nome depois.

## Adicione seus servidores {#add-servers}

A etapa **Adicione seus servidores** oferece quatro caminhos:

| Opção | O que faz |
| --- | --- |
| **Colar um link** | Toque em **Colar** para importar de imediato o link que está na área de transferência. Pode ser um link de compartilhamento como `vless://…`, uma URL de assinatura ou uma URL de configuração. |
| **Escanear um código QR** | Escaneia um código QR com um link de compartilhamento ou uma URL de assinatura. Para ler um código QR de uma imagem, toque no botão de foto no canto do leitor. |
| **Importar um link ou arquivo** | Abre o importador: cole um link ou uma configuração inteira, ou escolha um arquivo de configuração. Veja [Importar de um arquivo](#file). |
| **Inserir um servidor manualmente** | Abre um formulário de servidor vazio. Veja [Inserir um servidor à mão](#manual). |

O Potatso detecta o formato sozinho. Ele lê links de compartilhamento, assinaturas, JSON do Shadowsocks e SIP008, YAML do Mihomo / Clash, JSON do V2Ray / Xray, perfis do Surge e listas de regras. Uma URL de assinatura continua sendo atualizada depois de importada. Veja [Importar assinaturas e configurações](/docs/pt-br/guides/import-subscriptions/) para cada formato.

Depois de importar algo, a etapa passa a mostrar **Servidores adicionados** e indica quantos servidores, grupos e regras entraram. Você pode adicionar mais do mesmo jeito. Toque em **Continuar**.

Se uma importação falhar, o motivo aparece abaixo das opções.

Ainda sem servidores? Toque em **Ainda não tenho servidores** para concluir a configuração sem eles. Você pode [adicionar servidores depois, pelo Início](#add-more).

### Importar de um arquivo {#file}

1. Toque em **Importar um link ou arquivo**.
2. Em **Origem**, escolha **Arquivo** e toque em **Escolher arquivo…**.
3. Escolha um arquivo YAML, JSON, CONF ou de texto. Ele precisa ser texto UTF-8 e ter no máximo 5 MB.
4. Toque em **Continuar**, confira a prévia e toque em **Adicionar**.

Um arquivo não tem de onde ser atualizado, então o conteúdo dele não é atualizado depois. Importe a URL, se o seu provedor fornecer uma.

### Inserir um servidor à mão {#manual}

1. Toque em **Inserir um servidor manualmente**.
2. Digite um **Nome** e escolha o **Protocolo** do servidor.
3. Preencha **Endereço** e **Porta**, e depois os ajustes que o seu protocolo exige, como senha ou ID de usuário.
4. Toque em **Salvar** (a marca de seleção).

A página de cada protocolo lista os ajustes que o Potatso suporta: [Shadowsocks](/docs/pt-br/protocols/shadowsocks/), [ShadowsocksR](/docs/pt-br/protocols/shadowsocksr/), [Trojan](/docs/pt-br/protocols/trojan/), [VLESS](/docs/pt-br/protocols/vless/), [VMess](/docs/pt-br/protocols/vmess/), [HTTP e HTTPS](/docs/pt-br/protocols/http/), [SOCKS5](/docs/pt-br/protocols/socks5/), [Hysteria 2](/docs/pt-br/protocols/hysteria2/), [AnyTLS](/docs/pt-br/protocols/anytls/) e [Snell](/docs/pt-br/protocols/snell/).

## Escolha uma rota {#route}

A etapa **Escolha uma rota** define como o perfil roteia o tráfego e qual servidor ele usa. Enquanto você escolhe, o Potatso testa a latência de cada servidor.

1. Escolha um modo de saída, se a etapa oferecer mais de um:
   - **Regra**: as regras da sua configuração decidem o que vai para onde. É oferecido quando a importação tem regras.
   - **Global**: todo o tráfego passa pela saída que você escolher.
   - **Direto**: nada passa por um proxy.
2. Escolha a saída no cartão abaixo do modo: toque em uma das opções rápidas ou abra a lista completa.
3. Toque no botão na parte de baixo. Ele mostra o nome da sua escolha, como **Usar Tokyo 01**, ou **Continuar**.

O quarto modo, **Inteligente**, não é oferecido aqui. Você pode ativá-lo depois, pelo Início. Veja [Modos de saída](/docs/pt-br/guides/outbound-modes/).

## Permita a VPN {#allow-vpn}

O Potatso conecta por meio de uma configuração VPN no seu dispositivo. O iOS pergunta uma vez antes de o Potatso poder adicioná-la.

1. Toque em **Adicionar configuração VPN**.
2. Quando o iOS perguntar, toque em **Permitir**.

Nada é conectado ainda. Quando a configuração é adicionada, a etapa mostra **Tudo pronto**. Se o iOS não a adicionar, toque em **Tentar novamente** e escolha **Permitir**.

Você pode tocar em **Agora não** para pular esta etapa. O iOS pergunta então na primeira vez que você conectar. Se o seu dispositivo já tem a configuração VPN do Potatso, de uma instalação anterior, o Potatso pula esta etapa.

Em seguida o Potatso mostra os planos Pro, a menos que você já tenha o Pro. Feche-os para ir ao Início.

## Conectar {#connect}

1. Abra o **Início**. O cartão de status no alto diz **Não conectado**.
2. Ative o interruptor do cartão de status.

O status muda para **Conectando…** e depois para **Conectado**. Para desconectar, desative o interruptor.

Se o modo Regra não tem um servidor para onde enviar o tráfego, o Potatso mostra **Escolha um servidor para conectar** e abre a lista de saídas. Escolha uma e conecte de novo.

Não consegue conectar? Veja [Solução de problemas](/docs/pt-br/troubleshooting/).

## Mudar o modo {#mode}

A linha **Modo de saída** no Início mostra o modo do perfil. Toque nela para escolher **Global**, **Inteligente**, **Regra** ou **Direto**. Veja em [Modos de saída](/docs/pt-br/guides/outbound-modes/) o que cada um faz.

## Adicionar mais servidores {#add-more}

No **Início**, toque no botão **+** no canto superior direito. Ele oferece:

- **Adicionar proxy**: insira um servidor à mão, como em [Inserir um servidor à mão](#manual).
- **Importar via link/arquivo**: cole um link ou uma configuração, ou escolha um arquivo, e depois confira a prévia da importação.
- **Escanear código QR**: escaneie um link de compartilhamento ou uma URL de assinatura e depois confira a prévia da importação.

A prévia mostra o que a importação contém e para onde vai. Veja [Importar assinaturas e configurações](/docs/pt-br/guides/import-subscriptions/).

Source: https://potatso.com/docs/pt-br/guides/getting-started/index.mdx
