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

# Configure em um NAS

Um NAS em casa roda o goodcryptoX dia e noite sem nada para alugar; os passos usam um Synology, e os apps de contêiner de outros fabricantes aceitam o mesmo arquivo.

Um NAS em casa roda o goodcryptoX dia e noite, sem nada para alugar. Comece aqui, ou comece no seu Mac e mude para cá depois com um único arquivo. Os passos abaixo usam um Synology; os apps de contêiner de outros fabricantes aceitam o mesmo arquivo.

## Confira o seu NAS <a href="#check-your-nas" id="check-your-nas"></a>

O goodcryptoX precisa de três coisas:

1. **O app de contêiner do fabricante:** Synology Container Manager, QNAP Container Station, Asustor Docker Engine, UGREEN Docker, TerraMaster Docker Manager.
2. **Pelo menos 2 GB de memória instalada,** com cerca de 1 GB livre.
3. **Um processador de 64 bits** (x86-64 ou ARM64).

No Synology, servem os modelos Plus de 2018 em diante (DS218+, DS220+, DS224+, DS920+, DS923+ e outros) e os DS223 e DS423. Os modelos j e play, o DS124 e os DS118, DS218 e DS418 não servem. Não tem certeza? Pergunte no grupo do Telegram do goodcryptoX, [t.me/goodcrypto](https://t.me/goodcrypto), com o seu modelo exato.

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

1. Na **Central de Pacotes**, instale o **Container Manager**.
2. Baixe o arquivo compose do goodcryptoX: [compose.yaml](https://github.com/GoodCryptoApp/gcx/releases/latest/download/compose.yaml).
3. No Container Manager, **Projeto › Criar**: dê o nome `gcx`, defina o caminho para uma pasta nova no disco do próprio NAS (como `docker/gcx`), escolha **Carregar docker-compose.yml** e selecione o arquivo. Pressione **Próximo** até **Concluído**. O goodcryptoX inicia.

O arquivo é a versão mais recente do goodcryptoX no GitHub.

<details>

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

Escolha **Criar docker-compose.yml** em vez do carregamento e cole o texto do arquivo:

```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}
```

</details>

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

No Container Manager, abra o contêiner `gcx` e o log dele. Na primeira inicialização, as primeiras linhas mostram um link: copie-o, cole no navegador do seu computador e crie uma passkey com o Touch ID ou com o desbloqueio do próprio computador. O goodcryptoX abre em my.goodcrypto.app. O celular vem depois, pelo painel: Configurações › Dispositivos › **Adicionar um dispositivo** mostra um QR code para escanear.

O primeiro link é de uso único: ele morre no instante em que um dispositivo o usa. Ele também expira em 10 minutos: para um novo, reinicie o contêiner ou execute `gcx pair` no terminal do contêiner. O link é uma chave: nunca o compartilhe nem o cole em lugar nenhum.

O link passa pelo relay do goodcryptoX.

<details>

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

Chegue ao goodcryptoX por um túnel. Ative o SSH no NAS (**Painel de Controle › Terminal e SNMP › Terminal › Habilitar serviço SSH**; só uma conta de administrador pode entrar). No seu computador, abra o Terminal (PowerShell no Windows), execute esta linha com o seu usuário e o endereço do NAS, digite a senha e deixe a janela aberta:

```
ssh -N -L 8128:127.0.0.1:8128 <user>@<your NAS's address>
```

Em uma segunda janela, entre no NAS com `ssh <user>@<your NAS's address>`, execute `sudo docker exec gcx gcx open --print` e abra o link impresso no navegador em até 60 segundos. O goodcryptoX abre em `http://localhost:8128/gcx`. Um endereço de rede como `http://192.168.1.20:8128` só abre depois que você ativa **Conectar direto em casa**, abaixo.

</details>

A partir daqui, tudo é como em um servidor: [adicionar um celular ou outro computador](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/set-up-on-a-server.md#add-a-phone-or-another-computer), [atualizações e backups](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/set-up-on-a-server.md#updates-and-backups).

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

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

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

### Qual NAS pode rodar o goodcryptoX? <a href="#which-nas-can-run-goodcryptox" id="which-nas-can-run-goodcryptox"></a>

Um com o app de contêiner do fabricante, pelo menos 2 GB de memória e um processador de 64 bits. No Synology, servem os modelos Plus de 2018 em diante e os DS223 e DS423.

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

Sim: o NAS roda o goodcryptoX dia e noite, e você o abre pelo computador ou pelo celular.

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

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

### Posso começar no meu Mac e mudar para um NAS depois? <a href="#can-i-start-on-my-mac-and-move-to-a-nas-later" id="can-i-start-on-my-mac-and-move-to-a-nas-later"></a>

Sim: **Exportar** no seu Mac e **Trazer** no painel do NAS; o navegador envia o arquivo, contas e bots incluídos ([Mudar o goodcryptoX](https://docs.goodcrypto.app/goodcryptox-pt/goodcryptox-3.0/readme/moving-goodcryptox.md)).

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