hnwProxy is a proxy server you can use to simulate a broken Internet connection. It was developed as a bachelor's thesis by Eemil Aikio.

hnwProxy uses a simple module system to run scripts that break things. The command proxy show will list available modules, all of these can be called without arguments for usage information. (more info about modules under guestfiles/proxy_cli)

• Broken MTU
• Port block (drop & tcp rst)
• DNS redirect
• Transparent proxy (http & https)

1. Install Vagrant
2. Download hnwProxy: git clone https://github.com/HowNetWorks/hnwProxy.git
3. Start hnwProxy with a supported provider.
4. Connect.
5. Use the command proxy to see what you can break in hnwProxy.

hnwProxy supports 3 providers:

1. Install VirtualBox
2. (optional) Enable bridged networking in settings.yamlif you have a wired NIC available.
3. Run vagrant up

1. Ensure you have one external type external switch configured in Hyper-V.
2. Run vagrant up (include --provider=hyperv if vagrant doesn't recognize this automatically)

1. Install DO plugin: vagrant plugin install vagrant-digitalocean
2. Create API token: https://cloud.digitalocean.com/settings/api/tokens
3. Add token to settings.yaml
4. (optional) Change DO region in settings.yaml.
5. vagrant up --provider=digital_ocean

1. vagrant ssh -- -D 6000
2. Set localhost:6000 as your socks5 proxy.

1. Connect via SSH (vagrant ssh).
2. proxy pptp
3. Connect with the shown settings.

• Stop VM: vagrant halt
• Delete VM: vagrant destroy
• Update VM: vagrant halt && vagrant up --provision (fast and works most of the time)
• Update VM: vagrant destroy && vagrant up

PS D:\git\hnwProxy> vagrant ssh -- -D 6000

vagrant@hnwproxy:~$ proxy
USAGE
  proxy <module_name> [options]
  proxy show

OPTIONS
  module_name   Run this module.
  show          List available modules.
vagrant@hnwproxy:~$ proxy  show

 dns-redirect - Redirect DNS requests to another server.
 Usage: proxy dns-redirect <ip>

 mtu - break mtu
 usage: proxy mtu [value]

 port - Filters traffic by outgoing destination port.
 Run without arguments for usage information.

vagrant@hnwproxy:~$ proxy dns-redirect 127.0.0.1
vagrant@hnwproxy:~$ proxy dns-redirect ::0
vagrant@hnwproxy:~$ proxy dns-redirect show
Redirecting IPv4 DNS requests to 127.0.0.1
Redirecting IPv6 DNS requests to ::
vagrant@hnwproxy:~$ ping google.com
ping: unknown host google.com