Mathieu
39f37ee2b8
Le parent docker-compose.yml fixe `network_mode: host` ; combiné avec une déclaration `networks:` dans l'override, Compose refuse le projet (mutuellement exclusifs). On utilise `!reset null` pour supprimer la clé héritée et permettre l'usage du réseau bridge personnalisé. Requiert Compose v2.24+. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
IPAM Homelab
Application web TypeScript / Next.js 15 pour gérer l'inventaire IP d'un homelab : hôtes, ports, applications, avec découverte réseau automatique (ping sweep, scan de ports, ARP, mDNS).
Stack
- Next.js 15 (App Router) + React 18 + TypeScript
- Prisma ORM avec support SQLite ou PostgreSQL (via variable d'env)
- TailwindCSS + design system inspiré shadcn/ui
- Zod pour la validation
- Pino pour les logs
- Docker / Docker Compose pour le déploiement
Démarrage rapide
# 1. Installer les dépendances
npm install
# 2. Copier la configuration d'exemple
cp .env.example .env
# 3. Générer le client Prisma et créer la DB
npm run db:generate
npm run db:migrate
# 4. (Optionnel) Charger des données d'exemple
npm run db:seed
# 5. Lancer en développement
npm run dev
Accès : http://localhost:3000
Passer de SQLite à PostgreSQL
Dans .env :
DATABASE_PROVIDER=postgresql
DATABASE_URL="postgresql://ipam:ipam@localhost:5432/ipam?schema=public"
Puis :
npm run db:generate
npm run db:migrate
Déploiement Docker
# Avec SQLite (simple, fichier local persisté dans un volume)
docker compose --profile sqlite -f docker/docker-compose.yml up -d
# Avec PostgreSQL
docker compose --profile postgres -f docker/docker-compose.yml up -d
Le conteneur utilise
network_mode: hostpour permettre les scans ARP / mDNS / ping sur le LAN. À désactiver si non nécessaire.
Découverte réseau
| Scanner | Description | Requiert |
|---|---|---|
ping |
Ping sweep ICMP sur un CIDR | cap_net_raw ou bin ping |
port |
Scan TCP connect sur une IP | — |
arp |
Lit la table ARP locale (ip neigh / arp -a) |
Accès au LAN (host network) |
mdns |
Écoute Bonjour / DNS-SD | Multicast sur le LAN |
Lancer un scan complet via CLI :
npm run discovery:run -- --kind full --cidr 192.168.1.0/24
Via l'API :
curl -X POST http://localhost:3000/api/discovery \
-H 'Content-Type: application/json' \
-d '{"kind":"full","cidr":"192.168.1.0/24"}'
Architecture
Voir ARCHITECTURE.md pour le détail des couches et la
procédure d'ajout d'un nouveau module métier ou d'un nouveau scanner.