Skip to content

Releases

netdoctor-ir v0.1.0

Choose a tag to compare

@mrzroot mrzroot released this 08 Oct 10:12

First public release of netdoctor-ir, a connectivity doctor and mirror switcher for developers in Iran.

netdoctor is a diagnostic tool. It tells you what is blocked, sanctioned or slow and points you to legitimate, publicly documented mirrors and resolvers. It does not bypass anything, and it never changes system DNS. The dns --apply option only prints commands.

Highlights

  • netdoctor scan runs concurrent DNS → TCP → TLS → HTTP probes of 38 developer services (GitHub, PyPI, npm, Docker Hub, Go proxy, Maven, cloud/AI APIs and more). It assigns a verdict to each service (ok, slow, sanctioned, filtered, forbidden, dns/tcp/tls/http-error, timeout) and ends with a summary and advice.
  • Detection covers:
    • DNS hijacks to 10.10.34.x
    • SNI-filtering fingerprints
    • block-page redirects
    • sanction pages: Docker export control, Google 403, OpenAI unsupported country, Cloudflare 1009, CloudFront geo-block, GitLab embargo
    • Cloudflare challenges and fake-IP proxies
  • netdoctor dns benchmarks 13 public and Iranian anti-sanction resolvers and ranks them. --deep checks which resolvers actually unlock sanctioned services. Per-OS instructions are printed only, never applied.
  • netdoctor mirrors runs content-verified checks of 37 PyPI / npm / Docker / Go / Maven mirrors, each with a trust level (official, documented, community-reported). --write updates pip.conf, .npmrc, Docker daemon.json and GOPROXY, showing diffs and taking automatic backups. netdoctor restore undoes the changes.
  • netdoctor report --json/--md produces a shareable report that contains no IP address.
  • netdoctor tui is an optional Textual dashboard (pip install "netdoctor-ir[tui]").
  • Data catalogs live in plain YAML (netdoctor/data/) and are easy to contribute to.

Install

Not published on PyPI. Install from this release:

pipx install https://github.com/mrzroot/netdoctor-ir/releases/download/v0.1.0/netdoctor_ir-0.1.0-py3-none-any.whl
# or from source
pipx install git+https://github.com/mrzroot/netdoctor-ir@v0.1.0

Quality

  • 169 tests, all using a mocked network, with about 98% line and branch coverage.
  • ruff and mypy (strict) pass.
  • All of the above was verified locally from a clean checkout on Python 3.10, 3.11, 3.12 and 3.13.

Known limitations

  • The sample output and screenshots were captured outside Iran, on a US host behind a fake-IP proxy, so they do not show real Iranian filtering.
  • Entries marked community-reported have not been independently verified. Please report a broken entry with the Catalog entry issue template.

Checksums (SHA-256)

c997cc53b980bad64bd4ac3482e75f6389ed5bed1752f624b440ee7f4c1a71ab  netdoctor_ir-0.1.0-py3-none-any.whl
8f3daf8acb7d92a6f26f9fe4fb9aa2c009e273c55bf50c21cae96bd444b374f4  netdoctor_ir-0.1.0.tar.gz

Full changelog: CHANGELOG.md