https://github.com/fabgcruz/bagre
Bagre — Open Source IP Address Management. IPAM leve e moderno para gerenciar, organizar e monitorar todos os IPs da sua rede.
https://github.com/fabgcruz/bagre
docker fastify infrastructure ip-address-management ipam network opensource react
Last synced: about 1 month ago
JSON representation
Bagre — Open Source IP Address Management. IPAM leve e moderno para gerenciar, organizar e monitorar todos os IPs da sua rede.
- Host: GitHub
- URL: https://github.com/fabgcruz/bagre
- Owner: fabgcruz
- License: mit
- Created: 2026-05-16T02:56:49.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-26T00:17:22.000Z (about 1 month ago)
- Last Synced: 2026-05-26T00:30:15.650Z (about 1 month ago)
- Topics: docker, fastify, infrastructure, ip-address-management, ipam, network, opensource, react
- Language: JavaScript
- Size: 470 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Roadmap: ROADMAP.md
Awesome Lists containing this project
- awesome-starts - fabgcruz/bagre - Bagre — Open Source IP Address Management. IPAM leve e moderno para gerenciar, organizar e monitorar todos os IPs da sua rede. (docker)
README
# Bagre
**Open Source IP Address Management**
Uma solução leve e poderosa para gerenciar, organizar e monitorar todos os
IPs da sua rede — de ambientes simples até infraestruturas híbridas complexas.
[](https://github.com/fabgcruz/bagre/releases/latest)
[](https://github.com/fabgcruz/bagre/actions/workflows/ci.yml)
[](LICENSE)
[](https://github.com/fabgcruz/bagre/stargazers)
[](https://github.com/fabgcruz/bagre/issues)
[](https://github.com/fabgcruz/bagre/graphs/contributors)
[](https://github.com/fabgcruz/bagre/commits/main)
[](https://github.com/fabgcruz/bagre/pulls)
---
## Por que Bagre?
O bagre é um peixe que vive nas águas turvas e se orienta pelos bigodes
sensíveis, detectando tudo ao seu redor. O Bagre IPAM segue a mesma lógica:
- **Enxerga** o que está oculto na rede
- **Detecta** mudanças e oportunidades (IPs disponíveis, hosts fantasmas, ranges fragmentados)
- **Funciona** em diferentes ambientes e infraestruturas
- **Silencioso, resistente e eficiente**
- **Mantém tudo organizado e sob controle**
## O que o Bagre faz
- Catálogo central de sites, sub-redes (CIDR) e endereços IP com auditoria completa
- Alocação manual ou automática de IPs respeitando o range da sub-rede
- Importação de inventários existentes (XLSX/CSV)
- **Cloud sync (AWS)** — conecta sua conta AWS via Access Key ou Assume Role, sincroniza VPCs/subnets/ENIs/Elastic IPs e mostra IPs públicos ociosos sangrando custo (relatório FinOps). Azure e GCP no roadmap.
- API REST para integração com ferramentas de descoberta (Zabbix, scanners de rede, OTEL)
- Login local + SSO via OIDC (Microsoft Entra ID, Keycloak, qualquer provider compatível)
- RBAC com perfis ADMIN/READER e wiki integrada via DokuWiki
- Métricas Prometheus em `/metrics`
- Trilha de auditoria com diff antes/depois de toda alteração
## Stack
- **Backend**: Node.js 20 + Fastify + Prisma + PostgreSQL 15
- **Frontend**: React + Vite + Tailwind CSS
- **Orquestração**: Docker Compose
- **Opcional**: DokuWiki para documentação operacional, Zabbix para descoberta automática
## Quickstart
Requisitos: Docker + Docker Compose plugin.
```bash
git clone https://github.com/fabgcruz/bagre.git
cd bagre
cp .env.example .env
# editar .env e definir ADMIN_TOKEN, JWT_SECRET, BOOTSTRAP_ADMIN_EMAIL/PASSWORD
docker compose up -d
```
Abra http://localhost:3000 e faça login com o e-mail/senha definidos no `.env`.
| Componente | URL |
|---|---|
| Web UI | http://localhost:3000 |
| API REST | http://localhost:3001 |
| Métricas Prometheus | http://localhost:3001/metrics |
| Health check | http://localhost:3001/api/health |
## Linha do tempo e evolução
- **[CHANGELOG.md](CHANGELOG.md)** — todas as mudanças, versão por versão (features adicionadas, removidas, renomeadas, bugs corrigidos)
- **[Releases](https://github.com/fabgcruz/bagre/releases)** — versões publicadas com notas, downloads e tags
- **[ROADMAP.md](ROADMAP.md)** — visão, princípios, fases planejadas até a 1.0.0
- **[Issues](https://github.com/fabgcruz/bagre/issues)** — backlog público, incluindo sugestões da comunidade
Quem está testando: dá uma olhada no **CHANGELOG** pra acompanhar o que mudou em cada release. Quem quer ajudar a moldar o que vem: as **Issues** estão abertas, opinião informada é o melhor combustível pro projeto.
## Documentação
A pasta [`docs/`](docs/) contém guias detalhados:
- [`01-arquitetura.md`](docs/01-arquitetura.md) — Stack, modelo de dados, decisões
- [`02-instalacao.md`](docs/02-instalacao.md) — Subir do zero, requisitos
- [`03-uso-diario.md`](docs/03-uso-diario.md) — Operação pelo usuário final
- [`04-administracao.md`](docs/04-administracao.md) — Usuários, perfis, RBAC
- [`05-integracoes.md`](docs/05-integracoes.md) — Zabbix, OIDC, Prometheus
- [`06-api-rest.md`](docs/06-api-rest.md) — Endpoints com exemplos `curl`
- [`07-operacao.md`](docs/07-operacao.md) — Backup, restore, troubleshooting
- [`08-desenvolvimento.md`](docs/08-desenvolvimento.md) — Dev local, contribuir
Versão renderizada em HTML único navegável: [`docs.html`](docs.html) (gerada por `node scripts/build-docs-html.mjs`).
## Contribuindo
Pull requests e issues são bem-vindos. Veja **[CONTRIBUTING.md](CONTRIBUTING.md)** para fluxo, convenções e onde achar coisas.
## Segurança
Para reportar vulnerabilidade, **NÃO abra issue pública** — use o canal privado descrito em **[SECURITY.md](SECURITY.md)**.
## Licença
[MIT](LICENSE) — use, modifique, redistribua. Atribuição é apreciada mas não exigida.
## Status do projeto
Bagre é jovem e evoluindo. Considere produção a partir da versão `1.0.0` (ainda não lançada).
Hoje serve bem para laboratórios, ambientes internos e times pequenos.
---
> Bagre — IPAM que enxerga nas águas turvas da sua rede.