initial commit

README.md

@@ -0,0 +1,57 @@
+# ![Cheburcheck Logo](static/favicon.svg) Cheburcheck.ru
+
+[Cheburcheck.ru](https://cheburcheck.ru) — open-source сервис для проверки доменов и IP-адресов на наличие в списках блокировок Роскомнадзора и популярных заблокированных CDN-провайдеров.
+
+---
+
+## О проекте
+
+Этот сервис реализован на языке Rust с использованием веб-фреймворка [Rocket.rs](https://rocket.rs/). Основная задача — проверять, заблокирован ли домен или IP-адрес, основываясь на актуальных данных из реестров Роскомнадзора и других источниках.
+
+---
+
+## Технологии
+
+- **Rust** — язык программирования, на котором написан весь бекенд.  
+- **Rocket.rs** — веб-фреймворк для построения HTTP API и серверной логики.  
+- **DoH резолвер Cloudflare** — для разрешения DNS-запросов используется DNS-over-HTTPS через Cloudflare, что позволяет обойти локальные ограничения и получать актуальные данные.  
+- **Tera** — шаблонизатор для генерации HTML страниц, используется для фронтенда.  
+- **lucide** — библиотека иконок, применяемая для визуального оформления интерфейса.  
+
+---
+
+## Как это работает
+
+1. Пользователь вводит домен или IP-адрес в форму на сайте.  
+2. Сервер выполняет DNS-запрос через Cloudflare DoH для получения актуальной информации.  
+3. Полученный домен/IP проверяется на наличие в блокировочных списках через префиксные деревья.
+4. Результат формируется с помощью Tera и отображается пользователю.  
+
+---
+
+## Списки
+
+Для проверки используются списки [123jjck/cdn-ip-ranges](https://github.com/123jjck/cdn-ip-ranges) и [antifilter.download](https://antifilter.download/).
+
+---
+
+## Структура проекта
+
+* `src/` — исходный код приложения
+* `templates/` — Tera-шаблоны для фронтенда
+* `static/` — статические файлы
+* `Cargo.toml` — зависимости и конфигурация Rust-проекта
+
+---
+
+## Вклад
+
+Если хотите помочь с разработкой — открывайте issue или присылайте pull requests.
+Если хотите помочь финансово:
+- TON: `UQAACsiwpGryjP-kqp4TJPAWpXytuB6M_puuO0Cg5zNvaSJW`
+
+---
+
+## Контакты
+
+Для вопросов и обсуждений можно написать на [support@cheburcheck.ru](mailto:support@cheburcheck.ru).