Repository navigation
Releases
Releases · mrzroot/netdoctor-ir
netdoctor-ir v0.1.0
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 --applyoption only prints commands.
Highlights
netdoctor scanruns 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
- DNS hijacks to
netdoctor dnsbenchmarks 13 public and Iranian anti-sanction resolvers and ranks them.--deepchecks which resolvers actually unlock sanctioned services. Per-OS instructions are printed only, never applied.netdoctor mirrorsruns content-verified checks of 37 PyPI / npm / Docker / Go / Maven mirrors, each with a trust level (official,documented,community-reported).--writeupdates pip.conf, .npmrc, Dockerdaemon.jsonandGOPROXY, showing diffs and taking automatic backups.netdoctor restoreundoes the changes.netdoctor report --json/--mdproduces a shareable report that contains no IP address.netdoctor tuiis 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.0Quality
- 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-reportedhave 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