Netrunner Core

Netrunner Core — это высокопроизводительный сетевой комплекс, реализующий TLS-инкапсуляцию с мультиплексированием потоков для обхода сетевых ограничений. Система состоит из легковесного клиента (с поддержкой Android и Linux) и серверной части.

Архитектура

Проект построен на следующих принципах:

Прозрачный перехват трафика: Использование TUN-интерфейса и userspace сетевого стека (smoltcp) совместно с tokio для захвата и обработки TCP/UDP пакетов на сетевом уровне.
Мультиплексирование потоков: Передача независимых кадров (Frames) внутри единого зашифрованного TLS-туннеля.
TLS-маскировка: Имитация рукопожатия TLS 1.3 (ClientHello/ServerHello) для скрытия факта проксирования от систем DPI (Deep Packet Inspection).
Безопасность: Кадры защищены надежным AEAD-шифрованием (ChaCha20-Poly1305) с контролем целостности через auth_tag.
Кроссплатформенность: Ядро написано на Rust, компилируется под Linux и упаковывается через JNI/UniFFI для нативной интеграции в Android-приложения (Kotlin).

Основные компоненты

core/ — общая сетевая логика, кодек кастомного протокола и реализация AEAD-шифрования.
tlseng/ — движок формирования TLS-отпечатков (Fingerprinting Engine) для маскировки трафика под популярные браузеры.
client/ — локальный прокси-клиент (создает TUN-интерфейс, парсит пакеты и инкапсулирует их в туннель).
server/ — серверная часть, принимающая замаскированные TLS-соединения, маршрутизирующая кадры и выполняющая запросы во внешнюю сеть.
tools/ — набор утилит, включая логгер и bindgen-tool для генерации связующего кода (Kotlin bindings) под Android.

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

Требования

Rust (latest stable)
cargo-ndk (для кросс-компиляции под Android)
Linux: Права root или настроенные capabilities (cap_net_admin, cap_net_raw) для создания виртуального сетевого интерфейса.

Локальная разработка

Для запуска и отладки на локальной машине используйте команды:

# Запуск сервера локально (биндится на 0.0.0.0:4443)
make debug-server

# Сборка клиента, выдача необходимых cap-прав и запуск
make debug-client

Деплой сервера

Процесс развертывания серверной части полностью автоматизирован.

Укажите IP-адрес вашего сервера в Makefile (переменная SERVER_IP).
Выполните первоначальную настройку удаленной машины (установка зависимостей):
```
make setup-server
```
Соберите релизный бинарник:
```
make build-server
```
Отправьте бинарник на сервер и перезапустите systemd-сервис:
```
make deploy-server
```

Команды Makefile

Для удобства управления жизненным циклом проекта предусмотрены следующие цели:

Команда	Описание
`make debug-client`	Сборка клиента в режиме отладки, установка прав (`setcap`) и запуск.
`make debug-server`	Сборка и локальный запуск сервера на порту 4443.
`make build-android`	Кросс-компиляция `.so` библиотек для Android (arm64, armv7, x86, x86_64) и генерация Kotlin-биндингов.
`make build-server`	Сборка релизной версии сервера (`--release`).
`make setup-server`	Установка необходимых пакетов (`build-essential`, `libssl-dev`) на удаленном сервере.
`make deploy-server`	Остановка текущего сервиса, загрузка нового бинарника и конфигурации, старт через `systemctl`.
`make logs`	Подключение к серверу и просмотр логов сервиса `netrunner-server` в реальном времени (`journalctl -f`).
`make ssh`	Быстрое SSH-подключение к удаленному серверу.

5.9 KiB Raw Blame History Unescape Escape