doh-stub/README.md
2026-07-19 20:47:23 +05:00

33 lines
1.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# doh-stub
[![CI](https://github.com/ImSavsis/doh-stub/actions/workflows/ci.yml/badge.svg)](https://github.com/ImSavsis/doh-stub/actions/workflows/ci.yml)
[![license](https://img.shields.io/github/license/ImSavsis/doh-stub.svg)](https://github.com/ImSavsis/doh-stub/blob/master/LICENSE)
локальный DNS-резолвер на C++, который сам ходит наружу по DNS-over-HTTPS. провайдер/DPI видит только HTTPS к cloudflare, а не голые DNS-запросы.
```mermaid
sequenceDiagram
OS->>doh-stub: обычный DNS-запрос (UDP)
doh-stub->>Cloudflare: тот же запрос, но внутри HTTPS POST
Cloudflare->>doh-stub: ответ внутри HTTPS
doh-stub->>OS: обычный DNS-ответ (UDP)
```
## сборка
```
cmake -B build
cmake --build build --config Release
```
## юзать
```
build\Release\dohstub.exe --port 5300
```
по умолчанию слушает `127.0.0.1:5300` и форвардит на `cloudflare-dns.com`. чтобы реально подменить системный DNS — нужен порт 53 и админ, плюс прописать `127.0.0.1` в настройках сети.
## что не умеет
не кэширует ответы, каждый запрос — новый HTTPS-коннект. для личного использования хватает, для нагрузки — нет.