HandyCafe Docs
it-admin

Primeiros Passos: Administrador de TI

Este guia aborda a configuracao tecnica do HandyCafe. Ao final, voce tera 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 implantacao dos clientes)

Passo 1: Instale o Servidor e os Clientes

Instalacao do servidor:

  1. Verifique se o PC servidor atende aos requisitos do sistema.
  2. Baixe e instale o HandyCafe Server no seu PC de gestao.
  3. Inicie o servidor e conclua o Assistente de Configuracao Inicial para criar a conta de administrador.
  4. Anote o endereco IP local do PC servidor. Os clientes precisarao dele para se conectar.

Instalacao 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 nao for encontrado automaticamente, insira o endereco IP do servidor manualmente nas configuracoes do cliente.
  5. Apos conectado, o cliente aparecera no Painel Administrativo do servidor.

Dica: Use o recurso de nomeacao automatica do servidor (Configuracoes > Clientes) para nomear os clientes automaticamente com um prefixo como "PC #1", "PC #2", etc. Voce pode personalizar os nomes de exibicao depois.

Consulte Instalacao do Servidor e Instalacao do Cliente para instrucoes detalhadas.

Passo 2: Configure as Opcoes de Rede

Navegue ate Configuracoes > Rede no servidor.

O HandyCafe utiliza quatro portas para comunicacao:

Porta Padrao Finalidade
Porta TCP 5001 Comunicacao de comandos e respostas
Porta de Arquivos 5002 Transferencia de arquivos entre servidor e clientes
Porta de Gerenciamento Remoto 5003 Controle de streaming de area de trabalho remota
Porta UDP 5004 Dados de streaming de tela

Configuracao:

  1. Defina as portas (os valores padrao funcionam para a maioria dos ambientes).
  2. Defina a Chave de Conexao. Este e um segredo compartilhado usado para autenticacao 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, saida 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 Configuracoes de Rede para todas as opcoes de rede.

Passo 3: Configure o Menu do Cliente

O menu do cliente e o lancador de aplicativos que os clientes veem em sua area de trabalho. Navegue ate Configuracoes > Clientes > aba Conteudo.

  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 descricao.
    • Escolha o tipo do aplicativo: Jogo, Navegador, Link, Arquivo ou Aplicativo.
    • Defina o caminho do executavel ou URI de abertura.
    • Faca upload de um icone e opcionalmente de uma imagem de poster para o cartao 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 alteracoes sao enviadas automaticamente a todos os clientes conectados em tempo real via TCP.

Dica: Use a integracao IGDB para buscar metadados e icones de jogos automaticamente.

Consulte Menu do Cliente para a documentacao completa do construtor de menus.

Passo 4: Configure a Tela de Espera e a Aparencia

Tela de Espera (Configuracoes > Clientes > aba Tela de Espera):

A tela de espera e o que os clientes veem quando nenhuma sessao esta ativa (a tela de bloqueio).

  1. Ative a apresentacao de slides da tela de espera.
  2. Adicione imagens ou vídeos (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Defina a duracao por item e o efeito de transicao (fade, deslizar, zoom).
  4. Opcionalmente ative uma sobreposicao de relogio e a exibicao do nome da lan house com cores personalizadas.
  5. Clique em Salvar.

Aparencia (Configuracoes > Clientes > aba Aparencia):

Configure a aparencia da area de trabalho online que os clientes utilizam durante as sessoes.

  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 solida, gradiente, imagem ou video com sobreposicao e desfoque.
  4. Ajuste a densidade dos cartoes (Grande, Media, Compacta) e os efeitos de hover.
  5. Clique em Salvar.

Consulte Tela de Espera do Cliente e Aparencia do Cliente para todas as opcoes.

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

Verifique se o gerenciamento remoto esta funcionando:

Capturas de tela:

  1. No Painel Administrativo, selecione qualquer cartao de cliente online.
  2. Clique em Capturar Tela no cartao do cliente.
  3. Uma captura de tela do monitor do cliente aparecera no visualizador.
  4. Voce pode baixar ou atualizar a captura de tela.

Area de trabalho remota:

  1. Selecione um cartao de cliente online e clique em Area de Trabalho Remota.
  2. Uma janela de area de trabalho remota sera aberta com streaming H.264 ao vivo.
  3. Voce pode controlar o mouse e o teclado no PC remoto.
  4. A sincronizacao de area de transferencia funciona entre servidor e cliente.

Nota: A area de trabalho remota utiliza streaming UDP. Se o video estiver com atraso, verifique a largura de banda da rede e garanta que a porta UDP 5004 nao esteja bloqueada. Voce tambem pode ajustar a taxa de bits nas configuracoes de streaming (350-25.000 kbps).

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

Visao 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
    +-- ...

Proximos Passos