Documentação do aplicativo.

Visão geral

O RackLab é um aplicativo local-first para documentar, planejar e validar redes de computadores. O projeto é o centro de tudo: racks, equipamentos, portas, cabos, VLANs, sub-redes, plantas baixas e simulações vivem no mesmo workspace.

Ele foi feito para quem precisa responder perguntas concretas: onde este cabo termina, qual VLAN passa por este switch, qual IP está livre, o que muda se eu mover este rack e se a configuração proposta faz sentido antes de tocar na produção.

Conceitos do workspace

Instalação e primeiro projeto

Requisitos

• Windows: Windows 10/11 64-bit.
• Linux: Debian/Ubuntu 22.04+ 64-bit, como pacote .deb ou .AppImage portátil.
• Navegador: a demonstração web funciona em navegadores modernos com IndexedDB e sessionStorage.

Instalação por sistema

O RackLab é distribuído apenas para Windows e Linux. Não há instalador para macOS: use a demonstração web para avaliar o produto nesse sistema.

No Windows, o pacote é portátil: para atualizar, baixe o ZIP novo e substitua os arquivos. No Linux, o AppImage se atualiza sozinho; o .deb é atualizado baixando e instalando o pacote novo por cima da versão atual. Projetos e licenças ficam na pasta do usuário e não são removidos na atualização nem na desinstalação.

1. Baixe o instalador. Use a página de download e confira o SHA-256 quando disponível. No Linux, instale o .deb com o gerenciador de pacotes ou use o .AppImage portátil.
2. Abra o RackLab. O aplicativo inicia no onboarding e oferece o projeto de exemplo Rede Matriz ou um workspace vazio.
3. Escolha o modo de uso. Use o projeto de exemplo para explorar os recursos ou crie um projeto novo para a sua rede. A demonstração web abre com dados temporários.
4. Ative a licença ou use o teste. São 14 dias de teste gratuito por dispositivo. Depois do teste, ative com uma chave online ou pelo fluxo offline.
5. Salve e faça backup. O projeto é salvo automaticamente no armazenamento local. Use Exportar projeto JSON para manter uma cópia externa.

Primeiro projeto em cinco minutos

1. Crie ou renomeie o projeto no cabeçalho.
2. Monte pelo menos um rack e instale o switch principal.
3. Adicione as VLANs e as sub-redes que serão usadas.
4. Conecte as portas e registre os cabos.
5. Abra a planta baixa, importe a imagem e posicione o rack.
6. Rode um ping ou traceroute para validar o caminho documentado.
7. Exporte um JSON e um relatório HTML para guardar a linha de base.

Interface e navegação

A navegação lateral separa as áreas de trabalho. O projeto ativo permanece o mesmo ao trocar de página; a maior parte das telas edita o workspace aberto.

Barra de ferramentas do canvas

• Físico / Lógico: alterna entre racks e grafo de nós.
• Esquema / Painéis: muda a representação do modo físico entre vista compacta e painéis com portas e LEDs.
• Selecionar, Cabo e Mover tela: ferramentas de interação do canvas.
• Equipamento e Rack: atalhos para adicionar novos itens.
• Simular: abre o painel de simulação L2/L3.
• Desfazer / Refazer: histórico de alterações do workspace.
• Grade, encaixe e fluxo: preferências visuais do canvas.
• Snapshot, importar e exportar: backup e interoperabilidade.

Inspetor

O inspetor lateral mostra o contexto do item selecionado. Ele edita racks, equipamentos, portas, acessos, VLANs, sub-redes, comentários e ambientes da planta. Quando nada está selecionado, exibe a visão geral do projeto ou da planta ativa.

Paleta de comandos

Use Ctrl + K no Windows/Linux para navegar, criar racks, criar plantas, exportar e executar outras ações sem tirar as mãos do teclado.

Tema e idioma

O tema claro/escuro é aplicado à interface e às plantas baixas. Os canvases técnicos mantêm contraste adequado nos dois temas. O seletor de idioma cobre a shell e as preferências em português, inglês e espanhol.

Topologia física

O modo físico representa o ambiente como ele é instalado: racks, unidades, equipamentos, portas, cabos e energia. É a base para documentação operacional e para a agenda de cabos.

Racks e unidades

• Crie um rack com nome, localização, quantidade de U e capacidade de energia.
• Instale equipamentos escolhendo a unidade inicial e a altura em U.
• O inspetor mostra ocupação, ativos instalados e consumo estimado.
• Use as tomadas e conexões de energia para documentar a distribuição elétrica.

Equipamentos e portas

Cada ativo pode ter portas RJ45, SFP/SFP+, console, energia, USB, HDMI, áudio, serial e portas genéricas. O configurador em lote cria sequências como Gi0/1…Gi0/24 e preserva portas extras.

• Cadastre marca, modelo, tipo, sistema operacional, imagem e observações.
• Defina IP de gerência, sub-rede, VLAN e status.
• Use perfis de acesso SSH, Telnet, HTTP/HTTPS, SNMP (v1/v2c/v3), console e API.
• Documente portas livres, ocupadas, desabilitadas e com defeito.

Cabos e validação

Conecte portas com a ferramenta de cabo ou arrastando a partir de uma porta. O RackLab registra tipo de cabo, cor, comprimento, padrão e status do link.

• Tipos comuns: cobre, fibra, DAC e console.
• Padrões: Cat5e, Cat6, Cat6a, OM3, OM4 e DAC.
• Validação de distância e compatibilidade entre portas.
• Fluxo animado opcional para leitura rápida dos links ativos.

Vista de painéis e bancada

Alterne para Painéis para ver os equipamentos em escala real no canvas. Um duplo clique (ou Enter) abre a bancada do ativo, com frente, traseira, portas, LEDs, fontes e ligação de cabos sem sair do painel.

Seleção e organização

• Clique para selecionar; Shift + clique para seleção múltipla.
• Arraste uma área vazia para selecionar vários ativos.
• Use guias de alinhamento, alinhar/distribuir, copiar/colar e snap-to-grid.
• Use Alt + setas para mover o ativo selecionado com precisão.

Topologia lógica e Wi-Fi

O modo lógico transforma o mesmo projeto em um grafo de nós e conexões. As ligações vêm das portas e cabos documentados; não é um desenho paralelo que precisa ser mantido à mão.

Grafo lógico

• Ative Lógico na barra de ferramentas.
• Os nós podem ser arrastados; o layout automático organiza as categorias principais.
• As arestas representam os cabos físicos documentados.
• Selecione um nó ou link para inspecionar o ativo ou a conexão.

Wi-Fi derivado da configuração

Access points, roteadores Wi-Fi, câmeras e estações podem ter rádio configurado com SSID, banda, canal, segurança, senha, alcance e potência. O RackLab deriva as associações a partir da posição e do alcance: não é necessário criar um cabo para cada cliente sem fio.

• Access point: anuncia o SSID e atende clientes.
• Roteador Wi-Fi: atende clientes e pode fazer backhaul com outro rádio.
• Cliente: procura o broadcaster mais próximo com o mesmo SSID.
• Backhaul: enlace entre rádios com o SSID de uplink configurado.

Na planta baixa, os enlaces aparecem tracejados e os rádios podem exibir círculos de cobertura. No grafo lógico, os mesmos enlaces são desenhados como arestas específicas.

Plantas baixas

A planta baixa é a vista superior do ambiente. Ela serve para localizar racks, mesas, câmeras, APs e clientes, além de mostrar a cobertura Wi-Fi de forma visual.

1. Crie a planta. Informe nome, descrição e dimensões lógicas. Use o botão Nova planta na barra lateral ou na paleta de comandos.
2. Importe a imagem. Aceita PNG, JPG, WebP e SVG. Fontes de até 12 MB são otimizadas para WebP com no máximo 2.200 px no maior lado; SVG tem limite de 700 KB.
3. Ajuste a escala. Informe a largura e a altura da planta e quantos pixels representam um metro. A escala é usada nas distâncias e no alcance Wi-Fi.
4. Desenhe os ambientes. Crie datacenter, salas e áreas abertas. O tipo define a cor e a semântica do ambiente.
5. Posicione racks e ativos. Traga itens existentes para a planta ou crie novos pela barra superior. O posicionamento automático tenta evitar sobreposição.
6. Conecte a planta ao projeto. Dê duplo clique em um rack ou use Abrir no workspace para centralizar o rack na vista física do datacenter.

Ambientes: criar, editar e remover

Navegação e movimentação

• Arraste o fundo para mover a tela, inclusive dentro de uma sala.
• Arraste um rack ou ativo para reposicionar somente aquele item.
• Arraste o cabeçalho do ambiente para mover a sala inteira.
• Use a roda do mouse para zoom; o zoom mantém o ponto sob o cursor.
• Use Ajustar à tela para reenquadrar a planta.
• Pressione Esc para cancelar um arraste em andamento.

Mesas e equipamentos apoiados

Mesas e bancadas podem hospedar roteadores, notebooks, câmeras e APs. Ao mover a mesa, os equipamentos apoiados acompanham o deslocamento. Use o campo Apoio / mobiliário no inspetor para criar ou alterar o vínculo.

Wi-Fi na planta

• Ative Mostrar enlaces Wi-Fi para ver associações e backhaul.
• Ative Mostrar cobertura Wi-Fi para exibir os raios de alcance.
• O painel Wi-Fi na planta resume SSIDs, rádios e clientes.
• As cores indicam a banda: 2,4 GHz, 5 GHz e 6 GHz.

Inventário e catálogo

O inventário é a lista operacional de ativos do projeto. Ele complementa o canvas: serve para busca, conferência, documentação e exportação.

Catálogo de equipamentos

• Modelos organizados por fabricante e pasta de personalizados.
• Cisco, Juniper, Aruba/HPE, Fortinet, Huawei, H3C, ZTE, Nokia, Ericsson, Ruckus, Extreme, MikroTik, Ubiquiti, TP-Link e outros.
• Presets da equipe para reutilizar um modelo em vários projetos.
• Imagens customizadas por ativo em PNG, SVG, JPG ou WebP.
• Configuração de portas em lote e portas extras.

Importação CSV

1. Baixe o modelo de CSV na tela de inventário.
2. Preencha os ativos e importe para pré-visualizar.
3. Escolha ignorar nomes já existentes, se necessário.
4. O RackLab pode criar racks automaticamente e registrar uma única entrada no histórico.

Exportação

Exporte CSV de ativos, plano de IP, agenda de cabos e o workspace JSON. O JSON é a forma mais completa de backup e de transferência entre máquinas.

VLANs, IPAM e sub-redes

O plano de endereçamento é documentado junto com a topologia. VLANs, sub-redes, gateways e IPs de gerência alimentam diagnósticos, simulação e relatórios.

VLANs

• Crie VLANs com VID, nome, descrição e cor.
• Associe portas e sub-redes às VLANs.
• Use a visão de VLANs para conferir segmentação e links trunk.

Sub-redes

• Cadastre CIDR, gateway, VLAN e descrição.
• Atribua IPs às portas e aos ativos.
• O IPAM aponta conflitos, endereços duplicados e ocupação.
• A calculadora de sub-rede mostra máscara, faixa, broadcast e próximo IP livre.

Diagnósticos de endereçamento

• IPs duplicados e fora da sub-rede.
• Gateways ausentes ou inconsistentes.
• Sub-redes sobrepostas e VLANs sem plano.
• Ocupação de portas e capacidade de racks.

Simulação L2/L3

A simulação permite ensaiar o comportamento da rede sem tocar na produção. Ela usa o modelo documentado no workspace: portas, cabos, VLANs, sub-redes, rotas e políticas.

Como executar

1. Confira se os equipamentos estão conectados e com IPs/VLANs coerentes.
2. Abra Simular na barra de ferramentas.
3. Escolha a origem, o destino e o tipo de teste: ping, traceroute ou ARP.
4. Leia o caminho, os saltos e as mensagens de erro.

Console e CLI

Abra o console de um ativo para trabalhar com a CLI nativa do sistema ou com o terminal xterm integrado. Alterações de configuração podem ser aplicadas ao workspace.

Exemplos de comandos aceitos em equipamentos compatíveis:

show version
show ip interface brief
show vlan brief
show running-config

Testes reais no desktop

No aplicativo desktop, o RackLab também pode testar acesso real por SSH autenticado, SNMP GET e conectividade TCP. Esses testes dependem de rota, credencial e permissão de rede e não estão disponíveis na demonstração web.

Diagnósticos, relatórios e exportação

Diagnósticos

• Saúde geral da topologia e inconsistências de documentação.
• Ocupação de portas e capacidade dos racks.
• Validação de cabeamento e distância.
• Conflitos de IP, sub-redes e VLANs.
• Ativos sem gerência, sem rack ou sem documentação mínima.

Relatórios

• Agenda de cabos com origem, destino, tipo, comprimento e status.
• Relatório HTML autocontido para impressão ou PDF.
• Indicadores de cobertura documental do projeto.
• CSV de ativos, IPAM e cabeamento para auditoria externa.

Interoperabilidade

Snapshots

Salve uma fotografia do projeto antes de mudanças grandes. Snapshots locais ficam no IndexedDB e o link comprimido é somente leitura, sem backend. Credenciais são protegidas no snapshot local.

Dados, backup e segurança

Onde os dados ficam

• IndexedDB é a persistência principal, com escrita debounced.
• Se o IndexedDB não estiver disponível, o app usa localStorage como fallback.
• O projeto é salvo automaticamente; o cabeçalho mostra o estado do salvamento.
• O workspace é validado com Zod na importação e na exportação.

Credenciais

• Senhas SSH, communities SNMP e senhas Wi-Fi são cifradas com AES-GCM no armazenamento local.
• A chave criptográfica fica na instalação; ela não é enviada para nenhum servidor.
• A exportação JSON padrão redige os segredos.
• Imagens, comentários e atividade fazem parte do workspace.

Backup recomendado

1. Exporte o workspace JSON depois de mudanças relevantes.
2. Guarde o arquivo em local versionado ou com backup automático.
3. Gere um snapshot antes de uma alteração de topologia.
4. Teste a importação do backup em uma cópia antes de depender dele.

Offline e privacidade

O RackLab não tem telemetria. A licença é verificada localmente depois da ativação. A demonstração web usa sessionStorage: cada aba tem seus próprios dados e o navegador apaga a sessão ao fechá-la.

Atalhos e produtividade

Rotina recomendada

• Use a paleta para criar racks, abrir plantas e exportar sem navegar pelo menu.
• Mantenha o snap-to-grid ativo em plantas e topologias que precisam de alinhamento.
• Documente o ativo no momento da instalação; a memória é o pior backup.
• Antes de uma mudança grande, salve um snapshot e exporte o JSON.

Licença e ativação

O RackLab é licenciado por dispositivo e por período. Cada instalação ativa ocupa uma vaga do plano escolhido.

Consulte a página de ativação para o fluxo offline e a tabela de preços para os planos atuais.

Limitações e solução de problemas

Demonstração versus desktop

• Demo web: dados temporários por aba, sem licença, sem SSH/SNMP real.
• Desktop: persistência local durável, licença, testes de acesso real, atalhos e integração com o sistema.

Boas práticas de armazenamento

• Não dependa de uma única aba aberta como backup.
• Em projetos grandes, prefira o aplicativo desktop ao navegador.
• Mantenha exports JSON periódicos e um snapshot antes de mudanças estruturais.

Perguntas frequentes

O RackLab funciona sem internet?

Sim. A ativação pode ser feita online ou por desafio/resposta. Depois de ativado, o aplicativo funciona offline e não exige heartbeat.

O RackLab monitora a rede em tempo real?

Não. Ele documenta, planeja e simula. Testes reais de SSH, SNMP e TCP são executados sob demanda no aplicativo desktop.

Posso importar um projeto existente?

Sim. Importe workspace JSON, EVE-NG, GNS3, NetBox-like ou CSV de ativos. O formato JSON é o mais completo para backup e migração.

As credenciais ficam seguras?

Senhas SSH, communities SNMP e senhas Wi-Fi são cifradas localmente com AES-GCM. A exportação padrão redige esses valores. Ainda assim, trate exports com segredos como material sensível.

Posso usar a mesma licença em vários computadores?

O plano define 1 ou 5 dispositivos. Cada instalação ativa consome uma vaga. Para trocar de máquina, desative a licença e solicite a liberação da vaga.

O que acontece quando a licença expira?

O aplicativo volta a solicitar uma licença para liberar os recursos. Seus projetos continuam no computador e podem ser exportados.

A planta baixa aceita qualquer imagem?

Aceita PNG, JPG, WebP e SVG, com limites de tamanho e otimização automática. A imagem é ajustada à área lógica da planta e a escala é definida por você.

Glossário