Logo NetBox

Réseau & VPN

NetBox

NetBox sur VPS : documentez préfixes, adresses IP, VLAN, baies et câblage dans une source de vérité unique, pilotée par API REST et GraphQL.

En validation

À propos de NetBox

NetBox est l'outil open source de référence pour documenter un réseau et une infrastructure, publié sous licence Apache-2.0. Il réunit deux métiers : l'IPAM — préfixes, plages et adresses IP, VLAN, VRF — et le DCIM — sites, baies, équipements, interfaces et câbles. Chaque objet est relié aux autres : une adresse IP appartient à une interface, qui appartient à un équipement, installé dans une baie d'un site.

Pour une équipe qui gère des serveurs, un hébergement ou un réseau d'entreprise, c'est la fin du tableur d'adresses IP que personne ne tient à jour. Tout se lit et s'écrit aussi par l'API REST et GraphQL : vos inventaires Ansible, vos scripts Terraform ou OpenTofu et vos webhooks partent de la même source. L'installation ServOrbit crée le compte administrateur et exige une connexion pour tout consulter.

Ce qui est installé

Prêt au démarrage du VPS

OS compatibles
Distributions Linux au choix
Application
NetBox
Stack technique
DockerPythonPostgreSQLValkey
RAM minimum
2 Go minimum
CPU minimum
2 vCPU
Port par défaut
8121
Accès
root par SSH

Fonctionnalités clés

  • IPAM complet — préfixes hiérarchiques, plages, adresses IP, VLAN, VRF et calcul automatique de l'espace libre.
  • DCIM — sites, baies avec leur élévation, équipements, modules, interfaces, câbles et alimentation.
  • Une API REST et GraphQL pour chaque objet, avec jetons d'API par utilisateur et documentation OpenAPI intégrée.
  • Automatisation — webhooks, scripts personnalisés et inventaire dynamique pour Ansible.
  • Journal des modifications — qui a changé quoi et quand, objet par objet.
  • Instance fermée par défaut — connexion exigée pour consulter, et compte administrateur créé à l'installation.

Quand utiliser cette solution ?

Remplacer le tableur d'adresses IP

Chaque préfixe et chaque adresse IP est attribué à un équipement ou à un client : plus de doublon d'adresse, et l'espace libre d'un réseau se lit en un clic.

Documenter une salle serveur ou une baie

Baies, équipements, ports et câbles sont décrits une fois ; l'équipe d'exploitation sait ce qui est branché où avant d'intervenir.

Alimenter Ansible et vos scripts

L'inventaire dynamique Ansible et vos scripts lisent la liste des serveurs, de leurs rôles et de leurs adresses dans NetBox au lieu d'un fichier tenu à la main.

Guide

Déployer NetBox sur votre VPS

  1. Créer le VPS et choisir l'adresse

    Commandez un VPS Ubuntu 24.04 avec 2 Go de RAM au minimum (4 Go conseillés) et 2 vCPU. NetBox exige un domaine : il est servi en HTTPS et n'accepte les formulaires que depuis son adresse déclarée. Il s'ouvre sur un sous-domaine de l'un de vos domaines, ou sur le sous-domaine gratuit du VPS (netbox.{dns_slug}.servorbit-dns.com), HTTPS compris. Inutile d'acheter un nom de domaine.

  2. Installer NetBox depuis le Marketplace

    Dans votre espace client, sélectionnez NetBox, choisissez l'adresse et cliquez sur Installer. Le script déploie l'image officielle netbox-docker avec PostgreSQL, Valkey et le processus de tâches de fond, génère le mot de passe administrateur et les secrets de l'instance, et configure le reverse proxy nginx en HTTPS. Le premier démarrage applique les migrations de la base : comptez cinq à dix minutes.

  3. Se connecter la première fois

    Ouvrez https://votre-domaine/login/ et connectez-vous avec l'utilisateur admin et le mot de passe affiché dans votre espace client. Ce compte est le superutilisateur de l'instance : vous pouvez changer son mot de passe depuis votre profil.

  4. Décrire votre premier site

    Créez un site, puis vos préfixes IP (IPAM, Préfixes) et vos équipements (Équipements, Appareils). NetBox calcule l'espace libre de chaque préfixe et propose la prochaine adresse disponible. L'import CSV ou YAML permet de reprendre un tableur existant en une fois.

  5. Créer un jeton d'API

    Depuis votre profil, menu Jetons d'API, créez un jeton pour vos scripts. Il s'utilise dans l'en-tête Authorization: Bearer <jeton> ; la documentation interactive de l'API est servie sur https://votre-domaine/api/schema/swagger-ui/.

Questions fréquentes

Questions sur NetBox

← Retour à Réseau & VPNToutes les applications
Oui, et il va plus loin : chaque adresse IP est rattachée à une interface, à un équipement et à un site, l'espace libre de chaque préfixe est calculé, et chaque modification est journalisée. L'import CSV permet de reprendre votre tableur existant.

Besoin d'aide ?

Parcourez notre centre d'aide et notre FAQ, ou contactez notre équipe — rappel, WhatsApp ou e-mail.

Écrire sur WhatsApps'ouvre dans un nouvel onglet