Skip to content

README.md

Latest commit

 

History

History
187 lines (138 loc) · 7.64 KB

README.md

File metadata and controls

187 lines (138 loc) · 7.64 KB

TrustTunnel

TrustTunnel Client for Windows v2.6.0

Графический клиент для безопасного сетевого соединения по протоколу TrustTunnel.
Две редакции: Pro (управление сервером + подключение) и Light (только подключение).

Скачать · TrustTunnel Endpoint · Быстрый старт

Две редакции

TrustTunnel Pro

Полноценный клиент для администраторов: развёртывание сервера через SSH, управление пользователями, дашборд, логи, расширенные сетевые настройки.

TrustTunnel Light

Упрощённый клиент для обычных пользователей: импорт конфига, подключение одной кнопкой, маршрутизация. Без серверных настроек.

Функция Pro Light
Безопасное подключение + +
Импорт конфигурации (файл / ссылка / deeplink) + +
Маршрутизация (GeoIP, GeoSite, домены, IP) + +
Тема (тёмная / светлая), язык (RU / EN) + +
Автозапуск, автоподключение, системный трей + +
Проверка обновлений и автообновление + +
Контроль соединения (мониторинг, реконнект) + +
Генератор учётных данных + +
Управление сервером (SSH) + —
Установка протокола на сервер + —
Управление пользователями + —
Дашборд (пинг, статистика сервера) + —
Безопасность сервера (fail2ban, firewall) + —
Просмотр логов + —
Настройки соединения (протокол, MTU, Kill Switch, DNS) + —
QR-код конфигурации + —

Что такое TrustTunnel

TrustTunnel — протокол адаптивного сетевого взаимодействия, работающий поверх стандартных транспортных протоколов (HTTP/2, QUIC).

  • Туннелирование TCP, UDP и ICMP трафика
  • Системный сетевой адаптер (TUN) и SOCKS5-прокси
  • Раздельная маршрутизация трафика (split tunneling)
  • Пользовательские DNS-серверы через туннель
  • Post-Quantum криптография (X25519MLKEM768)

Быстрый старт

Требования

  • Windows 10/11 (x64)
  • Права администратора (для WinTUN-адаптера)

Pro — для администраторов

  1. Арендуйте Linux-сервер (Ubuntu 22+, Debian 11+), купите домен
  2. Скачайте TrustTunnel-Pro-v2.6.0-portable-win64.zip из Releases
  3. Распакуйте и запустите TrustTunnel.exe
  4. В мастере введите SSH-данные сервера (IP, порт, логин, пароль или SSH-ключ)
  5. Приложение установит TrustTunnel-сервер и создаст конфигурацию
  6. Нажмите Подключить

Light — для пользователей

  1. Получите конфиг-файл (.toml) или ссылку (tt://) от администратора
  2. Скачайте TrustTunnel-Light-v2.6.0-portable-win64.zip из Releases
  3. Распакуйте и запустите TrustTunnel Light.exe
  4. Импортируйте конфиг (файл или ссылка)
  5. Нажмите кнопку подключения

Также доступны установщики (.exe) для обеих редакций.

Архитектура

┌──────────────────────────────────────────────────┐
│  GUI (Tauri v2 + React + TypeScript + Tailwind)  │
│                                                  │
│  Pro: sidebar, 8 панелей, SSH-деплой             │
│  Light: bottom nav, 4 экрана, без SSH            │
│                                                  │
│  Shared: UI-компоненты, хуки, i18n, tokens.css   │
│                                                  │
│  Sidecar: trusttunnel_client.exe (C++)           │
│  VPN-подключение через WinTUN                    │
└──────────────────────────────────────────────────┘
  • Frontend: React 19 + TypeScript + Tailwind CSS
  • Backend: Rust 1.88 (Tauri v2) — sidecar, SSH-деплой (Pro), системный трей
  • Network Core: C++ библиотеки TrustTunnel — WinTUN-адаптер, DNS, маршрутизация

Сборка из исходников

Требования

  • Node.js >= 18
  • Rust >= 1.88
  • CMake >= 3.24
  • Visual Studio 2022 (C++ Build Tools)
  • Python >= 3.10 (для Conan)

Сборка

# 1. Клонировать
git clone https://github.com/ialexbond/TrustTunnelClientForWindows.git
cd TrustTunnelClientForWindows

# 2. Собрать C++ sidecar
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=RelWithDebInfo
cmake --build build --target trusttunnel_client

# 3. Скопировать sidecar для Tauri
copy build\trusttunnel\trusttunnel_client.exe ^
     gui-app\src-tauri\trusttunnel_client-x86_64-pc-windows-msvc.exe

# 4. Собрать Pro
cd gui-app && npm install && npx tauri build

# 5. Собрать Light
cd ..\gui-light && npm install && npx tauri build

Технологии

Компонент Технология
GUI Framework Tauri v2
Frontend React 19 + TypeScript + Tailwind CSS
Backend Rust 1.88
Network Core C++20 (TrustTunnel Client Libraries)
Tunnel Driver WinTUN
SSH Deploy russh (Pro only)

Благодарности

  • AdGuard — за разработку протокола TrustTunnel и открытие исходного кода клиентских библиотек

Лицензия

Apache 2.0

Ссылки