SILAB documentation

Commencer

Installation

SILAB installe tout ce dont il a besoin — QEMU, l'image RouterOS, nginx et ses propres services — à partir d'une seule commande. Il est indépendant : il s'installe sur une machine Ubuntu vierge et coexiste avec tout ce qui tourne déjà sur l'hôte, sans y toucher.

Chaque installation est vérifiée : le bootstrap contrôle la signature du manifeste de version par rapport à la clé de version de SILAB et le SHA256 du bundle avant toute exécution, puis vous demande d'accepter la licence de MikroTik.

Choisissez votre plateforme :

• L Linux (une commande) Ubuntu 22.04 / 24.04 / 26.04, amd64 ou arm64. VT-x non requis.
• W Windows (WSL2) Windows 10 (2004+) ou 11 — sa propre instance WSL2 et un menu sur le bureau.
• i Prérequis & options Dimensionnement matériel, ce que l'installateur met en place, variables d'environnement de surcharge.

Installation

Linux (une commande)

Sur Ubuntu 22.04, 24.04 ou 26.04 (amd64 ou arm64), exécutez en tant que root :

curl -fsSL https://silab.securytik.com/install.sh | sudo bash

L'installateur télécharge depuis notre bucket de téléchargement, et depuis la release GitHub de SILAB de lui-même lorsque le bucket est inaccessible — il n'y a rien à choisir.

Ce qui se passe

1. Le bootstrap récupère le dernier manifeste de version, vérifie sa signature et son expiration, télécharge le bundle et vérifie son SHA256. Une incohérence arrête l'installation avant toute exécution.
2. Il vous demande d'accepter la licence de MikroTik pour RouterOS CHR, puis télécharge la dernière image CHR stable depuis MikroTik et vérifie son SHA256. L'image n'est jamais redistribuée par SILAB.
3. Il installe QEMU, nginx et les services de SILAB, et publie l'interface web sur le port 80 — ou 8088 lorsque le port 80 est déjà utilisé, par exemple par SAMM.

Première connexion

Ouvrez le serveur dans un navigateur et connectez-vous :

Changez le mot de passe immédiatement dans System → Profile. SILAB affiche un avertissement tant que le mot de passe par défaut est utilisé.

Installation

Windows (WSL2)

SILAB fonctionne sur Windows 10 (version 2004 ou plus récente) et Windows 11 dans sa propre instance WSL2, mise en place par un seul installateur. Ouvrez PowerShell — pas l'invite de commandes (cmd) — et exécutez la ligne ci-dessous. Si PowerShell ne s'exécute pas en tant qu'administrateur, Windows demande l'autorisation : cliquez sur Oui et l'installation se poursuit dans une nouvelle fenêtre administrateur.

irm https://silab.securytik.com/install.ps1 | iex

Il télécharge depuis notre bucket de téléchargement, et depuis la release GitHub de SILAB de lui-même lorsque le bucket est inaccessible.

Le bootstrap télécharge l'installateur complet vers %ProgramData%\SILAB\silab-windows.ps1 et l'exécute depuis cet emplacement, afin de pouvoir s'élever lui-même et continuer après un redémarrage.

Ce qui se passe

1. Il active WSL2. La première fois, cela nécessite un redémarrage de Windows ; l'installation se poursuit ensuite d'elle-même.
2. Il importe une instance Ubuntu 24.04 dédiée nommée SILAB (vérifiée par checksum). Vos autres distributions WSL restent intactes.
3. Il installe SILAB à l'intérieur de cette instance avec l'installateur Linux.
4. Il ajoute une icône SILAB sur le bureau et dans le menu Démarrer : un petit menu pour Démarrer, Arrêter, voir le Statut, l'Ouvrir dans le navigateur, et Partager sur le LAN afin que d'autres PC — et leur WinBox — puissent atteindre le labo.

Installer à partir d'un fichier téléchargé

L'installateur complet peut aussi être exécuté directement, par exemple depuis une copie sur une clé USB :

powershell -ExecutionPolicy Bypass -File silab-windows.ps1

Désinstallation

-Uninstall supprime l'instance SILAB, le raccourci et les règles de partage LAN :

powershell -ExecutionPolicy Bypass -File "$env:ProgramData\SILAB\silab-windows.ps1" -Uninstall

Installation

Prérequis & options

Exigences

• Linux : Ubuntu 22.04, 24.04 ou 26.04, amd64 ou arm64, avec un accès root / sudo. KVM est utilisé automatiquement lorsque /dev/kvm est utilisable ; sans cela, SILAB fonctionne en émulation logicielle — VT-x non requis.
• Windows : Windows 10 version 2004 (build 19041) ou plus récente, ou Windows 11, avec la virtualisation matérielle (VT-x / AMD-V) activée pour WSL2.
• Taille : 2 cœurs et 4 Go de RAM font tourner une poignée de routeurs ; prévoyez environ 200–300 Mo de RAM par routeur.
• RouterOS : CHR 7.15 ou plus récent, téléchargé depuis MikroTik.

Ce que le programme d'installation configure

Variables d'environnement de surcharge

Placez-les devant la commande d'installation, par exemple curl -fsSL https://silab.securytik.com/install.sh | sudo SILAB_HTTP_PORT=8080 bash.

Commencer

Votre premier labo

Deux routeurs et un câble, d'un canevas vide à un ping à travers le lien.

1. Connectez-vous avec admin / admin et changez le mot de passe dans System → Profile.
2. Créez un labo, puis ouvrez Lab → Topology.
3. Cliquez sur + Node et ajoutez deux nœuds Router (CHR) — R1 et R2 dans cet exemple.
4. Cliquez sur + Connect, cliquez sur R1 puis R2, et choisissez les ports — par exemple ether1 sur les deux.
5. Appuyez sur Start lab. En émulation logicielle, un labo propre à deux routeurs est opérationnel et provisionné en environ une demi-minute.
6. Double-cliquez sur R1 pour ouvrir sa console, attribuez une adresse à ether1 sur chaque routeur, puis utilisez Ping — cliquez sur R1, puis R2 — pour tester le câble.

Le fichier de labo

Un labo est un petit diagramme YAML. Exporté en fichier .silab, il transporte le diagramme plus un .rsc par routeur — généralement quelques Ko. Le SILAB du destinataire reconstruit le labo à partir de sa propre image RouterOS, et les fichiers importés sont validés strictement : aucun chemin d'hôte, aucun argument QEMU brut.

silab: 1
name: OSPF basics
routeros: "7.24.4"
nodes:
  - {id: 1, name: R1, kind: router, x: 100, y: 100, config: R1.rsc}
  - {id: 2, name: R2, kind: router, x: 400, y: 100}
  - {id: 3, name: LAN, kind: hub,    x: 250, y: 300}
  - {id: 4, name: PC1, kind: pc,     x: 250, y: 450}
links:
  - {a: {node: 1, port: 1}, b: {node: 2, port: 1}, delay_ms: 20}
  - {a: {node: 2, port: 2}, b: {node: 3}}
  - {a: {node: 4}, b: {node: 3}}

Un labo fixe sa version de RouterOS, afin qu'un labo partagé se comporte de la même façon partout.

Construire des labos

Nœuds & câbles

Ajoutez des nœuds avec + Node et câblez-les port à port avec + Connect — pendant que le labo fonctionne, sans redémarrage.

Types de nœuds

Renommez un routeur sur le canevas et son identité RouterOS suit, à chaud. Chaque routeur peut porter une configuration de démarrage (.rsc), appliquée au premier démarrage.

Câbles

• Les câbles point à point laissent passer toutes les trames : STP, LACP, LLDP, MNDP et les tags VLAN.
• Débranchez et rebranchez un câble, ou dégradez-le volontairement : délai, jitter, perte, bande passante.
• Plusieurs câbles entre les deux mêmes nœuds sont dessinés côte à côte, chacun avec ses propres étiquettes.
• Clic droit sur un câble pour le capturer en direct dans Wireshark.

Alimentation

Clic droit sur un routeur pour un menu d'alimentation façon VMware :

Construire des labos

Accéder à un routeur

Double-cliquez sur un routeur pour sa console dans le navigateur. Elle fonctionne via le port série du routeur, elle continue donc de fonctionner même quand l'étudiant a effacé toutes les adresses IP. Chaque routeur reçoit aussi des ports fixes sur l'hôte SILAB, accessibles depuis le LAN ou Internet.

Ainsi, le routeur 1 répond à WinBox sur 20010, à SSH sur 20011 et à WebFig sur 20012 ; le routeur 2 sur 20020, 20021 et 20022. La connexion aux routeurs se fait avec admin / admin.

ssh -p 20011 admin@<silab-host>

WinBox en un clic

Clic droit sur un routeur → WinBox et WinBox s'ouvre déjà connecté, avec l'adresse, l'utilisateur et le mot de passe déjà remplis. Une page web ne peut pas démarrer un programme sur votre PC toute seule, cela nécessite donc l'assistant WinBox, installé une fois par PC depuis System → Helpers :

• Windows — téléchargez l'assistant, clic droit sur celui-ci → Run with PowerShell. S'il ne trouve pas WinBox, il demande où se trouve WinBox.exe. Redémarrez le navigateur une fois.
• Linux — téléchargez l'assistant et exécutez sh silab-winbox-linux.sh (pas en tant que root). Il trouve WinBox, ou demande le chemin du binaire WinBox.
• macOS — en attendant qu'un assistant existe, clic droit sur un routeur → Links → WinBox copie l'adresse.

L'assistant ne nécessite aucun droit administrateur. Vous devez d'abord disposer de WinBox lui-même, depuis mikrotik.com/download.

Le port de gestion

SILAB atteint chaque routeur via un port de gestion maintenu dans son propre VRF, vrf-mgmt : hors de la table de routage de l'étudiant et hors d'OSPF et BGP. Les ports de l'étudiant restent ether1..N, exactement comme dessiné.

Construire des labos

PC virtuels

Un nœud PC est un client léger sans VM derrière lui. Définissez son IP depuis le canevas — DHCP client, Static, PPPoE client (éventuellement seulement le serveur proposant un nom de service donné) ou No address — ou depuis sa console. La console n'a aucun shell hôte derrière elle ; voici ses commandes :

Ping entre deux appareils quelconques

À côté de + Connect sur la topologie, Ping teste l'accessibilité sans ouvrir de console : cliquez sur deux appareils, cinq pings s'exécutent en arrière-plan, et le résultat s'ouvre dans une fenêtre pop-up. SILAB envoie un ping vers l'adresse du sous-réseau partagé par les deux, sinon vers la première adresse de la cible ; un nœud Internet comme cible reçoit un ping vers 8.8.8.8.

Construire des labos

Capture dans Wireshark

Clic droit sur un câble → Capture in Wireshark : Wireshark s'ouvre sur votre PC et affiche le trafic de ce câble en direct, dans les deux sens, jusqu'à ce que vous le fermiez.

Installez l'assistant Wireshark une fois

Comme pour WinBox, cela nécessite un petit assistant par PC, depuis System → Helpers. Il ne nécessite aucun droit administrateur.

• Windows — téléchargez l'assistant, clic droit sur celui-ci → Run with PowerShell. S'il ne trouve pas Wireshark, il demande où se trouve Wireshark.exe. Redémarrez le navigateur une fois : les liens de capture ouvrent alors Wireshark sans demander.
• Linux — téléchargez l'assistant et exécutez sh silab-wireshark-linux.sh (pas en tant que root). Il trouve Wireshark, ou demande le chemin du binaire wireshark. Il nécessite curl.

Vous devez d'abord disposer de Wireshark lui-même, depuis wireshark.org.

Construire des labos

Actions en bloc

Lab → Bulk actions applique un même changement à tous les routeurs du labo — ou à ceux que vous cochez — et affiche le résultat par routeur.

Système

Mises à jour

System → Updates affiche la version installée, la dernière version et What's new. Une minuterie quotidienne vérifie les nouvelles versions.

1. Apply update télécharge la version signée et la vérifie.
2. Il sauvegarde l'installation dans /var/backups/silab, remplace les fichiers par les nouveaux et redémarre le moteur et le web. Les routeurs en cours d'exécution continuent de fonctionner.
3. En cas d'échec, la version précédente est restaurée automatiquement.

Après une mise à niveau de version Ubuntu (22.04 → 24.04 → 26.04), les services reconstruisent eux-mêmes l'environnement Python de SILAB à leur prochain démarrage ; relancer l'installateur fonctionne aussi.

Versions de RouterOS

Plusieurs versions de RouterOS peuvent être installées côte à côte, et SILAB vous informe quand une nouvelle version de RouterOS est disponible. Rien ne se met à jour tout seul : un labo fixe sa version. Ajoutez-en une depuis la ligne de commande :

silab image latest
silab image pull 7.24.4
silab image list

Système

Sauvegarde & restaurer

System → Backup & restore crée, télécharge, importe et restaure des sauvegardes.

• Chaque sauvegarde contient tous les labos avec leurs configurations de démarrage, les comptes et les paramètres.
• Cochez Include the routers' disks pour conserver aussi leur état complet — le fichier est plus volumineux.
• Les images RouterOS ne sont pas incluses ; elles sont téléchargées à nouveau depuis MikroTik.
• Une sauvegarde automatique s'exécute chaque jour à 04h00 (horloge du serveur). Choisissez le nombre de copies automatiques à conserver ; les sauvegardes que vous avez créées ou importées vous-même ne sont jamais supprimées.
• Les fichiers importés doivent être un .tar.gz produit par SILAB ; tout le reste est refusé.

Depuis la ligne de commande :

silab backup create --disks
silab backup list

Système

Ligne de commande

Tout ce qui se fait sur le canevas peut aussi se faire depuis le shell du serveur avec silab :

silab lab load ospf-basics.silab
silab up
silab link impair R1:1 --delay 50 --loss 2
silab console R1

Référence

FAQ & dépannage

Avez-vous besoin d'une aide supplémentaire ?

Envoyez un e-mail à [email protected] pour signaler un bug ou demander une fonctionnalité.