gont

README

Gont - A Go network testing toolkit

Gont is a package to creat realistic virtual network, running real kernel, switch and application code, on a single machine (VM, cloud or native).

Gont is heavily inspired by Mininet. It allows the user to build virtual network topologies using Go code. Under to hood the network is then constructed using Linux virtual bridges and network namespaces.

Getting started

Have a look at our slide set to get you started.

Features

• L3 Routers
• L2 Switches
• L3 NAT Routers
• L3 Host NAT (to host network)
• Hostname resolution (using /etc/hosts)
• Support for multiple simultaneous and isolated networks
• Ideal for golang unit tests
• Can run in workflows powered by GitHub's runners
• Lean code thanks to functional options
• Full IPv6 support
• Per link network emulation and bandwidth limiting via for netem and tbf qdiscs
• Use of existing network namespaces as nodes

Examples

Have a look at the unit tests for usage examples:

• Simple
• Run
• NAT
• Switch
• Links

Prerequisites

• traceroute (for testing)

Architecture

Credits

• Steffen Vogel 📧

Funding acknowledment

The development of Gont has been supported by the ERIGrid 2.0 project
of the H2020 Programme under Grant Agreement No. 870620