WonderShaper: Network card speed limit tool

1. What is WonderShaper

WonderShaper is a tool for quickly limiting the speed of a specific network card. It is actually a shell script that encapsulates the Linux tc command, so it is cheaper to use than tc and easier to use. The following is used together with the speed test tool speedtest

2. How to install WonderShaper

 #Pull wondershaper directly and use it out of the box
 git clone https://github.com/magnific0/wondershaper.git ​ ​ ​

 root@ ****- 5491 : / home / soft / wondershaper # ./wondershaper-v
 Version 1.4 .1
 root@ ****- 5491 : / home / soft / wondershaper#

 #Installation of Internet speed test tool speedtest ( Ubuntu )
 apt install speedtest - cli
 --yum install speedtest-cli (centos)

3.WonderShaper Help

 root @ ****- 5491 : / home / soft / wondershaper# ./wondershaper-h
 USAGE : . / wondershaper [ - hcs ] [ - a < adapter > ] [ - d < rate > ] [ - u < rate > ]

 Limit the bandwidth of an adapter

 OPTIONS :
 -h Show this message 【Help information】
 - a < adapter > Set the adapter [Specify the network card interface]
 -d < rate > Set maximum download rate ( in Kbps ) and / or [Limit download speed ( in Kbps ) ]
 -u < rate > Set maximum upload rate ( in Kbps ) [Limit upload speed ( Kbps ) ]
 -p Use presets in "/etc/systemd/wondershaper.conf"
 -f <file> Use alternative preset file
 -c Clear the limits from adapter [Clear the specified network card rules to cancel the speed limit]
 -s Show the current status of adapter [Show the current status of the network card]
 -v Show the current version

 Configure HIPRIODST in "/etc/systemd/wondershaper.conf" for hosts
 requiring high priority i .e . in case ssh uses dport 443 .

 MODES :
 wondershaper - a < adapter > - d < rate > - u < rate >
 wondershaper - c - a <adapter>
 wondershaper - s - a <adapter>

 EXAMPLES : [Examples]
 wondershaper - a eth0 - d 1024 - u 512 [Set the upstream speed of network card eth0 to 512kbps and the downstream speed to 1024kbps]
 wondershaper - a eth0 - u 512 [Only set the uplink speed to 512kbps]
 wondershaper - c - a eth0 [Clear the rules of network card eth0]
 wondershaper - p - f foo .conf [Set the specified configuration file]

4. WonderShaper Usage Examples

4.1 Check the network card status

 root@ ****- 5491 : / home / soft / wondershaper# ifconfig eno1
 eno1 : flags = 4163 < UP , BROADCAST , RUNNING , MULTICAST > mtu 1500
 inet 192.168 .5 .103 netmask 255.255 .255 .0 broadcast 192.168 .5 .255
 inet6 fe80 :: 2 c93 : 21 f9 : 1931 : 304 prefixlen 64 scopeid 0x20 <link>
 ether c8 : f7 : 50 : 7 e : 50 : 48 txqueuelen 1000 ( Ethernet )
 RX packets 7748809 bytes 1034513376 ( 1.0 GB )
 RX errors 0 dropped 439 overruns 0 frame 0
 TX packets 15528838 bytes 4784318169 ( 4.7 GB )
 TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
 device interrupt 16 memory 0x91500000 - 91520000

 root@ ****- 5491 : / home / soft / wondershaper # ./wondershaper-s-a eno1
 qdisc fq_codel 0 : root refcnt 2 limit 10240 p flows 1024 quantum 1514 target 5.0 ms interval 100.0 ms memory_limit 32 Mb ecn
 Sent 4528052159 bytes 14890189 pkt ( dropped 0 , overlimits 0 requeues 4224 )
 backlog 0 b 0 p requeues 4224
 maxpacket 66616 drop_overlimit 0 new_flow_count 35953 ecn_mark 0
 new_flows_len 0 old_flows_len 0

 --Test network speed
 root@ ****- 5491 : / home / soft / wondershaper# speedtest
 Retrieving speedtest .net configuration...
 Testing from China Telecom ( 120.36 .98 .11 ) ...
 Retrieving speedtest .net server list...
 Selecting best server based on ping...
 Hosted by Fuzhou China Mobile , Fujian ( Fuzhou ) [ 589.19 km ] : 14.449 ms
 Testing download speed................................................................................
 -- Download speed is 171.43 Mbit/s,
 Download : 171.43 Mbit / s
 Testing upload speed................................................................................................................
 -- Upload speed is 4.15 Mbit/s
 Upload : 4.15 Mbit / s

4.2 Limit network card speed (in Kbps)

 -- Downlink 2048kbps = 2 Mbit/s, Uplink 1024kbps = 1 Mbit/s
 root @ ****- 5491 : / home / soft / wondershaper # ./wondershaper-aeno1-d2048-u1024
 --Test network speed
 root@ **** e - 5491 : / home / soft / wondershaper# speedtest
 Retrieving speedtest .net configuration...
 Testing from China Telecom ( 120.36 .98 .11 ) ...
 Retrieving speedtest .net server list...
 Selecting best server based on ping...
 Hosted by Far EasTone Telecom ( Miaoli City ) [ 722.10 km ] : 174.383 ms
 Testing download speed................................................................................
 --Downlink speed
 Download : 1.80 Mbit / s
 Testing upload speed................................................................................................................
 --Uplink speed
 Upload : 1.28 Mbit / s
 root@ ****- 5491 : / home / soft / wondershaper#

4.3 Cancel speed limit

 --Cancel speed limit
 root@ ****- 5491 : / home / soft / wondershaper # ./wondershaper-c-a eno1
 -- Check the network card status
 root@ ****- 5491 : / home / soft / wondershaper # ./wondershaper-s-a eno1
 qdisc fq_codel 0 : root refcnt 2 limit 10240 p flows 1024 quantum 1514 target 5.0 ms interval 100.0 ms memory_limit 32 Mb ecn
 Sent 123022 bytes 471 pkt ( dropped 0 , overlimits 0 requeues 0 )
 backlog 0 b 0 prequeues 0
 maxpacket 0 drop_overlimit 0 new_flow_count 0 ecn_mark 0
 new_flows_len 0 old_flows_len 0

 -- Test network speed
 root@ ****- 5491 : / home / soft / wondershaper# speedtest
 Retrieving speedtest .net configuration...
 Testing from China Telecom ( 120.36 .98 .11 ) ...
 Retrieving speedtest .net server list...
 Selecting best server based on ping...
 Hosted by Far EasTone Telecom ( Miaoli City ) [ 722.10 km ] : 173.886 ms
 Testing download speed................................................................................
 Download : 11.29 Mbit / s
 Testing upload speed................................................................................................................
 Upload : 2.93 Mbit / s
 root@ ****- 5491 : / home / soft / wondershaper#

5. Application of WonderShaper in testing

Test project: An internal database migration tool

Test purpose: During data migration, the target end is limited in speed. When the speed limit is canceled, the transmission speed can be restored.

Test steps: Start the migration process and use the WonderShaper tool to limit the speed on the target server:

 -- Limit only the downstream speed
 [ #22#root@ **** ~/ wondershaper ] 22. / wondershaper - a enp0s3 - d 100

Test results: After the speed limit is applied, the number of rows and bytes written per unit in the target database drops sharply, as shown in the following figure:

 After the speed limit is canceled and the network is restored, the transmission rate slowly recovers: 

6. Network speed unit conversion

 1 KB / s = 8 kbps = 8 kb / s
 For example, a 100M broadband connection actually has a speed of 100Mbps = ( 100 / 8 ) MB / s = 12.5 MB / s

7. Summary

Use WonderShaper to limit the speed of the network card. During the test, you can specify the network card in a targeted manner, specify the upload speed or specify the download speed. In the test, the upload and download speeds do not affect each other, so you can limit only one side. The WonderShaper tool is easy to use and is a good tool.