Skip to content

ImSavsis/pydoh

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pydoh

CI Coverage pypi downloads versions license

DNS-over-HTTPS резолвер для питона. ноль зависимостей — весь HTTPS через стандартный http.client+ssl. провайдер/DPI видит только твой HTTPS к cloudflare, а не голые DNS-запросы.

sequenceDiagram
    App->>pydoh: resolve("example.com")
    pydoh->>Cloudflare: DNS-запрос внутри HTTPS POST
    Cloudflare-->>pydoh: ответ внутри HTTPS
    pydoh-->>App: ["93.184.216.34"]
Loading

установка

pip install pydoh

юзать

import pydoh

ips = pydoh.resolve("example.com")

или подменить резолвинг вообще везде в питоне одной строкой — requests, aiohttp, что угодно на сокетах будет резолвить через DoH:

import pydoh
pydoh.patch_socket()

документация

  • quickstart — установка, базовое использование, свой провайдер
  • api — все функции с параметрами
  • faq — зачем это надо, что делать если cloudflare забанят, законно ли

фичи

  • zero deps, только stdlib
  • fallback между cloudflare / google / quad9 если один упал
  • кэш по TTL из ответа
  • typed (py.typed), питон 3.10–3.13

что не умеет

не проверяет DNSSEC, не поддерживает TCP-фрагментированные DNS-ответы больше одного UDP-пакета.

Releases

Packages

Contributors

Languages