Skip to main content

SRE Toolbox

DNS Blacklist Checker

Check whether an IP address or hostname is listed on DNS blacklists.

Install

pip install lupaxa-dns-blacklist-checker
dns-blacklist-checker --help

CLI

dns-blacklist-checker 192.0.2.1 example.com
dns-blacklist-checker 203.0.113.1 --zone zen.spamhaus.org --timeout 5
python -m lupaxa.dns_blacklist_checker --version

dnsbl is an alias for dns-blacklist-checker. Both commands accept the same flags and print the same output. python -m lupaxa.dns_blacklist_checker runs that same program.

The tool resolves each hostname to every IPv4 and IPv6 address, reverses the address, and queries the built-in DNSBL zones. A loopback answer means the address is listed. Spamhaus and Abusix policy codes are reported as notes.

Library

from lupaxa.dns_blacklist_checker import check

result = check("203.0.113.9", zones=("zen.spamhaus.org",))
print(result.listed, [item.address for item in result.addresses])

Development

make init
make python-install-dev
make python-check
make mkdocs-serve

Documentation

The published guide is at https://dns-blacklist-checker.thelupaxaproject.org/.

Site Markdown lives in mkdocs/.

The Lupaxa Project Footer

Metadata

Release files for lupaxa-dns-blacklist-checker 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lupaxa-dns-blacklist-checker 0.1.3
File Size Uploaded
lupaxa_dns_blacklist_checker-0.1.3.tar.gz 10.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for lupaxa-dns-blacklist-checker 0.1.3
File Interpreter ABI Platform
lupaxa_dns_blacklist_checker-0.1.3-py3-none-any.whl Python 3 none any Details

Total release size: 22.4 kB

Release files / lupaxa_dns_blacklist_checker-0.1.3.tar.gz

Download URL lupaxa_dns_blacklist_checker-0.1.3.tar.gz
Size 10.3 kB
Tags Source
SHA-256 checksum
How to use checksums
0c92918d21a7fb2da70ee87a2207441d23f6e19a3cf1f87bad83355d5227c0ef
BLAKE2b-256 checksum
How to use checksums
0d9014113554627576f494d59143b7bbc1667b815eff3334c1f219b167fa27b2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.

Transparency log

Release files / lupaxa_dns_blacklist_checker-0.1.3-py3-none-any.whl

Download URL lupaxa_dns_blacklist_checker-0.1.3-py3-none-any.whl
Size 12.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e61eeb83676f97cd2a1c4feadd617f41ebb3e1ec9b0b1b931bb421f5ae2f4405
BLAKE2b-256 checksum
How to use checksums
43092542b6ed0036e12886a584d515e91243a8889833c59f0a6a26b90a86def9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.

Transparency log

Release history Release notifications | RSS feed

0.1.5

2 release files

0.1.4

2 release files

This release

0.1.3 This release

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page