HandyCafe Docs
it-admin

Primeiros Passos: Administrador de TI

Este guia aborda a configuração técnica do HandyCafe. Ao final, você terá o servidor e os clientes instalados, a rede configurada, os menus de aplicativos montados e o gerenciamento remoto testado.

Tempo estimado: 5 minutos (mais o tempo de implantação dos clientes)

Passo 1: Instale o Servidor e os Clientes

Instalação do servidor:

  1. Verifique se o PC servidor atende aos requisitos do sistema.
  2. Baixe e instale o HandyCafe Server no seu PC de gestão.
  3. Inicie o servidor e conclua o Assistente de Configuração Inicial para criar a conta de administrador.
  4. Anote o endereço IP local do PC servidor. Os clientes precisarão dele para se conectar.

Instalação do cliente (repita para cada PC):

  1. Baixe o HandyCafe Client em cada PC destinado aos clientes.
  2. Instale e inicie o cliente.
  3. O cliente busca o servidor na rede local usando descoberta mDNS.
  4. Se o servidor não for encontrado automaticamente, insira o endereço IP do servidor manualmente nas configurações do cliente.
  5. Após conectado, o cliente aparecerá no Painel Administrativo do servidor.

Dica: Use o recurso de nomeação automática do servidor (Configurações > Clientes) para nomear os clientes automaticamente com um prefixo como "PC #1", "PC #2", etc. Você pode personalizar os nomes de exibição depois.

Consulte Instalação do Servidor e Instalação do Cliente para instruções detalhadas.

Passo 2: Configure as Opções de Rede

Navegue até Configurações > Rede no servidor.

O HandyCafe utiliza quatro portas para comunicação:

Porta Padrão Finalidade
Porta TCP 5001 Comunicação de comandos e respostas
Porta de Arquivos 5002 Transferência de arquivos entre servidor e clientes
Porta de Gerenciamento Remoto 5003 Controle de streaming de área de trabalho remota
Porta UDP 5004 Dados de streaming de tela

Configuração:

  1. Defina as portas (os valores padrão funcionam para a maioria dos ambientes).
  2. Defina a Chave de Conexão. Este é um segredo compartilhado usado para autenticação HMAC-SHA256. Todos os clientes devem utilizar a mesma chave.
  3. Clique em Salvar.

Regras de firewall:

Certifique-se de que estas portas estejam abertas tanto no servidor quanto nos PCs clientes:

  • TCP: 5001, 5002, 5003 (entrada no servidor, saída nos clientes)
  • UDP: 5004 (bidirecional para streaming de tela)

Importante: Todos os PCs devem estar na mesma rede local (sub-rede). O HandyCafe utiliza mDNS para descoberta de clientes, o que requer conectividade LAN.

Consulte Configurações de Rede para todas as opções de rede.

Passo 3: Configure o Menu do Cliente

O menu do cliente é o lançador de aplicativos que os clientes veem em sua área de trabalho. Navegue até Configurações > Clientes > aba Conteúdo.

  1. Crie categorias. Agrupe os aplicativos por tipo (ex.: Jogos, Navegadores, Redes Sociais, Ferramentas).
  2. Adicione aplicativos a cada categoria:
    • Defina o nome do aplicativo e a descrição.
    • Escolha o tipo do aplicativo: Jogo, Navegador, Link, Arquivo ou Aplicativo.
    • Defina o caminho do executável ou URI de abertura.
    • Faça upload de um ícone e opcionalmente de uma imagem de pôster para o cartão do aplicativo.
  3. Reordene categorias e aplicativos usando os controles de arraste.
  4. Alterne a visibilidade para exibir ou ocultar itens.
  5. Clique em Salvar.

As alterações são enviadas automaticamente a todos os clientes conectados em tempo real via TCP.

Dica: Use a integração IGDB para buscar metadados e ícones de jogos automaticamente.

Consulte Menu do Cliente para a documentação completa do construtor de menus.

Passo 4: Configure a Tela de Espera e a Aparência

Tela de Espera (Configurações > Clientes > aba Tela de Espera):

A tela de espera é o que os clientes veem quando nenhuma sessão está ativa (a tela de bloqueio).

  1. Ative a apresentação de slides da tela de espera.
  2. Adicione imagens ou vídeos (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Defina a duração por item e o efeito de transição (fade, deslizar, zoom).
  4. Opcionalmente ative uma sobreposição de relógio e a exibição do nome da lan house com cores personalizadas.
  5. Clique em Salvar.

Aparência (Configurações > Clientes > aba Aparência):

Configure a aparência da área de trabalho online que os clientes utilizam durante as sessões.

  1. Selecione um tema: Neon Arena, Crimson Pulse ou Emerald Depth.
  2. Escolha um preset de layout: Split Classic, Hero Wide Top, Catalog Wide Bottom ou Compact Focus.
  3. Configure o fundo: cor sólida, gradiente, imagem ou vídeo com sobreposição e desfoque.
  4. Ajuste a densidade dos cartões (Grande, Média, Compacta) e os efeitos de hover.
  5. Clique em Salvar.

Consulte Tela de Espera do Cliente e Aparência do Cliente para todas as opções.

Passo 5: Teste a Área de Trabalho Remota e as Capturas de Tela

Verifique se o gerenciamento remoto está funcionando:

Capturas de tela:

  1. No Painel Administrativo, selecione qualquer cartão de cliente online.
  2. Clique em Capturar Tela no cartão do cliente.
  3. Uma captura de tela do monitor do cliente aparecerá no visualizador.
  4. Você pode baixar ou atualizar a captura de tela.

Área de trabalho remota:

  1. Selecione um cartão de cliente online e clique em Área de Trabalho Remota.
  2. Uma janela de área de trabalho remota será aberta com streaming H.264 ao vivo.
  3. Você pode controlar o mouse e o teclado no PC remoto.
  4. A sincronização de área de transferência funciona entre servidor e cliente.

Nota: A área de trabalho remota utiliza streaming UDP. Se o vídeo estiver com atraso, verifique a largura de banda da rede e garanta que a porta UDP 5004 não esteja bloqueada. Você também pode ajustar a taxa de bits nas configurações de streaming (350-25.000 kbps).

Consulte Área de Trabalho Remota e Capturas de Tela para todos os recursos remotos.

Visão Geral da Arquitetura de Rede

PC Servidor (Gestao)
    |
    |--- TCP (5001) --- Comando/Resposta (bincode + HMAC-SHA256)
    |--- TCP (5002) --- Transferencia de Arquivos
    |--- TCP (5003) --- Canal de Controle de Gerenciamento Remoto
    |--- UDP (5004) --- Streaming de Tela (H.264)
    |--- mDNS ------- Descoberta de Clientes (automatica)
    |
    +-- PC Cliente 1
    +-- PC Cliente 2
    +-- PC Cliente 3
    +-- ...

Próximos Passos