For the complete documentation index, see llms.txt. This page is also available as Markdown.

Configure em um NAS

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

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, com o seu modelo exato.

Inicie o goodcryptoX

  1. Na Central de Pacotes, instale o Container Manager.

  2. Baixe o arquivo compose do goodcryptoX: 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.

Se isso não funcionar

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

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}

Entre

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.

Se isso não funcionar

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:

Em uma segunda janela, entre no NAS com ssh <user>@<your NAS's address>, execute sudo 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. Um endereço de rede como http://192.168.1.20:8128 não o abre.

A partir daqui, tudo é como em um servidor: adicionar um celular ou outro computador, atualizações e backups.

Proxy

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 › Instalação › Servidor proxy, coloque Servidor proxy 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.

Perguntas

Qual NAS pode rodar o goodcryptoX?

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?

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

Onde estão os meus dados?

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?

Sim: Exportar no seu Mac e Trazer no painel do NAS; o navegador envia o arquivo, contas e bots incluídos (Mudar o goodcryptoX).

Última atualização