A plain HTTP proxy written to help understand the mechanics of proxies, in Node.js
 
 
Go to file
Jacob Windle b89cb298d3 Including Python test suite for proxy 2019-01-26 07:54:31 -05:00
test Including Python test suite for proxy 2019-01-26 07:54:31 -05:00
.gitignore Including Python test suite for proxy 2019-01-26 07:54:31 -05:00
README.md Including Python test suite for proxy 2019-01-26 07:54:31 -05:00
index.js Bring in winston for logging, upgrade to async/await for promises 2019-01-26 07:48:38 -05:00
index.test.js Setting up jest to run 2019-01-24 22:13:48 -05:00
package-lock.json Adding winston 2019-01-26 07:48:52 -05:00
package.json Adding winston 2019-01-26 07:48:52 -05:00

README.md

Node HTTP Proxy

This project is an HTTP proxy, written in Node.js.

I wrote this because I deal with proxies at work all the time, and wanted to write one as an exercise. I chose Node.js due to the event-driven architecture lending itself well to networking applications and because I am familiar with the language.

My goal for this project is to have it be easy to spin up, and compatible with major browsers. It will do 2 things.

  1. It will monitor application-level traffic (anything over HTTP/HTTPS) - and log it.
  2. It will block traffic after it's detected that you've been on a certain site for too long.

In the future I would like it to:

  1. Block traffic based on pre-configured block rules.
  2. Attempt to block any content it deems dangerous.
  3. Provide a web interface for configuration management.
  4. Provide a configuration file.

So in reality, it will be a tool to help monitor your internet usage and block you from spending too much time on any particular site!

Testing

To test, can either spin up the vagrant instance, or utilize the unit tests.

Testing Locally

The directory ./test includes Python based tests intended to stress the proxy. To run them, install the requirements with Pip, then run python3 test_proxy.py

TODO

  1. Setup a server that listens on a port
  2. Write a rudimentary parsing routine.
  3. Get Jest tests set up for the parsing routine
  4. Get Vagrantfile so can test with an actual browser that asks for a proxy
  5. Implement forwarding an HTTP request to the host after requesting it
  6. Return forwarded HTTP request to client after response is returned.