{"id":50286478,"url":"https://github.com/fabgcruz/bagre","last_synced_at":"2026-05-28T03:02:39.330Z","repository":{"id":358275910,"uuid":"1240338345","full_name":"fabgcruz/bagre","owner":"fabgcruz","description":"Bagre — Open Source IP Address Management. IPAM leve e moderno para gerenciar, organizar e monitorar todos os IPs da sua rede.","archived":false,"fork":false,"pushed_at":"2026-05-26T00:17:22.000Z","size":481,"stargazers_count":0,"open_issues_count":22,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-26T00:30:15.650Z","etag":null,"topics":["docker","fastify","infrastructure","ip-address-management","ipam","network","opensource","react"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fabgcruz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-16T02:56:49.000Z","updated_at":"2026-05-26T00:17:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fabgcruz/bagre","commit_stats":null,"previous_names":["fabgcruz/bagre"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fabgcruz/bagre","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabgcruz%2Fbagre","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabgcruz%2Fbagre/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabgcruz%2Fbagre/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabgcruz%2Fbagre/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fabgcruz","download_url":"https://codeload.github.com/fabgcruz/bagre/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabgcruz%2Fbagre/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33592074,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-28T02:00:06.440Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","fastify","infrastructure","ip-address-management","ipam","network","opensource","react"],"created_at":"2026-05-28T03:02:39.010Z","updated_at":"2026-05-28T03:02:39.323Z","avatar_url":"https://github.com/fabgcruz.png","language":"JavaScript","funding_links":[],"categories":["docker"],"sub_categories":[],"readme":"# Bagre\n\n**Open Source IP Address Management**\n\nUma solução leve e poderosa para gerenciar, organizar e monitorar todos os\nIPs da sua rede — de ambientes simples até infraestruturas híbridas complexas.\n\n[![Latest release](https://img.shields.io/github/v/release/fabgcruz/bagre?label=release\u0026color=blue)](https://github.com/fabgcruz/bagre/releases/latest)\n[![CI](https://img.shields.io/github/actions/workflow/status/fabgcruz/bagre/ci.yml?branch=main\u0026label=CI)](https://github.com/fabgcruz/bagre/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/fabgcruz/bagre?style=flat\u0026color=yellow)](https://github.com/fabgcruz/bagre/stargazers)\n[![Issues](https://img.shields.io/github/issues/fabgcruz/bagre)](https://github.com/fabgcruz/bagre/issues)\n[![Contributors](https://img.shields.io/github/contributors/fabgcruz/bagre)](https://github.com/fabgcruz/bagre/graphs/contributors)\n[![Last commit](https://img.shields.io/github/last-commit/fabgcruz/bagre)](https://github.com/fabgcruz/bagre/commits/main)\n[![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/fabgcruz/bagre/pulls)\n\n---\n\n## Por que Bagre?\n\nO bagre é um peixe que vive nas águas turvas e se orienta pelos bigodes\nsensíveis, detectando tudo ao seu redor. O Bagre IPAM segue a mesma lógica:\n\n- **Enxerga** o que está oculto na rede\n- **Detecta** mudanças e oportunidades (IPs disponíveis, hosts fantasmas, ranges fragmentados)\n- **Funciona** em diferentes ambientes e infraestruturas\n- **Silencioso, resistente e eficiente**\n- **Mantém tudo organizado e sob controle**\n\n## O que o Bagre faz\n\n- Catálogo central de sites, sub-redes (CIDR) e endereços IP com auditoria completa\n- Alocação manual ou automática de IPs respeitando o range da sub-rede\n- Importação de inventários existentes (XLSX/CSV)\n- **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.\n- API REST para integração com ferramentas de descoberta (Zabbix, scanners de rede, OTEL)\n- Login local + SSO via OIDC (Microsoft Entra ID, Keycloak, qualquer provider compatível)\n- RBAC com perfis ADMIN/READER e wiki integrada via DokuWiki\n- Métricas Prometheus em `/metrics`\n- Trilha de auditoria com diff antes/depois de toda alteração\n\n## Stack\n\n- **Backend**: Node.js 20 + Fastify + Prisma + PostgreSQL 15\n- **Frontend**: React + Vite + Tailwind CSS\n- **Orquestração**: Docker Compose\n- **Opcional**: DokuWiki para documentação operacional, Zabbix para descoberta automática\n\n## Quickstart\n\nRequisitos: Docker + Docker Compose plugin.\n\n```bash\ngit clone https://github.com/fabgcruz/bagre.git\ncd bagre\n\ncp .env.example .env\n# editar .env e definir ADMIN_TOKEN, JWT_SECRET, BOOTSTRAP_ADMIN_EMAIL/PASSWORD\n\ndocker compose up -d\n```\n\nAbra http://localhost:3000 e faça login com o e-mail/senha definidos no `.env`.\n\n| Componente | URL |\n|---|---|\n| Web UI | http://localhost:3000 |\n| API REST | http://localhost:3001 |\n| Métricas Prometheus | http://localhost:3001/metrics |\n| Health check | http://localhost:3001/api/health |\n\n## Linha do tempo e evolução\n\n- **[CHANGELOG.md](CHANGELOG.md)** — todas as mudanças, versão por versão (features adicionadas, removidas, renomeadas, bugs corrigidos)\n- **[Releases](https://github.com/fabgcruz/bagre/releases)** — versões publicadas com notas, downloads e tags\n- **[ROADMAP.md](ROADMAP.md)** — visão, princípios, fases planejadas até a 1.0.0\n- **[Issues](https://github.com/fabgcruz/bagre/issues)** — backlog público, incluindo sugestões da comunidade\n\nQuem 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.\n\n## Documentação\n\nA pasta [`docs/`](docs/) contém guias detalhados:\n\n- [`01-arquitetura.md`](docs/01-arquitetura.md) — Stack, modelo de dados, decisões\n- [`02-instalacao.md`](docs/02-instalacao.md) — Subir do zero, requisitos\n- [`03-uso-diario.md`](docs/03-uso-diario.md) — Operação pelo usuário final\n- [`04-administracao.md`](docs/04-administracao.md) — Usuários, perfis, RBAC\n- [`05-integracoes.md`](docs/05-integracoes.md) — Zabbix, OIDC, Prometheus\n- [`06-api-rest.md`](docs/06-api-rest.md) — Endpoints com exemplos `curl`\n- [`07-operacao.md`](docs/07-operacao.md) — Backup, restore, troubleshooting\n- [`08-desenvolvimento.md`](docs/08-desenvolvimento.md) — Dev local, contribuir\n\nVersão renderizada em HTML único navegável: [`docs.html`](docs.html) (gerada por `node scripts/build-docs-html.mjs`).\n\n## Contribuindo\n\nPull requests e issues são bem-vindos. Veja **[CONTRIBUTING.md](CONTRIBUTING.md)** para fluxo, convenções e onde achar coisas.\n\n## Segurança\n\nPara reportar vulnerabilidade, **NÃO abra issue pública** — use o canal privado descrito em **[SECURITY.md](SECURITY.md)**.\n\n## Licença\n\n[MIT](LICENSE) — use, modifique, redistribua. Atribuição é apreciada mas não exigida.\n\n## Status do projeto\n\nBagre é jovem e evoluindo. Considere produção a partir da versão `1.0.0` (ainda não lançada).\nHoje serve bem para laboratórios, ambientes internos e times pequenos.\n\n---\n\n\u003e Bagre — IPAM que enxerga nas águas turvas da sua rede.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabgcruz%2Fbagre","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffabgcruz%2Fbagre","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabgcruz%2Fbagre/lists"}