Skip to content

A fast adblocking proxy server (which works on HTTPS connections)

License

Notifications You must be signed in to change notification settings

epitron/mitm-adblock

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MITM Adblock

An adblocker that runs as a proxy server! (And works on HTTPS connections.)

Use this to block ads on your mobile device, or just monitor its traffic.

Installation

  1. Install mitmproxy
  2. Install required python modules:
$ pip install 'Cython>=0.29.19,<1.0'  # for pyre2
$ pip install -r requirements.txt
  1. Run ./update-blocklists to download some blocklists
  2. Run ./go to start the proxy server on port 8118 (or run ./go -c for a curses interface which lets you inspect the requests/responses, or run ./go -d to dump all flows to the 'flows/' directory)
  3. Do a quick test to make sure it's working: curl --proxy localhost:8118 -L -k https://slashdot.org/
  4. Setup your browser/phone to use localhost:8118 or lan-ip-address:8118 as an HTTP proxy server; then, visit http://mitm.it on that device to install the MITM SSL certificate so that your machine won't throw security warnings whenever the proxy server intercepts your secure connections.

If you'd like to change any of the mitmproxy settings (like port, and where/whether it logs your connections), edit the go script.

About

A fast adblocking proxy server (which works on HTTPS connections)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published