Skip to content

🌐 UniFi Software - Gerenciamento de Access Points no OpenFW

O UniFi Software é o Addon integrado ao OpenFW UTM Community que disponibiliza a controladora oficial da Ubiquiti (UniFi Controller) diretamente no seu servidor de borda. Ele permite centralizar o gerenciamento, adoção, configuração e monitoramento de Access Points (APs), switches e demais dispositivos da linha UniFi da sua rede.

📝 Visão Geral

Ao embarcar a controladora UniFi dentro do seu ecossistema UTM, elimina-se a necessidade de manter uma máquina ou servidor dedicado apenas para essa função na rede local. A ferramenta provê uma interface completa para criação de redes Wi-Fi (corporativas e de visitantes), portais cativos para hotéis/eventos, controle de banda por cliente e mapas de calor de cobertura de sinal.

O gerenciamento básico deste recurso pode ser feito de forma simples através da Interface Web, ou em modo avançado via Linha de Comando (CLI).

📥 1. Instalação do Addon

🌐 Método Padrão: Via Interface Web

A maneira mais rápida e recomendada para instalar a controladora UniFi é utilizando a WEB:

  • ⏱️ Acesse o menu superior e navegue até System > Addons and Packages.
  • 🔍 Localize o addon unifi (ou correspondente ao UniFi Software) na lista de módulos disponíveis. Se não estiver visível, clique em Update Repo.
  • 🚀 Clique em instalar e aguarde o processo automatizado ser concluído pelo painel.

💻 Método Avançado: Via Linha de Comando (CLI / SSH)

Caso prefira realizar a auditoria da instalação em tempo real pelo terminal, conecte-se via SSH com o usuário root e execute os comandos de forma separada:

  1. Atualize a lista de pacotes do repositório: 

    smart update

  2. Prossiga com a instalação do pacote do UniFi Software: 

    smart install unifi-software -y

⚙️ 2. Menu de Acesso e Configuração Inicial

Após o término da instalação, o painel de ativação e o link de direcionamento para o serviço estarão disponíveis nos menus centrais do OpenFW:

  1. 🧭 Acesse o menu superior: SERVIÇOS (ou SERVICES).

  2. 📂 No menu lateral esquerdo, selecione a opção UniFi Software.

  3. ⚡ Ativação: Localize a seção UniFi Software Settings, marque a caixa de seleção UniFi Service Enabled e clique em Salvar para inicializar o serviço da controladora em segundo plano.

🖥️ 3. Acesso à Interface Web do UniFi

Com o serviço ativo e inicializado pelo painel do OpenFW:

  • 🔗 Acesso Direto: Na seção UniFi Software Access, clique no link em destaque Access UniFi Web GUI.
  • 🧭 Redirecionamento Seguro: O sistema abrirá uma nova aba do navegador direcionando para a porta segura nativa da controladora UniFi (geralmente https://IP-DO-FIREWALL:8443).
  • 🚀 Wizard Inicial: No primeiro acesso, o assistente de configuração oficial da Ubiquiti guiará você na criação da sua conta de administrador, definição do nome do site e adoção inicial dos Access Points conectados à sua rede.

⏳ 4. Observação sobre a Primeira Inicialização

Nota sobre a Inicialização Inicial

Ao marcar a opção UniFi Service Enabled pela primeira vez após a instalação, o serviço do UniFi Software poderá demorar alguns minutos para inicializar completamente e tornar o link da Web GUI acessível. Isso ocorre porque o Java e a base de dados embutida (MongoDB) realizam o provisionamento e a montagem das tabelas do sistema em segundo plano no primeiro boot.