A fully configurable proxy in NodeJS, which can handle HTTPS requests perfectly.
Home page : AnyProxy.io
(Chinese in this doc is nothing but translation of some key points. Be relax if you dont understand.)
- work as http or https proxy
- when working as https proxy, AnyProxy could intercept https requests for any domain without complaint by browser (after you trust its root CA)
- a web interface for you to watch realtime request details, where html with (almost) any charset could be shown correctly
step 1 - install
- install NodeJS
npm install -g anyproxy, may require
- python is optional, it will be OK if you get some error about it during installing.
step 2 - start proxy server
- start with default settings :
- ...or start with a specific port:
anyproxy --port 8001
- ...start with a rule file:
anyproxy --rule ./rule_sample/rule_allow_CORS.js
step 3 - set up proxy settings in your browser , or system ,or mobile devices ,etc
- default proxy should be 127.0.0.1:8001 , or you_ip_address:8001 on remote devices
step 4 - launch web interface
- visit http://127.0.0.1:8002 ,you will see realtime requests in your browser
- be sure to use web interface with modern browsers
Rule module is the specialty for AnyProxy. Think it as a middleware, you could write your own code to hack requests at any stage, no matter it is about to response or the proxy just gets the request. In this way, AnyProxy would be flexible to meet your own demands.
It's highly recommended to read this guide before using: What is rule file and how to write one ?
After configuring rootCA, AnyProxy could help to decrypt https requests, whose approach is also called Man-In-The-Middle(MITM).
A guide about configuring https features is here : https://github.com/alibaba/anyproxy/wiki/How-to-config-https-proxy
to save request data
- to save request data to local file, use
anyproxy --file /path/to/file
- anyproxy uses nedb to save request data. Since NeDB's persistence uses an append-only format, you may get some redundant record in local file. For those dupplicated ones with the same id, just use the lastest line of record.
- TrafficeRecorder is another tool based on anyproxy to help recording all request data, including header and body. You may have a try.
- for instance,
anyproxy --throttle 10sets the speed limit to 10kb/s (kbyte/sec)
- this is just a rough throttling for downstream, not for network simulation
work as a module for nodejs
- use it as a module and develop your own proxy.
npm install anyproxy --save
var proxy = ;//create cert when you want to use https features//please manually trust this rootCA when it is the first time you run it!proxy && proxy;var options =type : "http"port : 8001hostname : "localhost"rule :dbFile : null // optional, save request data to a specified file, will use in-memory db if not specifiedwebPort : 8002 // optional, port for web interfacesocketPort : 8003 // optional, internal port for web socket, replace this when it is conflict with your own servicethrottle : 10 // optional, speed limit in kb/sdisableWebInterface : false //optional, set it when you don't want to use the web interfacesetAsGlobalProxy : false //set anyproxy as your system proxysilent : false //optional, do not print anything into terminal. do not set it when you are still debugging.;options;
- Please feel free to raise issue, or give us some advice. :)
- Apache License, Version 2.0