proxy-ip-check

proxy-ip-check: see what a website sees through your proxy

To check a proxy IP, send one request through it to an IP lookup service and read four fields: the exit IP, the country and city, the network owner (org, which includes the ASN), and the timezone. If the org is a hosting company, the IP is a datacenter IP whatever the seller calls it; if the city or timezone is not where you expected, fix that before you log in to any account. check-proxy.sh in this repo does all of that in one command and also tells you whether the exit IP stays the same between two requests.

Maintained by Proxy302, a proxy provider; we sell static residential (ISP) IPs from $0.50 per day or $7.99 per 30 days, and rotating residential traffic from $1.50/GB (prices). The script works with any provider’s proxy.

Usage

git clone https://github.com/proxy302/proxy-ip-check
cd proxy-ip-check
./check-proxy.sh 'http://USER:PASS@HOST:PORT'
./check-proxy.sh 'socks5h://USER:PASS@HOST:PORT'

Needs only bash and curl. Put the proxy URL in single quotes so the shell leaves characters such as ! or $ in the password alone; if the password contains @ or :, URL-encode them (%40, %3A).

Example output (addresses masked):

== Your own connection (no proxy)
  "ip": "x.x.x.x",
  "city": "Singapore",
  "country": "SG",
  "org": "AS4817 Simba Telecom Pte Ltd",
  "timezone": "Asia/Singapore",

== Through the proxy
  "ip": "x.x.x.x",
  "city": "Changsha",
  "country": "CN",
  "org": "AS4134 CHINANET BACKBONE",
  "timezone": "Asia/Shanghai",

== Same exit IP on a second request?
yes (x.x.x.x): the exit stays the same

How to read the result

Field What to look for
ip Must differ from your own connection. If it is the same, the proxy is not being used.
country, city Should match what you bought. Lookup databases disagree by a city now and then; a different country is a real problem.
org A consumer ISP or mobile carrier means residential or ISP IP space. Names of cloud and hosting companies mean datacenter space.
timezone Your browser or device timezone should match it, or sites see a person in one place using a clock from another.
second request A static IP should keep the same exit. A rotating proxy changes it when a new connection is opened, unless you use a sticky session.

When the script says the request failed

Limits

FAQ

Does this send my proxy password anywhere? Only to the proxy itself, as curl normally does. The lookup service sees the exit IP, nothing else.

Can I use it in a loop to test a list of proxies? Yes: while read p; do ./check-proxy.sh "$p"; done < proxies.txt. Keep the list file out of git.

More guides: proxy302.github.io/proxy-guides.

Facts checked 18 November 2026.