Doing some major updates and clean up on the mNemu project as it seems to be gaining some use for QA teams and I want to support that better. I'm converting mNemu over to GO (for concurrency and future expansion) and a Bootstrap front end (more modern look and feel). Along with this upgrade I'll be wrapping up the scripting system and introducing another new feature to allow for targeted throttling of IPs and Domains! Stay tuned! :)
MNemu is an open-source application developed to provide a simple, lightweight network emulation tool for testing and developing web, mobile, and standalone applications under various networking conditions. It was designed as a easy to use interface to harness the power of the Linux Kernel tc netem commands across multiple clients in real-time.
Currently MNemu is under very active development. While the core abilities that
MNemu was originally designed for are functional, bugs and changes should be
expected. A good portion of the codebase will undergo 'cleanup' and polish as
we approach a v1.0
Users wishing to utilize MNemu immediately will need to edit the interface name
and ip/port combinations in the mnemu_web.py file before launching to ensure the
application attaches to the correct networking interface on the machine.
Pre-reqs:
- Linux machine or VM with dual network interfaces
- iproute networking package installed (iproute includes the tc netem tool)
- A Route or Bridge between the two network interfaces
Starting:
- Identify the networking interface name to utilize
- Edit the interface name and ip/port numbers in mnemu_web.py at the MNemu init point
- Launch with 'python3 mnemu_web.py'
- Visit the page at the IP/Port combination used and begin manipulating network conditions for any devices that have visited the page
- Manually add and manipulate devices by visting 0.0.0.0:0/ip/1.2.3.4 where 1.2.3.4 is the IP you wish to add. You can then return to the home MNemu page and change the networking conditions for that IP
MNemu Web App
-
Simplistic TC Netem Configuration
Provides a simple web-based interface for creating tc netem configurations on a per IP basis. -
Per IP Inbound and Outbound Traffic Manipulation
MNemu allows for isolating network emulation rules to be set per IP and for the inbound and outbound traffic of that IP. -
(Webapp) - Device IP, Favorite IPs, and Ignored IP Sections
The web app interface shows the IP of the connecting device to allow users to simply visit the page with the device they wish to manipulate network conditions on. Users can also ignore certain IPs and set favorite IPs. -
(Webapp) - Presets
MNemus web app allows for quickly setting various 'preset' network conditions on the inbound and outbound traffic with a simple dropdown selection -
(Webapp) - Bandwidth, Ping, Loss, Duplication, and Corruption NetEm Settings
The current version of the web app allows users to set the common netem rules for the inbound and outbound traffic of any IP routing through the system -
REST API
While the API will undergo some organization changes, it is a fully functional interface to the MNemu applications abilities
-
Scripting
Soon MNemu will allow users to create 'scripts' to change the network emulation conditions. Scripts will initially allow users to set various conditions at certain times, for certain intervals of time, or at random points. -
Remaining Netem Settings
Adding the 'correlation' settings for all the available Netem settings. -
Preventing Network Conditioning To and From MNemu Server
Currently users can still 'kill' their connections to completely by settings an extremely low bandwidth limit or severe packet loss. This also prevents the users from reaching the MNemu web app to fix their connections. -
Simple Monitoring
Simple traffic statistics for IPs being actively conditioned.
-
Realtime Packet Capture
Adding the ability to perform a tcpdump on an active IP being conditioned by the MNemu server. -
Possible IPv6 Support
Support for IPv6 networks