Skip to content

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

Notifications You must be signed in to change notification settings

freepn/mitm-adblock

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 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 ./bin/update-blocklists.sh to download some blocklists
  2. Run ./bin/proxy-runner.sh to start the proxy server on port 8080 (or run ./bin/proxy-runner.sh -c for a curses interface which lets you inspect the requests/responses, or run ./bin/proxy-runner.sh -d to dump all flows to the 'flows/' directory)
  3. Do a quick test to make sure it's working: curl --proxy localhost:8080 -L -k https://slashdot.org/
  4. Setup your browser/phone to use localhost:8080 or lan-ip-address:8080 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.
  5. Alternately, you can use ./bin/install-cert.sh to install the proxy-generated cert; see the script for details.

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

About

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

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 40.8%
  • Shell 38.0%
  • Ruby 21.2%