> 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-windows.md).

# Configure no Windows

Um único instalador para todo PC com Windows 10 e 11, Intel ou Arm; ele se atualiza sozinho e restaura a versão anterior se uma nova não iniciar.

O goodcryptoX para Windows é um app ao lado do relógio que você instala com um único instalador, sem senha de administrador, e usa no navegador. Ele se atualiza sozinho, inicia quando você faz login e opera enquanto o seu PC está ligado e online.

Windows 10 (versão 1903 ou posterior) ou Windows 11, de 64 bits, inclusive Windows 11 em Arm. Um único download para todo PC com Windows.

{% hint style="warning" %}
**O goodcryptoX só opera enquanto este PC está ligado e online.** Ele vigia suas ordens e seus bots enquanto roda. Uma pausa curta não faz mal: uma conexão caída por alguns minutos, uma reinicialização do app ou do PC, e o goodcryptoX se atualiza quando volta. Se este PC não fica ligado dia e noite, rode o goodcryptoX em um [NAS em casa](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/set-up-on-a-nas.md) ou em um [servidor alugado](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/set-up-on-a-server.md): configure uma vez, passo a passo, e depois use do mesmo jeito no navegador ou no celular, sem se preocupar com uma ordem perdida. Você pode começar aqui e [mudar depois](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/moving-goodcryptox.md) com um único arquivo.
{% endhint %}

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

1. [Baixe o goodcryptoX](https://goodcrypto.app/download/windows?utm_source=docs\&utm_medium=page\&utm_campaign=setup-windows) e abra-o. Se o navegador disser que o arquivo não é baixado com frequência, escolha mantê-lo.
2. O instalador não pede senha de administrador: escolha **Instalar**.
3. O goodcryptoX aparece ao lado do relógio e o navegador o abre. **Configure o goodcryptoX** no Dashboard guia você pelo resto: suas contas de exchange e depois o seu bot do Telegram.

<details>

<summary>Se o Windows disser que protegeu o seu PC</summary>

O goodcryptoX para Windows ainda não está assinado. O Windows vai dizer que protegeu o seu PC: escolha **Mais informações** e depois **Executar assim mesmo**. Se o Windows disser que o Controle Inteligente de Aplicativos bloqueou o goodcryptoX, este PC bloqueia todo programa não assinado e o goodcryptoX não pode ser instalado nele até sair a versão assinada.

</details>

O Windows pode esconder o ícone do goodcryptoX sob a seta ao lado do relógio: arraste-o para perto do relógio para mantê-lo à vista. O menu dele tem **Open the dashboard**, **Copy sign-in link**, a versão e **Sair do goodcryptoX**.

O goodcryptoX se atualiza sozinho, como no Mac.

O goodcryptoX inicia quando você faz login e continua rodando com o navegador fechado. Para desligar isso: Configurações › Geral › **Iniciar o goodcryptoX quando eu entrar**, ou Configurações do Windows › Aplicativos › Inicializar. **Sair do goodcryptoX** o encerra do jeito certo: antes, ele termina o que está fazendo.

Em casa, ative **Conectar direto em casa** em **Configurações › Dispositivos** e abra o link nos outros dispositivos; começa **Desativado**. Se o Firewall do Windows perguntar se o goodcryptoX pode aceitar conexões, permita na sua rede doméstica. [Sua rede doméstica](#your-home-network) mostra os passos.

## Seus dados <a href="#your-data" id="your-data"></a>

O goodcryptoX guarda seus dados em `%LOCALAPPDATA%\GCX` e o programa em `%LOCALAPPDATA%\Programs\GCX`.

Suas chaves nessa pasta ficam seladas à sua conta do Windows neste computador. Uma pasta de dados copiada não consegue assinar com outro usuário do Windows nem em outro PC: use Mudar para outra máquina.

## Desinstalar o goodcryptoX <a href="#removing-goodcryptox" id="removing-goodcryptox"></a>

Configurações do Windows › Aplicativos e depois goodcryptoX › **Desinstalar**. Antes, o goodcryptoX se encerra do jeito certo. Seus dados ficam em `%LOCALAPPDATA%\GCX`: apague essa pasta você mesmo para apagar também os dados. As ordens e posições na exchange não são afetadas.

## 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>

### O goodcryptoX opera enquanto o meu PC está em repouso? <a href="#does-goodcryptox-trade-while-my-pc-sleeps" id="does-goodcryptox-trade-while-my-pc-sleeps"></a>

Não: ele opera só enquanto este PC está ligado e online, embora as ordens no livro da exchange continuem sendo executadas. Depois de uma pausa curta, ele se atualiza quando volta.

### Em quais PCs com Windows o goodcryptoX roda? <a href="#which-windows-pcs-does-goodcryptox-run-on" id="which-windows-pcs-does-goodcryptox-run-on"></a>

Windows 10 (versão 1903 ou posterior) ou Windows 11, de 64 bits, inclusive Windows 11 em Arm. Um único download funciona em todo PC com Windows.

### Por que o Windows diz que protegeu o meu PC? <a href="#why-does-windows-say-it-protected-my-pc" id="why-does-windows-say-it-protected-my-pc"></a>

O goodcryptoX para Windows ainda não está assinado: escolha **Mais informações** e depois **Executar assim mesmo**.

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

Em `%LOCALAPPDATA%\GCX`, com o programa em `%LOCALAPPDATA%\Programs\GCX`. Ao desinstalar, seus dados ficam lá: apague essa pasta você mesmo para apagá-los também.

### Posso mudar o goodcryptoX para outra máquina depois? <a href="#can-i-move-goodcryptox-to-another-machine-later" id="can-i-move-goodcryptox-to-another-machine-later"></a>

Sim: mude com um único arquivo, contas e bots incluídos ([Mudar o goodcryptoX](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/moving-goodcryptox.md)); uma pasta de dados copiada não consegue assinar com outro usuário do Windows nem em outro PC.

### Ainda preciso do servidor de vocês? <a href="#do-i-still-need-your-server" id="do-i-still-need-your-server"></a>

Não: em casa, seus dispositivos abrem o goodcryptoX diretamente. Fora de casa, use sua própria VPN para casa ou nosso servidor ([Acesso pelo celular](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/phone-access.md)).
