HashCore Docs
Início Rápido

Instalação do Agente no Linux

Visão Geral da Instalação

Tempo total de instalação: ~10 minutos
  • Conexão de internet estável
  • 500 MB de espaço livre em disco
  • 4+ GB RAM de memória livre
  • Permissões de root (sudo) no servidor/computador
  • Ubuntu / Debian / Linux (x64)

Requisitos do sistema:

  • Gerenciamento centralizado de múltiplos locais
  • Acesso à nuvem aos dados de qualquer lugar do mundo
  • Monitoramento em Real-time de Hashrate, temperatura, status
  • Detecção automática de Workers na rede

O que você obterá após a instalação:

é um agente local para coletar dados de ASIC-miners e transmiti-los para o sistema de monitoramento em nuvem HashCore Pulse. O agente opera em ambiente Linux e fornece monitoramento em Real-time do seu equipamento de mineração.


Preparação do agente na nuvem

Nesta etapa, criaremos um perfil de agente e definiremos os parâmetros para a busca de Workers na sua rede.

  1. Faça login no painel de controle HashCore Pulse.
  2. No menu esquerdo, selecione Agents e clique em + New Agent.
  3. Digite o nome do agente (por exemplo, Main_Site) e clique em Create.
  4. Na janela que aparecer, clique no botão Linux X64 para baixar o arquivo de instalação.
  5. Certifique-se de copiar e salvar o Agent ID e o Agent Secret (se você fechou a janela, pode encontrá-los clicando nos três pontos ao lado do agente → Show Credentials).
  6. Clique no nome do agente criado e clique em + New Task para configurar a varredura:
  • Task name: nome da tarefa (por exemplo, Main Network Scan).
  • IP Range: clique em + Add IP range e especifique o intervalo da sua rede (por exemplo, 192.168.0.0 - 192.168.0.255).
  • Unlock Configs: preencha esta aba se estiver usando Firmware personalizados (Vnish, Bitmain, etc.), especificando as senhas para acesso ao ASIC (por exemplo, admin ou root).
  1. Clique em Create. A nuvem está pronta para uso!

Instalação do agente no Linux

Agora, moveremos o arquivo baixado para o ambiente de trabalho e o instalaremos.

  1. Abra o terminal e crie uma pasta para o agente: mkdir ~/Pulse
  2. Coloque o arquivo baixado nesta pasta e descompacte-o.
  3. Navegue até a pasta com os arquivos descompactados: cd ~/Pulse/<nome_da_pasta_descompactada>
  4. Execute o instalador (serão necessárias permissões de administrador): sudo ./pulse-agent-updater
  5. Digite a senha da sua conta, confirme a instalação digitando y e pressione Enter. Aguarde a conclusão do processo.

Gerenciamento do agente e estatísticas locais

No Linux, a bandeja do sistema nem sempre está disponível (no GNOME/KDE ela existe, mas no XFCE não). Portanto, o agente é gerenciado via navegador.

1. Operação via navegador:

  • Abra o navegador no mesmo computador/servidor e acesse: http://localhost:4030 (ou http://127.0.0.1:4030).
  • Insira o Agent ID e a Secret key (que você copiou na primeira etapa) nos campos correspondentes.
  • Clique no botão Submit.

2. Gerenciamento via bandeja do sistema: Quando o Pulse Agent está em execução, seu ícone aparece na bandeja do sistema (no canto inferior direito da tela). Ao clicar nele, você abrirá o menu de gerenciamento. A aparência do menu e a cor do ícone dependem do estado atual do programa:

Ícone verde (Pulse Agent: Running)

Isso significa que o agente está ativo e escaneando a rede. Ao clicar, estão disponíveis:

  • Stop Service — parar completamente a operação do agente.
  • Restart Service — reinicialização rápida do programa (necessária se você alterou as configurações).
  • Dashboard & Settings — ir para o navegador no endereço http://localhost:4030 para visualizar as configurações ou logs.
  • About — visualizar informações sobre a versão do programa.

Ícone cinza (Pulse Agent Service: Stopped)

Isso significa que o programa está em execução, mas a busca por Workers foi interrompida. Ao clicar, estão disponíveis:

  • Start Service — iniciar o processo de varredura e transmissão de dados para a nuvem.
  • Dashboard & Settings — ir para o navegador no endereço http://localhost:4030 para visualizar as configurações ou logs.
  • About — visualizar informações sobre a versão do programa.

3. Estatísticas locais: Após inserir as chaves, a página será atualizada e você verá dados detalhados sobre a operação do agente:

  • Credentials — aqui você pode vincular outro agente, alterando o Agent ID e a Secret key.
  • uptime — tempo de operação contínua do programa (em segundos).
  • time — data e hora atuais.
  • version — versão instalada do Pulse Agent.
  • monitor_status — status do monitoramento (ligado — on, desligado — off).
  • connection_status — conexão com a nuvem (status: connected, initializing, domainNotAvailable, notAuthorized, internalError). Para funcionar, o status deve ser connected.
  • agent_id — número único do agente com o qual a conexão está atualmente estabelecida.
  • worker_threads — número de threads de varredura paralelas.
  • total — número total de endereços IP que estão sendo verificados atualmente.
  • found_miners — número de Workers encontrados, divididos por tipos de Firmware (vnish, bitmain e whats).
  • last_metric_submit — dados sobre o último envio para a nuvem:
    • elapsed_secs — quantos segundos se passaram desde o último envio.
  • metrics_count — número de métricas enviadas.
  • ip_ranges — intervalos de endereços IP que o agente recebeu da nuvem para varredura.

Verificação e gerenciamento

Vamos garantir que as informações dos seus dispositivos estão sendo enviadas com sucesso para o servidor.

  1. Acesse o site pulse.hashcore.com.
  2. Abra a seção Dashboard: os gráficos de Hashrate e o contador de dispositivos (Workers) devem exibir dados atualizados.
  3. Vá para a seção Workers: aqui aparecerá uma lista de todos os Workers encontrados. Para cada dispositivo, informações detalhadas estarão disponíveis: endereço IP, Hashrate, temperatura, consumo de energia, operação dos coolers e versão do Firmware.

Manutenção e gerenciamento (Referência de comandos)

Para gerenciar o agente no Linux, use os seguintes comandos no terminal:

Ação / ArquivoComando / Caminho
Reiniciar (ao trocar chaves ou rede)sudo service pulse-agent restart
Iniciar / Pararsudo service pulse-agent start / stop
Logs (últimas 20 linhas)sudo journalctl -u pulse-agent -n 20
Logs (em tempo real)sudo journalctl -u pulse-agent -f
Configuração (YAML)/var/lib/pulse-agent/conf.yaml
Pasta de logs/var/log/pulse-agent/
Remoção completasudo /opt/pulse-agent-updater/pulse-agent-updater uninstall