A forward HTTP/HTTPS proxy on your side, to accelerate/compress/rotate/distribute/manage/monitor/report/log/debug traffic to your proxies around the world.
With Luminati HTTP/HTTPS Proxy manager you can drive the Luminati residential IPs or Luminati static IPs.
This tool requires a Luminati account.
- Highly scalable
- Connection pool for faster response time
- Easy setup for multiple configurations using a simple web interface
- Statistics
- Automatically rotate IP every X requests
- Load balancing using multiple Super Proxies
- SSL sniffing (using a self-signed certificate)
- SOCKSv5 proxy
###Requirements Software requirements for Luminati proxy manager are:
- Git from version 1.7+
- Node.js from version 6+
npm install -g luminati-io/luminati-proxy- Install Node.js 6 or above (preferably using nave)
- Install Luminati Proxy from the terminal prompt:
sudo npm install -g luminati-io/luminati-proxy- Use npm to upgrade
sudo npm install -g luminati-io/luminati-proxyYou can review the CHANGELOG.md for list of changes in every version
After running the app for the first time:
luminatiPoint your browser to the app admin UI http://127.0.0.1:22999 to set up credentials and configure your proxies.
luminati --help
Usage: luminati [options] config1 config2 ...
Options:
--port, -p Port for the HTTP proxy [number] [default: 24000]
--multiply Multiply the port definition given number of times
[number]
--history Log request history [boolean] [default: false]
--ssl Enable SSL sniffing [boolean] [default: false]
--socks SOCKS5 port [number]
--log Log level [string] [default: "error"]
--iface Interface or IP to listen on
[string] [default: "0.0.0.0"]
--customer Luminati customer [string]
--zone Zone [string] [default: "gen"]
--password Zone password [string]
--proxy Hostname or IP of super proxy
[string] [default: "zproxy.luminati.io"]
--proxy_port Super proxy port [number] [default: 22225]
--proxy_count Minimum number of super proxies to use
[number] [default: 1]
--secure_proxy Use SSL when accessing super proxy
[boolean] [default: false]
--short_username Use Shorthand username for super proxy credentials
[boolean] [default: false]
--proxy_switch Automatically switch super proxy on failure
[number] [default: 5]
--insecure Enable SSL connection/sniffing to insecure hosts
[boolean] [default: false]
--country Country [string]
--state State [string]
--city City [string]
--asn ASN [number]
--ip Datacenter IP [string]
--dns DNS resolving [string]
--debug Luminati request debug info [string]
--request_timeout Timeout for request on the super proxy (seconds)
[number]
--allow_proxy_auth Allow Luminati authentication per request
[boolean] [default: false]
--session Luminati session for all proxy requests [string]
--sticky_ip Use session per requesting host to maintain IP per
host [boolean] [default: false]
--pool_size Session pool size [number] [default: 3]
--pool_type Pool session iteration order
[string] [default: "sequential"]
--session_init_timeout Session establish timeout (seconds)
[number] [default: 5]
--keep_alive Generate request to keep session alive after given
idle time (seconds) [number]
--seed Session ID seed used for identifing sessions from this
proxy [string]
--max_requests Maximum requests per session [string] [default: 50]
--session_duration Maximum duration of session (seconds) [string]
--throttle Throttle requests above given number [number]
--null_response URL pattern for null response [string]
--bypass_proxy URL pattern for bypassing the proxy and connect
directly [string]
--direct_include Include URL pattern for direct requests [string]
--exclude_include Exclude URL pattern for direct requests [string]
--www UI/API port [default: 22999]
--config Config file containing proxy definitions
[string] [default: "/home/lee/.luminati.json"]
--database Database file containing history and cached values
[string] [default: "/home/lee/.luminati.sqlite3"]
--resolve Reverse DNS lookup file [string]
--mode Defines a set of permissible operations within the
UI/API [string] [default: "root"]
--dropin Create dropin mode proxy on port 22225
[boolean] [default: false]
--no-www Disable local web
--no-config Working without a config file
--daemon, -d Start as a daemon
--stop-daemon Stop running daemon
--version, -v Show version number [boolean]
--help, -h, -? Show help [boolean]A docker image can be found on https://hub.docker.com/r/luminati/luminati-proxy/
docker pull luminati/luminati-proxy
docker run luminati/luminati-proxy
docker run luminati/luminati-proxy luminati --versionThe --ssl parameter is for SSL sniffing, HTTPS requests can be made without it.
The FAQ can be found on the luminati FAQ
If you do not find the answer there, feel free to open an issue on github.
Or contact support@luminati.io.
Working documentation of the API can be found inside the app.
A non-working version of it can be found here
The proxy manager can be used as a required module for node.js applications - eliminating the need to run it as a standalone process.
The API supports both Promises and Generators. Internally, it uses the request module and supports all of its features.
'use strict';
const Luminati = require('luminati-proxy').Luminati;
const proxy = new Luminati({
customer: 'CUSTOMER', // your customer name
password: 'PASSWORD', // your password
zone: 'gen', // zone to use
proxy_count: 5, //minimum number of proxies to use for distributing requests
});
proxy.on('response', res=>console.log('Response:', res));
proxy.listen(0, '127.0.0.1').then(()=>new Promise((resolve, reject)=>{
proxy.request('http://lumtest.com/myip', (err, res)=>{
if (err)
return reject(err);
resolve(res);
});
})).then(res=>{
console.log('Result:', res.statusCode, res.body);
}, err=>{
console.log('Error:', err);
}).then(()=>proxy.stop());'use strict';
const etask = require('hutil').etask;
const Luminati = require('luminati-proxy').Luminati;
etask(function*(){
const proxy = new Luminati({
customer: 'CUSTOMER', // your customer name
password: 'PASSWORD', // your password
zone: 'gen', // zone to use
proxy_count: 5, //minimum number of proxies to use for distributing requests
});
yield proxy.listen(0, '127.0.0.1'); // port and ip to listen to
let res = yield etask.nfn_apply(proxy, '.request',
['http://lumtest.com/myip']);
console.log('Result:', res.statusCode, res.body);
yield proxy.stop();
});