Déploiement du core 5G avec Docker Compose, contrôle de l'état des services, puis validation du chemin AMF/NRF avant de travailler la partie radio.
Lab réseau privé 5G OAI (SA)
Mise en place reproductible du Core + gNodeB + UE avec notes de dépannage autour des chemins USRP, Quectel et RFSim.
Points clés
- Construction et documentation d'un workflow 5G SA reproductible au lieu d'un simple essai ponctuel.
- Travail concentré sur la partie difficile du projet : isoler pourquoi l'enregistrement ou la PDU session échoue.
- Transformation des notes de dépannage en documentation de reprise réutilisable.
Ce que j'ai pris en charge
Construction et lancement du workflow gNodeB, alignement des paramètres de bande et de PLMN, puis vérification du côté NGAP.
Tests autour du chemin UE avec un Quectel RM500Q tout en gardant RFSim comme solution de repli pour conserver un lab reproductible sans SDR.
Documentation des points de blocage récurrents, des étapes de récupération et de la séquence exacte pour reprendre le travail sur une autre machine.
Résultats et preuves
Vue d'architecture
Timeline
Monter le core
Déployer OAI CN5G avec Docker Compose, valider la santé du NRF et de l'AMF, puis confirmer l'enregistrement des services.
Compiler et lancer le gNodeB
Compiler nr-softmodem, aligner la configuration de bande et de PLMN, puis valider la communication NGAP vers l'AMF.
Attacher l'UE et dépanner les sessions
Travailler l'enregistrement UE, le comportement des PDU sessions et les écarts de configuration qui bloquent souvent la chaîne de bout en bout.
Vue d'ensemble
Ce projet est un lab pratique autour d'un réseau privé 5G SA basé sur OpenAirInterface. L'objectif est de rendre l'installation reproductible, testable et suffisamment documentée pour poursuivre le diagnostic ou transmettre le travail sans perdre de temps.
Ce que j'ai construit
- Un workflow répétable de déploiement Core + gNodeB avec Docker Compose et des étapes de lancement structurées
- Un chemin de dépannage pour les pannes fréquentes autour de l'enregistrement, de NGAP et des PDU sessions
- Un flux de lab capable de fonctionner avec le matériel USRP B210 ou avec RFSim lorsque la radio n'est pas disponible
- Des notes sur les observations radio et protocole, y compris ce qui pourra ensuite remonter dans la supervision
Pourquoi ce projet compte dans mon portfolio
C'est l'un des projets les plus forts du portfolio car il combine :
- architecture télécom
- workflows Linux et conteneurisés
- dépannage méthodique
- rigueur de configuration
- documentation technique détaillée
Il montre aussi que je suis à l'aise sur un sujet où la chaîne peut échouer pour de nombreuses raisons subtiles.
Choix techniques clés
Garder le core conteneurisé
L'utilisation de Docker Compose pour le core aide à réinitialiser rapidement l'environnement et réduit les écarts de dépendances entre machines.
Centraliser la discipline de configuration
De petits écarts sur le PLMN, les slices ou les paramètres liés à l'UE peuvent casser la chaîne. Ce projet a renforcé l'importance d'une baseline stricte.
Déboguer par les preuves, pas par l'intuition
Les logs conteneurs, les logs gNB, le comportement du modem et la validation étape par étape ont servi à isoler le maillon bloquant au lieu de deviner.
Preuves actuellement intégrées à la page
- une image d'architecture montrant le chemin core, gNodeB et validation UE
- une planche de validation résumant les checkpoints réellement suivis
- un bloc dédié qui clarifie ce que j'ai personnellement pris en charge dans le lab
- des cartes de résultats qui transforment le projet en véritable étude de cas
Résultats et valeur d'apprentissage
Ce projet a renforcé ma capacité à :
- travailler sur un workflow de lab télécom réel
- relier la logique du core réseau à la mise en place de l'accès radio
- déboguer des succès partiels où une étape fonctionne mais pas la suivante
- documenter un travail technique avancé de manière à ce qu'il puisse être repris
Ce qui pourra être ajouté ensuite
La prochaine amélioration de cette page sera l'ajout d'extraits de logs nettoyés, de commandes marquantes et de captures choisies du lab.