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. Please report issues or bugs to your Luminati account manager or from our help center
Read this in ä¸ć–‡.
- 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 analyzing (using a self-signed certificate)
- SOCKSv5 proxy
- 2GB RAM
- 1 CPU
- 3GB SSD
- Ubuntu 16 LTS
Download the Luminati Proxy Manager installer
- Run the setup script to install
wget -qO- https://luminati.io/static/lpm/luminati-proxy-latest-setup.sh | bashOr
curl -L https://luminati.io/static/lpm/luminati-proxy-latest-setup.sh | bash- Install Node.js 10 (nodejs.org) Node.js version for the proxy manager should be any at least 10.15.3
- Make sure npm version is 6.4.1 or higher
- if not, run:
sudo npm install -g [email protected]
- if not, run:
- Install Luminati Proxy from the terminal prompt:
sudo npm install -g @luminati-io/luminati-proxyIf you are trying to install the Proxy Manager from china on Mac/Linux please run the following command first to make sure npm is installing with allowed registry:
npm config set registry https://r.cnpmjs.org/After this command ran successfully install using:
sudo npm install -g @luminati-io/luminati-proxy --allow-root- Use npm to upgrade
sudo npm install -g @luminati-io/luminati-proxyOr use the cli command:
luminati --upgrade-
To install a specific proxy manager version, choose a version from releases
-
Run (VERSION_NUMBER is the version you've chosen (example: 1.75.355)):
sudo npm install -g @luminati-io/luminati-proxy@VERSION_NUMBERYou 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.
To run the proxy manager in the background:
luminati --daemonLuminati Proxy comes with a "dropin mode" which behaves exactly like the existing super-proxies. When running a proxy in dropin mode, you do not need to log in via the administrative UI in order to make requests through your proxies. Rather, the proxy username and password are provided with each request to the proxy server. This mode is enabled by default, and you can use this mode as an easy replacement when migrating from the regular super-proxy to the Luminati Proxy Manager.
Dropin mode is enabled by default. To disable the dropin proxy, use the flag
--no-dropin:
luminati --no-dropinFor full documentation on the API for making requests through the dropin proxy, see the API Example page in your Luminati.io account.
All command line options below are also available also as ENV variables. Example:
cli: --port 22900 , env: LPM_PORT=22900
cli: --ssl true , env: LPM_SSL=true
cli: --log "error" , env: LPM_LOG=errorluminati --help
Usage:
luminati [options] config1 config2 ...
Options:
--help, -h, -? Show help [boolean]
--version, -v Show version number [boolean]
--port, -p Port for the HTTP proxy [number]
--proxy_type Decide if to save proxy into the configuration
file. Specifying "persist" in "proxy_type" value
will create port and save it in the
configuration file. [string]
--multiply Multiply the port definition given number of
times [number] [default: 0]
--multiply_users [boolean] [default: false]
--users List of users. This option has to be used along
with "multiply_users" [array]
--ssl Enable SSL analyzing [boolean] [default: false]
--iface Interface or IP to listen on [string]
--customer Luminati customer [string]
--zone Zone [string] [default: "static"]
--password Zone password [string]
--proxy Hostname or IP of super proxy
[string] [default: "zproxy.lum-superproxy.io"]
--proxy_port Super proxy port [number] [default: 22225]
--proxy_connection_type Determines what kind of connection will be used
between LPM and Super Proxy
[string] [default: "http"]
--proxy_retry Automatically retry on super proxy failure
[number] [default: 2]
--insecure Enable SSL connection/analyzing to insecure
hosts [boolean] [default: false]
--country Country [string]
--state State [string]
--city City [string]
--asn ASN [string]
--ip Data center IP [string]
--vip gIP [number]
--ext_proxies A list of proxies from external vendors. Format:
[username:password@]ip[:port] [array]
--ext_proxy_username default username for external vendor ips[string]
--ext_proxy_password default password for external vendor ips[string]
--ext_proxy_port default port for external vendor ips [number]
--dns DNS resolving [string]
--reverse_lookup_dns Process reverse lookup via DNS
[boolean] [default: false]
--reverse_lookup_file Process reverse lookup via file [string]
--reverse_lookup_values Process reverse lookup via value [array]
--session Luminati session for all proxy requests
[string] [default: true]
--sticky_ip Use session per requesting host to maintain IP
per host [boolean] [default: false]
--pool_size Session pool size [number]
--rotate_session Rotate sessions on each request
[boolean] [default: false]
--throttle Throttle requests above given number [number]
--rules Proxy request rules [array]
--race_reqs Race several requests at once and choose fastest
[number]
--route_err Block or allow requests to be automatically sent
through super proxy on error
[string] [default: "pass_dyn"]
--smtp [array]
--override_headers [boolean] [default: true]
--os Operating System of the Peer IP [string]
--headers Request headers [array]
--debug Luminati request debug info
[string] [default: "full"]
--whitelist_ips Default for all proxies whitelist ip list for
granting access to them [array] [default: []]
--www_whitelist_ips Whitelist ip list for granting access to browser
admin UI [array] [default: []]
--www HTTP and WebSocket port used for browser admin
UI and request logs [default: 22999]
--config Config file containing proxy definitions[string]
--cookie Cookie Jar file [string]
--mode Defines a set of permissible operations within
the UI/API [string]
--dropin Create dropin mode proxy port (default: 22225)
[boolean] [default: true]
--dropin_port Port for dropin mode [default: 22225]
--no_usage_stats Disable collection of usage statistics
[boolean] [default: false]
--lpm_token An authorization token [string]
--high_perf [boolean] [default: false]
--cloud [boolean] [default: true]
--zagent [boolean] [default: false]
--cluster [boolean] [default: true]
--request_stats Enable requests statistics
[boolean] [default: true]
--test_url Url for testing proxy
[string] [default: "http://lumtest.com/myip.json"]
--log Log level [string] [default: "notice"]
--logs Enable logs for all proxies
[boolean] [default: 1000]
--har_limit Number of bytes to store[number] [default: 1024]
--force Kill other instances of LPM if there are any
[boolean] [default: false]
--session_termination Stop sending new requests when the peer IP
becomes unavailable and redirect to confimration
page before new IP is taken
[boolean] [default: false]
--api Alternative url to luminati API [string]
--api_domain Alternative domain url to luminati API
[string] [default: "lum-lpm.com"]
--local_login Requires each browser to authenticate against
LPM [boolean] [default: false]
--read_only Avoid saving current config in the config file
[boolean] [default: false]
--no-www Disable local web
--no-config Working without a config file
--no-cookie Working without a cookie file
--daemon, -d, --start-daemon Start as a daemon
--restart-daemon Restart running daemon
--stop-daemon Stop running daemon
--delete-daemon Delete daemon instance
--upgrade Upgrade proxy manager
--downgrade Downgrade proxy manager (if backup exists on
disk)
--dir Path to the directory with database and
configuration files
--status Show proxy manager processes current status
--gen-cert Generate cert
--auto-upgrade Enable auto upgrade
--start-upgrader Install CRON process that checks upgrades
--stop-upgrader Removes CRON process that checks upgrades
--socket_inactivity_timeout [default: 120000]
--preset [default: "session_long"]
--multiply_ips [default: false]
--max_ban_retries [default: 10]
--multiply_vips [default: false]
--bw_limit [default: 0]
--api_domain_fallback [default: "l-lpm.com"]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 luminati
docker run luminati/luminati-proxy luminati --versionMake sure to forward appropriate ports. Proxy manager uses by default 22999 for the web console and the api, 22555 for dropin and 24000 for first configurable proxy.
- To run docker with cli option see the below example:
docker run luminati/luminati-proxy luminati --www_whitelist_ips "172.17.0.1" --ssl trueYou can add many more options to this run.
To use lpm's config file, docker volumes can be used: https://docs.docker.com/storage/volumes/
Following these instructions will make your docker run with a specific config file:
- create volume
docker volume create lpm-vol- Inspect the recently created volume
docker inspect lpm-volShould output something like this:
[
{
"CreatedAt": "2018-02-01T12:59:58+02:00",
"Driver": "local",
"Labels": null,
"Mountpoint": "/var/lib/docker/volumes/lpm-vol/_data",
"Name": "lpm-vol",
"Options": {},
"Scope": "local"
}
]- Take the mountpoint path /var/lib/docker/volumes/lpm-vol/_data and run
cd /var/lib/docker/volumes/lpm-vol/_data- put .luminati.json to this directory (here also will be the logs and other files generated by the container)
- run docker image and attach this volume:
docker run --rm --name 'lpm1' --mount source=lpm-vol,target=/root
"luminati/luminati-proxy" luminatiThe --ssl parameter is for SSL analyzing, 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 [email protected].
Working documentation of the API can be found inside the app.
A non-working version of it can be found here