diff --git a/docs/connect_uk.html b/docs/connect_uk.html new file mode 100644 index 0000000..64eeb80 --- /dev/null +++ b/docs/connect_uk.html @@ -0,0 +1,184 @@ + + + +
+ + +Якщо ви просто хочете почати експериментувати без створення фізичних мереж, ви можете приєднатися до публічного тестнету 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, до якого ваші пристрої зможуть підключатися локально, а потім з’єднаєте цей транспортний вузол з кількома публічними точками входу. Це забезпечить ефективні з’єднання та надійність у випадку, якщо одна з точок входу вийде з ладу.
+# These are community-provided public Reticulum entrypoints
+# served over TCP, and available over the public Internet.
+
+ [[Sydney RNS]]
+ type = TCPClientInterface
+ enabled = true
+ target_host = sydney.reticulum.au
+ target_port = 4242
+
+ [[dismails TCP Interface]]
+ type = TCPClientInterface
+ interface_enabled = true
+ target_host = rns.dismail.de
+ target_port = 7822
+
+ [[interloper node]]
+ type = TCPClientInterface
+ interface_enabled = true
+ target_host = intr.cx
+ target_port = 4242
+
+ [[The Outpost]]
+ type = TCPClientInterface
+ interface_enabled = true
+ target_host = theoutpost.life
+ target_port = 4242
+
+ [[Beleth RNS Hub]]
+ type = TCPClientInterface
+ interface_enabled = true
+ target_host = rns.beleth.net
+ target_port = 4242
+
+ [[Rocket Tech Hub]]
+ type = TCPClientInterface
+ enabled = yes
+ target_host = reticulum.rocket-tech.net
+ target_port = 443
+
+ [[SparkN0de]]
+ type = TCPClientInterface
+ interface_enabled = true
+ target_host = aspark.uber.space
+ target_port = 44860
+
+ [[Tidudanka.com]]
+ type = TCPClientInterface
+ enabled = yes
+ target_host = reticulum.tidudanka.com
+ target_port = 37500
+
+ [[quad4net tcp]]
+ type = TCPClientInterface
+ enabled = yes
+ target_host = rns.quad4.io
+ target_port = 4242
+
+ [[nisa-node]]
+ type = TCPClientInterface
+ enabled = yes
+ target_host = nisa.cat
+ target_port = 4242
+
+ [[acehoss]]
+ type = TCPClientInterface
+ enabled = yes
+ target_host = rns.acehoss.net
+ target_port = 4242
+
+ [[RNS Testnet StoppedCold]]
+ type = TCPClientInterface
+ enabled = yes
+ target_host = rns.stoppedcold.com
+ target_port = 4242
+
+ [[RNS COMSEC-RD]]
+ type = TCPClientInterface
+ enabled = yes
+ target_host = 80.78.23.249
+ target_port = 4242
+
+ [[R-Net TCP]]
+ type = TCPClientInterface
+ enabled = yes
+ target_host = istanbul.reserve.network
+ target_port = 9034
+
+ [[RNS TCP Node Germany 001]]
+ type = TCPClientInterface
+ enabled = true
+ target_host = 202.61.243.41
+ target_port = 4965
+
+ [[RNS TCP Node Germany 002]]
+ type = TCPClientInterface
+ enabled = true
+ target_host = 193.26.158.230
+ target_port = 4965
+
+ [[Quortal TCP Node]]
+ type = TCPClientInterface
+ enabled = true
+ target_host = reticulum.qortal.link
+ target_port = 4242
+
+ [[mobilefabrik TCP]]
+ type = TCPClientInterface
+ enabled = true
+ target_host = phantom.mobilefabrik.com
+ target_port = 4242
+
+ [[g00n.cloud Hub]]
+ type = TCPClientInterface
+ enabled = true
+ target_host = dfw.us.g00n.cloud
+ target_port = 6969
+
+ [[RNS_Transport_US-East]]
+ type = TCPClientInterface
+ interface_enabled = true
+ target_host = 45.77.109.86
+ target_port = 4965
+
+ [[rothbard_RNS_transport_ZA]]
+ type = TCPClientInterface
+ enabled = true
+ target_host = rothbard.lab.networks.deavmi.assigned.network
+ target_port = 4242
+
+ [[rothbard_RNS_transport_ZA_ygg]]
+ type = TCPClientInterface
+ enabled = true
+ target_host = 200:73eb:2e4:14be:aac7:90b3:784b:71a3
+ target_port = 4242
+
+ [[rothbard_RNS_transport_ZA_i2p]]
+ type = I2PInterface
+ enabled = true
+ peers = guuahj7pyb6ksmjv2bqrjg4cs2wou6cor3ivsi6crntqbzsxnbna.b32.i2p
+
+
+
+
diff --git a/docs/credits_uk.html b/docs/credits_uk.html
new file mode 100644
index 0000000..b280561
--- /dev/null
+++ b/docs/credits_uk.html
@@ -0,0 +1,35 @@
+
+
+
+
+
+
+Reticulum може існувати тільки завдяки великій кількості відкритого програмного забезпечення, на якому він був побудований, внескам всіх, хто брав участь, і всім, хто підтримував проєкт протягом багатьох років. Усім, хто допомагав, велике спасибі.
+Чимало інших модулів та проєктів є частинами або використовуються Reticulum. Щира подяка авторам і контриб'юторам наступних проєктів:
+Проєктування протоколу та його референс-імплементація для Reticulum здійснювались з 2014 по 2022 рік Маркусом Квістом.
+Python референс-імплементація Reticulum та цей вебсайт ліцензовані за умовами Reticulum License. Будь ласка, пожертвуйте, щоб підтримати подальший розвиток.
+Reticulum використовує простий набір ефективних, надійних і сучасних криптографічних примітивів, з широко доступними імплементаціями, які можна використовувати як на загальновживаних процесорах, так і на мікроконтролерах. Необхідні примітиви:
+У стандартній конфігурації установки примітиви X25519
, Ed25519
і AES-128-CBC
надаються OpenSSL (через пакет PyCA/cryptography). Функції хешування SHA-256
і SHA-512
надаються стандартною бібліотекою Python hashlib. Примітиви HKDF
, HMAC
, Fernet
, а також функція паддінгу PKCS7
завжди надаються наступними внутрішніми імплементаціями:
Reticulum також включає повну імплементацію всіх необхідних примітивів на чистому Python. Якщо OpenSSL і PyCA недоступні на системі під час запуску Reticulum, то замість них будуть використані внутрішні чисто-python примітиви. Легким наслідком цього є продуктивність, причому бекенд OpenSSL працює набагато швидше. Однак найважливіший наслідок полягає в потенційній втраті безпеки через використання примітивів, які не були піддані такій самій перевірці, тестуванню та огляду, як ті, що надаються OpenSSL.
+Якщо ви хочете використовувати внутрішні чисто-python примітиви, вкрай рекомендується добре розуміти ризики, які вони несуть, і приймати обґрунтоване рішення щодо того, чи є ці ризики для вас прийнятними.
+Reticulum — це відносно молода програма, і її слід розглядати саме як таку. Хоча вона була створена з урахуванням найкращих практик криптографії, вона не проходила зовнішнього аудиту безпеки, і цілком ймовірно, що існують помилки, які можуть зламати конфіденційність або безпеку. Якщо ви хочете допомогти або спонсорувати аудит, будь ласка, зв'яжіться з нами.
+Наступна тема: Подяки та кредити
+ + diff --git a/docs/docs_uk.html b/docs/docs_uk.html new file mode 100644 index 0000000..34bdd23 --- /dev/null +++ b/docs/docs_uk.html @@ -0,0 +1,17 @@ + + + + + + +Ви можете переглядати повну документацію для Reticulum на цьому сайті або на GitHub Pages.
+Ви також можете завантажити інструкцію Reticulum у форматі PDF або в форматі EPUB.
+Наступна тема: Криптографічні примітиви
+ + diff --git a/docs/donate_uk.html b/docs/donate_uk.html new file mode 100644 index 0000000..48ad48e --- /dev/null +++ b/docs/donate_uk.html @@ -0,0 +1,28 @@ + + + + + + +Ви можете допомогти підтримати подальший розвиток відкритих, безкоштовних та приватних комунікаційних систем, зробивши донат через один із наступних каналів:
+84FpY1QbxHcgdseePYNmhTHcrgMX4nFfBYtz2GKYToqHVVhJp8Eaw1Z1EedRnKD19b3B8NiLCGVxzKV17UMmmeEsCrPyA5w
+ 0xFDabC71AC4c0C78C95aDDDe3B4FA19d6273c5E73
+ 35G9uWVzrpJJibzUwpNUQGQNFzLirhrYAH
+ https://ko-fi.com/markqvist
Reticulum можна використовувати практично через будь-який медіум, який підтримує хоча б напівдуплексний канал з пропускною здатністю 500 біт на секунду і MTU 500 байт. Прикладом фізичних пристроїв, через які можна використовувати Reticulum, є радіостанції даних, модеми, LoRa радіостанції, серійні лінії, TNC AX.25, цифрові режими аматорського радіо, WiFi та Ethernet пристрої, оптичні лінії вільного простору та подібні системи. Підтримувані типи інтерфейсів включають:
+Для більш детальної інформації та повного списку підтримуваних типів інтерфейсів, будь ласка, ознайомтесь з розділами Комунікаційне обладнання та Підтримувані інтерфейси у посібнику.
+Reticulum також може бути інкапсульований через існуючі IP мережі, тому немає жодних обмежень у використанні його через дротовий Ethernet, вашу локальну WiFi мережу або Інтернет, де він працюватиме так само добре. Насправді, однією з переваг Reticulum є те, як легко він дозволяє підключати різні медіуми до самоконфігурованої, стійкої та зашифрованої мережі, використовуючи будь-яку доступну суміш доступної інфраструктури.
+Наприклад, можна налаштувати Raspberry Pi, підключений до радіо LoRa, TNC для пакетного радіо та WiFi мережі. Після налаштування інтерфейсів, Reticulum подбає про решту, і будь-який пристрій у WiFi мережі зможе спілкуватися з вузлами в мережі LoRa і пакетного радіо, і навпаки.
+Наступна тема: Публічний тестнет
+ + diff --git a/docs/index_uk.html b/docs/index_uk.html new file mode 100644 index 0000000..bea370f --- /dev/null +++ b/docs/index_uk.html @@ -0,0 +1,35 @@ + + + + + + +Reticulum — це криптографічна мережна структура для створення локальних і широкомасштабних мереж з використанням доступного апаратного забезпечення. Reticulum може продовжувати працювати навіть за несприятливих умов з дуже високою затримкою і надзвичайно низькою пропускною здатністю.
+Місія Reticulum — дозволити кожному створювати власні суверенні комунікаційні мережі та зробити їх дешевими й простими для покриття великих територій безліччю незалежних, взаємопідключених і автономних мереж. Reticulum — це мережі, котрі не зупинити для людей.
+Reticulum — це не одна мережа. Це інструмент для створення тисяч мереж. Мереж без вимикачів, спостереження, цензури й контролю. Мереж, які можуть вільно взаємодіяти, асоціюватися і роз’єднуватися між собою. Reticulum — це мережі для людей.
+З погляду користувача, Reticulum дозволяє створювати додатки, які поважають і зміцнюють автономію та суверенітет громад і осіб. Reticulum забезпечує безпечну цифрову комунікацію, яку не можна піддавати зовнішньому контролю, маніпуляціям або цензурі.
+Reticulum дозволяє будувати як малі, так і потенційно планетарні мережі без необхідності в ієрархічних або бюрократичних структурах для їх контролю чи управління, при цьому забезпечуючи повний суверенітет осіб і громад над їхніми власними сегментами мережі.
+Хоча Reticulum вирішує ту ж проблему, що й будь-яка інша мережна структура, а саме забезпечити надійний перехід даних з однієї точки в іншу через кілька посередників, він робить це дуже по-іншому порівняно з іншими мережними технологіями.
+MIT Ліцензія
+
+Авторські права (c) 2016-2024 Mark Qvist / unsigned.io
+
+Цим надається безкоштовна ліцензія будь-якій особі, яка отримає копію
+цього програмного забезпечення та супутніх документаційних файлів ("Програмне забезпечення"), використовувати
+Програмне забезпечення без обмежень, зокрема, але не обмежуючись правами
+на використання, копіювання, модифікацію, об'єднання, публікацію, розповсюдження, надання ліцензії, і/або продаж
+копій Програмного забезпечення, а також дозволяти особам, яким надається це Програмне забезпечення, робити це, за умови дотримання наступних умов:
+
+Усі копії або суттєві частини цього Програмного забезпечення повинні містити
+вище зазначене повідомлення про авторські права та це повідомлення про дозвіл.
+
+ПРОГРАМНЕ ЗАБЕЗПЕЧЕННЯ НАДАЄТЬСЯ "ЯК Є", БЕЗ ЯКОЇ-НЕБУДЬ ГАРАНТІЇ, ВИРАЖЕНОЇ АБО
+НЕВИРАЖЕНОЇ, ВКЛЮЧАЮЧИ, АЛЕ НЕ ОБМЕЖУЮЧИСЬ, ГАРАНТІЯМИ ПРОДОВЖУВАННЯ,
+ПРИДАТНІСТЬ ДЛЯ ПЕВНОЇ МЕТИ ТА НЕПОРУШЕННЯ ПРАВ. В ЖОДНОМУ ВИПАДКУ
+АВТОРИ АБО ВОЛОДІЛІ РОБОТОМ НЕ НЕСУТЬ ВІДПОВІДАЛЬНІСТЬ ЗА ЯКІ-БУДЬ
+СКАРГИ, ШКОДИ АБО ІНШІ ЗОБОВ'ЯЗАННЯ, ЯК У РАМКАХ ДОГОВОРУ, ДЕЛІКТУ АБО ІНШОГО, ЩО ВИНИКАЮТЬ З,
+АБО У ЗВ'ЯЗКУ З ПРОГРАМНИМ ЗАБЕЗПЕЧЕННЯМ, ЙОГО ВИКОРИСТАННЯМ АБО ІНШИМИ ДІЯМИ У
+ПОРОДЖЕННІ ПРОГРАМНОГО ЗАБЕЗПЕЧЕННЯ.
+
+
+
diff --git a/docs/manual/_images/board_opencomxl.png b/docs/manual/_images/board_opencomxl.png
new file mode 100644
index 0000000..c3b78bd
Binary files /dev/null and b/docs/manual/_images/board_opencomxl.png differ
diff --git a/docs/manual/_images/board_t114.png b/docs/manual/_images/board_t114.png
new file mode 100644
index 0000000..ba7cbdc
Binary files /dev/null and b/docs/manual/_images/board_t114.png differ
diff --git a/docs/manual/_images/board_techo.png b/docs/manual/_images/board_techo.png
new file mode 100644
index 0000000..3958628
Binary files /dev/null and b/docs/manual/_images/board_techo.png differ
diff --git a/docs/start_uk.html b/docs/start_uk.html
new file mode 100644
index 0000000..5e4f858
--- /dev/null
+++ b/docs/start_uk.html
@@ -0,0 +1,64 @@
+
+
+
+
+
+
+Найкращий спосіб почати роботу з мережею Reticulum залежить від того, що ви хочете зробити. Для повних деталей та прикладів ознайомтеся з розділом Швидкий старт в Посібнику Reticulum.
+Будь ласка, майте на увазі! Reticulum все ще в бета-версії. Це означає, що хоча система вже працює дуже добре та є стабільною, можуть бути критичні помилки або недоліки в поведінці, конфіденційності або безпеці системи в цілому. Використовуйте Reticulum, якщо вам комфортно з цим і ви розумієте наслідки.
+Якщо у вас виникли проблеми або щось не працює, ось кілька чудових місць, де можна попросити про допомогу:
+#reticulum:matrix.org
Для встановлення Reticulum та супутніх утиліт на вашу систему найпростішим способом є використання pip:
+pip install rns
+
+Ви можете запустити будь-яку програму, що використовує Reticulum, або запустити Reticulum як системну службу за допомогою утиліти rnsd.
+Якщо pip
недоступний на вашій системі, спочатку встановіть пакети python3
та python3-pip
для вашої ОС.
Під час першого запуску Reticulum створить конфігураційний файл за замовчуванням, який забезпечить базовий зв'язок з іншими одноранговими проєктами Reticulum, які можуть бути доступними локально. Якщо серед них є транспортні екземпляри, вони можуть з'єднати вас з більш широкими мережами. Файл конфігурації містить кілька прикладів та посилань для створення більш складної конфігурації.
+Для більш детальних прикладів того, як розширити зв'язок через різні канали, такі як пакетне радіо або LoRa, послідовні порти, або через швидкі IP-з'єднання та Інтернет, використовуючи інтерфейси UDP та TCP, ознайомтесь із розділом Підтримувані інтерфейси в Посібнику Reticulum.
+Reticulum включає ряд корисних утиліт для керування вашими мережами, перегляду статусу та інформації, а також виконання інших завдань. Більше про ці програми можна дізнатися в розділі Включені утилітні програми в Посібнику Reticulum.
+rnsd
для запуску Reticulum як завжди доступної службиrnstatus
, яка виводить інформацію про інтерфейсиrnpath
rnprobe
для перевірки з'єднання з пунктами призначенняrncp
, який дозволяє легко копіювати файли на віддалені системиrnx
, яка дозволяє запускати команди та програми на віддалених системах і отримувати виведенняУсі інструменти, включаючи rnx
та rncp
, працюють надійно навіть через дуже низькошвидкісні з'єднання, такі як LoRa або пакетне радіо.
Якщо ви хочете швидко зрозуміти, що може зробити Reticulum, ознайомтесь з наступними ресурсами.
+Встановлення за замовчуванням пакету rns
потребує таких залежностей. Більшість систем та дистрибутивів мають доступні пакети для цих залежностей, і коли пакет rns
встановлюється через pip
, вони також будуть завантажені та встановлені.
На менш звичайних системах, а також у рідкісних випадках, може бути неможливо встановити або навіть скомпілювати один або кілька з вищезгаданих модулів. У таких ситуаціях ви можете використати пакет rnspure
замість цього, який не потребує зовнішніх залежностей для встановлення. Зверніть увагу, що вміст пакетів rns
та rnspure
ідентичний. Єдина різниця в тому, що пакет rnspure
не має списку залежностей, необхідних для встановлення.
Не залежно від того, як Reticulum було встановлено і запущено, воно завантажить зовнішні залежності тільки якщо вони необхідні і доступні. Якщо, наприклад, ви хочете використовувати Reticulum на системі, яка не підтримує pyserial, це цілком можливо зробити, використовуючи пакет rnspure
, але Reticulum не зможе використовувати інтерфейси, що базуються на серійному з'єднанні. Усі інші доступні модулі будуть завантажені, коли це буде потрібно.
Зверніть увагу! Якщо ви використовуєте пакет rnspure
для запуску Reticulum на системах, які не підтримують PyCA/cryptography, важливо, щоб ви прочитали і зрозуміли розділ Криптографічні примітиви на цьому сайті.
Reticulum орієнтовано на дуже широкий діапазон використаної продуктивності, але при цьому надається пріоритет функціональності та продуктивності над низькошвидкісними середовищами. Метою є забезпечення динамічного діапазону продуктивності від 250 біт на секунду до 1 гігабіта на секунду на звичайному обладнанні.
+Наразі використаний діапазон продуктивності становить приблизно від 150 біт на секунду до 40 мегабіт на секунду, при цьому фізичні середовища, що перевищують цей рівень, не насичуються. Продуктивність, що перевищує поточний рівень, планується для майбутніх оновлень, але не є головним пріоритетом, поки не буде зафіксовано формат передачі та API.
+ + +