Primeiros passos

Bem-vindo à documentação oficial do Ravi Monitor 7.2. Esta página apresenta o produto, os requisitos, a instalação, o primeiro acesso e os planos de assinatura. Se você já sabe o que procura, use os atalhos abaixo.

O que é o Ravi Monitor

O Ravi Monitor é um sistema de monitoramento de rede feito para provedores de internet (ISPs). Você instala o sistema em um servidor Linux próprio, físico ou virtual, e opera toda a rede por uma interface 100% web: do sinal de cada ONU até a mitigação de um ataque DDoS.

Os principais ambientes do sistema são:

  • Dispositivos e Sensores: monitoramento de roteadores, switches, servidores e qualquer equipamento via SNMP e ping, com condições de alerta e notificações por e-mail, Telegram e WhatsApp. Veja Dispositivos e sensores.
  • OLT (fibra/GPON): ONUs e ONTs de 15 marcas, sinal RX/TX, autorização de ONU e alertas de rompimento. Veja OLT e fibra.
  • Concentradora (BNG/PPPoE): sessões PPPoE com latência, tráfego, quedas e reconexões. Veja Concentradora.
  • Flow Novo na 7.2: coleta NetFlow/IPFIX/sFlow com detecção de ataques por vetor e mitigação BGP (FlowSpec e RTBH), liberado por plano. Veja Flow: visão e análise.
  • Dashboards (NOC/TV) Novo na 7.2: telas customizadas com editor visual e slideshows para TV. Veja Dashboards.
  • Backups Novo na 7.2: backup diário da configuração dos equipamentos da rede, multi-marca, com histórico de alterações. Veja Backups de equipamentos.
  • DNS: servidor recursivo e autoritativo do provedor, com estatísticas e reverso (PTR). Veja DNS.
  • IPDOCS: documentação de blocos IP, scanner e verificação RBL. Veja IPDOCS.
  • Copiloto IA Novo na 7.2: assistente com inteligência artificial que executa ações reais no sistema. Veja Copiloto IA.
  • Extras: terminal web, WinBox no navegador, WireGuard, monitoramento de serviços, relatórios em PDF, API pública e aplicativo móvel.

A versão 7.2 foi lançada em 30/06/2026. O resumo das novidades está na seção O que há de novo na 7.2, no fim desta página.


Como funciona

O sistema roda inteiro no seu servidor: interface web, banco de dados, coletas e serviços auxiliares. Os dados de monitoramento da sua rede ficam com você; nada de tráfego dos seus assinantes sai do servidor.

Em linhas gerais:

  • Coletas contínuas: tarefas agendadas coletam dados dos ambientes (dispositivos, OLT, concentradora, Flow, IPDOCS) a cada minuto e processam alertas. Não há nada para o operador "rodar": depois da instalação, tudo é automático.
  • Interface web: toda a operação acontece pelo navegador, no IP configurado na instalação. O acesso pode receber certificado SSL depois, pelas Configurações.
  • Central Ravi: o servidor conversa periodicamente (a cada 10 minutos) com a central da Ravi por um canal cifrado de ponta a ponta. É por esse canal que ele valida a licença e o plano, envia telemetria de uso e recebe o aviso de versão nova com o pacote de atualização assinado digitalmente.

A central cuida apenas de licenciamento, plano e distribuição de atualizações: o tráfego e os dados dos seus assinantes nunca passam por esse canal.

A validação de licença tem folga: basta uma sincronização bem-sucedida por dia para o plano continuar valendo. Quedas curtas de internet não afetam nada. O bloqueio só ocorre após mais de 3 dias sem conseguir sincronizar, ou por inadimplência prolongada (ver Planos e recursos).

Para os detalhes de licenciamento, sincronização e atualização automática, veja Atualizações do sistema.


Requisitos

O Ravi Monitor é distribuído como uma ISO própria baseada em Debian 11 (64 bits). A ISO instala o sistema operacional e todo o restante: servidor web, banco de dados e serviços auxiliares. Você não instala nada manualmente, nem na instalação nem depois: as atualizações automáticas mantêm toda a pilha.

Hardware mínimo

RecursoMínimo
Processador4 núcleos, 64 bits
Memória RAM6 GB (recomendado 8 GB em máquina virtual)
Disco80 GB

Esses valores são mínimos. Quanto mais equipamentos, sensores, ONUs e sessões você monitorar, mais recursos o servidor precisa. Referência prática do Flow: receber a tabela BGP completa (cerca de 1,1 milhão de rotas) fica confortável com 12 GB de RAM ou mais e satura com menos de 6 GB.

O próprio sistema protege você de excessos: o Flow classifica a capacidade real do servidor (RAM, núcleos e carga) e bloqueia recursos pesados que o hardware não comporta, como ClickHouse, GeoIP por cidade e captura forense. O operador acompanha isso na aba de capacidade das configurações do Flow (veja Capacidade do servidor). O backup diário de equipamentos também tem uma trava de segurança: ele não roda se houver menos de 2 GB livres em disco.

Rede e internet

  • O servidor precisa de saída para a internet por HTTPS: é por ela que ele sincroniza licença e plano com a central da Ravi, baixa as atualizações, os pacotes Debian e as bases opcionais do Flow (ASN, GeoIP, threat intelligence).
  • O painel web é acessado pelo IP definido na instalação. O SSL é configurável depois, nas Configurações (certificado wildcard Ravi ou certificado próprio).
  • A atualização ativa automaticamente o fail2ban: após várias senhas erradas no SSH, o IP de origem é bloqueado temporariamente por proteção contra força bruta. Se o SSH "parar de responder" depois de erros de senha, é essa proteção agindo, não uma falha.

Sem saída HTTPS liberada para a internet e para os repositórios Debian, o servidor não valida a licença nem recebe atualizações. Mantenha essa saída sempre liberada no seu firewall de borda.


Instalação

A instalação é a mesma para servidor dedicado e para máquina virtual: gravar ou apontar a ISO, seguir o instalador e acessar o painel pelo IP configurado. A ISO oficial está disponível em ravimonitor.com/downloads.

Servidor dedicado (bare metal)

  1. Baixe a ISO em ravimonitor.com/downloads.
  2. Grave a ISO em um pendrive bootável (por exemplo, com o Rufus).
  3. Dê boot no servidor pelo pendrive.
  4. Siga o instalador: informe IP, Gateway e máscara de rede, e defina a senha de root.
  5. Reinicie e acesse o painel web pelo navegador, no IP configurado.

Máquina virtual

O processo vale para qualquer virtualizador (Proxmox, VMware, Hyper-V, KVM), desde que a CPU virtual seja 64 bits.

  1. Crie a VM apontando para a ISO. Recomendação: no mínimo 4 núcleos, 8 GB de RAM e 80 GB de disco.
  2. Siga o mesmo instalador: IP, gateway, máscara e senha de root.
  3. Reinicie a VM e acesse o painel pelo IP.

Em máquina virtual, tirar um snapshot antes de mudanças grandes é barato e recomendado. É a sua rede de segurança adicional, além das proteções da própria atualização do sistema.

Uma instalação corresponde a um servidor. Clonar a VM e manter as duas cópias ativas gera conflito de identidade na central (proteção anti-clone) e o plano deixa de ser aplicado. Para migrar de servidor, use backup e restauração e deixe o sistema se registrar de novo sozinho; nunca rode os dois ao mesmo tempo.

Depois de instalar, confira o fuso horário nas Configurações (campo Selecione um fuso horário): ele alinha data e hora de logs e relatórios.


Primeiro acesso

No primeiro acesso ao painel, quando ainda não existe nenhum usuário, o sistema abre automaticamente o assistente de boas-vindas para criar o primeiro usuário. Essa tela tem seletor de idioma e alternador de tema claro/escuro.

  1. Abra o navegador e acesse o IP configurado na instalação.
  2. No assistente, escolha o Idioma: além de ajustar a própria tela ao vivo, ele define o idioma padrão do sistema.
  3. Preencha Nome, Usuário, Senha e Confirmar Senha.
  4. Informe Telefone e Email verdadeiros: eles são usados na recuperação de senha.
  5. Clique em Continuar. O sistema leva você à tela de login.

O usuário criado nesse assistente é o Master, com acesso completo ao sistema. É com ele que você cria os demais usuários e define permissões depois, em Usuários e permissões.

Período de testes

Toda instalação nova nasce no plano TRIAL: 10 dias com todos os recursos liberados, equivalente ao plano ENTERPRISE. Durante o teste, o topo do sistema mostra Versão de testes e um aviso regressivo de expiração. Ao fim dos 10 dias, o plano cai para FREE e os recursos pagos são bloqueados até o registro.

Registro e ativação do plano

  1. Para contratar, use o item de menu Registrar agora! (visível para Master e Admin durante o teste ou após a expiração). Ele abre o site da Ravi já identificando o seu servidor.
  2. O token de identificação do servidor fica em Configurações, no card Registro RAVI, com o botão Copiar.
  3. Depois de contratar ou mudar de plano, volte ao card Registro RAVI e clique em Atualizar: isso força uma sincronização imediata com a central e o novo plano vale na hora. Sem esse clique, o plano é aplicado em até 10 minutos, na próxima sincronização automática.

Planos e recursos

O plano da assinatura é definido na central Ravi e sincronizado automaticamente para o seu servidor. O nome do plano ativo aparece no cabeçalho do sistema, ao lado do logotipo, para o usuário Master.

PlanoO que libera
RAVI FREEServidor não registrado ou teste expirado. Recursos pagos bloqueados.
RAVI 250 / 500 / 1000 / 2500 / 5000Planos legados, dimensionados por porte da rede.
BASICMonitoramento básico de dispositivos e sensores. Sem OLT e sem Concentradora.
NORMALTudo do BASIC, mais 1 OLT e 1 concentradora.
PREMIUMAté 4 OLTs e até 4 concentradoras. Flow liberado com 1 exportador.
GOLDOLTs e concentradoras ilimitadas. Flow com até 4 exportadores.
ENTERPRISETudo ilimitado, inclusive exportadores de Flow.
TRIALTeste de 10 dias, equivalente ao ENTERPRISE.

Pontos importantes sobre os limites:

  • O ambiente Flow Plano Premium+ só é habilitado nos planos PREMIUM, GOLD, ENTERPRISE e TRIAL. O item Flow do menu fica sempre visível, mesmo sem plano elegível: é por ele que você conhece, contrata e ativa o recurso.
  • Ao tentar cadastrar uma OLT, concentradora ou exportador além do limite do plano, o sistema mostra uma mensagem de upgrade e não conclui o cadastro. Não há cobrança surpresa.
  • Se o plano cai para FREE (teste expirado), o ambiente DNS é desativado automaticamente e o resolvedor passa a encaminhar as consultas para resolvedores públicos: seus clientes não perdem resolução de nomes, você perde a gestão até regularizar.
  • Inadimplência prolongada (mais de 15 dias de atraso) ou mais de 3 dias sem conseguir sincronizar com a central derrubam a sessão web de todos os usuários até a regularização.

Mudou de plano? Vá em Configurações, card Registro RAVI, e clique em Atualizar para o novo plano valer imediatamente.


O que há de novo na 7.2 Novo na 7.2

A 7.2 é o maior salto de versão da história do produto, com cerca de 160 avanços catalogados. Estes são os 10 destaques do lançamento:

  1. Ambiente Flow: detecção e mitigação de DDoS em tempo real com NetFlow/IPFIX/sFlow, FlowSpec e RTBH via BGP, aprovação de mitigação em 1 clique pelo WhatsApp e post-mortem automático em PDF. Veja Flow: visão e análise e Flow: configuração e mitigação.
  2. Copiloto IA: assistente presente em todo o sistema que executa ações reais (criar, editar, excluir, acessar equipamento por SSH), e não apenas responde perguntas. Veja Copiloto IA.
  3. Ambiente Dashboards: telas customizadas para TVs e NOC com editor visual, 19 tipos de widget, slideshows rotativos e dashboards multi-servidor que consolidam vários POPs num painel. Veja Dashboards.
  4. Ambiente Backups: backup diário automático da configuração de todos os equipamentos da rede, com descoberta por IA, histórico de alterações (diff) e credenciais cifradas em cofre. Veja Backups de equipamentos.
  5. Telas novas de Dispositivos, OLT e Concentradora: colmeia com milhares de ONUs e sessões em tela, painéis nativos e colunas configuráveis. Veja Dispositivos, OLT e Concentradora.
  6. Sondas remotas: agente leve (inclusive para Windows) pareado por token, para monitorar redes e POPs remotos na mesma árvore de dispositivos. Veja Sondas remotas.
  7. Segurança de conta: verificação em duas etapas (2FA), dispositivos confiáveis, múltiplas sessões com desconexão remota e auditoria de ações. Veja Conta e segurança.
  8. Experiência nova: tema escuro em todo o sistema, interface redesenhada para o celular e três idiomas (Português, Inglês e Espanhol) com escolha por usuário. Veja Interface e navegação.
  9. API pública ampliada: Flow completo via API e criação, edição e exclusão reais de dispositivos e sensores. Veja a documentação de API.
  10. Atualizações assinadas digitalmente, com liberação gradual (canário): mais segurança e controle na evolução da plataforma. Veja Atualizações do sistema.

Dentro do próprio sistema, a página Novidades mostra a linha do tempo de lançamentos em linguagem de cliente: passe o mouse sobre o avatar no canto superior direito e clique em Novidades. Detalhes em Página de novidades.

Se você vem da versão 7.1, comece por Vindo da versão 7.1: lá estão as telas que mudaram de lugar, o que foi substituído e o que migra sozinho.