IPQuality/README_EN.md at main · xykt/IPQuality

IP Quality Check Script - IP质量体检脚本 (中文)

Bilingual support in English and Chinese
Supports dual-stack queries for IPv4/IPv6
Beautifully formatted, intuitive display, optimized for single-screen multi-terminal display, facilitating screenshot sharing
Six modules: Basic Information, IP Type, Risk Score, Risk Factors, Streaming Media Unlocking, and Post Office Check
Basic data sourced from the Maxmind database
Risk information integrated from multiple databases: IPinfo / ipregistry / ipapi / AbuseIPDB / IP2Location / IPQS / DB-IP / Scamalytics
Streaming and AI service providers' unlocking and type detection: TikTok / Disney+ / Netflix / Youtube / AmazonPrimeVideo / Reddit / ChatGPT
Connectivity tests for multiple email providers: Gmail / Outlook / Yahoo / Apple / QQ / Mail.ru / AOL / GMX / Mail.com / 163 / Sohu / Sina
Over 400 IP address blacklist database checks

Screenshots

Usage

Easy Mode: Run with Interactive Interface

Bash:

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

Docker:

Linux

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

Windows (CMD)

docker run --rm --net=host -it xykt/check -EI & docker rmi xykt/check > NUL 2>&1

Advanced Mode: Run with Parameters

English version of dual-stack test (Either):

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

IPv4 only test:

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

IPv6 only test:

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

Specify network interface:

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

Specify proxy server:

bash <(curl -Ls https://IP.Check.Place) -E -x http://username:password@proxyserver:port
bash <(curl -Ls https://IP.Check.Place) -E -x https://username:password@proxyserver:port
bash <(curl -Ls https://IP.Check.Place) -E -x socks5://username:password@socksproxy:port

Skip checking OS and dependencies:

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

Auto-install dependencies:

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

Show full IP on report:

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

JSON output (Example Output)：

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

Output report to file in ANSI/JSON/Text format:

bash <(curl -Ls https://IP.Check.Place) -o /path/to/file.ansi
bash <(curl -Ls https://IP.Check.Place) -o /path/to/file.json
bash <(curl -Ls https://IP.Check.Place) -o /path/to/file.txtoranyother

Basic information multi-language support:

bash <(curl -Ls https://IP.Check.Place) -l jp|es|de|fr|ru|pt

Privacy mode - Disable online report link:

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

Docker (supports runtime arguments; insert them before the `&`):

Linux

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

Windows (CMD)

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

Script Updates

2026/01/24 12:40 Replace Spotify detection with Reddit detection

2026/01/15 17:23 Fix non-standard JSON

2025/08/03 00:00 Add Docker support

2025/08/01 16:15 Add -p for privacy mode, which disables online report links

2025/07/30 16:30 Replace all HTTP requests with HTTPS to improve script security

2025/06/02 21:25 Fix the error logic in port 25 detection and standardize the connectivity testing method for email service providers

2025/04/23 18:00 Add -o to output report to file in ANSI/JSON/Text format

2025/04/19 21:00 Add -j for JSON mode

2025/03/13 23:15 Add -y -n for dependencies auto-install/skip

2024/11/09 00:30 Add Cloudflare threat score, fix IP2Location IP type bug

2024/10/06 01:15 Fixed bug causing script errors in very rare cases

2024/07/23 23:50 Add parameter -f to show full IP address on report

2024/07/22 01:50 Add prompt before installing dependent packages, fix Disney+ bug

2024/06/27 01:00 Add Anolis OS | Alibaba Cloud Linux | SUSE Linux | openSUSE support

2024/05/30 01:15 Add macOS support

2024/05/28 18:00 Fixed bug where default IP was detected for specified network interface/proxy server

2024/05/17 00:45 Add report svg image sharing link and fix some layout problems

2024/05/11 23:20 Fixed mail detection taking too long due to gateway blocking port 25, fix inaccurate Tiktok IPv6 results

2024/05/10 17:50 Fix dependency installation issue with no sudo installed

2024/05/10 11:00 Added support for specified network interface and proxy server

2024/05/09 15:00 Corrected errors caused by non-standard private IP addresses, and fixed several other bugs

2024/05/08 23:00 Fixed a bug affecting incorrect detection results for Netflix Australia

2024/05/08 18:10 Updated the dependency checks and installation for the 'dig' program

2024/05/08 00:00 Script published

Script Contributions

Acknowledgments:

Sponsor	Logo	Link
IP2Location		https://ip2location.io https://ip2location.com
Scamalytics		https://scamalytics.com

Sincerely appreciate the IP threat intelligence data provided by leading providers (No ranking implied, listed in alphabetical order): AbuseIPDB/Cloudflare/DB-IP/IP2Location/ipapi/IPinfo/IPQS/ipregistry/Scamalytics
Thanks to lmc999 for parts of this script reference the RegionRestrictionCheck script.
Thanks to spiritLHLS for parts of this script reference the VPS Fusion Monster Server Test Script.

Server Sponsors (No ranking implied):

Sponsor	Logo	Link
V.PS		https://v.ps
BAGE		https://bagevm.com
LisaHost 丽萨主机		https://lisahost.com
VIRCS 威尔克斯		https://vircs.com
RapidProxy `ISP IP`		https://rapidproxy.io
HNCloud 华纳云		https://hncloud.com
VMRack		https://vmrack.net
YINNET 蔭雲		https://yin-net.com
Swiftproxy `ISP IP`		https://swiftproxy.net