IPQuality guide: check your VPS IP quality with one command

IPQuality is an open-source IP quality check script by xykt. You run it on your own server and it inspects that machine's exit IP from every angle. This page covers usage and how to read the report; the original project is the authority on the script itself.

Run it (adding -p for privacy mode is recommended)

Privacy mode: no report upload, no online report link

bash <(curl -Ls https://IP.Check.Place) -p

Default (IPv4 + IPv6)

bash <(curl -Ls https://IP.Check.Place)

IPv4 only

bash <(curl -Ls https://IP.Check.Place) -4

English report

bash <(curl -Ls https://IP.Check.Place) -l en

JSON output (for scripts)

bash <(curl -Ls https://IP.Check.Place) -j

Run with Docker (no dependencies installed on the host)

docker run --rm --net=host -it xykt/ipquality && docker rmi xykt/ipquality > /dev/null 2>&1

Note: `bash <(curl …)` runs a remote script directly - if that bothers you, download ip.sh and read it first. The script may install dependencies such as curl and jq (use -n to skip). By default it uploads the report to the author's server to create a share link; -p turns that off.

The six report modules

1. Basics

ASN, ISP, location and time zone from MaxMind. A mismatch between the registered and the used country often means an announced ("broadcast") IP.

2. IP type

Whether databases classify the IP as residential, datacenter (IDC/hosting), business or mobile. AI services and streaming sites are stricter with datacenter IPs.

3. Risk scores

Scores from IPinfo, ipregistry, ipapi, AbuseIPDB, IP2Location, IPQS, DB-IP, Scamalytics and more - lower is better. Each database measures differently, so look at the overall picture.

4. Risk factors

Whether the IP is flagged as proxy, VPN, Tor, server, abuse or bot, plus each database's country verdict. Fewer flags means cleaner.

5. Streaming & AI unlocks

Checks whether TikTok, Disney+, Netflix, YouTube, Prime Video, Reddit and ChatGPT are reachable, native vs. DNS unlock, and the unlocked region.

6. Mail checks

Whether port 25 of Gmail, Outlook, Yahoo, QQ, 163 and other mail providers is reachable, and whether the IP is on hundreds of mail blacklists (DNSBL).

Common flags

-4 / -6: Test IPv4 / IPv6 only
-p: Privacy mode, no online report link
-l en (or -E): English report; -l also supports jp/es/de/fr/ru/pt
-j: JSON output
-f: Show the full IP in the report (masked by default)
-i eth0: Use a specific network interface
-x proxy-url: Test through an http/https/socks5 proxy (checks the proxy exit)
-n / -y: Skip OS and dependency checks / install dependencies automatically

Credit and license

IPQuality is developed by xykt and released under AGPL-3.0. This site only shows the original project's commands and usage notes; it does not host or modify the script. Our online IP check is an independent implementation and uses none of its code.

GitHub: xykt/IPQuality

No server handy? Check your current IP online first