Skip to content

Commit fd31577

Browse files
committed
docs: Rewrite main README.md from scratch with top-tier design
1 parent 3de544c commit fd31577

1 file changed

Lines changed: 90 additions & 80 deletions

File tree

README.md

Lines changed: 90 additions & 80 deletions
Original file line numberDiff line numberDiff line change
@@ -3,118 +3,128 @@
33
<img src="./build/appicon.png" alt="Unbound Logo" width="160" />
44

55
# 🚀 UNBOUND v2.0
6-
**Универсальная мультиплатформенная пушка для обхода любых DPI блокировок**
6+
**Мультиплатформенная пушка для прозрачного обхода DPI-блокировок.** <br>
7+
*Zero latency. Zero overhead. Zero VPN.*
78

8-
[![Версия](https://img.shields.io/badge/Версия-2.0.0-ff6b6b?style=for-the-badge&logo=rocket)](#)
9-
[![Windows](https://img.shields.io/badge/Windows-10%2F11-0078D6?style=for-the-badge&logo=windows)](#)
10-
[![macOS](https://img.shields.io/badge/macOS-Apple_Silicon%2FIntel-000000?style=for-the-badge&logo=apple)](#)
11-
[![Linux](https://img.shields.io/badge/Linux-Kernel_5.10+-FCC624?style=for-the-badge&logo=linux)](#)
12-
[![Android](https://img.shields.io/badge/Android-8.0+-3DDC84?style=for-the-badge&logo=android)](#)
13-
[![Уеб](https://img.shields.io/badge/Web-Browser_Extension-4285F4?style=for-the-badge&logo=googlechrome)](#)
14-
[![Open Source](https://img.shields.io/badge/Язык-Русский_🇷🇺-brightgreen?style=for-the-badge)](#)
9+
[![Версия](https://img.shields.io/badge/Release-2.0.0-ff6b6b?style=for-the-badge&logo=rocket)](#)
10+
[![Лицензия](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)](#)
11+
[![Русский Язык](https://img.shields.io/badge/Язык-Русский_🇷🇺-brightgreen?style=for-the-badge)](#)
1512

16-
<a href="#-почему-unbound">🏆 Почему Unbound?</a> •
17-
<a href="#-как-эта-херня-работает">⚙️ Под капотом</a> •
18-
<a href="#-установка-и-платформы">📦 Скачать под свою ОС</a> •
19-
<a href="#-детали-для-гиков">💻 Для программистов</a>
13+
<img src="./docs/screenshot.jpg" alt="Unbound Interface" width="100%" style="border-radius: 12px; box-shadow: 0 10px 30px rgba(0,0,0,0.4); max-width: 800px; margin: 20px 0;" />
2014

21-
<br/>
22-
<img src="./docs/screenshot.jpg" alt="Unbound Interface" width="800" style="border-radius:12px; box-shadow: 0 10px 30px rgba(0,0,0,0.5);" />
23-
<br/>
15+
[**🌐 Скачать**](#-поддерживаемые-платформы-и-установка) &nbsp; | &nbsp; [**✨ Архитектура**](#-как-работает-движок) &nbsp; | &nbsp; [**📖 Документация**](#-компиляция-из-исходников) &nbsp; | &nbsp; [**🖥 Официальный Сайт**](https://bobberdolle1.github.io/unbound)
2416

25-
*Доступ к YouTube, Instagram, Discord, Twitter и сотням других ресурсов без просадок скорости и без покупки VPN.*
17+
> **Unbound** — это ультимативный локальный оркестратор пакетов. Он не использует VPN, удалённые серверы или внешние прокси. Программа напрямую кромсает, модифицирует и десинхронизирует TCP/UDP-трафик на уровне сетевого стека вашей ОС, заставляя системы Deep Packet Inspection (DPI) провайдера ослепнуть и пропустить вас к заблокированному ресурсу.
2618
2719
</div>
2820

21+
<br>
22+
23+
## 🏆 Ключевые возможности
24+
25+
<table>
26+
<tr>
27+
<td width="50%">
28+
<h3>⚡ Скорость провайдера</h3>
29+
<p>Никаких туннелей. Никакого пинга. Трафик идет напрямую до целевого сервера, гарантируя максимальную пропускную способность для загрузки 4K-видео и нулевые задержки в играх вроде Discord.</p>
30+
</td>
31+
<td width="50%">
32+
<h3>🛡 Полная Анонимность</h3>
33+
<p>В отличие от VPN-сервисов, Unbound на 100% автономен. Программа не осуществляет сбор телеметрии, не требует аккаунтов и не отправляет ваши личные данные на "анонимные" удалённые серверы.</p>
34+
</td>
35+
</tr>
36+
<tr>
37+
<td width="50%">
38+
<h3>🕹 Нативная интеграция</h3>
39+
<p>Интеграция на уровень ядра (L3/L4) с помощью встроенных драйверов WinDivert (Windows), Packet Filter (macOS) и Netfilter (Linux). Никаких виртуальных сетевых адаптеров TUN/TAP и танцев с бубном.</p>
40+
</td>
41+
<td width="50%">
42+
<h3>🎨 UI нового поколения</h3>
43+
<p>Движок управления обладает сверхбыстрым графическим интерфейсом на базе Wails с невероятными кастомными темами (Скевоморфизм, Doodle Jump, Metro UI, Liquid Glass и другие).</p>
44+
</td>
45+
</tr>
46+
</table>
47+
2948
---
3049

31-
## 🏆 Почему Unbound?
50+
## 🧩 Поддерживаемые платформы и установка
3251

33-
Забудь про медленные VPN, отваливающиеся прокси и километровые туннели, которые урезают скорость провайдера в три раза и повышают пинг до небес.
52+
Unbound скомпилирован под подавляющее большинство операционных систем. **Не требует настройки — скачал, нажал одну кнопку, всё работает.**
3453

35-
**Unbound — это НЕ VPN.**
36-
Это нативный оркестратор пакетов, который работает прямо в сетевом стеке вашей операционной системы. Ваш трафик идет напрямую от вашего роутера к серверам Google/Discord, но программа локально «кромсает» и «мутирует» TCP-пакеты так, что фильтры провайдера (система DPI - Deep Packet Inspection) сходят с ума и пропускают вас на заблокированный сайт.
54+
| Платформа | Технология-Драйвер | Инструкция к установке | Статус |
55+
| :--- | :--- | :--- | :---: |
56+
| <img src="https://simpleicons.org/icons/windows.svg" width="16"/> **Windows 10/11** | `WinDivert` | Распакуйте ZIP и запустите `unbound.exe` от Админа. Драйвер встроен в бинарник. ||
57+
| <img src="https://simpleicons.org/icons/apple.svg" width="16"/> **macOS (Intel/M1+)** | `pf` + Raw Sockets | Запустите с правами суперпользователя: `sudo ./unbound-darwin-amd64`. ||
58+
| <img src="https://simpleicons.org/icons/linux.svg" width="16"/> **Linux** | `iptables` / `NFQUEUE` | Запустите от `root`. Правила iptables обновляются на лету. ||
59+
| <img src="https://simpleicons.org/icons/android.svg" width="16"/> **Android 8.0+** | `VpnService API` | Установите `app-release.apk` и разрешите локальный VPN профиль профиль. ||
60+
| <img src="https://simpleicons.org/icons/ios.svg" width="16"/> **iOS (Jailbreak)** | `launchd` демон | Установите `.deb` пакет через Sileo/Zebra (Rootful / Rootless). ||
61+
| <img src="https://simpleicons.org/icons/openwrt.svg" width="16"/> **OpenWRT** | Нативный пакет | Закиньте и установите `.ipk` через `opkg install`, настройте в LuCI. ||
3762

38-
🔥 **Главные фишки:**
39-
***Нулевая потеря скорости (Zero Penalty)** — Качай гигабайты и смотри 4K. Скорость не ограничена чужим сервером.
40-
* 🕹️ **Нулевой пинг в играх** — Трафик идет напрямую. Discord работает кристально чисто без лагов.
41-
* 🛡️ **100% Локально и Анонимно** — Программа не отправляет ни байта телеметрии. Никаких аккаунтов, никаких регистраций. Исходный код открыт — проверяйте сами.
42-
* 🎨 **Сочные темы оформления** — Скучно сидеть в сером окне? Выбирай `Aura`, `Win95` или `Liquid Glass` прямо в интерфейсе!
63+
📥 **Все бинарники доступны в разделе [GitHub Releases](../../releases).**
4364

4465
---
4566

46-
## ⚙️ Как эта херня работает? (Архитектура простым языком)
67+
## ⚙️ Как работает движок? (Краткая архитектура)
4768

48-
Провайдеры используют DPI-оборудование, чтобы отлавливать слово "youtube.com" или "discord.gg" прямо в вашем трафике во время самого первого "рукопожатия" (ClientHelloTLS).
69+
Большинство провайдеров используют пассивные (зеркалированные) DPI или inline анализаторы пакетов. Они ищут ключевые слова вроде `googlevideo.com` при установке безопасного соединения TLS-сессии (ClientHello).
4970

50-
**Что делает Unbound:**
51-
В то время как другие делают туннели, Unbound берет ваш запрос и в реальном времени применяет тактики ниндзя:
52-
1. **Дефрагментация пакетов:** Режет слово `youtube.com` на микроскопические пакеты: `you`, `tu`, `be.com`. Тупой DPI не может читать их по отдельности и пропускает. Целевой сервер собирает их обратно.
53-
2. **Фейковый TTL-спуфинг:** Выплевывает "мусорные" пакеты со сломанным временем жизни (TTL), которые оседают и забивают анализатор провайдера, но никогда не долетают до настоящего сайта.
54-
3. **Смещение окна (Window Size):** Перемешивает номера ответов, доводя DPI-фильтры до паники.
71+
Unbound перехватывает эти пакеты до отправки провайдеру и применяет арсенал механизмов обхода:
5572

5673
```mermaid
57-
graph LR
58-
A[Ваш Браузер YouTube] --(Оригинальный запрос)--> B((UNBOUND ENGINE))
59-
B --Летит мусорный пакет TTL=2--> C[DPI Провайдера РКН]
60-
C --Запутался и ослеп--> D
61-
B --Фрагментированный запрос--> D[Глобальный интернет]
62-
D --Соединение подтверждено--> E[Сервера Google]
63-
style B fill:#3b82f6,color:#fff,stroke:#fff,stroke-width:2px
64-
style C fill:#ef4444,color:#fff
74+
sequenceDiagram
75+
participant B as Ваш Браузер
76+
participant U as Unbound Engine
77+
participant D as DPI Провайдера
78+
participant S as Целевой Сервер (YouTube)
79+
80+
B->>U: Отправляет ClientHello [youtube.com]
81+
Note over U: Анализ TCP пакета на лету.
82+
U->>D: 1. Fake packet (TTL=2) с мусором "example.com"
83+
Note over D: DPI провайдера принимает Мусор и блокирует его.
84+
U->>D: 2. Разделение реального пакета на куски по 2-4 байта
85+
Note over D: DPI не видит полного слова "youtube" и пропускает
86+
D->>S: Куски долетают до сервера в разном порядке
87+
Note over S: Серверный TCP-стек их собирает и одобряет
88+
S-->>B: Соединение установлено! 🚀
6589
```
6690

67-
Мы не привязываемся к одному инструменту. Для каждой ОС в Unbound запаян свой идеальный нативный движок.
68-
69-
---
70-
71-
## 📦 Установка и Платформы
72-
73-
Качай билд именно под свое устройство. Без танцев с бубном. Все скачивания лежат во вкладке **[Releases (КЛИКАЙ СЮДА)](https://github.com/bobberdolle1/unbound/releases/latest)**.
74-
75-
| ОС / Устройство | Используемый движок в Unbound | Как поставить? |
76-
| :--- | :--- | :--- |
77-
| **Windows 10/11** | Ядерный драйвер `WinDivert` + `zapret` | Скачай `.exe`, запусти от Админа, нажми "Подключить". |
78-
| **macOS (Intel/M1+)** | `SpoofDPI` (SOCKS5/kqueue) | Скачай `.app`, перекинь в Программы, разреши запуск в Настройках, нажми "Подключить". |
79-
| **Linux / SteamOS** | `nfqws` + `nftables` | Скачай `unbound-linux-amd64`, выполни `sudo ./unbound start`. Зависимости: `nftables`. |
80-
| **Android** | `VpnService` + C-ядро | Скачай и поставь `.apk`. Нажми Start. (Или установи Magisk ZIP для root-режима). |
81-
| **OpenWrt Роутеры**| `zapret` (MIPS/ARM) | Закинь `.ipk` плагины на роутер через WinSCP. Рули прямо из веб-морды LuCI! |
82-
83-
> [!WARNING]
84-
> Блокировки в разных городах могут отличаться! Если не работает профиль по умолчанию, нажми кнопку **"Magic Wand / Автоподбор"**, и Unbound сам прощупает провайдера и выберет самую мощную стратегию конкретно для твоей квартиры.
91+
**Ключевые методики пробития:**
92+
1. **Дефрагментация пакета (Fragmentation):** Дробление SNI-домена (ClientHello) на мелкие TCP-сегменты, которые фильтр провайдера не может собрать воедино.
93+
2. **Мусорная переадресация (Fake TTL):** Отсылка фальшивого пакета, жизнь которого сгорает у оператора, забивая кеш DPI-фильтра и прокладывая дорогу подлинному запросу.
94+
3. **Рассинхрон Window Size:** Специальное манипулирование размерами TCP Window Size для обхода stateful-анализаторов пакетов.
8595

8696
---
8797

88-
## 💻 Для программистов (Мануалы по коду)
89-
90-
Unbound разработан по принципу "Разделяй и властвуй". Интерфейс на React/Wails — отдельно, суровые C/Rust бэкенды — отдельно.
98+
## 💻 Компиляция из исходников
9199

92-
Хочешь собрать всё сам или залезть в код? Читай наши ультра-детальные русскоязычные технические гайды:
100+
Если вы хотите собрать ядро или GUI-оболочку приложения самостоятельно:
101+
**Требования:**
102+
* Наличие `Go` v1.21+
103+
* Наличие `Node.js` v18+ (для сборки UI наsvelte/react)
104+
* Сборочный пакет `Wails` (`go install github.com/wailsapp/wails/v2/cmd/wails@latest`)
93105

94-
* 🐧 **Linux & Steam Deck:** [Как работает наш NFQUEUE драйвер на Rust ->](linux/README.md)
95-
* 🤖 **Android APK & NDK:** [Как компилить нативное ядро через Gradle ->](android/README.md)
96-
* 🍎 **macOS Darwin API:** [Как мы прокидываем настройки прокси в SCPreferences ->](macos/README.md)
97-
* 🌐 **OpenWrt роутеры:** [Сборка пакетов под OpenWrt SDK ->](openwrt/README.md)
98-
* 🍏 **iOS Jailbreak:** [Написание Theos-твика под Cydia/Dopamine ->](theos/unbound-legacy/README.md)
99-
100-
### 🛠 Кросскомпиляция Десктопа за одну команду
101-
У тебя должны стоять `Go`, `NodeJS` и `Wails CLI`.
102106
```bash
107+
# Клонируем проект
103108
git clone https://github.com/bobberdolle1/unbound.git
104109
cd unbound
105-
npm install --prefix frontend
106-
# Собираем мощь!
107-
wails build -platform windows/amd64,darwin/arm64
110+
111+
# Компиляция ядра CLI-режима под текущую архитектуру:
112+
go build -ldflags="-s -w" -o unbound_cli ./main.go
113+
114+
# Сборка Wails графического приложения (настольные ОС)
115+
wails build -m
108116
```
109117

110-
---
118+
> **Важно:** Подробные инструкции по сборке пакетов для *iOS (theos)*, *Android (gradle)*, и *OpenWRT* лежат в соответствующих папках: `/ios`, `/android`, `/openwrt`.
111119
112-
## 📜 Лицензия и Благодарности
120+
---
113121

114-
**GPL-3.0**. Делайте форки, улучшайте, делитесь.
122+
## 📜 Поддержать проект
115123

116-
Огромный респект и почёт гигантам Open Source систем: **bol-van** (за легендарный `zapret`), **basil00** (за `WinDivert`), **ValdikSS** (за идеи `GoodbyeDPI`), и **xvzc** (за `SpoofDPI`). Без этих титанов мы бы до сих пор сидели через медленные прокси.
124+
Исходный код распространяется под лицензией **MIT License**. Модификации, форки и коммерция разрешены.
125+
Если проект был полезен — **поставьте ему ⭐ на GitHub**, это здорово помогает развитию!
117126

118-
<p align="center">
119-
<sub>Создано с гордостью командой UNBOUND. Интернет должен быть свободным. 🇷🇺 2024-2026</sub>
120-
</p>
127+
<div align="center">
128+
<br>
129+
<i>Разработано с любовью к свободному интернету.</i>
130+
</div>

0 commit comments

Comments
 (0)