Repolode
Submit
xykt

xykt/IPQuality

A Bash script that checks an IP address's quality, covering risk scores, IP type, streaming and AI service unlocks, and mail server connectivity.

View on GitHub
Stars
10,778
Forks
743
Open issues
0
Last commit
20 days ago

What is it?

IPQuality is a shell script that runs a multi-part health check on the IP address of the machine it runs on. The report covers basic geolocation data from a MaxMind database, IP type classification, a risk score drawn from several fraud and abuse databases, risk factors, streaming and AI service unlock tests, and connectivity checks for common email providers.

The script supports both IPv4 and IPv6 dual-stack queries and can check a specific network interface or route through a proxy. Output can be an interactive terminal view, JSON, or plain text and ANSI files written to disk. It also includes a privacy mode that disables online report generation.

It runs on a wide range of Linux distributions, macOS, and Windows through Docker, and offers Chinese and English interfaces with several other language options for basic information.

Key features

  • 01Checks IPv4 and IPv6 addresses with dual-stack support
  • 02Aggregates risk scores from multiple IP reputation databases
  • 03Tests unlock status for streaming and AI services such as Netflix, YouTube and ChatGPT
  • 04Checks connectivity to major email providers including Gmail and Outlook
  • 05Exports results as JSON, ANSI or plain text files

Use cases

  • Checking whether a VPS or proxy IP is flagged as risky before deploying it
  • Verifying which streaming and AI services are accessible from a given server
  • Testing whether outbound mail from a host can reach major email providers
  • Automating IP audits by exporting JSON results to other tools

Quick start

  1. 1

    Run the script in a Docker container on Linux

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

    Or run the interactive menu with the official one-line bash command from the README

Things to know

  • Windows is supported only through Docker.
  • Licensed under AGPL-3.0, a copyleft license that requires sharing modified versions under the same terms.
  • Results depend on many third-party risk databases and streaming services that the script queries over the network.

Topics

#ip-address#network#risk-score#proxy#streaming#bash#ipv6#diagnostics

FAQ

What is IPQuality?
A Bash script that checks an IP address's quality, covering risk scores, IP type, streaming and AI service unlocks, and mail server connectivity. IPQuality is a shell script that runs a multi-part health check on the IP address of the machine it runs on. The report covers basic geolocation data from a MaxMind database, IP type classification, a risk score drawn from several fraud and abuse databases, risk factors, streaming and AI service unlock tests, and connectivity checks for common email providers.
Is IPQuality free to use? What license does it have?
IPQuality is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is IPQuality still maintained?
Actively maintained. The last commit to IPQuality was on Sep 30, 2026.
What can I use IPQuality for?
Checking whether a VPS or proxy IP is flagged as risky before deploying it Verifying which streaming and AI services are accessible from a given server Testing whether outbound mail from a host can reach major email providers Automating IP audits by exporting JSON results to other tools
How do I install IPQuality?
Run the script in a Docker container on Linux: docker run --rm --net=host -it xykt/ipquality && docker rmi xykt/ipquality > /dev/null 2>&1 Or run the interactive menu with the official one-line bash command from the README
Where can I get IPQuality?
The source code and installation instructions are on GitHub: https://github.com/xykt/IPQuality

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects