Перейти к содержанию

rncp

rncp — утилита для передачи файлов через сеть Reticulum. Позволяет легко копировать файлы между системами, подключёнными к сети Reticulum.


Примеры использования

Запуск в режиме прослушивания с указанием разрешённых Identity:

$ rncp --listen -a 1726dbad538775b5bf9b0ea25a4079c8 -a c50cc4e4f7838b6c31f60ab9032cbc62

Запуск в режиме прослушивания с использованием файла разрешённых Identity:

Файл ~/.rncp/allowed_identities должен содержать хеши Identity (по одному на строку):

$ rncp --listen

Отправка файла на удалённую систему:

$ rncp ~/path/to/file.tgz 73cbd378bb0286ed11a707c13447bb1e

Получение файла с удалённой системы:

$ rncp --fetch ~/path/to/file.tgz 73cbd378bb0286ed11a707c13447bb1e

Использование альтернативного файла Identity:

По умолчанию файл Identity хранится в ~/.reticulum/identities/rncp:

$ rncp ~/path/to/file.tgz 73cbd378bb0286ed11a707c13447bb1e -i /path/to/identity

Все опции командной строки (переведены для понимания)

usage: rncp [-h] [--config path] [-v] [-q] [-S] [-l] [-F] [-f]
            [-j path] [-b seconds] [-a allowed_hash] [-n] [-p]
            [-i identity] [-w seconds] [--version] [file] [destination]

Утилита передачи файлов Reticulum

Позиционные аргументы:
  file                  файл для передачи
  destination           шестнадцатеричный хеш получателя

Опции:
  -h, --help            показать это сообщение и выйти
  --config path         путь к альтернативной директории конфигурации Reticulum
  -v, --verbose         увеличить подробность вывода
  -q, --quiet           уменьшить подробность вывода
  -S, --silent          отключить вывод прогресса передачи
  -l, --listen          прослушивать входящие запросы на передачу
  -C, --no-compress     отключить автоматическое сжатие
  -F, --allow-fetch     разрешить аутентифицированным клиентам получать файлы
  -f, --fetch           получить файл от удалённого слушателя вместо отправки
  -j, --jail path       ограничить запросы на получение указанным путём
  -s, --save path       сохранять полученные файлы в указанной директории
  -O, --overwrite       разрешить перезапись полученных файлов вместо добавления постфикса
  -b seconds            интервал анонсов, 0 только для анонса при запуске
  -a allowed_hash       разрешить эту Identity (или добавить в ~/.rncp/allowed_identities)
  -n, --no-auth         принимать запросы от кого угодно
  -p, --print-identity  вывести информацию об Identity и назначении и выйти
  -i identity           путь к используемому файлу Identity
  -w seconds            таймаут отправителя перед отказом
  -P, --phy-rates       отображать скорости передачи физического уровня
  --version             показать номер версии программы и выйти

Расположение файлов

  • Файл Identity по умолчанию: ~/.reticulum/identities/rncp
  • Файл разрешённых Identity: ~/.rncp/allowed_identities
  • Директория конфигурации Reticulum: ~/.reticulum/ (или указывается через --config)

Типичные сценарии использования

1. Настройка сервера для приёма файлов

# Запуск в режиме прослушивания с разрешением конкретных Identity
$ rncp --listen -a <hash1> -a <hash2>

# Или с файлом разрешённых Identity
$ rncp --listen

2. Отправка файла

$ rncp /path/to/file <destination_hash>

3. Получение файла с удалённой системы

$ rncp --fetch /remote/path/file <destination_hash>

4. Безопасная передача с ограничением доступа

# На принимающей стороне:
$ rncp --listen -a <trusted_identity_hash>

# На отправляющей стороне:
$ rncp file.tgz <destination_hash> -i /path/to/trusted_identity

См. также

  • Основы RNS — введение в протокол Reticulum
  • Утилиты RNS — обзор всех утилит командной строки
  • rnid — управление идентичностями и шифрование файлов
  • rnx — удалённое выполнение команд