Pular para o conteúdo principal

Instalar o Trade (comece aqui)

Um servidor na nuvem com 2 núcleos de CPU e 2 GB de memória é suficiente. Siga o passo a passo e um único comando faz a instalação.

Instale acompanhando o vídeo

Alibaba CloudAWS

Compre um servidorO ZML Trade é instalado no seu próprio servidor em nuvem, e suas chaves de API de corretora ficam armazenadas somente nele. Os requisitos são baixos: um servidor em nuvem básico é suficiente, a partir de cerca de 11 USD por mês.

O ZML Trade roda no seu próprio servidor em nuvem, e as chaves de API da sua corretora ficam armazenadas somente nesse servidor. Não é preciso ter conhecimento técnico: clique algumas vezes, copie e cole um comando e a instalação está pronta.

Requisitos mínimos

  • 2 núcleos de CPU, 2 GB de memória e 20 GB de disco, em Linux x86_64 (Ubuntu 24.04 LTS recomendado).

  • Escolha largura de banda cobrada por tráfego.

  • Escolha Japão (Tóquio) como região.

  • Um plano de entrada é suficiente, a partir de cerca de 11 USD por mês (preço oficial de 2026-10; vale o da página de ordem). O próprio ZML Trade é gratuito.

  • Você não precisa instalar o Docker antes nem preparar domínio ou certificado. O instalador cuida disso.

Escolha Japão (Tóquio): as corretoras podem recusar o acesso à API a partir de servidores de outras regiões. A região não pode ser alterada após a compra.

Passo a passo: escolha um

Se ainda não tem um servidor, escolha um provedor e acompanhe, da compra do servidor até a abertura do Trade:

Ambas permitem atualizar o servidor no console a qualquer momento: quando você operar mais combinações, faça o upgrade sem reinstalar o Trade.

Usar outro servidor em nuvem

Qualquer servidor que atenda aos requisitos mínimos acima funciona; o provedor e o plano ficam a seu critério. Antes de comprar e instalar, verifique estes pontos:

  • Escolha x86 (x86_64), não uma máquina ARM.

  • Escolha uma imagem de sistema Linux limpa (Ubuntu 24.04 LTS recomendado), não uma imagem com aplicativos como BT Panel ou WordPress: os programas que eles incluem ocupam a porta 443, que o Trade precisa usar.

  • Escolha largura de banda cobrada por tráfego. Em planos com muito pouca largura de banda, ou que a reduzem nos horários de pico, os dados de mercado chegam com atraso.

  • Escolha Japão (Tóquio) como região.

  • No grupo de segurança (firewall) do console da sua nuvem, permita TCP de entrada na porta 443. O Trade usa apenas essa porta.

  • Você pode fazer login como root, ou o usuário com o qual faz login pode usar sudo.

  • As listas de IPs permitidos das chaves de API das suas corretoras precisam do IP público deste servidor. Se o IP público do servidor puder mudar, associe um IP público fixo (um IP elástico) antes de instalar.

Quando estiver pronto, faça login no servidor e siga os passos abaixo para executar o comando de instalação.

Execute o comando de instalação

  1. Copie este comando (a página de instalação do Trade em nosso site tem um botão “Copiar comando de instalação”):

bash
curl -fsSL --compressed https://api.zmarketlab.com/install.sh -o install.sh && sudo bash install.sh

  1. Clique com o botão direito na linha de comando e escolha Colar, ou pressione Ctrl+V (⌘V no Mac) e, em seguida, pressione Enter.

  2. A tela lista 16 idiomas. Digite o número que aparece antes do idioma desejado e pressione Enter. O instalador e as páginas web do Trade passam a usar esse idioma.

  3. O restante é automático e não pergunta mais nada: verificar o servidor, instalar o Docker, baixar o ZML Trade, iniciá-lo e solicitar um certificado HTTPS. As cinco etapas são marcadas uma a uma. O símbolo antes da etapa atual continua girando e os segundos continuam contando, para que você saiba que está funcionando.

  4. Quando aparecer "Instalação concluída em …", a instalação terminou. Normalmente leva um ou dois minutos.

Se o Trade não puder ser instalado (por exemplo, falta de espaço em disco ou outro programa usando a porta 443), o instalador informa o motivo e para. Resolva conforme indicado e execute novamente o mesmo comando; as etapas já concluídas são ignoradas.

Abra o Trade e crie a conta de administrador

  1. No final, o terminal exibe “Abra este link no navegador (copie a linha inteira)”. A linha isolada logo abaixo é o seu endereço do Trade. Arraste o mouse de https até o final do endereço para selecioná-lo, clique com o botão direito e escolha Copiar; depois, cole-o na barra de endereços do navegador. Ctrl+C na linha de comando não copia. Se o endereço for longo e quebrar em duas linhas, selecione as duas linhas.

  2. A página exibe Configure a conta de administrador. Informe um nome de usuário e uma senha, aceite os termos e escolha Criar e continuar. Pronto, você já está no Trade.

Este link contém um código de uso único para criar a conta de administrador. Mantenha-o só para você e não o compartilhe. A conta fica armazenada apenas no seu próprio servidor, por isso guarde bem a senha. Se a esquecer, execute curl -fsSL --compressed https://api.zmarketlab.com/install.sh -o install.sh && sudo bash install.sh --reset-admin no servidor para definir uma nova.

Se você perder o link, faça login novamente no servidor, abra a linha de comando, cole este comando e pressione Enter para imprimir o link outra vez.

bash
curl -fsSL --compressed https://api.zmarketlab.com/install.sh -o install.sh && sudo bash install.sh --setup-link

O navegador avisa que o certificado não é confiável

O instalador solicita automaticamente um certificado confiável para o IP público do servidor. Quando consegue um, o navegador abre o Trade diretamente. Quando não consegue (o servidor está atrás de NAT ou a porta 443 não pode ser acessada pela internet), ele usa um certificado autoassinado e o terminal imprime uma linha extra com a impressão digital TLS SHA-256. Para verificá-la, clique no ícone à esquerda da barra de endereços do navegador, abra os detalhes do certificado, encontre a impressão digital SHA-256 e compare-a caractere por caractere com a impressa no terminal; continue somente se houver correspondência e pare se não houver.

Depois de abrir a porta, execute este comando para solicitar novamente um certificado confiável:

bash
curl -fsSL --compressed https://api.zmarketlab.com/install.sh -o install.sh && sudo bash install.sh --enable-ip-cert

Depois da instalação

  1. Conectar uma corretora: adicione as chaves de API da sua corretora. Na lista de IPs permitidos de cada chave, informe o IP de saída que o Trade lista, que é o IP público deste servidor.

  2. Fazer o pareamento com o Z Market Lab: envie para este Trade, com um clique, as oportunidades de que você gostar no Z Market Lab.

  3. Usar vários IPs públicos: quando você operar muitas combinações, adicione mais IPs públicos ao servidor; o Trade os encontra sozinho e distribui as requisições.

Atualizações

O Trade instala apenas versões assinadas. Por padrão, as novas instalações são atualizadas automaticamente assim que chega uma nova versão. Você pode mudar para atualizações manuais no Trade e escolher o horário, mas uma nova versão ainda é instalada em até 7 dias após a chegada. Correções urgentes que a ZML marca como obrigatórias são instaladas sem esperar. O banco de dados passa por backup antes da troca e, se algo falhar antes de a nova versão iniciar, a versão atual continua em execução. Uma atualização não exige fechar posições e nunca fecha posições por você. Durante o minuto ou dois da atualização, o Trade pausa as operações, e pode haver execução das ordens que já estão na corretora durante esse período.

Use o seu próprio domínio (avançado)

Para acessar o Trade com seu próprio domínio e um certificado confiável, edite o Caddyfile no diretório de instalação; as atualizações não o sobrescrevem. Antes de adicionar o site do seu domínio, remova o site padrão com certificado autoassinado; caso contrário, as conexões ao seu domínio continuarão recebendo o certificado autoassinado.