markqvist/reticulumСетевой стек на основе криптографии для создания неостанавливаемых сетей с LoRa, Packet Radio, WiFi и всем, что между ними.
Стек сетей Reticulum <img align="right" src="https://static.pepy.tech/personalized-badge/rns?period=month&units=international_system&left_color=grey&right_color=blue&left_text=Installs/month" style="padding-left:10px"/><a href="https://github.com/markqvist/Reticulum/actions/workflows/build.yml"><img align="right" src="https://github.com/markqvist/Reticulum/actions/workflows/build.yml/badge.svg"/></a> ========== > [!WARNING] > В настоящее время под отполированными, но в конечном счёте вводящими в заблуждение или откровенно обманными заявлениями продвигается значительное количество поспешно запущенных, некорректных, сомнительных, напрямую вредоносных и в большинстве случаев полностью сгенерированных LLM подделок реализаций Reticulum, «документации», «руководств» и пользовательских приложений. > > Для получения более подробной информации см. соответствующие разделы главы [Brandolini's Reference](https://reticulum.network/manual/brandolinis.html) руководства. Известные добросовестные реализации сообщества перечислены в разделе [Community Implementations](#community-implementations) этого readme. О программном обеспечении и проектах, признанных сообществом Reticulum, см. главу [Programs Using Reticulum](https://reticulum.network/manual/software.html) руководства. > > Машинно-сгенерированный контент, производный от исходного кода или документации RNS (например, «реализации», «руководства» на продажу и т. д.), в ряде хорошо задокументированных случаев нарушает лицензии с открытым исходным кодом, предоставившие права на копирование и распространение. > > Любые заявленные притязания на авторские права или предоставление лицензии (Apache, GPL и т. д.), которые делают такие проекты, являются [void grants](https://reticulum.network/manual/brandolinis.html#void-grants-legal-foundations-of-machine-generated-code). Как сами нарушители, так и все нижестоящие проекты, использующие нарушающие производные, **непосредственно** и лично несут юридическую ответственность за последствия. > > **Не** используйте эти «проекты», они представляют опасность для всей экосистемы, которую мы тщательно выстраивали последние десять лет. <p align="center"><img width="200" src="https://assets.kitploit.com/production/public/readmes/10927/035f499a1619cfb6d2da2ca99539e9e9d122bb18addf2ab83d3413592e7662f9.png"></p> *Этот репозиторий — [публичное зеркало](https://github.com/markqvist/reticulum/blob/master/MIRROR.md). Вся разработка ведётся в другом месте.* Чтобы понять основополагающую философию и цели этой системы, прочитайте [Zen of Reticulum](https://github.com/markqvist/reticulum/blob/master/Zen%20of%20Reticulum.md). Reticulum — это основанный на криптографии сетевой стек для построения локальных и глобальных сетей с использованием доступного оборудования. Он может работать даже при очень высокой задержке и чрезвычайно низкой пропускной способности. Reticulum позволяет строить глобальные сети с помощью готовых инструментов и предлагает сквозное шифрование и связность, анонимность инициатора, самоконфигурируемый многоскачковый транспорт с криптографической защитой, эффективную адресацию, неподделываемые подтверждения доставки и многое другое. Видение Reticulum — позволить любому стать собственным сетевым оператором и сделать дешёвым и простым покрытие огромных территорий множеством независимых, взаимосвязываемых и автономных сетей. Reticulum **не является** *одной* сетью. Это **инструмент** для построения *тысяч сетей*. Сетей без выключателей, слежки, цензуры и контроля. Сетей, которые могут свободно взаимодействовать, объединяться и разъединяться друг с другом и не требуют централизованного надзора. Сетей для людей. *Сетей для народа*. Reticulum — это полноценный сетевой стек, который не полагается на IP или вышележащие уровни, но при этом возможно использовать IP в качестве нижележащего носителя для Reticulum. Поэтому тривиально туннелировать Reticulum через Интернет или частные IP-сети. Отсутствие зависимостей от традиционных сетевых стеков освобождает ресурсы, которые были использованы для реализации сетевого стека, построенного непосредственно на криптографических принципах, что обеспечивает устойчивость и стабильную работу даже в открытых и недоверенных сетях. Не требуются модули ядра или драйверы. Reticulum полностью работает в пользовательском пространстве и может работать практически на любой системе, поддерживающей Python 3. ## Читайте руководство Полная документация по Reticulum доступна по адресу [markqvist.github.io/Reticulum/manual/](https://markqvist.github.io/Reticulum/manual/). Вы также можете скачать [руководство Reticulum в формате PDF](https://github.com/markqvist/Reticulum/releases/latest/download/Reticulum.Manual.pdf) или [в формате электронной книги EPUB](https://github.com/markqvist/Reticulum/releases/latest/download/Reticulum.Manual.epub). Для получения дополнительной информации см. [reticulum.network](https://reticulum.network/) и [раздел FAQ вики](https://github.com/markqvist/Reticulum/wiki/Frequently-Asked-Questions). ## Примечательные возможности - Глобально уникальная адресация и идентификация без координации - Полностью самоконфигурируемая многоскачковая маршрутизация по гетерогенным носителям - Гибкая масштабируемость на гетерогенных топологиях - Reticulum может передавать данные по любой комбинации физических сред и топологий - Низкопропускные сети могут сосуществовать и взаимодействовать с крупными высокопропускными сетями - Анонимность инициатора, общение без раскрытия своей личности - Reticulum не включает адреса источника ни в один из пакетов - Асимметричное шифрование X25519 и подписи Ed25519 как основа всего взаимодействия - Основополагающие ключи идентичности Reticulum — это 512-битные наборы ключей на эллиптических кривых - Прямая секретность доступна для всех типов связи, как для отдельных пакетов, так и поверх каналов - Reticulum использует следующий формат для зашифрованных токенов: - Эфемерные для каждого пакета и канала ключи, производные от обмена ключами ECDH на Curve25519 - AES-256 в режиме CBC с дополнением PKCS7 - HMAC с использованием SHA256 для аутентификации - IV генерируются через os.urandom() - Неподделываемые подтверждения доставки пакетов - Гибкая и расширяемая система интерфейсов - Reticulum включает большое разнообразие встроенных типов интерфейсов - Возможность загружать и использовать пользовательские или предоставленные сообществом типы интерфейсов - Легко создавать собственные интерфейсы для связи через что угодно - Аутентификация и сегментация виртуальных сетей на всех поддерживаемых типах интерфейсов - Интуитивный и простой в использовании API - Проще и удобнее в использовании, чем API сокетов, но при этом мощнее - Значительно упрощает создание распределённых и децентрализованных приложений - Надёжная и эффективная передача произвольных объёмов данных - Reticulum может обрабатывать как несколько байт данных, так и файлы в несколько гигабайт - Упорядочивание, сжатие, координация передачи и контрольные суммы выполняются автоматически - API очень прост в использовании и предоставляет прогресс передачи - Лёгкий, гибкий и расширяемый механизм запросов/ответов - Эффективное установление канала - Общая стоимость установления зашифрованного и проверенного канала составляет всего 3 пакета, в сумме 297 байт - Низкая стоимость поддержания открытых каналов — всего 0,44 бита в секунду - Надёжная последовательная доставка с механизмами Channel и Buffer ## Ресурсы сообщества Перечисленные здесь ссылки не управляются, не администрируются и не модерируются проектом Reticulum или его сопровождающим. Они предоставлены преданными независимыми добровольцами сообщества для пользы всех, кто заинтересован в изучении Reticulum. - [Reticulum Community Wiki](https://reticulum.miraheze.org/wiki) - [RNS Recipes](https://rns.recipes/) - [RNS Moscow](https://rns.moscow/) - [RMAP.world](https://rmap.world/) Если вы обнаружите что-то, что больше не является точным, некорректно или просто не совсем актуально, не требуйте и не жалуйтесь сопровождающим этих ресурсов. Вместо этого возьмите задачу на себя, чтобы помочь и улучшить ситуацию, работая над тем и предлагая те вклады, которые вы хотели бы видеть, как это сделали сами создатели вышеперечисленного. ## Эталонная реализация Код на Python в этом репозитории является эталонной реализацией Reticulum. Протокол Reticulum полностью и авторитетно определяется этой эталонной реализацией и связанным с ней руководством. Он поддерживается Марком Квистом, идентифицируемым по идентичности Reticulum `<bc7291552be7a58f361522990465165c>`. Никаких производных спецификаций протокола второго порядка в настоящее время не существует и никогда не будет. Вы не можете получить лучшую спецификацию, чем та, которая является исполняемой, функциональной, тестируемой, развёрнутой и работающей круглосуточно по всей планете. Не существует и никогда не будет отдельной производной «формальной спецификации», «RFC» или чего-либо подобного для Reticulum: **Эталонная реализация *и есть* окончательная, авторитетная спецификация.** Совместимость с протоколом Reticulum определяется как полная интероперабельность и достаточный функциональный паритет с этой эталонной реализацией. Любая конкретная реализация протокола, достигающая этого, является Reticulum. Любая, которая этого не достигает, не является Reticulum. Эталонная реализация лицензирована под Reticulum License. Протокол Reticulum был посвящён общественному достоянию в 2016 году. ## Реализации сообщества Перечисленные здесь реализации продемонстрировали совместимость на уровне протокола, достаточный функциональный паритет, разумные практики безопасности и разработки, долгосрочную приверженность и заботу о качестве реализации. Кроме того, они имеют историю как минимум 18 месяцев активной разработки. Что наиболее важно, их разработчики и сопровождающие признаны сообществом как действительно понимающие, что они делают, и как приверженные улучшению всей экосистемы Reticulum. - [microReticulum](https://github.com/attermann/microReticulum/) от [Chad Atterman](https://github.com/attermann) — это реализация на C++, ориентированная на 32-битные микроконтроллеры. - [Reticulum-Go](https://reticulum-go.quad4.io/) от [Quad4](https://quad4.io/) — это реализация на Go, ориентированная как на настольные, так и на мобильные и встраиваемые системы. *Если вы являетесь сопровождающим реализации, не указанной выше, и считаете, что она заслуживает включения, следуя тем же стандартам строгости и приверженности, ваше предложение будет приветствоваться.* --- **Внимание!** Значительное количество поспешно запущенных, некорректных, сомнительных, напрямую вредоносных и в большинстве случаев полностью сгенерированных LLM подделок реализаций Reticulum (и пользовательских приложений) в настоящее время продвигается и навязывается под отполированными, но в конечном счёте вводящими в заблуждение или откровенно обманными заявлениями. Большинство из них — либо быстрая попытка привлечь внимание или заработать, полностью непроверенные, несовместимые, без сопровождения или человеческого надзора, активно пытающиеся фрагментировать сообщество, либо комбинация всего этого. --- Для получения более обширной информации по этой теме прочитайте главу [Brandolini's Reference](https://reticulum.network/manual/brandolinis.html) руководства (о юридических основах см. конкретно [Void Grants](https://reticulum.network/manual/brandolinis.html#void-grants-legal-foundations-of-machine-generated-code)). Эта глава очень длинная, очень подробная и представляет собой вежливый, взвешенный анализ, задуманный как развивающийся, разбитый на разделы справочник по этим вопросам. Если вы предпочитаете просто короткую, нефильтрованную и довольно гневную версию, которая состоит из предпринятого ответа на одно конкретное проявление феномена в целом, использованного в качестве примера, вы можете прочитать [Yes, I am Angry](https://github.com/markqvist/reticulum/blob/master/docs/history/2026_09_18_Yes_I_am_Angry.md). Она доносит ту же мысль, но на совершенно другом языке, если вы способны воспринять такое общение. Основные сопровождающие и разработчики Reticulum **настоятельно не рекомендуют использовать любую такую «реализацию»**. [Обманчивое и корыстное поведение](https://reticulum.network/manual/brandolinis.html#a-persistent-but-fragile-triad) небольшого числа либо злонамеренных, либо ищущих внимания, либо некомпетентных лиц причинило значительный [ущерб и потерю времени и ресурсов](https://reticulum.network/manual/brandolinis.html#intent-consequence) как разработчикам, так и операторам узлов, пользователям, сообществу и проекту Reticulum в целом. Мы любезно, но настоятельно просим всех пользователей проявлять осторожность, здравый смысл и здоровый скептицизм при [оценке](https://reticulum.network/manual/brandolinis.html#evaluating-a-reticulum-implementation) потенциального использования любой реализации, не указанной выше; и принять, что **решение поступить иначе переносит ответственность за потенциальный ущерб с безответственного или злонамеренного лица на вас самих**. ## Примеры приложений Reticulum Если вы хотите быстро получить представление о том, что умеет Reticulum, взгляните на раздел [Programs Using Reticulum](https://reticulum.network/manual/software.html) руководства или на следующие ресурсы: - [LXMF](https://github.com/markqvist/lxmf) — это распределённый протокол передачи сообщений, устойчивый к задержкам и нарушениям, построенный на Reticulum - Протокол и фреймворк [LXST](https://github.com/markqvist/lxst) обеспечивают передачу аудио и сигналов в реальном времени поверх Reticulum. Он включает примитивы и утилиты для создания голосовых приложений и аппаратных устройств, таких как программа `rnphone`, которые можно использовать для создания аппаратных телефонов. - Для автономной, зашифрованной и устойчивой платформы mesh-связи см. [Nomad Network](https://github.com/markqvist/NomadNet) - Приложение для Android, Linux, macOS и Windows [Sideband](https://github.com/markqvist/Sideband) имеет графический интерфейс и множество продвинутых функций, таких как передача файлов, изображения и голосовые сообщения, голосовые вызовы в реальном времени, распределённая система телеметрии, возможности картографирования и полная расширяемость плагинами. - [MeshChatX](https://git.quad4.io/RNS-Things/MeshChatX) — это полнофункциональный клиент LXMF со множеством встроенных инструментов и функций, который также поддерживает изображения и голосовые сообщения, передачу файлов и голосовые вызовы. Он также включает встроенный браузер страниц для просмотра узлов Nomad Network. - Вы можете использовать включённую программу [rnsh](https://reticulum.network/manual/using.html#the-rnsh-utility) для установления сессий удалённой оболочки поверх Reticulum. - Включённая система [rngit](https://reticulum.network/manual/git.html) предоставляет полноценное решение для управления, хостинга, совместной работы и взаимодействия с репозиториями Git поверх Reticulum. ## Где можно использовать Reticulum? Практически на любой среде, которая может поддерживать как минимум полудуплексный канал с пропускной способностью более 5 бит в секунду и MTU в 500 байт. Радиомодемы передачи данных, модемы, LoRa-радио, последовательные линии, AX.25 TNC, любительские цифровые радиорежимы, устройства WiFi и Ethernet, оптические линии связи в свободном пространстве и подобные системы — всё это примеры типов физических устройств, которые может использовать Reticulum. Интерфейс на основе LoRa с открытым исходным кодом под названием [RNode](https://markqvist.github.io/Reticulum/manual/hardware.html#rnode) был разработан специально для использования с Reticulum. Его можно собрать самостоятельно или приобрести в виде готового трансивера, которому нужно только USB-, WiFi- или Bluetooth-подключение к хосту. Reticulum также может быть инкапсулирован поверх существующих IP-сетей, так что ничто не мешает вам использовать его через проводной Ethernet, вашу локальную WiFi-сеть или Интернет, где он будет работать так же хорошо. Фактически, одно из преимуществ Reticulum — то, насколько легко он позволяет соединять различные среды в самоконфигурируемую, устойчивую и зашифрованную mesh-сеть, используя любую доступную комбинацию имеющейся инфраструктуры. Например, можно настроить Raspberry Pi, подключённый одновременно к LoRa-радио, TNC пакетной радиосвязи и WiFi-сети. Как только интерфейсы настроены, Reticulum позаботится об остальном, и любое устройство в WiFi-сети сможет общаться с узлами на стороне LoRa и пакетной радиосвязи сети, и наоборот. ## С чего мне начать? Лучший способ начать работу с сетевым стеком Reticulum зависит от того, что вы хотите делать. Для получения полной информации и примеров обратитесь к разделу [Getting Started Fast](https://markqvist.github.io/Reticulum/manual/gettingstartedfast.html) [руководства Reticulum](https://markqvist.github.io/Reticulum/manual/). Чтобы просто установить Reticulum и связанные утилиты в вашей системе, проще всего через `pip`. После этого вы можете запустить любую программу, использующую Reticulum, или запустить Reticulum как системную службу с помощью [утилиты rnsd](https://markqvist.github.io/Reticulum/manual/using.html#the-rnsd-utility).```bash pip install rns ``` Если вы используете операционную систему, которая блокирует обычную установку пакетов пользователем через `pip`, вы можете вернуть `pip` к нормальному поведению, отредактировав файл `~/.config/pip/pip.conf` и добавив следующую директиву в раздел `[global]`:```text [global] break-system-packages = true ``` Кроме того, вы можете использовать инструмент `pipx` для установки Reticulum в изолированной среде:```bash pipx install rns ``` При первом запуске Reticulum создаст файл конфигурации по умолчанию, обеспечивающий базовое подключение к другим узлам Reticulum, которые могут быть доступны локально. Файл конфигурации по умолчанию содержит несколько примеров и ссылок для создания более сложной конфигурации. Если в вашей системе установлена старая версия `pip`, возможно, потребуется сначала обновить её с помощью `pip install pip --upgrade`. Если `pip` ещё не установлен, вы можете установить его, используя менеджер пакетов вашей системы, с помощью `sudo apt install python3-pip` или аналогичной команды. Более подробные примеры того, как расширить связь по множеству сред, таких как пакетное радио или LoRa, последовательные порты, или по быстрым IP-каналам и через Интернет с использованием интерфейсов UDP и TCP, смотрите в разделе [Supported Interfaces](https://markqvist.github.io/Reticulum/manual/interfaces.html) [Reticulum Manual](https://markqvist.github.io/Reticulum/manual/). ## Включённые утилиты Reticulum включает ряд полезных утилит для управления вашими сетями, просмотра статуса и информации, а также других задач. Подробнее об этих программах можно прочитать в разделе [Included Utility Programs](https://markqvist.github.io/Reticulum/manual/using.html#included-utility-programs) [Reticulum Manual](https://markqvist.github.io/Reticulum/manual/). - Системный демон `rnsd` для запуска Reticulum в качестве постоянно доступного сервиса - Утилита состояния интерфейсов `rnstatus`, отображающая информацию об интерфейсах - Инструмент поиска и управления путями `rnpath`, позволяющий просматривать и изменять таблицы путей - Диагностический инструмент `rnprobe` для проверки подключения к пунктам назначения - Простая программа передачи файлов `rncp`, упрощающая передачу файлов между системами - Утилита управления идентификацией и шифрования `rnid`, позволяющая управлять идентификаторами и шифровать/расшифровывать файлы - Программа `rnsh` позволяет установить полностью интерактивную сессию оболочки с удалёнными системами - Программа удалённого выполнения команд `rnx` позволяет запускать простые команды и программы и получать вывод с удалённых систем ``` --- [Read more](https://github.com/markqvist/reticulum)
