# MayersScott/rkn-block-checker

Diagnose RKN/TSPU internet blocks layer by layer (DNS, TCP, TLS, HTTP)

Repository: https://github.com/MayersScott/rkn-block-checker
Canonical: https://ross.abutalabs.com/products/rkn-block-checker
Language: Python
License: MIT
License Family: permissive
Topics: censorship, cli, dns, dpi, network-diagnostics, networking, python, rkn, tls, tspu
Last push: 2026-06-12T09:19:10+00:00

## Health v2 (maintenance only)
Score: 72/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 87, release rhythm 88, longevity 8
- inputs: {"age_days": 122, "days_push": 82, "days_rel": 82, "gap_med": 0, "n_releases_24m": 10}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1598, forks 61 (observed 2026-08-28T04:05:09.372750+00:00)

## What it is
A Python CLI tool that diagnoses whether your connection is in an RKN/TSPU-blocked zone and classifies the type of block (DNS poisoning, TCP reset, TLS SNI-based DPI, or ISP stub page) by probing each network layer independently. It probes built-in whitelist and blacklist site lists and prints a per-layer verdict with a summary.

## Use cases
- check if my ISP is blocking websites via DPI
- diagnose why a site won't open in Russia
- detect DNS poisoning versus TCP reset versus TLS SNI filtering
- find out if I'm behind an RKN/TSPU censorship zone
- identify ISP stub pages that fake a successful HTTP response
- troubleshoot network blocks layer by layer
- verify which sites are blocked on my current connection

## When to choose
- you need to know *how* a connection is being blocked, not just that it is
- you want a zero-config CLI that classifies censorship mechanisms automatically
- you're in or traveling to Russia and want to assess your network's filtering situation

## When to avoid
- you need a general-purpose network scanner or monitoring tool
- you want to bypass blocks rather than diagnose them
- you need censorship measurement outside the RKN/TSPU context
- you require a GUI or continuous background monitoring

## Facets
- artifact type: cli-tool
- maturity: active
- function: networking, developer-tools, cli, security
- domain: censorship-circumvention, networking, security, developer-tools
- platform: cli, python, cross-platform
- tags: censorship, dpi, rkn, tspu, network-diagnostics, dns, tls, network-probing, command-line

## Member repositories
- MayersScott/rkn-block-checker (main) score 72

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:09.372750+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:53:15.428580+00:00, confidence not recorded.
  - readme: https://github.com/MayersScott/rkn-block-checker (fetched 2026-08-28T04:05:09.372750+00:00, sha 2eba5311a1c1)
  - registry_pypi: https://pypi.org/pypi/rkn-block-checker/json (fetched 2026-08-29T11:24:32.663780+00:00, sha c3a36d68d3fd)
- Data as of 2026-08-30T08:39:29.467469+00:00.