dojo.swos: libreria Python e PHP per gli switch MikroTik SwOS

pip install --index-url https://mikrotikdojo.com/pypi/<il-tuo-indirizzo>/simple/ dojo-swos

from dojo.swos import SwOS

sw = SwOS("192.0.2.10")            # utente admin, password vuota (default SwOS)
print(sw.system()["identity"])      # -> SWOS

for p in sw.ports():
    print(p["name"], "UP" if p["link"] else "giu'")

# configurare una VLAN (attento alla porta di gestione!)
sw.set_vlans([{"vid": 10, "ports": [2, 3], "name": "lab"}])

# scrivi via b-file, verifica via SNMP
sw.set_snmp(location="sala-rack")

composer config repositories.dojo composer https://mikrotikdojo.com/composer/<il-tuo-indirizzo>/
composer require dojo/swos

use Dojo\Swos\SwOS;

$sw = new SwOS("192.0.2.10");        // utente admin, password vuota (default SwOS)
echo $sw->system()["identity"];      // -> SWOS

foreach ($sw->ports() as $p) {
    echo $p["name"], $p["link"] ? " UP\n" : " giu'\n";
}

// configurare una VLAN (attento alla porta di gestione!)
$sw->setVlans([["vid" => 10, "ports" => [2, 3], "name" => "lab"]]);

Che cosa fa

dojo.swos parla con gli smart switch MikroTik che girano SwOS attraverso la sua interfaccia HTTP non documentata — i cosiddetti b-file (sys.b, link.b, vlan.b…). SwOS ufficialmente si gestisce solo dal browser: questa libreria apre quel canale da codice, così puoi leggere lo stato, i contatori e la configurazione, e scrivere la configurazione, senza aprire la GUI.

Cosa fa: legge sistema (identity, IP, temperatura, ventole), porte (link, velocità, nomi), tabella MAC, statistiche per-porta, VLAN, RSTP e SNMP; scrive identity, impostazioni SNMP e tabella VLAN. Incapsula il formato b-file (numeri esadecimali, stringhe in hex-ASCII, bitmask per-porta, IP little-endian) e la Digest authentication.

Quando serve: automazione e provisioning degli switch SwOS, backup della configurazione, monitoraggio del traffico, script di controllo — tutto ciò che la GUI fa a mano, ma ripetibile.

Limiti: SwOS usa HTTP in chiaro con Digest auth (niente HTTPS): va usata su reti fidate o in laboratorio. Il formato b-file è frutto di reverse-engineering e MikroTik potrebbe cambiarlo tra le versioni. La scrittura è immediata: una VLAN sbagliata sulla porta di gestione taglia l’accesso.