Skip to content

charlesbullsd/mitm-adblock

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 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 adblockparser Cython git+https://github.com/andreasvc/pyre2.git
  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

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 67.3%
  • Ruby 22.4%
  • Shell 10.3%