[{"_1":2,"_202":-5,"_203":-5},"loaderData",{"_3":4,"_18":19,"_25":26,"_175":176},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16,"_17":11},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","dockerRebrandTour","routes/_layout",{"_20":-5,"_21":22,"_23":11,"_24":22},"username","isAskGordonEnabled",true,"showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_89":90,"_111":112,"_163":-5,"_164":11,"_165":22,"_166":11,"_167":11,"_168":-5,"_169":11,"_170":-5,"_171":172,"_173":113,"_174":-7},"canonicalUrl","https://hub.docker.com/r/xomoxcc/networkmgmt/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","xomoxcc","reponame","networkmgmt","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":73,"_74":75,"_80":11,"_81":82,"_86":33,"_87":88},"categories",[],"content_types",[44],"image","date_registered","2026-02-09T18:07:42.969024Z","description","","is_private","last_updated","2026-11-01T12:09:21.850899Z","last_modified","2026-02-10T08:49:17.296347Z","media_types",[56],"application/vnd.oci.image.index.v1+json","name","pull_count",1837,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","[![black-lint](https://github.com/vroomfondel/networkmgmt/actions/workflows/checkblack.yml/badge.svg)](https://github.com/vroomfondel/networkmgmt/actions/workflows/checkblack.yml)\n[![mypy and pytests](https://github.com/vroomfondel/networkmgmt/actions/workflows/mypynpytests.yml/badge.svg)](https://github.com/vroomfondel/networkmgmt/actions/workflows/mypynpytests.yml)\n[![BuildAndPushMultiarch](https://github.com/vroomfondel/networkmgmt/actions/workflows/buildmultiarchandpush.yml/badge.svg)](https://github.com/vroomfondel/networkmgmt/actions/workflows/buildmultiarchandpush.yml)\n![Cumulative Clones](https://img.shields.io/endpoint?logo=github&url=https://gist.githubusercontent.com/vroomfondel/906f5c4deb7e6e6bcd6ee0f7c96f586c/raw/networkmgmt_clone_count.json)\n[![PyPI](https://img.shields.io/pypi/v/networkmgmt?logo=python&logoColor=white)](https://pypi.org/project/networkmgmt/)\n[![Gemini_Generated_Image_8bu6gi8bu6gi8bu6_250x250.png](https://raw.githubusercontent.com/vroomfondel/networkmgmt/main/Gemini_Generated_Image_8bu6gi8bu6gi8bu6_250x250.png)](https://github.com/vroomfondel/networkmgmt)\n\n# WIP !!!\n\n# networkmgmt — Network Management Toolkit\n\nCLI tool and Python library for multi-vendor switch management and network topology discovery.\n\nQuick links:\n- [Docker Hub](https://hub.docker.com/r/xomoxcc/networkmgmt/tags) — multi-arch image (amd64/arm64)\n- [PyPI](https://pypi.org/project/networkmgmt/) — `pip install networkmgmt`\n- [GitHub](https://github.com/vroomfondel/networkmgmt) — source, issues, CI\n\n## Modules\n\n| Module | Description |\n|--------|-------------|\n| **networkmgmt.switchctrl** | Multi-vendor switch management (Cisco, MikroTik, QNAP, Netgear) |\n| **networkmgmt.discovery** | Network topology discovery (ARP, DNS, SNMP, LLDP, nmap, traceroute) |\n| **networkmgmt.snmp_vlan_dump** | SNMP VLAN-port dump for Netgear switches |\n\n## Supported Switch Vendors\n\n| Vendor | Model(s) | Transport | Notes |\n|--------|----------|-----------|-------|\n| **cisco** | Catalyst 1200 (C1200-8T-D) | SSH CLI only | 8 GE ports (`gi1`–`gi8`), no REST API, enable password required |\n| **mikrotik** | RouterOS v7+ switches | REST API + SSH CLI | REST for monitoring, SSH for configuration |\n| **qnap** | QSW-M408 series | REST API + SSH CLI | Cisco-style CLI, enable password auto-generated from serial |\n| **netgear** | Managed switches | — | Stub (not yet implemented) |\n\n## CLI Structure\n\n`networkmgmt` is an orchestrator that dispatches to three sub-CLIs. Each sub-CLI can also be invoked directly:\n\n| Orchestrator command | Direct script | Description |\n|---|---|---|\n| `networkmgmt switchctrl ...` | `networkmgmt-switchctrl` | Multi-vendor switch management |\n| `networkmgmt discover ...` | `networkmgmt-discover` | Network topology discovery |\n| `networkmgmt vlan-dump ...` | `networkmgmt-vlan-dump` | SNMP VLAN-port dump |\n\n## Installation\n\n```bash\npip install .\n```\n\n## Network Topology Discovery\n\nDiscover local network topology via ARP scanning, reverse DNS, MAC vendor lookup, SNMP bridge tables, LLDP, optional nmap service detection, and traceroute. Outputs Mermaid flowcharts or JSON.\n\n### CLI\n\n```bash\n# Basic discovery (auto-detect interface)\nnetworkmgmt-discover -i eth0\n# or: networkmgmt discover -i eth0\n\n# With nmap service detection (requires root for ARP scan)\nsudo networkmgmt-discover -i eth0 --nmap -o topology.md\n\n# JSON output\nnetworkmgmt-discover -i eth0 --format json -o topology.json\n\n# Multi-subnet scan\nnetworkmgmt-discover -i eth0,vlan100 -o multi.md\n\n# SNMP L2 topology (query switch MAC tables)\nnetworkmgmt-discover -i eth0 --switches 192.168.1.38:public,192.168.1.19\n\n# LLDP-based topology\nnetworkmgmt-discover -i eth0 --lldp-collect /tmp/lldp\n\n# Manual topology + diagram style\nnetworkmgmt-discover -i eth0 --topology 192.168.1.50:192.168.1.19:g3 -d hierarchical\n\n# Traceroute to external targets\nnetworkmgmt-discover -i eth0 -t 8.8.8.8,1.1.1.1\nsudo networkmgmt-discover -i eth0 -t 192.168.1.0/24\n```\n\n### Discovery Options\n\n| Option | Description |\n|--------|-------------|\n| `-i` / `--interface` | Network interface(s), comma-separated (default: auto-detect) |\n| `-t` / `--targets` | Traceroute targets: IPs, CIDR (`192.168.1.0/24`), or range (`192.168.1.1-254`) |\n| `--nmap` | Enable nmap service detection |\n| `--top-ports` | nmap top ports to scan (default: 100) |\n| `-o` / `--output` | Output file (default: stdout) |\n| `--format` | `mermaid` (default) or `json` |\n| `--timeout` | Scan timeout in seconds (default: 10) |\n| `--max-hops` | Max traceroute hops (default: 30) |\n| `--trace-local` | Tracepath to all LAN hosts to detect switch hierarchy |\n| `--switches` | SNMP L2 discovery: `IP[:community],...` (default community: `public`) |\n| `--lldp-collect` | SSH into hosts, collect lldpctl JSON to directory |\n| `--lldp-dir` | Read existing LLDP JSON files from directory |\n| `--topology` | Manual L2 topology: `HOST:SWITCH:PORT,...` |\n| `-d` / `--diagram-style` | `auto` (default), `flat`, `categorized`, `hierarchical` |\n| `--direction` | Mermaid flowchart direction: `LR` or `TD` (default: auto) |\n| `--elk` | Use ELK layout engine for large diagrams |\n| `-v` / `--verbose` | Verbose logging |\n\n### Python Library Usage (Discovery)\n\n```python\nfrom networkmgmt.discovery import NetworkTopologyScanner, MermaidGenerator\n\nscanner = NetworkTopologyScanner(interfaces=[\"eth0\"], use_nmap=True)\ntopology = scanner.run_discovery()\n\n# Generate Mermaid diagram\ngen = MermaidGenerator(topology, diagram_style=\"hierarchical\")\nprint(gen.generate())\n\n# Or export as JSON\nprint(topology.model_dump_json(indent=2))\n```\n\n## Switch Management CLI\n\n```bash\nnetworkmgmt-switchctrl --vendor --host --password [options] \n# or: networkmgmt switchctrl --vendor --host --password [options] \n```\n\n### Global Options\n\n| Option | Description |\n|--------|-------------|\n| `--vendor` | Switch vendor (`cisco`, `mikrotik`, `netgear`, `qnap`) |\n| `--host` | Switch IP address or hostname |\n| `--password` | Admin password |\n| `--username` | Username (default: `admin`) |\n| `--enable-password` | Enable password (Cisco: required; QNAP: auto-generated if omitted) |\n| `--ssh-port` | SSH port (default: 22) |\n| `--rest-port` | REST API port (default: 443) |\n| `--ssh-username` | SSH username (vendor-specific default if omitted) |\n| `--ssh-password` | SSH password (vendor-specific default if omitted) |\n| `--verify-ssl` | Verify SSL certificates for REST API |\n| `-v` / `--verbose` | Enable debug logging |\n\n### Commands\n\n#### `monitor` — Show system info, sensors, ports, and LACP status\n\n```bash\n# Cisco Catalyst 1200\nnetworkmgmt-switchctrl --vendor cisco --host 192.168.1.254 \\\n --username admin --password --enable-password monitor\n\n# QNAP QSW\nnetworkmgmt-switchctrl --vendor qnap --host 192.168.1.1 --password monitor\n```\n\n#### `vlan` — VLAN management\n\n```bash\n# Create VLAN\nnetworkmgmt-switchctrl --vendor cisco --host 192.168.1.254 \\\n --username admin --password --enable-password \\\n vlan create 100 --name servers\n\n# List VLANs\nnetworkmgmt-switchctrl --vendor cisco ... vlan list\n\n# Delete VLAN\nnetworkmgmt-switchctrl --vendor cisco ... vlan delete 100\n```\n\n#### `port` — Port configuration\n\n```bash\n# Configure port (Cisco uses gi1-gi8, QNAP uses GigabitEthernet1/0/1)\nnetworkmgmt-switchctrl --vendor cisco --host 192.168.1.254 \\\n --username admin --password --enable-password \\\n port config gi1 --speed 1000 --duplex full\n\n# Disable a port\nnetworkmgmt-switchctrl --vendor cisco ... port config gi3 --shutdown\n```\n\n#### `example` — Quick connectivity test\n\n```bash\nnetworkmgmt-switchctrl --vendor cisco --host 192.168.1.254 \\\n --username admin --password --enable-password example\n```\n\n## Python Library Usage (Switch Management)\n\n```python\nfrom networkmgmt import create_switch\n\n# Cisco Catalyst 1200\nwith create_switch(\n \"cisco\",\n host=\"192.168.1.254\",\n username=\"admin\",\n password=\"mypass\",\n enable_password=\"myenable\",\n) as switch:\n switch.enable()\n\n # Monitoring\n info = switch.monitoring.get_system_info()\n print(f\"{info.model} — FW {info.firmware_version}\")\n\n sensors = switch.monitoring.get_sensor_data()\n print(f\"Temperature: {sensors.temperature}°C\")\n\n ports = switch.monitoring.get_port_status()\n for p in ports:\n print(f\" {p.port}: {'UP' if p.link_up else 'DOWN'}\")\n\n # VLAN management (uses 'vlan database' mode on C1200)\n switch.vlan.create_vlan(100, \"servers\")\n switch.vlan.assign_port_to_vlan(\"gi3\", 100)\n\n # LACP (uses 'mode auto' on C1200)\n switch.lacp.create_port_channel(1, [\"gi5\", \"gi6\"])\n```\n\n```python\n# QNAP QSW\nwith create_switch(\"qnap\", host=\"192.168.1.1\", password=\"admin123\") as switch:\n switch.enable() # auto-generates enable password from serial\n info = switch.monitoring.get_system_info()\n print(info.model)\n```\n\n## Vendor-Specific Notes\n\n### Cisco Catalyst 1200 (C1200-8T-D)\n\n- **SSH only** — no REST API available\n- **Port names**: `gi1` through `gi8` (not `GigabitEthernet1/0/1`)\n- **Enable password required** — no auto-generation, C1200 enforces password change on first login\n- **VLAN creation** uses `vlan database` mode (not `configure terminal` > `vlan {id}`)\n- **LACP** uses `channel-group {id} mode auto` (not `mode active`)\n- **Fanless** — PoE-powered, `get_sensor_data()` always returns `fan_speed=0`\n\n### QNAP QSW\n\n- **Dual transport** — REST API for monitoring, SSH (Cisco-style CLI) for configuration\n- **Enable password** can be auto-generated from the switch serial number\n- **Default SSH credentials**: `guest` / `guest123`\n\n### MikroTik\n\n- **Dual transport** — REST API (RouterOS v7+) for monitoring, SSH for configuration\n- **No enable mode** — RouterOS uses direct admin access\n\n## Architecture\n\n```\nnetworkmgmt/\n├── __init__.py # Public API: create_switch(), list_vendors()\n├── __main__.py # Orchestrator CLI — dispatches to sub-CLIs\n├── switchctrl/ # Multi-vendor switch management\n│ ├── __init__.py # Re-exports: create_switch, list_vendors, SwitchError\n│ ├── cli.py # Switch management CLI (networkmgmt-switchctrl)\n│ ├── factory.py # Vendor registry and factory\n│ ├── exceptions.py # Exception hierarchy\n│ ├── base/ # Abstract base classes\n│ │ ├── client.py # BaseSwitchClient\n│ │ ├── managers.py # BaseMonitoringManager, BaseVLANManager, ...\n│ │ └── transport.py # BaseTransport\n│ ├── models/ # Dataclasses (vendor-agnostic)\n│ │ ├── port.py # PortConfig, PortStatus, PortSpeed, ...\n│ │ ├── vlan.py # VLAN, TrunkConfig\n│ │ ├── stats.py # PortStatistics\n│ │ └── system.py # SystemInfo, SensorData, LACPInfo\n│ └── vendors/\n│ ├── common/ # Shared Cisco-style CLI transport & managers\n│ │ ├── cisco_cli.py # CiscoCLITransport (SSH + paramiko)\n│ │ └── cisco_managers.py CiscoVLANManager, CiscoPortManager, CiscoLACPManager\n│ ├── cisco/ # Cisco Catalyst 1200\n│ │ ├── client.py # CiscoSwitch — SSH only\n│ │ └── managers.py # CiscoCLIMonitoringManager, CiscoCatalyst*Manager\n│ ├── mikrotik/ # MikroTik RouterOS\n│ │ ├── client.py # MikroTikSwitch\n│ │ ├── managers.py # MikroTik*Manager\n│ │ ├── rest.py # MikroTikRESTTransport\n│ │ └── ssh.py # RouterOSTransport\n│ ├── qnap/ # QNAP QSW\n│ │ ├── client.py # QNAPSwitch\n│ │ ├── rest.py # QNAPRESTTransport, QNAPMonitoringManager\n│ │ └── utils.py # generate_enable_password()\n│ └── netgear/ # Netgear (stub)\n│ └── client.py # NetgearSwitch (NotImplementedError)\n├── discovery/ # Network topology discovery\n│ ├── __init__.py # Public API: NetworkTopologyScanner, MermaidGenerator, ...\n│ ├── cli.py # Discovery CLI (networkmgmt-discover)\n│ ├── models.py # Pydantic models: NetworkTopology, DiscoveredHost, ...\n│ ├── _util.py # Shared helpers: _run_cmd, _validate_*, _strip_hostname\n│ ├── oui.py # IEEE OUI database loading and vendor lookup\n│ ├── categorize.py # Device category classification rules\n│ ├── scanner.py # NetworkTopologyScanner (ARP, ping, nmap, DNS, traceroute)\n│ ├── snmp.py # SnmpBridgeDiscovery (SNMP MAC table queries)\n│ ├── lldp.py # LldpDiscovery (SSH + lldpctl)\n│ └── mermaid.py # MermaidGenerator (flowchart diagram output)\n└── snmp_vlan_dump/ # SNMP VLAN-port dump\n ├── __init__.py\n ├── cli.py # VLAN dump CLI (networkmgmt-vlan-dump)\n ├── collector.py # VlanDataCollector\n ├── formatters.py # TerminalFormatter, MarkdownFormatter\n ├── mermaid.py # VlanMermaidGenerator\n └── snmp.py # SNMP operations\n```\n\n## Adding a New Vendor\n\n1. Create `networkmgmt/switchctrl/vendors//` with `__init__.py`, `client.py`, and optionally `managers.py`\n2. Decorate your client class with `@register_vendor(\"\")`\n3. Add `import networkmgmt.switchctrl.vendors.` to `networkmgmt/switchctrl/vendors/__init__.py`\n4. The CLI picks it up automatically via `list_vendors()`\n\n\n## License\nThis project is licensed under the LGPL where applicable/possible — see [LICENSE.md](LICENSE.md). Some files/parts may use other licenses: [MIT](LICENSEMIT.md) | [GPL](LICENSEGPL.md) | [LGPL](LICENSELGPL.md). Always check per‑file headers/comments.\n\n\n## Authors\n- Repo owner (primary author)\n- Additional attributions are noted inline in code comments\n\n\n## Acknowledgments\n- Inspirations and snippets are referenced in code comments where appropriate.\n\n\n## ⚠️ Note\n\nThis is a development/experimental project. For production use, review security settings, customize configurations, and test thoroughly in your environment. Provided \"as is\" without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software. Use at your own risk.","has_starred","hub_user","vroofoo","immutable_tags_settings",{"_76":11,"_77":78},"enabled","rules",[79],".*","is_automated","permissions",{"_83":22,"_84":11,"_85":11},"read","write","admin","user","storage_size",835201714,"orgData",{"_91":92,"_93":94,"_95":96,"_97":33,"_98":48,"_99":100,"_101":102,"_103":48,"_104":105,"_106":107,"_108":48,"_109":48,"_110":22},"id","6f318f246c8440b0aaa23a169c30bbc8","uuid","6f318f24-6c84-40b0-aaa2-3a169c30bbc8","type","organization","orgname","full_name","location","Ellerbek","company","XOMOX GmbH","profile_url","date_joined","2025-02-07T09:09:11.304991Z","gravatar_url","https://www.gravatar.com/avatar/1afeb5ce231a633bb22208de6879f7b6?s=80&r=g&d=mm","gravatar_email","badge","is_active","recentTags",[113,156],{"_114":44,"_115":116,"_117":118,"_119":120,"_91":121,"_122":123,"_50":145,"_146":116,"_147":33,"_148":56,"_57":149,"_150":151,"_152":130,"_153":145,"_154":66,"_155":22},"content_type","creator",32378403,"digest","sha256:d0a0a4d1784c508126e91f5b84e167ced26789f808086fe489a59c49f2ce90b2","full_size",120487401,1070739968,"images",[124,139],{"_125":126,"_117":127,"_128":48,"_129":130,"_131":132,"_133":134,"_135":48,"_136":-5,"_137":120,"_63":66,"_138":-5},"architecture","amd64","sha256:bbcbbb079e8b94d4f892f6eff2fe13cd2d7962718b257d8e52fcc95008544438","features","last_pulled","2026-11-02T15:57:02.498485887Z","last_pushed","2026-11-01T12:09:17.408097276Z","os","linux","os_features","os_version","size","variant",{"_125":140,"_117":141,"_128":48,"_129":142,"_131":143,"_133":134,"_135":48,"_136":-5,"_137":144,"_63":66,"_138":-5},"arm64","sha256:8cfeb4588362fa1a006ee8a3f83e6918c32e3b22f1b96f730f9a3a77f0ef960f","2026-11-02T15:57:02.484620416Z","2026-11-01T12:09:17.878561046Z",119889265,"2026-11-01T12:09:19.288485Z","last_updater","last_updater_username","media_type","latest","repository",30047681,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_114":44,"_115":116,"_117":118,"_119":120,"_91":157,"_122":158,"_50":161,"_146":116,"_147":33,"_148":56,"_57":162,"_150":151,"_152":130,"_153":161,"_154":66,"_155":22},1070739985,[159,160],{"_125":126,"_117":127,"_128":48,"_129":130,"_131":132,"_133":134,"_135":48,"_136":-5,"_137":120,"_63":66,"_138":-5},{"_125":140,"_117":141,"_128":48,"_129":142,"_131":143,"_133":134,"_135":48,"_136":-5,"_137":144,"_63":66,"_138":-5},"2026-11-01T12:09:21.088201Z","python-3.14-slim-trixie","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxRunInCloud","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":177,"_184":185,"_171":200,"_201":11},{"_40":178,"_42":179,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":180,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":73,"_74":181,"_80":11,"_81":183,"_86":33,"_87":88},[],[44],[56],{"_76":11,"_77":182},[79],{"_83":22,"_84":11,"_85":11},"tags",{"_186":187,"_188":-5,"_189":-5,"_190":191},"count",2,"next","previous","results",[192,196],{"_114":44,"_115":116,"_117":118,"_119":120,"_91":157,"_122":193,"_50":161,"_146":116,"_147":33,"_148":56,"_57":162,"_150":151,"_152":130,"_153":161,"_154":66,"_155":22},[194,195],{"_125":126,"_117":127,"_128":48,"_129":130,"_131":132,"_133":134,"_135":48,"_136":-5,"_137":120,"_63":66,"_138":-5},{"_125":140,"_117":141,"_128":48,"_129":142,"_131":143,"_133":134,"_135":48,"_136":-5,"_137":144,"_63":66,"_138":-5},{"_114":44,"_115":116,"_117":118,"_119":120,"_91":121,"_122":197,"_50":145,"_146":116,"_147":33,"_148":56,"_57":149,"_150":151,"_152":130,"_153":145,"_154":66,"_155":22},[198,199],{"_125":126,"_117":127,"_128":48,"_129":130,"_131":132,"_133":134,"_135":48,"_136":-5,"_137":120,"_63":66,"_138":-5},{"_125":140,"_117":141,"_128":48,"_129":142,"_131":143,"_133":134,"_135":48,"_136":-5,"_137":144,"_63":66,"_138":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
bbcbbb079e8b	linux/amd64	114.91 MB
8cfeb4588362	linux/arm64	114.34 MB

xomoxcc/networkmgmt

Tags for xomoxcc/networkmgmt