Git-Mirrors/reticulum_website
1
0
Fork 0
mirror of https://github.com/markqvist/reticulum_website.git synced 2025-04-03 03:46:11 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity

Ukrainian translation added

Browse Source
This commit is contained in:
Petro Ostapuk 2025-02-14 23:57:04 +02:00
parent ffd7c6fbce
commit 9271ac908b
10 changed files with 267 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
build.py
View File

@ -39,6 +39,7 @@ langs = [
{"name": "Türkçe", "ext": "tr"},
{"name": "日本語", "ext": "jp"},
{"name": "简体中文", "ext": "zh-cn"},
{"name": "Українська", "ext": "uk"},
]
menu_translations = {
@ -141,6 +142,17 @@ menu_translations = {
"SOURCE": "源代码",
"DONATE": "支持开发",
},
"uk": {
"RETICULUM": "Reticulum",
"START": "Початок",
"HARDWARE": "Обладнання",
"TESTNET": "Тестова мережа",
"MANUAL": "Довідник",
"CRYPTO": "Крипто",
"CREDITS": "Кредит",
"SOURCE": "Вихідний код",
"DONATE": "Донати",
},
}

40
source/connect_uk.md Normal file
View File

@ -0,0 +1,40 @@
# Публічний Testnet
Якщо ви просто хочете почати експериментувати без створення фізичних мереж, ви можете приєднатися до публічного тестнету Reticulum. Тестнет саме такий, неформальна мережа для тестування та експериментів. Він буде доступний більшість часу, і кожен може приєднатися, але це також означає, що немає гарантій щодо доступності сервісу.
**Зверніть увагу!** Для повсякденного використання Reticulum, наприклад, для обміну повідомленнями та інших комунікацій, набагато краще використовувати один або кілька з публічних точок входу, наданих спільнотою. Деталі дивіться в наступному розділі.
Тестнет працює на найновішій версії Reticulum (зазвичай навіть до її офіційного випуску). Іноді на тестнеті можуть бути розгорнуті експериментальні версії Reticulum, що може призвести до дивної поведінки. Якщо вас це не лякає, ви можете приєднатися до тестнету через TCP або I2P.
Просто додайте один із наступних інтерфейсів до вашого конфігураційного файлу Reticulum:
```
# TCP/IP interface to the Dublin Hub
[[RNS Testnet Dublin]]
type = TCPClientInterface
enabled = yes
target_host = dublin.connect.reticulum.network
target_port = 4965
# TCP/IP interface to the BetweenTheBorders Hub (community-provided)
[[RNS Testnet BetweenTheBorders]]
type = TCPClientInterface
enabled = yes
target_host = reticulum.betweentheborders.com
target_port = 4242
# Interface to I2P Hub A
[[RNS Testnet I2P Hub A]]
type = I2PInterface
enabled = yes
peers = g3br23bvx3lq5uddcsjii74xgmn6y5q325ovrkq2zw2wbzbqgbuq.b32.i2p
```
Тестнет також містить кілька вузлів Nomad Network та вузлів поширення LXMF.
Точки входу спільноти
Спільнота надала кілька публічно доступних точок входу до мереж Reticulum. Для повсякденного використання рекомендується використовувати ці точки замість тестнету.
Ви можете приєднати свої пристрої або інстанси до однієї або кількох таких точок входу, щоб отримати доступ до будь-яких мереж Reticulum, до яких вони фізично підключені.
Ідеально, якщо ви налаштуєте вузол транспорту Reticulum, до якого ваші пристрої зможуть підключатися локально, а потім з’єднаєте цей транспортний вузол з кількома публічними точками входу. Це забезпечить ефективні з’єднання та надійність у випадку, якщо одна з точок входу вийде з ладу.
{PUBLIC_ENTRYPOINTS}
<p align="right"><a href="docs.html">Наступна тема: Читати мануал</a></p>

27
source/credits_uk.md Normal file
View File

@ -0,0 +1,27 @@
# Подяки та кредити
Reticulum може існувати тільки завдяки великій кількості відкритого програмного забезпечення, на якому він був побудований, внескам всіх, хто брав участь, і всім, хто підтримував проєкт протягом багатьох років. Усім, хто допомагав, велике спасибі.
Чимало інших модулів та проєктів є частинами або використовуються Reticulum. Щира подяка авторам і контриб'юторам наступних проєктів:
- [PyCA/cryptography](https://github.com/pyca/cryptography), *BSD License*
- [Pure-25519](https://github.com/warner/python-pure25519) від [Brian Warner](https://github.com/warner), *MIT License*
- [Pysha2](https://github.com/thomdixon/pysha2) від [Thom Dixon](https://github.com/thomdixon), *MIT License*
- [Python-AES](https://github.com/orgurar/python-aes) від [Or Gur Arie](https://github.com/orgurar), *MIT License*
- [Curve25519.py](https://gist.github.com/nickovs/cc3c22d15f239a2640c185035c06f8a3#file-curve25519-py) від [Nicko van Someren](https://gist.github.com/nickovs), *Public Domain*
- [I2Plib](https://github.com/l-n-s/i2plib) від [Viktor Villainov](https://github.com/l-n-s)
- [PySerial](https://github.com/pyserial/pyserial) від Chris Liechti, *BSD License*
- [Netifaces](https://github.com/al45tair/netifaces) від [Alastair Houghton](https://github.com/al45tair), *MIT License*
- [Configobj](https://github.com/DiffSK/configobj) від Michael Foord, Nicola Larosa, Rob Dennis та Eli Courtwright, *BSD License*
- [Six](https://github.com/benjaminp/six) від [Benjamin Peterson](https://github.com/benjaminp), *MIT License*
- [Umsgpack.py](https://github.com/vsergeev/u-msgpack-python) від [Ivan A. Sergeev](https://github.com/vsergeev)
- [Python](https://www.python.org)
Проєктування протоколу та його референс-імплементація для Reticulum здійснювались з 2014 по 2022 рік Маркусом Квістом.
[Python референс-імплементація Reticulum](https://github.com/markqvist/reticulum) та цей вебсайт ліцензовані за умовами [MIT License](license.html). Будь ласка, <a href="donate.html">пожертвуйте</a>, щоб підтримати подальший розвиток.
----------------
<center>Протокол Reticulum є спільною власністю всіх людей,<br/>я віддаю його в публічне надбання.<br/><br/>Присвячую з надією і вірою в майбутнє,<br/>свободу і процвітання всіх,<br/>на Землі й за її межами.<br/><br/>Дякую</center>
----------------

25
source/crypto_uk.md Normal file
View File

@ -0,0 +1,25 @@
# Криптографічні примітиви
Reticulum використовує простий набір ефективних, надійних і сучасних криптографічних примітивів, з широко доступними імплементаціями, які можна використовувати як на загальновживаних процесорах, так і на мікроконтролерах. Необхідні примітиви:
- Ed25519 для підписів
- X22519 для ECDH обміну ключами
- HKDF для виведення ключів
- AES-128 у режимі CBC
- HMAC-SHA256 для аутентифікації повідомлень
- SHA-256
- SHA-512
У стандартній конфігурації установки примітиви `X25519`, `Ed25519` і `AES-128-CBC` надаються [OpenSSL](https://www.openssl.org/) (через пакет [PyCA/cryptography](https://github.com/pyca/cryptography)). Функції хешування `SHA-256` і `SHA-512` надаються стандартною бібліотекою Python [hashlib](https://docs.python.org/3/library/hashlib.html). Примітиви `HKDF`, `HMAC`, `Fernet`, а також функція паддінгу `PKCS7` завжди надаються наступними внутрішніми імплементаціями:
- [HKDF.py](https://github.com/markqvist/Reticulum/blob/master/RNS/Cryptography/HKDF.py)
- [HMAC.py](https://github.com/markqvist/Reticulum/blob/master/RNS/Cryptography/HMAC.py)
- [Fernet.py](https://github.com/markqvist/Reticulum/blob/master/RNS/Cryptography/Fernet.py)
- [PKCS7.py](https://github.com/markqvist/Reticulum/blob/master/RNS/Cryptography/PKCS7.py)
Reticulum також включає повну імплементацію всіх необхідних примітивів на чистому Python. Якщо OpenSSL і PyCA недоступні на системі під час запуску Reticulum, то замість них будуть використані внутрішні чисто-python примітиви. Легким наслідком цього є продуктивність, причому бекенд OpenSSL працює *набагато* швидше. Однак найважливіший наслідок полягає в потенційній втраті безпеки через використання примітивів, які не були піддані такій самій перевірці, тестуванню та огляду, як ті, що надаються OpenSSL.
Якщо ви хочете використовувати внутрішні чисто-python примітиви, **вкрай рекомендується** добре розуміти ризики, які вони несуть, і приймати обґрунтоване рішення щодо того, чи є ці ризики для вас прийнятними.
Reticulum — це відносно молода програма, і її слід розглядати саме як таку. Хоча вона була створена з урахуванням найкращих практик криптографії, вона _не проходила_ зовнішнього аудиту безпеки, і цілком ймовірно, що існують помилки, які можуть зламати конфіденційність або безпеку. Якщо ви хочете допомогти або спонсорувати аудит, будь ласка, зв'яжіться з нами.
<p align="right"><a href="credits.html">Наступна тема: Подяки та кредити</a></p>

7
source/docs_uk.md Normal file
View File

@ -0,0 +1,7 @@
# Читайте інструкцію
Ви можете переглядати повну документацію для Reticulum [на цьому сайті](manual/index.html) або [на GitHub Pages](https://markqvist.github.io/Reticulum/manual/).
Ви також можете [завантажити інструкцію Reticulum у форматі PDF](manual/Reticulum%20Manual.pdf) або в [форматі EPUB](manual/Reticulum%20Manual.epub).
<p align="right"><a href="crypto.html">Наступна тема: Криптографічні примітиви</a></p>

20
source/donate_uk.md Normal file
View File

@ -0,0 +1,20 @@
## Підтримати Reticulum
Ви можете допомогти підтримати подальший розвиток відкритих, безкоштовних та приватних комунікаційних систем, зробивши донат через один із наступних каналів:
- Monero<br/>
```
84FpY1QbxHcgdseePYNmhTHcrgMX4nFfBYtz2GKYToqHVVhJp8Eaw1Z1EedRnKD19b3B8NiLCGVxzKV17UMmmeEsCrPyA5w
```
<br/><br/>
- Ethereum<br/>
```
0xFDabC71AC4c0C78C95aDDDe3B4FA19d6273c5E73
```
<br/><br/>
- Bitcoin<br/>
```
35G9uWVzrpJJibzUwpNUQGQNFzLirhrYAH
```
<br/><br/>
- Ko-Fi<br/>
<a href="https://ko-fi.com/markqvist">`https://ko-fi.com/markqvist`</a>

21
source/hardware_uk.md Normal file
View File

@ -0,0 +1,21 @@
# Підтримуване обладнання
Reticulum можна використовувати практично через будь-який медіум, який підтримує хоча б напівдуплексний канал з пропускною здатністю 500 біт на секунду і MTU 500 байт. Прикладом фізичних пристроїв, через які можна використовувати Reticulum, є радіостанції даних, модеми, LoRa радіостанції, серійні лінії, TNC AX.25, цифрові режими аматорського радіо, WiFi та Ethernet пристрої, оптичні лінії вільного простору та подібні системи. Підтримувані типи інтерфейсів включають:
- Будь-який Ethernet пристрій
- Майже все обладнання на базі WiFi
- LoRa з використанням [RNode](https://unsigned.io/rnode/)
- TNC для пакетного радіо (з або без AX.25)
- Апаратура та програмні модеми сумісні з KISS
- Будь-який пристрій з серійним портом
- TCP через IP мережі
- UDP через IP мережі
- Зовнішні програми через stdio або канали
- Користувацьке обладнання через stdio або канали
Для більш детальної інформації та повного списку підтримуваних типів інтерфейсів, будь ласка, ознайомтесь з розділами [Комунікаційне обладнання](manual/hardware.html) та [Підтримувані інтерфейси](manual/interfaces.html) у посібнику.
Reticulum також може бути інкапсульований через існуючі IP мережі, тому немає жодних обмежень у використанні його через дротовий Ethernet, вашу локальну WiFi мережу або Інтернет, де він працюватиме так само добре. Насправді, однією з переваг Reticulum є те, як легко він дозволяє підключати різні медіуми до самоконфігурованої, стійкої та зашифрованої мережі, використовуючи будь-яку доступну суміш доступної інфраструктури.
Наприклад, можна налаштувати Raspberry Pi, підключений до радіо LoRa, TNC для пакетного радіо та WiFi мережі. Після налаштування інтерфейсів, Reticulum подбає про решту, і будь-який пристрій у WiFi мережі зможе спілкуватися з вузлами в мережі LoRa і пакетного радіо, і навпаки.
<p align="right"><a href="connect.html">Наступна тема: Публічний тестнет</a></p>

27
source/index_uk.md Normal file
View File

@ -0,0 +1,27 @@
# Reticulum
Reticulum — це криптографічна мережна структура для створення локальних і широкомасштабних мереж з використанням доступного апаратного забезпечення. Reticulum може продовжувати працювати навіть за несприятливих умов з дуже високою затримкою і надзвичайно низькою пропускною здатністю.
Місія Reticulum — дозволити кожному створювати власні суверенні комунікаційні мережі та зробити їх дешевими й простими для покриття великих територій безліччю незалежних, взаємопідключених і автономних мереж. Reticulum — це мережі, котрі не зупинити для людей.
<p align="center"><img width="30%" src="gfx/reticulum_logo_512.png"></p>
Reticulum — це не одна мережа. Це інструмент для створення тисяч мереж. Мереж без вимикачів, спостереження, цензури й контролю. Мереж, які можуть вільно взаємодіяти, асоціюватися і роз’єднуватися між собою. Reticulum — це мережі для людей.
З погляду користувача, Reticulum дозволяє створювати додатки, які поважають і зміцнюють автономію та суверенітет громад і осіб. Reticulum забезпечує безпечну цифрову комунікацію, яку не можна піддавати зовнішньому контролю, маніпуляціям або цензурі.
Reticulum дозволяє будувати як малі, так і потенційно планетарні мережі без необхідності в ієрархічних або бюрократичних структурах для їх контролю чи управління, при цьому забезпечуючи повний суверенітет осіб і громад над їхніми власними сегментами мережі.
## Основні характеристики
Хоча Reticulum вирішує ту ж проблему, що й будь-яка інша мережна структура, а саме забезпечити надійний перехід даних з однієї точки в іншу через кілька посередників, він робить це дуже по-іншому порівняно з іншими мережними технологіями.
- Reticulum не використовує адреси джерела. Жоден переданий пакет не містить інформації про адресу, місце, машину чи людину, з якої він надійшов.
- В Reticulum немає центрального контролю над простором адрес. Кожен може виділяти стільки адрес, скільки йому потрібно, коли вони йому потрібні.
- Reticulum забезпечує з’єднання від кінця до кінця. Новостворені адреси стають глобально доступними протягом декількох секунд або хвилин.
- Адреси є самостійними та переносними. Після того, як адреса була створена, її можна фізично перемістити в інше місце в мережі й продовжувати бути доступною.
- Усі комунікації за замовчуванням захищені сильним, сучасним шифруванням.
- Усі ключі шифрування є тимчасовими, а комунікація за замовчуванням забезпечує вперед-секретність.
- У мережах Reticulum неможливо встановити незашифровані з’єднання.
- Неможливо надсилати незашифровані пакети в будь-які пункти призначення в мережі.
- Пункти призначення, які отримують незашифровані пакети, відкидатимуть їх як недійсні.
<p align="right"><a href="start.html">Наступна тема: Розпочати</a></p>

22
source/license_uk.md Normal file
View File

@ -0,0 +1,22 @@
```
MIT Ліцензія
Авторські права (c) 2016-2024 Mark Qvist / unsigned.io
Цим надається безкоштовна ліцензія будь-якій особі, яка отримає копію
цього програмного забезпечення та супутніх документаційних файлів ("Програмне забезпечення"), використовувати
Програмне забезпечення без обмежень, зокрема, але не обмежуючись правами
на використання, копіювання, модифікацію, об'єднання, публікацію, розповсюдження, надання ліцензії, і/або продаж
копій Програмного забезпечення, а також дозволяти особам, яким надається це Програмне забезпечення, робити це, за умови дотримання наступних умов:
Усі копії або суттєві частини цього Програмного забезпечення повинні містити
вище зазначене повідомлення про авторські права та це повідомлення про дозвіл.
ПРОГРАМНЕ ЗАБЕЗПЕЧЕННЯ НАДАЄТЬСЯ "ЯК Є", БЕЗ ЯКОЇ-НЕБУДЬ ГАРАНТІЇ, ВИРАЖЕНОЇ АБО
НЕВИРАЖЕНОЇ, ВКЛЮЧАЮЧИ, АЛЕ НЕ ОБМЕЖУЮЧИСЬ, ГАРАНТІЯМИ ПРОДОВЖУВАННЯ,
ПРИДАТНІСТЬ ДЛЯ ПЕВНОЇ МЕТИ ТА НЕПОРУШЕННЯ ПРАВ. В ЖОДНОМУ ВИПАДКУ
АВТОРИ АБО ВОЛОДІЛІ РОБОТОМ НЕ НЕСУТЬ ВІДПОВІДАЛЬНІСТЬ ЗА ЯКІ-БУДЬ
СКАРГИ, ШКОДИ АБО ІНШІ ЗОБОВ'ЯЗАННЯ, ЯК У РАМКАХ ДОГОВОРУ, ДЕЛІКТУ АБО ІНШОГО, ЩО ВИНИКАЮТЬ З,
АБО У ЗВ'ЯЗКУ З ПРОГРАМНИМ ЗАБЕЗПЕЧЕННЯМ, ЙОГО ВИКОРИСТАННЯМ АБО ІНШИМИ ДІЯМИ У
ПОРОДЖЕННІ ПРОГРАМНОГО ЗАБЕЗПЕЧЕННЯ.
```

66
source/start_uk.md Normal file
View File

@ -0,0 +1,66 @@
# Початок роботи
Найкращий спосіб почати роботу з мережею Reticulum залежить від того, що ви хочете зробити. Для повних деталей та прикладів ознайомтеся з розділом [Швидкий старт](manual/gettingstartedfast.html) в [Посібнику Reticulum](manual/index.html).
## Експериментальне програмне забезпечення
*Будь ласка, майте на увазі!* Reticulum все ще в бета-версії. Це означає, що хоча система вже працює дуже добре та є стабільною, можуть бути критичні помилки або недоліки в поведінці, конфіденційності або безпеці системи в цілому. Використовуйте Reticulum, якщо вам комфортно з цим і ви розумієте наслідки.
## Спільнота та підтримка
Якщо у вас виникли проблеми або щось не працює, ось кілька чудових місць, де можна попросити про допомогу:
- [Форум обговорень](https://github.com/markqvist/Reticulum/discussions) на GitHub
- [Канал Reticulum у Matrix](https://matrix.to/#/#reticulum:matrix.org) на `#reticulum:matrix.org`
- [Subreddit Reticulum](https://reddit.com/r/reticulum)
## Встановлення
Для встановлення Reticulum та супутніх утиліт на вашу систему найпростішим способом є використання pip:
```bash
pip install rns
```
Ви можете запустити будь-яку програму, що використовує Reticulum, або запустити Reticulum як системну службу за допомогою утиліти [rnsd](manual/using.html#the-rnsd-utility).
Якщо `pip` недоступний на вашій системі, спочатку встановіть пакети `python3` та `python3-pip` для вашої ОС.
Під час першого запуску Reticulum створить конфігураційний файл за замовчуванням, який забезпечить базовий зв'язок з іншими одноранговими проєктами Reticulum, які можуть бути доступними локально. Якщо серед них є транспортні екземпляри, вони можуть з'єднати вас з більш широкими мережами. Файл конфігурації містить кілька прикладів та посилань для створення більш складної конфігурації.
Для більш детальних прикладів того, як розширити зв'язок через різні канали, такі як пакетне радіо або LoRa, послідовні порти, або через швидкі IP-з'єднання та Інтернет, використовуючи інтерфейси UDP та TCP, ознайомтесь із розділом [Підтримувані інтерфейси](manual/interfaces.html) в [Посібнику Reticulum](manual/index.html).
## Включені утиліти
Reticulum включає ряд корисних утиліт для керування вашими мережами, перегляду статусу та інформації, а також виконання інших завдань. Більше про ці програми можна дізнатися в розділі [Включені утилітні програми](manual/using.html#included-utility-programs) в [Посібнику Reticulum](manual/index.html).
- Системний демон `rnsd` для запуску Reticulum як завжди доступної служби
- Утиліта для перегляду статусу інтерфейсів під назвою `rnstatus`, яка виводить інформацію про інтерфейси
- Інструмент для перегляду та керування таблицями шляхів `rnpath`
- Діагностична утиліта під назвою `rnprobe` для перевірки з'єднання з пунктами призначення
- Простий файл-переносник `rncp`, який дозволяє легко копіювати файли на віддалені системи
- Утиліта для віддаленого виконання команд `rnx`, яка дозволяє запускати команди та програми на віддалених системах і отримувати виведення
Усі інструменти, включаючи `rnx` та `rncp`, працюють надійно навіть через дуже низькошвидкісні з'єднання, такі як LoRa або пакетне радіо.
## Програми, що використовують Reticulum
Якщо ви хочете швидко зрозуміти, що може зробити Reticulum, ознайомтесь з наступними ресурсами.
- Для оффлайн, зашифрованої та стійкої мережевої платформи, дивіться [Nomad Network](https://github.com/markqvist/NomadNet)
- Мобільний додаток для Android, Linux та macOS [Sideband](https://github.com/markqvist/sideband) має графічний інтерфейс і зосереджений на зручності використання.
- [LXMF](https://github.com/markqvist/lxmf) — це розподілений, стійкий до затримок і переривань протокол передачі повідомлень, побудований на Reticulum.
## Залежності
Встановлення за замовчуванням пакету `rns` потребує таких залежностей. Більшість систем та дистрибутивів мають доступні пакети для цих залежностей, і коли пакет `rns` встановлюється через `pip`, вони також будуть завантажені та встановлені.
- [PyCA/cryptography](https://github.com/pyca/cryptography)
- [netifaces](https://github.com/al45tair/netifaces)
- [pyserial](https://github.com/pyserial/pyserial)
На менш звичайних системах, а також у рідкісних випадках, може бути неможливо встановити або навіть скомпілювати один або кілька з вищезгаданих модулів. У таких ситуаціях ви можете використати пакет `rnspure` замість цього, який не потребує зовнішніх залежностей для встановлення. Зверніть увагу, що вміст пакетів `rns` та `rnspure` *ідентичний*. Єдина різниця в тому, що пакет `rnspure` не має списку залежностей, необхідних для встановлення.
Не залежно від того, як Reticulum було встановлено і запущено, воно завантажить зовнішні залежності тільки якщо вони *необхідні* і *доступні*. Якщо, наприклад, ви хочете використовувати Reticulum на системі, яка не підтримує [pyserial](https://github.com/pyserial/pyserial), це цілком можливо зробити, використовуючи пакет `rnspure`, але Reticulum не зможе використовувати інтерфейси, що базуються на серійному з'єднанні. Усі інші доступні модулі будуть завантажені, коли це буде потрібно.
**Зверніть увагу!** Якщо ви використовуєте пакет `rnspure` для запуску Reticulum на системах, які не підтримують [PyCA/cryptography](https://github.com/pyca/cryptography), важливо, щоб ви прочитали і зрозуміли розділ [Криптографічні примітиви](crypto.html) на цьому сайті.
## Продуктивність
Reticulum орієнтовано на дуже широкий діапазон використаної продуктивності, але при цьому надається пріоритет функціональності та продуктивності над низькошвидкісними середовищами. Метою є забезпечення динамічного діапазону продуктивності від 250 біт на секунду до 1 гігабіта на секунду на звичайному обладнанні.
Наразі використаний діапазон продуктивності становить приблизно від 150 біт на секунду до 40 мегабіт на секунду, при цьому фізичні середовища, що перевищують цей рівень, не насичуються. Продуктивність, що перевищує поточний рівень, планується для майбутніх оновлень, але не є головним пріоритетом, поки не буде зафіксовано формат передачі та API.
<p align="right"><a href="hardware.html">Наступна тема: Підтримуване обладнання</a></p>