Compétences routeros-netinstall
📦

routeros-netinstall

Sûr

Installer et gérer des appareils RouterOS avec netinstall

L'installation de MikroTik RouterOS sur un appareil nécessite de comprendre BOOTP, TFTP, la gestion des packages et les scripts. Ce skill fournit une documentation de référence complète pour netinstall-cli avec des modèles d'automatisation pour les installations sur un seul appareil ou sur plusieurs appareils.

Prend en charge: Claude Codex Code(CC)
🥉 72 Bronze
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "routeros-netinstall". Installer RouterOS 7.22 avec les packages container et WiFi sur un appareil ARM64 via eth0.

Résultat attendu:

  • Exécutez : sudo netinstall-cli -r -b -i eth0 routeros-7.22-arm64.npk container-7.22-arm64.npk wifi-qcom-7.22-arm64.npk
  • Assurez-vous que l'appareil est en mode etherboot (maintenez le bouton reset en appuyant sur l'alimentation jusqu'à ce qu'il apparaisse dans netinstall).
  • Le package système (routeros-*.npk) doit être listé en premier dans la commande.

Utilisation de "routeros-netinstall". Comment entrer en mode etherboot depuis le CLI RouterOS ?

Résultat attendu:

  • Exécutez cette commande dans le CLI RouterOS : /system/routerboard/settings/set boot-device=try-ethernet-once-then-nand
  • Redémarrez ensuite l'appareil. Il tentera un démarrage ethernet une fois avant de revenir à NAND.
  • Une fois netinstall terminé, le paramètre boot-device revient à la normale.

Audit de sécurité

Sûr
v2 • 4/16/2026

This skill is a documentation-only SKILL.md file (252 lines) describing MikroTik RouterOS netinstall-cli usage. The static analyzer flagged 124 patterns, but all are false positives from misinterpreting markdown formatting. Backtick-enclosed text (e.g., `netinstall-cli`) is markdown inline code formatting, not Ruby/shell execution. Sudo references, shell command substitution examples, and network URLs appear in documented code examples and reference links. The file contains no executable code, no secrets, and no malicious patterns. Safe for publication.

1
Fichiers analysés
252
Lignes analysées
0
résultats
2
Total des audits
Aucun problème de sécurité trouvé

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
32
Communauté
100
Sécurité
100
Conformité aux spécifications

Ce que vous pouvez construire

Administrateur réseau déployant RouterOS à grande échelle

Utilisez les modèles d'automatisation netinstall pour flasher plusieurs appareils RouterOS simultanément dans un environnement de laboratoire ou de production. Consultez la boucle de service d'installation multi-appareils avec les indicateurs -m -o pour un approvisionnement par lot efficace.

Ingénieur DevOps construisant des pipelines CI/CD RouterOS

Intégrez netinstall-cli dans des pipelines de construction conteneurisés pour les tests automatisés RouterOS. Consultez le modèle netinstall conteneurisé avec le réseau VETH et la configuration par variables d'environnement.

Technicien récupérant des appareils RouterOS hors service

Suivez les procédures d'entrée etherboot et les étapes d'installation sur un seul appareil pour récupérer les appareils dont les mises à jour du firmware ont échoué ou dont les configurations sont corrompues. Utilisez le modèle de script de configuration pour des paramètres par défaut personnalisés.

Essayez ces prompts

Construction d'une commande netinstall de base
Je dois installer RouterOS 7.22 sur un appareil MikroTik ARM64. Construisez la commande netinstall-cli avec les valeurs par défaut de réinstallation et en excluant le package branding sur l'interface eth0.
Modescript pour la configuration device-mode
Écrivez un modescript qui active le mode avancé avec le support container et zerotier, puis montrez la commande netinstall-cli pour l'appliquer au premier démarrage.
Netinstall multiplateforme sur hôte ARM
J'ai un serveur Linux ARM64 et je dois exécuter netinstall-cli. Expliquez la configuration en mode utilisateur QEMU et montrez comment détecter automatiquement le binaire QEMU correct pour une exécution transparente.
Service netinstall conteneurisé sur RouterOS
Configurez netinstall-cli comme un conteneur RouterOS qui installe automatiquement RouterOS sur les appareils se connectant au LAN. Configurez le conteneur avec le réseau VETH, l'architecture arm64, le canal stable et les packages container et wifi.

Bonnes pratiques

  • Listez toujours le package système (routeros-VER-ARCH.npk) en premier dans la liste des packages netinstall-cli pour garantir l'ordre d'installation correct.
  • Utilisez une interface réseau dédiée ou un switch sans autres sources DHCP pour éviter les conflits BOOTP lors de la découverte des appareils etherboot.
  • Appliquez une logique de retry DNS (5 tentatives avec des délais de 2 secondes) lors de l'exécution de netinstall dans des conteneurs au démarrage, car le DNS peut ne pas être immédiatement disponible.

Éviter

  • Ne combinez pas les indicateurs -r (réinstallation avec les valeurs par défaut) et -e (réinstallation avec une configuration vide). Ils sont mutuellement exclusifs et produisent un comportement indéfini.
  • Évitez d'utiliser des adaptateurs Ethernet USB directement entre l'hôte et l'appareil. Les fluctuations de lien des adaptateurs USB peuvent empêcher la détection de l'appareil. Utilisez un switch comme intermédiaire.
  • N'exécutez pas netinstall-cli sur des réseaux avec des serveurs DHCP actifs sans isolation. BOOTP utilise les mêmes ports que DHCP et provoquera des conflits d'adresses.

Foire aux questions

Quelle est la différence entre netinstall et netinstall-cli ?
Netinstall est l'application GUI Windows. Netinstall-cli est l'outil en ligne de commande Linux distribué sous forme de binaire ELF x86. Les deux effectuent la même fonction d'installation RouterOS via Ethernet en utilisant les protocoles BOOTP et TFTP.
Pourquoi netinstall-cli nécessite-t-il des privilèges root ou sudo ?
Netinstall-cli utilise BOOTP sur les ports 67/68 et TFTP sur le port 69. Ce sont des ports privilégiés inférieurs à 1024 qui nécessitent un accès root sur les systèmes Linux. L'outil effectue également des opérations réseau de bas niveau pour la découverte d'appareils.
Puis-je exécuter netinstall-cli sur un Mac ou une machine Linux ARM ?
Sur Linux x86_64, netinstall-cli s'exécute nativement. Sur Linux ARM/ARM64, utilisez l'émulation en mode utilisateur QEMU avec qemu-i386-static ou qemu-i386. Sur macOS, une machine virtuelle QEMU complète avec un réseau en mode pont est nécessaire car l'émulation en mode utilisateur QEMU est limitée à Linux.
Quelle est la différence entre un script de configuration et un mode script ?
Un script de configuration (indicateur -s) s'exécute après l'application de la configuration par défaut et persiste à travers les mises à niveau jusqu'à une nouvelle netinstallation. Un mode script (indicateur -sm, RouterOS 7.22+) s'exécute une seule fois au premier démarrage avant les autres scripts et est automatiquement supprimé après exécution. Les mode scripts sont idéaux pour la configuration device-mode initiale.
Comment entrer en mode etherboot sur un appareil MikroTik ?
Quatre méthodes existent : maintenez le bouton reset en appuyant sur l'alimentation jusqu'à ce que l'appareil apparaisse dans netinstall ; appuyez sur Ctrl+E pendant le démarrage via la console série ; définissez boot-device sur try-ethernet-once-then-nand via le CLI RouterOS et redémarrez ; ou utilisez la méthode du bootloader protégé si précédemment configuré.
Où télécharger les fichiers de packages RouterOS (.npk) ?
Téléchargez les packages depuis download.mikrotik.com en utilisant le modèle : https://download.mikrotik.com/routeros/VERSION/routeros-VERSION-ARCH.npk. Vous pouvez également extraire des packages individuels depuis l'archive all_packages-ARCH-VERSION.zip pour votre architecture.

Détails du développeur

Structure de fichiers

📄 SKILL.md