> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/set-up-on-a-server.md).

# Configure em um servidor

Um servidor alugado roda o goodcryptoX dia e noite; configure a partir de qualquer computador ou do celular, ou mude a instalação do seu Mac para lá com um único arquivo.

Um servidor alugado roda o goodcryptoX dia e noite. Você o configura a partir de qualquer computador, ou só pelo celular; comece aqui, ou comece no seu Mac e mude para cá depois com um único arquivo.

Qualquer provedor serve. Por enquanto recomendamos a Hostinger: de longe a mais fácil de configurar que encontramos, e também custa pouco. Os passos abaixo mostram a Hostinger tela por tela; os mesmos passos valem em qualquer provedor de nuvem, AWS, DigitalOcean, Google Cloud, Azure ou qualquer outro.

[**Implante na Hostinger**](https://www.hostinger.com/docker-hosting?compose_url=https://raw.githubusercontent.com/GoodCryptoApp/gcx/main/compose.yaml\&REFERRALCODE=HBDNPMHGJLZB)

O atalho: abra o link, crie sua conta na Hostinger, escolha um plano e siga as telas; no fim o goodcryptoX fica configurado no servidor novo por conta própria, sem nada para colar. Termine no mesmo navegador em que abriu o link. Se algo der errado, o guia passo a passo abaixo faz o mesmo à mão.

*Por este link você ganha 20% de desconto na primeira compra, e o goodcryptoX recebe uma parte. Você é livre para ir à Hostinger sem ele, ou para usar qualquer outro provedor.*

## Alugue um servidor <a href="#rent-a-server" id="rent-a-server"></a>

O que você faz: cria sua conta na Hostinger, aluga o servidor, instala o goodcryptoX nele e depois conecta a ele o navegador do seu computador e o seu celular. Veja como, passo a passo.

Como as telas da Hostinger eram em outubro de 2026:

**1. Cadastre-se.** Nenhum cartão é pedido até você pagar, algumas telas adiante.

**2. VPS › Set up VPS**

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-38aa5d1c8d69ce3fea27b1d23be9814e0607beec%2F01-vps-page.webp?alt=media" alt="A página VPS, com a seta em Set up VPS" width="563"><figcaption></figcaption></figure>

**3. Localização.** Escolha a cidade mais perto de você e depois **Próximo**.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-fa113e868c66fdf3a3db74d607c29c4919a43d68%2F02-location.webp?alt=media" alt="Escolha a localização do servidor, com a seta em Next" width="563"><figcaption></figcaption></figure>

**4. O que instalar.** Abra **Applications**, ou procure "Docker".

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-b80255526231264fbbb66d2a504934dce0a1b5f1%2F03-choose-what-to-install.webp?alt=media" alt="Escolha o que instalar, com a seta em Applications" width="563"><figcaption></figcaption></figure>

Escolha o cartão **Docker** simples, não Docker e Traefik, Docker Registry nem Dockge.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-9b6dfd53ca522c9aa49a6d4ab8d67a4762f89aea%2F04-docker-search.webp?alt=media" alt="A busca por Docker, com a seta no cartão Docker" width="563"><figcaption></figcaption></figure>

O cartão diz "Installed in Ubuntu 24.04": pressione **Select**.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-23f7a871be764d6320958c6b2f8386bcd6e43792%2F05-docker-select.webp?alt=media" alt="O cartão do Docker, com a seta em Select" width="563"><figcaption></figcaption></figure>

**5. Senha de root.** Pressione **Generate** e guarde a senha no seu gerenciador de senhas: ela abre o seu servidor. Pule a chave SSH.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-5c6ba4e6c3b3d2cb26c861180c5700774517968c%2F06-root-password.webp?alt=media" alt="Proteja o acesso ao seu VPS, com a seta em Generate" width="563"><figcaption></figcaption></figure>

**6. Recursos adicionais.** Deixe as duas caixas vazias e depois **Próximo**.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-3f986addd8b40794dff95e85a929a6ce108f640c%2F07-additional-features.webp?alt=media" alt="Recursos adicionais, com a seta em Next" width="563"><figcaption></figcaption></figure>

**7. Plano.** O KVM 1 basta para o goodcryptoX: pressione o **Select** dele.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-340977a7ad685328509fa705c71eecf12550c765%2F08-plan.webp?alt=media" alt="Os planos, com a seta no Select do KVM 1" width="563"><figcaption></figcaption></figure>

**8. Período de cobrança.** O preço é escolha sua. Em 18 de outubro de 2026, o KVM 1 custava US$ 6.49 por mês em 24 meses, US$ 6.99 em 12 meses e US$ 9.99 em 1 mês, mais impostos; os preços mudam, então olhe o formato do negócio:

* O preço baixo vale só para o primeiro período, pago adiantado.
* Depois dele, os de 12 e 24 meses renovam pelo preço normal (US$ 11.99 por mês naquele dia) e o de 1 mês pelo preço cheio (US$ 19.49 por mês).
* Você pode trocar o período depois, pelo preço normal, nunca pelo promocional.
* Vai testar primeiro? Pegue 1 mês. Vai ficar? Pegue 12 ou 24 meses desde o início. Um servidor de 1 mês que se provou: alugue um novo em 12 ou 24 meses, [mude o goodcryptoX para lá](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/moving-goodcryptox.md#from-one-server-to-another) e cancele o antigo antes de renovar.
* Uma compra nova tem garantia de reembolso de 30 dias.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-9871a3e853d43a044d56e10078b47427db0c5b4c%2F09-billing-period.webp?alt=media" alt="O período de cobrança, com a seta em 24 meses" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-6af7e90b53a1c1f216f16cb870aea379699176af%2F09b-billing-1-month.webp?alt=media" alt="O período de cobrança em 1 mês, renovando pelo preço cheio" width="563"><figcaption></figcaption></figure>

**9. Pagamento.** A Hostinger prepara o seu servidor em cerca de 5 minutos e manda um e-mail quando está pronto.

**10. Pronto.** Pressione **Manage VPS**. Pule o domínio grátis: o goodcryptoX não precisa de um.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-74cd99ecc60de9b692d2ece5befcda9e17bf290c%2F11-ready.webp?alt=media" alt="Está tudo pronto, com a seta em Manage VPS" width="563"><figcaption></figcaption></figure>

**11. Visão geral.** Uma pesquisa curta abre: pressione **Skip**. Depois pressione **Docker manager** no cartão do Docker.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-106ebc9e276deee724e17a0edfc7fdf098891494%2F13-overview-clean.webp?alt=media" alt="A visão geral do VPS, com a seta em Docker manager" width="563"><figcaption></figcaption></figure>

<details>

<summary>Em outro provedor</summary>

Alugue um servidor pequeno com Ubuntu e Docker, com 2 GB de memória ou mais, em uma região perto de você. Muitos provedores oferecem Ubuntu com Docker pronto para instalar.

</details>

## Inicie o goodcryptoX <a href="#start-goodcryptox" id="start-goodcryptox"></a>

**12. Compose › Compose from URL**

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-cbbd312f6d8085c1c4e4060ba6c5018458778640%2F15-docker-manager.webp?alt=media" alt="Docker Manager, com a seta em Compose" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-f78d8bfd93a506fa7db821902183cf1cb3cd7ac9%2F16-compose-menu.webp?alt=media" alt="O menu Compose, com a seta em Compose from URL" width="563"><figcaption></figcaption></figure>

**13. O link e o nome.** Cole este link (o arquivo compose do goodcryptoX no GitHub, que usa a imagem mais recente), dê o nome `gcx` à aplicação e pressione **Deploy**.

```
https://raw.githubusercontent.com/GoodCryptoApp/gcx/main/compose.yaml
```

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-c5639bb955ce701dbacfd5d76afa19150d2e1af6%2F17b-compose-from-url-filled.webp?alt=media" alt="Compose from URL preenchido, com a seta em Deploy" width="563"><figcaption></figcaption></figure>

**14. Em execução.** Em um ou dois minutos, `gcx` mostra **Em execução**. A Hostinger pode oferecer a ativação de HTTPS com Traefik para seus aplicativos Docker: o goodcryptoX não precisa disso, pois o painel não abre nenhuma porta para a internet; feche a oferta.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-9113469ff32d1c7e626325323e1b3753c7de9f48%2F19-running.webp?alt=media" alt="Aplicações Docker: gcx, em execução, com as setas em Terminal e no menu da linha" width="563"><figcaption></figcaption></figure>

<details>

<summary>Se isso não funcionar</summary>

Há outras duas formas.

O texto do arquivo. Na Hostinger, escolha **Compose › Compose manually** e cole na aba **.yaml editor**, com o nome `gcx`. Em outro painel do Docker, crie o projeto à mão e cole.

```yaml
services:
  gcx:
    image: ghcr.io/goodcryptoapp/gcx:latest
    container_name: gcx
    network_mode: host
    init: true
    restart: unless-stopped
    stop_grace_period: 60s
    volumes: [gcx-data:/data, gcx-secret:/secret]
  updater:
    image: ghcr.io/goodcryptoapp/gcx:latest
    container_name: gcx-updater
    entrypoint: [gcx, updater]
    user: "0:0"
    network_mode: none
    init: true
    restart: unless-stopped
    volumes: [/var/run/docker.sock:/var/run/docker.sock, /root/.docker:/docker:ro, gcx-data:/data]
volumes:
  gcx-data: {name: gcx-data}
  gcx-secret: {name: gcx-secret}
```

Um terminal. Abra o console web do seu provedor, ou `ssh root@<your server's address>` no seu computador, e execute esta linha no servidor (com `sudo` antes de cada `docker` onde for preciso); o log segue na mesma janela:

```
curl -fsSLo compose.yaml https://github.com/GoodCryptoApp/gcx/releases/latest/download/compose.yaml && docker compose up -d && docker logs -f gcx
```

</details>

## Entre <a href="#sign-in" id="sign-in"></a>

**15. Os logs.** Na linha do `gcx`, abra o menu **⋮** (a seta à direita da linha na imagem acima) e pressione **View logs**, depois a aba **Logs**.

**16. O link.** Na primeira inicialização, as primeiras linhas do log mostram um link: selecione-o e copie.

<figure><img src="https://3303217878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjMXDuang2jfsDFolf49T%2Fuploads%2Fgit-blob-f463bf2ab9a2f140bd93fe39d4bc38e16b337d18%2F22-logs-link.webp?alt=media" alt="A aba de logs na primeira inicialização, com a seta no link" width="563"><figcaption></figcaption></figure>

**17. Abra.** Cole o link no navegador do seu computador e crie uma passkey com Touch ID, Face ID ou o desbloqueio do próprio computador. O goodcryptoX abre em my.goodcrypto.app, e daqui em diante esse endereço é a entrada neste dispositivo. Uma passkey salva no iCloud ou no Google funciona nos seus outros dispositivos da mesma conta; qualquer outro dispositivo se adiciona em Configurações › Dispositivos › **Adicionar um dispositivo**. O celular vem depois, pelo painel: Configurações › Dispositivos › **Adicionar um dispositivo** mostra um QR code para escanear ([Adicione um celular ou outro computador](#add-a-phone-or-another-computer)).

O link funciona uma vez: ele morre no instante em que um dispositivo o usa. Ele também expira em 10 minutos; para um novo, pressione **Restart** no menu da linha. Se my.goodcrypto.app mostrar “Offline desde”, os 10 minutos do link passaram e nenhum dispositivo foi pareado ainda: obtenha um novo link e abra em até 10 minutos. O link é uma chave: nunca o compartilhe nem o cole em nenhum outro lugar.

O mesmo dispositivo abre o painel pelo favorito ou pelo ícone da tela inicial e entra com Face ID ou Touch ID, sem link, sem código. Essa é a passkey que o pareamento criou. **Configure o goodcryptoX** no Dashboard guia você pelo resto: suas contas de exchange e depois o seu bot do Telegram.

<details>

<summary>Em que o my.goodcrypto.app se apoia</summary>

Seu servidor mantém uma conexão de saída com o relay do goodcryptoX, e o my.goodcrypto.app chega ao seu servidor por ela: pela internet, não por uma chamada direta. Tudo que passa vai selado entre o seu navegador e o seu servidor; o relay encaminha e não consegue ler nem guardar nada. A única consequência: se um dia o nosso relay acabar, esse endereço deixa de funcionar. O goodcryptoX em si continua rodando e operando no seu servidor. A entrada então é o túnel da seção recolhida abaixo; ele não precisa de nada nosso.

</details>

<details>

<summary>Se isso não funcionar</summary>

Para escanear um código com o celular, ou para um link novo de outro jeito: abra o terminal do contêiner (na Hostinger, **Terminal** na linha do `gcx`) e execute `gcx pair` (em outros lugares `docker exec gcx gcx pair`); um terminal desenha o código para que dê para escanear.

Ou chegue ao goodcryptoX por um túnel. No seu computador, abra o Terminal (PowerShell no Windows) e execute esta linha com o endereço do seu servidor (na Hostinger, depois de **IPv4** na visão geral):

```
ssh -N -L 8128:127.0.0.1:8128 root@<your server's address>
```

Responda `yes` na primeira vez e digite a senha do servidor (na Hostinger, a senha de root do passo 5). Nada mais aparece, e está certo: deixe a janela aberta enquanto usa o goodcryptoX. Depois execute `gcx open --print` no terminal do contêiner (em outros lugares `docker exec gcx gcx open --print`) e abra no navegador o link que ele imprime em até 60 segundos. O goodcryptoX abre em `http://localhost:8128/gcx`. Se o log citar uma porta diferente de 8128, use esse número nos dois lados da linha e no endereço. Entrar com Binance também funciona pelo túnel.

</details>

## Adicione um celular ou outro computador <a href="#add-a-phone-or-another-computer" id="add-a-phone-or-another-computer"></a>

Depois que o celular é adicionado, nenhum computador é necessário: dá para tocar tudo por ele.

Um celular ou computador novo é adicionado a partir de um dispositivo que já está dentro: Configurações › Dispositivos › **Adicionar um dispositivo** ([Acesso pelo celular](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/phone-access.md)).

Ter perdido todos os dispositivos é o único caso que volta ao servidor: na Hostinger, **Terminal** na linha do `gcx` e depois `gcx pair` para um link novo (em outros lugares `docker exec gcx gcx pair`). Essa é a recuperação; não há redefinição por e-mail, já que não existe conta conosco.

## Na sua própria rede <a href="#on-your-own-network" id="on-your-own-network"></a>

Em um servidor em casa, o goodcryptoX também pode abrir no notebook ou celular sem relay: ative **Conectar direto em casa** em Configurações › Dispositivos ou execute `gcx network on` no Terminal do contêiner (`docker exec gcx gcx network on` em outros lugares). Fica desativado até você ativar. O arquivo compose acima não precisa de mudança: usa a rede da própria máquina, então ativar a chave faz a porta responder nos endereços da máquina e nada mais muda; um firewall na frente do servidor precisa liberar essa porta. Para não ter nenhum contato com nosso relay, defina `GCX_PHONE_RELAY: ""` no serviço `gcx` antes do primeiro início. Os passos e o que fazer se perder um dispositivo estão em [Sua rede doméstica](#your-home-network).

Um servidor alugado não é uma rede doméstica: seus endereços ficam expostos à internet. Mantenha a chave desativada ali e use o relay ou o túnel.

## Atualizações e backups <a href="#updates-and-backups" id="updates-and-backups"></a>

O goodcryptoX se mantém atualizado no servidor: uma versão nova se instala sozinha em um momento tranquilo, como em um Mac, e antes termina o que está fazendo. Configurações › Geral › Instalação mostra a versão, e o botão **Atualizar** instala uma nova na hora se você não quiser esperar.

<details>

<summary>Se isso não funcionar</summary>

Na Hostinger, escolha **Atualizar** no menu da linha do `gcx`; em outros lugares, execute `docker compose pull && docker compose up -d` na pasta do `compose.yaml`.

</details>

O goodcryptoX guarda seus dados em dois volumes do Docker, `gcx-data` e `gcx-secret`. Faça backup dos dois juntos: `gcx-data` sozinho não consegue abrir as suas chaves.

## Servidores grátis e baratos <a href="#free-and-low-cost-servers" id="free-and-low-cost-servers"></a>

Servidores baratos e até grátis podem rodar o goodcryptoX. O servidor Arm Always Free da Oracle Cloud tem memória suficiente, mas a capacidade gratuita pode ser difícil de conseguir e a Oracle pode recuperar um servidor pouco usado. Vale considerar se você já tem uma conta na Oracle; para quem chega agora e quer a configuração mais fácil, a Hostinger continua sendo a mais fácil que encontramos.

### Oracle Cloud Always Free (grátis para sempre) <a href="#oracle-cloud-always-free" id="oracle-cloud-always-free"></a>

Escolha **Ampere A1**, com **Ubuntu**, **1 OCPU e 2 GB de memória**. A imagem Docker do goodcryptoX funciona em Arm e em Intel/AMD sem mudar os comandos. Evite o micro AMD grátis: o 1 GB de memória dele deixa pouco espaço para Ubuntu e goodcryptoX juntos.

A [cota gratuita atual](https://docs.oracle.com/en-us/iaas/Content/FreeTier/freetier_topic-Always_Free_Resources.htm) da Oracle, verificada em 22 de outubro de 2026, cobre este servidor; confira o rótulo de grátis e a estimativa antes de criar qualquer coisa. O crédito de teste com prazo é uma oferta diferente.

Antes de escolher a Oracle:

* O cadastro exige um cartão de crédito ou débito adequado e pode fazer uma retenção temporária; [fale com a Oracle](https://www.oracle.com/cloud/free/faq/) se a verificação falhar.
* Escolha com cuidado a sua [região de origem](https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/managingregions.htm): os servidores gratuitos precisam estar lá, e ela não pode ser mudada.
* Se não houver servidor gratuito disponível, tente outro domínio de disponibilidade nessa região ou tente mais tarde.
* A Oracle pode recuperar um servidor pouco usado mesmo com ele ligado; [faça backup dos dois volumes do goodcryptoX](#updates-and-backups) e conte com interrupções.
* Fazer upgrade mantém a cota gratuita mas permite cobranças acima dela; não faça upgrade só para evitar a recuperação.
* A Oracle pode [suspender ou encerrar uma conta parada por 30 dias](https://www.oracle.com/cloud/free/faq/); confira as mensagens dela e o seu servidor com regularidade.

### Configuração da Oracle <a href="#oracle-setup" id="oracle-setup"></a>

Estes passos seguem a documentação da Oracle; o passo a passo e as capturas aguardam uma conta Oracle verificada.

**1. Entre.** Abra a [Oracle Cloud](https://cloud.oracle.com/) com a sua conta de nuvem. Uma conta nova começa na [página Free Tier da Oracle](https://www.oracle.com/cloud/free/).

**2. Crie o servidor.** Siga o [guia de servidor Linux da Oracle](https://docs.oracle.com/en-us/iaas/Content/Compute/tutorials/first-linux-instance/overview.htm): **Compute › Instances › Create instance**. Escolha Ubuntu e depois o formato **VM.Standard.A1.Flex** com **1 OCPU e 2 GB**. Mantenha o disco de boot dentro da cota gratuita e salve a chave SSH quando a Oracle oferecer. A chave privada abre o seu servidor: mantenha-a privada.

**3. Confira a rede.** O servidor precisa de um endereço público e de acesso SSH. Permita SSH (TCP 22) a partir do endereço IP público do seu computador. O goodcryptoX não precisa de nenhuma porta de entrada adicional: use o túnel privado abaixo, ou o link de acesso em [Entre](#sign-in). Não abra a porta 8128 para a internet.

**4. Conecte.** No seu computador, abra o Terminal, ou o PowerShell no Windows. Troque os dois marcadores pelo arquivo da chave salva e pelo endereço público do servidor. No macOS ou Linux, execute antes `chmod 400 <your-private-key-file>`; no Windows, use os [passos de permissão de chave da Oracle](https://docs.oracle.com/en-us/iaas/Content/Compute/tutorials/first-linux-instance/overview.htm):

```
ssh -i <your-private-key-file> ubuntu@<your-server-address>
```

**5. Instale o Docker, se precisar.** Nesse terminal do servidor, siga a [instalação do Docker no Ubuntu](https://docs.docker.com/engine/install/ubuntu/), usando o repositório apt, e instale também o plugin Compose. As mesmas instruções cobrem Arm e Intel/AMD. Confira que `sudo docker compose version` imprime uma versão.

**6. Inicie o goodcryptoX.** Execute isto no servidor:

```
curl -fsSLo compose.yaml https://github.com/GoodCryptoApp/gcx/releases/latest/download/compose.yaml && sudo docker compose up -d && sudo docker logs -f gcx
```

**7. Abra o painel.** Use o link de acesso do log como em [Entre](#sign-in).

<details>

<summary>Use um túnel SSH em vez disso</summary>

Deixe isto rodando em um segundo terminal no seu computador:

```
ssh -i <your-private-key-file> -N -L 8128:127.0.0.1:8128 ubuntu@<your-server-address>
```

Depois execute `sudo docker exec gcx gcx open --print` no servidor e abra o link que ele imprime em até 60 segundos. Se o log citar outra porta, use esse número nos dois lados do túnel. Nunca compartilhe o link de acesso.

</details>

### Outros servidores pequenos <a href="#other-small-servers" id="other-small-servers"></a>

Preços publicados verificados em 22 de outubro de 2026; importam a moeda, os impostos, a região, o prazo de pagamento e a renovação. Leia o preço final antes de pagar. Estes provedores não tiveram o passo a passo tela por tela do goodcryptoX acima.

| Servidor                                                            | Preço publicado                                             | O que importa                                                                                                             |
| ------------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| [netcup VPS nano G11.5s](https://www.netcup.com/de/server/vps-lite) | € 3.69/mês com 19% de IVA incluído, prazo de seis meses     | 2 GB de memória, 60 GB de disco; só Nuremberg. Os preços variam com o seu país fiscal; escolha conectividade IPv4         |
| [OVHcloud VPS-1](https://www.ovhcloud.com/en/vps/)                  | A partir de US$ 4.54/mês                                    | 4 GB de memória, 40 GB de disco. Preço inicial; confirme o prazo, os impostos, a região e a renovação na página de pedido |
| [IONOS VPS S+](https://www.ionos.com/servers/vps)                   | US$ 2/mês por três meses, depois US$ 6/mês, prazo de um ano | 2 GB de memória, 60 GB de disco; o preço promocional baixo não dura o ano                                                 |

## Proxy <a href="#proxy" id="proxy"></a>

Um proxy envia todas as conexões com a exchange por um endereço que você escolhe, em um computador, um NAS ou um servidor.

Abra **Configurações › Geral › Privacidade e segurança › Servidor proxy**, coloque **Proxy ativado** em **Ativado**, digite `socks5://host:port` ou `http://host:port` e pressione **Salvar**. Sem endereço salvo, Salvar ativa o proxy. Com um endereço salvo, a chave é salva na hora; Desativado guarda o endereço para a próxima vez. O endereço salvo oculta a senha; **Editar** o abre com **Salvar** e **Cancelar**, e **Remover** o apaga e desativa o proxy. Um campo vazio não mostra aviso; um endereço que não é SOCKS5 nem HTTP avisa no campo depois de Salvar e não é salvo. Se o proxy exige login, use `socks5://user:password@host:port` ou `http://user:password@host:port`; codifique os caracteres especiais do login (por exemplo, `@` como `%40`). Use um proxy em que você confia. As conexões abertas com as exchanges se reconectam por ele sem reiniciar o goodcryptoX. Se o proxy falhar, o goodcryptoX avisa você; confira o endereço e o login, ou coloque o proxy em Desativado para conectar direto.

Para uma instalação em terminal ou Docker, defina `GCX_PROXY=socks5://host:port` (ou o endereço HTTP) no ambiente antes de iniciar o goodcryptoX. Depois que você salva o proxy em Configurações, essa escolha vale mais que o ambiente, inclusive Desativado. O proxy cobre as exchanges; o relay do goodcryptoX, os relatórios, as atualizações e outros serviços conectam direto.

Em um servidor ou NAS, você pode rodar uma VPN com um sidecar do Gluetun: adicione o serviço abaixo ao seu arquivo Compose, preencha os dados do seu provedor de VPN e mantenha o `network_mode: host` do goodcryptoX. Só o Gluetun usa a VPN; os serviços do goodcryptoX continuam diretos. Inicie o projeto atualizado e salve `http://127.0.0.1:8888` em Servidor proxy (ou defina `GCX_PROXY` no serviço `gcx`). A porta do proxy só fica disponível nesta máquina. O provedor de VPN precisa aceitar as credenciais OpenVPN que você fornecer; um NAS precisa ter `/dev/net/tun` e permitir a capacidade `NET_ADMIN`.

```yaml
  gluetun:
    image: qmcgaw/gluetun:latest
    cap_add: [NET_ADMIN]
    devices: [/dev/net/tun:/dev/net/tun]
    environment:
      VPN_SERVICE_PROVIDER: <your-vpn-provider>
      VPN_TYPE: openvpn
      OPENVPN_USER: <your-vpn-user>
      OPENVPN_PASSWORD: <your-vpn-password>
      HTTPPROXY: "on"
    ports: ["127.0.0.1:8888:8888/tcp"]
    restart: unless-stopped
```

### Sua rede doméstica <a href="#your-home-network" id="your-home-network"></a>

O goodcryptoX pode abrir diretamente na sua rede doméstica, sem nosso servidor: ative uma chave e a página mostra um link. Abra esse link em qualquer dispositivo em casa e o goodcryptoX está lá. Fica desativado até você ativar, em Mac, Windows, Linux, NAS ou servidor.

#### Ative <a href="#turn-it-on" id="turn-it-on"></a>

1. Abra o goodcryptoX como já faz: na máquina, pelo my.goodcrypto.app ou com o link impresso pela instalação. Você pode fazer isso de qualquer lugar, até de um celular fora de casa.
2. Abra **Configurações › Dispositivos** e ative **Conectar direto em casa**, no cartão **Rede doméstica** no fim da página.
3. O cartão mostra um link e seu código QR: “Abra este link ou escaneie o código QR em qualquer dispositivo na sua rede doméstica”.

O link fica igual até você desativar a chave. Guarde onde costuma guardar suas coisas: no navegador, em uma nota ou em uma mensagem para você mesmo.

Se o firewall do computador perguntar se o goodcryptoX pode aceitar conexões, ou bloquear, permita.

#### Conecte um dispositivo <a href="#connect-a-device" id="connect-a-device"></a>

Abra este link ou escaneie o código QR em qualquer dispositivo na sua rede doméstica. Clique no texto do link ou em **Copiar** para copiá-lo e depois cole no navegador desse dispositivo; no celular, você pode escanear o código QR com a câmera. O goodcryptoX abre e o dispositivo tem acesso. Faça o mesmo em cada dispositivo em casa.

Depois, o dispositivo abre o goodcryptoX nesse endereço pelo histórico do navegador ou pelo mesmo link: um dispositivo que já tem acesso abre sem outro passo e sem nova linha em Dispositivos.

Em um Mac ou iPhone, o navegador pode primeiro perguntar se pode encontrar dispositivos na sua rede local: permita. Se a página disser que o endereço está inacessível, ative o navegador em Ajustes do Sistema › Privacidade e Segurança › Rede Local (no iPhone: Ajustes › o navegador › Rede Local) e recarregue a página.

#### Em um NAS ou servidor <a href="#on-a-nas-or-a-server" id="on-a-nas-or-a-server"></a>

Pelo my.goodcrypto.app, você ativa em Configurações › Dispositivos, como acima. Sem contato com nosso servidor, ou antes de algum dispositivo ter acesso, o log da máquina diz como a cada início: “Conectar direto em casa: gcx network on no Terminal do contêiner, ou docker exec gcx gcx network on”.

1. Abra o Terminal do contêiner (em um NAS, o contêiner `gcx` no Container Manager; em um servidor, o console do provedor).
2. Execute `gcx network on` (no shell da máquina: `sudo docker exec gcx gcx network on`). Ele imprime um link e seu código QR.
3. Copie o link e abra no navegador do notebook.

Enquanto nenhum dispositivo tem acesso, o log imprime o mesmo link a cada início. O link é uma chave: qualquer pessoa que leia o log do contêiner pode vê-lo, então guarde o log só para você.

Se o endereço sugerido não é o que seu notebook alcança, informe você mesmo: `gcx network on http://192.168.1.20:8128`, com o endereço da sua máquina e a porta que o goodcryptoX imprime. O comando também lista os outros endereços da máquina para escolher.

Um goodcryptoX que roda como serviço em um computador sem tela (fora do Docker) não imprime essa linha ao iniciar: execute `gcx network on` no shell dele.

* `gcx network` informa se está ativado, em quais endereços, e imprime o link.
* `gcx network off` desativa.
* **Nenhum contato com nosso servidor:** defina `GCX_PHONE_RELAY: ""` no serviço `gcx` do arquivo compose antes do primeiro início. Depois que o goodcryptoX iniciou com nosso servidor, ativar a chave não desfaz esse primeiro contato. Com nosso servidor desativado, **Adicionar um dispositivo** não aparece: o link doméstico é a forma de entrar.
* **O arquivo compose incluído** (a rede da própria máquina) não precisa de mudança para a chave. Desativada, o goodcryptoX responde só na própria máquina, como antes; ativada, nos endereços da máquina. Se houver um firewall na frente do NAS ou servidor, ele precisa liberar a porta.

#### Quem pode abrir <a href="#who-can-open-it" id="who-can-open-it"></a>

Ative em casa, em uma rede em que você confia. Não encaminhe a porta no roteador.

Qualquer pessoa que tenha este link e esteja na sua rede pode adicionar um dispositivo enquanto a chave estiver ativada. O link funciona de qualquer lugar em que foi mostrado ou enviado: captura de tela, conversa, log da máquina. Você vê cada dispositivo em **Configurações › Dispositivos**: remova os que não adicionou. Para invalidar o próprio link, desative e reative a chave: isso cria um novo link e o antigo para de funcionar. Dispositivos já adicionados voltam a abrir o goodcryptoX quando você reativa, até você removê-los.

Qualquer outra pessoa que abre o endereço vê só o logo e "Para abrir o goodcryptoX neste navegador, use o link de casa em Configurações › Dispositivos num dispositivo em que o goodcryptoX esteja aberto."

Se perder um dispositivo ou suspeitar que outra pessoa entrou: remova o dispositivo, desative e reative a chave para obter um novo link, depois confira Dispositivos e remova os que não adicionou; revogue as chaves criadas nesse período e qualquer chave que possa ter sido copiada.

Um dispositivo que você adiciona aqui pode fazer o que você faz no computador, incluindo operar e mudar configurações, a menos que você defina **Somente leitura**. Um dispositivo em Somente leitura vê o endereço, nunca o link. HTTP transmite a página, o link e o login sem criptografia: alguém que leia o tráfego da sua rede pode copiá-los; seu próprio endereço HTTPS protege contra isso.

#### Em um notebook <a href="#on-a-laptop" id="on-a-laptop"></a>

Em um notebook, ao ativar **Conectar direto em casa**, aparece primeiro um aviso: escolha **Ativar** para continuar ou **Cancelar** para deixar desativado. Essa janela só aparece em notebooks. Enquanto estiver ativado, o cartão mantém o mesmo texto em cinza discreto junto à chave: “Em qualquer Wi-Fi em que MacBook-Pro entrar, qualquer pessoa nele pode abrir o goodcryptoX com este link”, com o nome da sua máquina. A rede doméstica é qualquer Wi-Fi ao qual o notebook esteja conectado, inclusive de um café ou hotel: qualquer pessoa lá com o link pode adicionar um dispositivo. Desative antes de sair de casa ou guarde o link só para você. O goodcryptoX reconhece um notebook pela bateria ou pelo gabinete; não consegue saber de dentro do Docker (Docker Desktop em um notebook não mostra essa linha), e também não mostra se a leitura falhar.

#### O que significa "rede doméstica" <a href="#what-home-network-means" id="what-home-network-means"></a>

O goodcryptoX responde aos dispositivos das redes às quais sua máquina está conectada e da sua própria VPN para casa; ele recusa o resto da internet. Essa verificação faz o possível, mas não é uma trava: um proxy, uma VPN ou um roteador que encaminha tráfego pode passar por ela, e a conexão pela qual uma VPN envia seu tráfego não é sua rede doméstica. Ela não sabe em qual Wi-Fi um dispositivo está nem distingue um convidado de alguém da família. O que mantém os outros de fora é o link e os dispositivos que você mantém.

#### Seu próprio endereço <a href="#your-own-address" id="your-own-address"></a>

Se já acessa a máquina por um nome seu, pelo seu próprio proxy HTTPS (Caddy, nginx), informe na máquina: `gcx network on https://gcx.example.com`. O goodcryptoX salva, ativa a chave e mostra o link nesse endereço. Um nome também mantém o acesso dos dispositivos quando o endereço da máquina muda. HTTPS em casa sem um proxy próprio está planejado para uma versão futura.

<details>

<summary>Configurações do proxy</summary>

A configuração padrão do Caddy funciona:

```caddyfile
gcx.example.com {
    reverse_proxy 127.0.0.1:8128
}
```

O nginx precisa manter o Host do navegador e passar WebSockets; as linhas habituais `X-Forwarded-*` podem ficar. Coloque o map no bloco `http` do nginx e o location dentro do servidor HTTPS que você já usa para esse nome:

```nginx
map $http_upgrade $gcx_connection {
    default upgrade;
    '' close;
}
location / {
    proxy_pass http://127.0.0.1:8128;
    proxy_http_version 1.1;
    proxy_set_header Host $http_host;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $gcx_connection;
}
```

Use a porta que o goodcryptoX imprime no lugar de 8128. Se uma página disser "Este endereço não está disponível", o proxy mudou o Host: mantenha como o navegador enviou.

Um proxy nesta máquina que passa um endereço `localhost` ao goodcryptoX o acessa como a própria máquina, e desativar a chave não o fecha: restrinja ou remova esse proxy você mesmo.

</details>

#### Seus dispositivos <a href="#your-devices" id="your-devices"></a>

* Cada dispositivo adicionado assim tem sua linha em **Configurações › Dispositivos**, marcada **Rede doméstica**, com **Pode negociar** ou **Somente leitura** e **Remover**. Remover encerra o acesso na hora.
* Um dispositivo sem uso por 90 dias precisa ser adicionado de novo. Um que você usa mantém o login. O navegador guarda o login para o endereço em que foi adicionado, então a mesma máquina em outro endereço (um nome em vez de um número) é adicionada de novo; o navegador também pode esquecer antes se você apagar seus dados.
* Um celular que usa nosso servidor (fora de casa) e o link doméstico (em casa) tem duas linhas: uma para cada forma de entrar. Remover remove a linha que você pressionar.
* Desativar a chave fecha o goodcryptoX para todos os dispositivos da rede doméstica; as linhas ficam, e ativar de novo permite que voltem. Dispositivos que usam nosso servidor não são afetados (Acesso pelo celular).
* Fora de casa, conecte-se à sua própria VPN para a rede doméstica e abra o mesmo endereço, ou use nosso servidor (Acesso pelo celular).
* Entrar com Binance funciona no endereço da sua rede doméstica, como 192.168.1.20. No seu próprio endereço (um nome), use uma chave de API gerada por você.

#### Conecte uma carteira neste endereço <a href="#connect-a-wallet-at-this-address" id="connect-a-wallet-at-this-address"></a>

Uma carteira se conecta no endereço doméstico como em qualquer outro: uma extensão de carteira no navegador (MetaMask, Rabby e outras), ou uma carteira de celular ao escanear o código QR. Abrir a janela da carteira envia à Reown / WalletConnect o endereço da página, inclusive seu endereço na rede doméstica (veja a política de privacidade). O código QR precisa que os servidores desses serviços estejam acessíveis.

Uma carteira não criptografa sua conexão com o goodcryptoX: no endereço doméstico ela continua sendo HTTP sem criptografia. Se não confia nessa rede, use [seu próprio endereço](#your-own-address) com HTTPS ou abra o goodcryptoX pelo nosso servidor (Acesso pelo celular).

Se o serviço de carteiras recusar esse endereço, a janela da carteira fecha e uma linha abaixo de **Conectar carteira** indica o que fazer: “Carteiras de celular não conectam neste endereço. Use uma extensão de carteira neste navegador ou abra esta página no navegador do app da sua carteira.” **Outras formas** acrescenta o acesso ao goodcryptoX pelo nosso servidor ou por um túnel SSH. Até você recarregar a página, a janela lista apenas as carteiras do navegador; sem nenhuma, Conectar carteira mostra “Nenhuma extensão de carteira neste navegador”.

#### Se algo der errado <a href="#if-something-goes-wrong" id="if-something-goes-wrong"></a>

* **O link não funciona mais:** a chave foi desativada e a reativação criou um novo link. Abra o novo em **Configurações › Dispositivos** em um dispositivo com acesso, ou execute `gcx network` na máquina.
* **A página mostra "Para abrir o goodcryptoX neste navegador, use o link de casa em Configurações › Dispositivos num dispositivo em que o goodcryptoX esteja aberto."** O dispositivo não está adicionado: foi removido, ficou sem uso por 90 dias ou o navegador o esqueceu. Abra o link de novo.
* **Todos os dispositivos foram perdidos:** no console da máquina, execute `gcx network` (`gcx network on` se a chave estiver desativada) e abra o link impresso. Não há redefinição por e-mail.
* **O endereço mudou** (o roteador pode atribuir outro) **ou os dados do navegador foram apagados:** abra o link de novo em **Configurações › Dispositivos**: ele traz o novo endereço. [Seu próprio endereço](#your-own-address) evita o primeiro caso.
* **O cartão diz “goodcryptoX está bloqueado”:** desbloqueie o goodcryptoX primeiro; o link reaparece. Os dispositivos já adicionados e o próprio link continuam funcionando enquanto isso.
* **Depois de mudar o goodcryptoX com Trazer** de um dispositivo aberto na rede doméstica: a nova máquina inicia com a chave desativada, sem dispositivos da rede doméstica e sem link, então esse dispositivo perde o acesso ao goodcryptoX ao reiniciar. Ative a chave lá e abra o novo link.

## Perguntas <a href="#questions" id="questions"></a>

### Quanto custa? <a href="#what-does-it-cost" id="what-does-it-cost"></a>

Você paga pelo servidor: em 18 de outubro de 2026, o KVM 1 da Hostinger custava US$ 6.49 por mês em 24 meses pagos adiantados, mais impostos, e servidores baratos e até grátis também podem rodar o goodcryptoX. O goodcryptoX em si é grátis de rodar; a única cobrança é 0.03% de cada operação executada que ele faz por você (no spot, de cada venda).

### O goodcryptoX em um servidor opera enquanto o meu computador está desligado? <a href="#does-goodcryptox-on-a-server-trade-while-my-computer-is-off" id="does-goodcryptox-on-a-server-trade-while-my-computer-is-off"></a>

Sim: o servidor roda o goodcryptoX dia e noite. Depois que o celular é adicionado, nenhum computador é necessário: dá para tocar tudo por ele.

### Qual provedor de servidor devo usar? <a href="#which-server-provider-should-i-use" id="which-server-provider-should-i-use"></a>

Qualquer provedor serve: os passos mostram a Hostinger, a mais fácil de configurar que encontramos, e os mesmos passos valem na AWS, DigitalOcean, Google Cloud, Azure ou qualquer outro.

### Preciso de um domínio? <a href="#do-i-need-a-domain" id="do-i-need-a-domain"></a>

Não: o goodcryptoX não precisa de um, e você o abre em my.goodcrypto.app.

### Onde estão os meus dados? <a href="#where-is-my-data" id="where-is-my-data"></a>

Em dois volumes do Docker no servidor, `gcx-data` e `gcx-secret`: faça backup dos dois juntos, já que `gcx-data` sozinho não consegue abrir as suas chaves.

### Posso mudar o goodcryptoX para outro servidor depois? <a href="#can-i-move-goodcryptox-to-another-server-later" id="can-i-move-goodcryptox-to-another-server-later"></a>

Sim: exporte no servidor antigo com `sudo docker exec -it gcx gcx export` no terminal dele, copie o arquivo para seu computador e use **Trazer** no painel do novo, incluindo contas e bots ([Mover goodcryptoX](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/moving-goodcryptox.md#from-one-server-to-another)).
