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

Release files for lupaxa-dns-blacklist-checker 0.1.2

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.2
File Size Uploaded
lupaxa_dns_blacklist_checker-0.1.2.tar.gz 10.3 kB Details

Built distribution (wheel)

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

Total release size: 22.4 kB

Release files / lupaxa_dns_blacklist_checker-0.1.2.tar.gz

Download URL lupaxa_dns_blacklist_checker-0.1.2.tar.gz
Size 10.3 kB
Tags Source
SHA-256 checksum
How to use checksums
9611655d4a6ef4e3584376f830e364f26dcea6e336204c57177040a5a1478abd
BLAKE2b-256 checksum
How to use checksums
d639b108b0b6a748aab8878f87f1cbe3cc865fbf1c59892e34968ab018aa95ed
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 25, 2026.

Transparency log

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

Download URL lupaxa_dns_blacklist_checker-0.1.2-py3-none-any.whl
Size 12.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
67b527887cae1e1b5c181922a09f8b7df0bbb818a525f8221bfed577c57dc74b
BLAKE2b-256 checksum
How to use checksums
945d5e18a0fc4873f202050f673cd3b5e8f26264b7b9ba27069188c864381b5a
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 25, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.2 This release

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