Frieren: O micro-framework para gadgets de segurança

Descrição

O Frieren é um framework para executar ferramentas de segurança em roteadores OpenWrt e Single Board Computers (SBCs). Ele fornece um painel web com gerenciamento de WiFi, módulos instaláveis, um terminal integrado e um gerenciador de pacotes. A stack é uma API backend em PHP com um frontend em React, projetada para ser leve o suficiente para dispositivos embarcados, permanecendo extensível por meio de módulos de terceiros.

Recursos

• Gerenciamento de WiFi — Crie, edite e remova interfaces sem fio. Escaneie redes, configure rádios, edite a configuração UCI bruta.
• Rede — Gerencie interfaces de rede, visualize concessões de DHCP e execute diagnósticos de conectividade.
• Sistema de Módulos — Instale, remova e fixe módulos de terceiros a partir de um repositório remoto. Os módulos carregam dinamicamente como bundles UMD.
• Gerenciador de Pacotes — Instale e remova pacotes opkg diretamente pelo painel web.
• Terminal Integrado — Terminal baseado na web (ttyd) acessível pelo painel.
• Ferramentas do Sistema — Dashboard com estatísticas do sistema, listagem de dispositivos USB, uso do filesystem, visualizador de syslog, diagnósticos e controle de serviços init.d.
• Configurações — Configure hostname, fuso horário, senha do usuário e tema do painel.
• Extensível — Gere novos módulos com frieren-module-template. Controller PHP + frontend React por módulo.

Componentes

• frieren-back — Micro-framework PHP. API JSON POST com autenticação por sessão, CSRF, integração com a configuração UCI e um mini ORM.
• frieren-front — SPA React (Vite, Wouter, Jotai, React Query). Suporta carregamento dinâmico de módulos UMD.
• frieren-module-template — Ferramenta de scaffolding para desenvolver módulos de terceiros com dependências compartilhadas via globais do window.
• frieren-terminal — @frieren/terminal-core, uma biblioteca TypeScript/xterm.js empacotada no frontend. Fornece o cliente de terminal ttyd em tempo real, um visualizador de logs somente leitura e os temas de terminal compartilhados.
• tools — Utilitários de desenvolvimento: proxy da API de dev, script de deploy para dispositivos, cliente de teste da API e um minificador PHP.

Repositórios Relacionados

• Frieren Modules: Contém módulos desenvolvidos pela comunidade com base no frieren-module-template. Este repositório é um recurso para usuários que buscam estender a funcionalidade de sua instalação do Frieren com recursos adicionais.
• Frieren Release: Hospeda os instaladores para implantar versões pré-compiladas do Frieren. Este repositório é ideal para usuários que desejam instalar o Frieren de forma rápida e fácil, sem passar pelo processo de build.
• Frieren Modules Release: Pipeline de build do catálogo de módulos — gera o índice modules.json e os tarballs de release por módulo a partir dos quais o painel instala.

Instalação

O Frieren roda em OpenWrt (builds oficiais, não forks). Pode ser instalado por meio de um script automatizado ou compilado manualmente.

Instalação Rápida

Para uma instalação rápida e fácil, execute o seguinte comando no seu terminal. Este script cuidará de todas as configurações e etapas de instalação necessárias:

wget -qO- https://raw.githubusercontent.com/xchwarze/frieren-release/master/install/install-openwrt.sh | sh

Novo nisso? Comece aqui. Se você não sabe o que é OpenWrt, como fazer flash, ou como abrir o painel depois, siga o passo a passo, amigável para iniciantes, FAQ de Instalação — ele te guia por tudo, do zero até o login.

Compilação Manual

Cada componente do projeto Frieren (frieren-back, frieren-front e frieren-module-template) possui seu próprio arquivo README.md detalhado, com instruções específicas de build e instalação. Consulte esses arquivos em seus respectivos diretórios para obter orientações mais detalhadas.

Desenvolvimento de Módulos

Use o frieren-module-template para gerar novos módulos. Execute yarn wizard para configurar um novo módulo, desenvolva seu recurso e, em seguida, yarn build para compilar um bundle UMD. Consulte o README do template de módulo para obter detalhes.

Licença

Este projeto é licenciado sob a PolyForm Noncommercial License 1.0.0.

O uso não comercial é permitido. O uso comercial não é permitido sob esta licença. O uso comercial requer uma licença comercial separada do autor.

Para licenciamento comercial, entre em contato: [email protected]

Contribuição

Contribuições são bem-vindas — novos recursos, correções de bugs ou módulos. Consulte o README de cada componente para instruções de build.

Autores

• Desenvolvedor Principal: DSR! - [email protected]

Apoie o Desenvolvimento

Se você acha o Frieren útil, considere apoiar o desenvolvimento. Doações financiam hardware de teste e o trabalho contínuo. Envie via Binance ou junte-se ao Patreon para atualizações e builds exclusivos.