Skip to content

Latest commit

 

History

History
171 lines (119 loc) · 19 KB

USER_GUIDE.md

File metadata and controls

171 lines (119 loc) · 19 KB

NetDrop - Руководство пользователя

Файлы летают напрямую. Без серверов, без аккаунтов, без "загрузите файл в облако и пришлите ссылку".

"Интернет задумывался как сеть равных, а не как десять серверов, к которым подключены все остальные."

  • по мотивам Тима Бернерса-Ли

1. Что это за приложение

NetDrop - это программа для мгновенной передачи файлов и папок напрямую между устройствами: с компьютера на телефон, с телефона на компьютер, с ноутбука друга на ваш ПК - в любой точке мира.

Представьте, что вы протянули невидимый провод между двумя устройствами. Всё, что вы отправляете, идёт по этому проводу - и никогда не ложится на чужой сервер. Никто по пути не может файл прочитать, сохранить себе "на всякий случай" или показать вам рекламу дрели, потому что вы переслали фото дрели.

Работает на Windows, Linux, macOS и Android. Внутри - Rust, протокол QUIC и P2P-сеть iroh: те же технологии, на которых строится современный "прямой" интернет.

Как выглядит передача глазами пользователя:

  1. Отправитель выбирает файл -> появляется короткий тикет и QR-код.
  2. Получатель сканирует QR (или вставляет тикет) -> видит, что ему предлагают, и жмёт "Принять".
  3. Файл летит напрямую. Всё.

А для своих устройств можно вообще убрать шаги 1–2 - см. "Доверенные устройства".


2. Какие проблемы решает

Знакомая боль Как её лечит NetDrop
"Скинь фотки" -> полчаса возни с кабелем, который вечно не тот QR-код -> файлы уже на компьютере
Мессенджер сжал видео в кашу 480p Файлы передаются байт в байт, без пережатия
"Файл больше 2 ГБ, загрузите на облако" Ограничений размера нет - хоть 200 ГБ образ диска
Облако = ваши файлы на чужом компьютере Файлы не покидают ваши устройства
Оборвалась связь на 90% - качай заново Докачка: передача продолжится с места обрыва
AirDrop не дружит с Windows и Android NetDrop дружит со всеми
"Отправь себе на почту" (классика!) Телефон сам отдаёт файл домашнему ПК - даже с улицы

И главная, невидимая проблема: приватность. Каждый файл, прошедший через центральный сервер, - это файл, который потенциально прочитан, проиндексирован и сохранён. NetDrop решает её радикально: сервера просто нет.

"Аргумент <мне нечего скрывать> - это как сказать <мне нечего сказать>, отказываясь от свободы слова."

  • Эдвард Сноуден

3. Чем NetDrop отличается от других

Централизованные сервисы - это почта с сортировочным центром: ваша посылка сначала едет на склад компании, там её взвешивают, сканируют, хранят, а потом (может быть) везут адресату. NetDrop - это когда вы передаёте посылку из рук в руки, а если руки не дотягиваются - через шифрованную трубу, в которую даже сам трубопроводчик заглянуть не может.

NetDrop AirDrop Telegram/WhatsApp Google Drive / облака USB-флешка
Прямая передача P2P ✅ ✅ (только рядом) ❌ ❌ ✅ (ножками)
Работает через интернет (разные сети) ✅ ❌ ✅ ✅ ❌
Windows + Linux + macOS + Android ✅ ❌ только Apple ✅ ✅ ✅
Файл хранится на чужом сервере ❌ никогда ❌ ✅ ✅ ❌
Сквозное шифрование ✅ X25519 + ChaCha20 ✅ частично ❌ 🤷
Лимит размера нет нет 2–4 ГБ платные тарифы размер флешки
Пережатие фото/видео нет нет да нет нет
Докачка после обрыва ✅ ❌ частично ✅ -
Нужен аккаунт / регистрация нет Apple ID телефон Google-аккаунт нет
Сжатие на лету ✅ ZSTD ❌ ❌ ❌ ❌
Открытый исходный код ✅ ❌ частично ❌ 😄

Ключевое отличие даже от других P2P-дропов (Snapdrop, LocalSend): они работают только в одной локальной сети. NetDrop благодаря сети iroh соединяет устройства через любые сети и NAT: пробивает прямой канал (hole punching, IPv4 и IPv6), а если провайдер совсем суров - прозрачно проходит через шифрованное реле, которое видит только поток случайных байтов.


4. Все возможности и сценарии использования

🎫 Тикеты - передача любому человеку

Выбрали файлы -> мгновенно получили тикет nd1... и QR. Тикет - это "адрес + ключ" в одной строке: перешлите его любым способом (покажите QR, продиктуйте, киньте в чат). Тикет одноразовый - после передачи он бесполезен, как использованный билет в кино.

Пример: сосед просит свадебное видео 8 ГБ. Показываете ему QR на экране - через несколько минут видео у него, в оригинальном качестве.

👥 Мульти-получатели

Включите в настройках - и один тикет смогут использовать сразу несколько человек, каждый качает параллельно, у каждого своя строка прогресса. Тикет живёт, пока вы его не отмените.

Пример: раздать материалы всей учебной группе - один QR на проекторе.

🤝 Доверенные устройства - магия для своих

Один раз сопрягите телефон и компьютер (QR из настроек), включите на ПК "Всегда принимать" - и дальше:

Вы гуляете по городу, сфотографировали что-то важное -> "Поделиться" -> NetDrop -> "--> Desktop-Home" -> домашний компьютер уже принял фото и записал на диск. Вы ещё улицу не перешли.

  • Работает из любой сети: мобильный интернет, кафе, другая страна.
  • Если второе устройство сейчас офлайн - файл можно оставить в его облачном ящике (см. "Почта доверенных"), и оно заберёт его само позже.
  • Симметрично: и ПК может слушать, и телефон.
  • В списке устройств видно, кто сейчас онлайн (зелёная точка).
  • Постоянный ID устройства используется только для своих; для разовых тикетов - одноразовые ключи (вас нельзя отследить).

📱 Android как первоклассный гражданин

  • "Поделиться" из галереи и любого приложения прямо в NetDrop.
  • Сканер QR камерой - тикеты и коды сопряжения.
  • Принятые файлы попадают в Download/netdrop - видны в проводнике и галерее.
  • Кнопка "Поделиться" у принятого файла - сразу переслать дальше.
  • Компактный интерфейс с нижней навигацией.

🔐 Безопасность без кнопки "Согласен со всем"

  • Сквозное шифрование: X25519 (обмен ключами) + ChaCha20-Poly1305 (поток).
  • Perfect Forward Secrecy: ключи одноразовые - даже если завтра кто-то украдёт устройство, вчерашние передачи не расшифровать.
  • Отпечаток сессии показывается обеим сторонам - можно сверить вслух, как пароль из шпионских фильмов.
  • Получатель всегда видит, что ему шлют, до того как принять (кроме доверенных, где вы сами включили автоприём).

🚀 Скорость и надёжность

  • ZSTD-сжатие на лету: документы и код летят в разы быстрее.
  • Умный размер чанков под размер файла.
  • Докачка прерванных передач с места обрыва.
  • Папки любой вложенности - одним тикетом.
  • Ограничение скорости, если не хотите занимать весь канал.

🖥️ Мелочи, которые приятно

Тёмная/светлая тема, трей и автозапуск ("ПК всегда готов принять"), история передач с "отправить снова", два языка (RU/EN), системные уведомления, вибро-отклик на телефоне, CLI-версия для терминала и скриптов.

☁️ Crypto Cloud - когда напрямую совсем никак

Иногда прямой канал не пробить: очень строгий рабочий файрвол, "серый" мобильный интернет, или вы с приятелем просто не в сети одновременно. Для таких случаев есть Crypto Cloud - запасной путь через ваш собственный облачный диск (Яндекс.Диск, Google Drive или Облако Mail.ru).

Ключевая мысль: облако используется как тупой транзитный ящик, а не как хранилище ваших файлов. Перед отправкой файл дробится на куски и каждый кусок шифруется прямо у вас на устройстве. В облако попадает только шифр-мусор. Ключ расшифровки живёт исключительно внутри тикета ndc1…, который вы передаёте получателю. Сам провайдер диска видит набор бессмысленных байтов - открыть их нельзя.

  • Получателю не нужен аккаунт и даже своё облако (для Яндекса и Google): он просто вставляет тикет или переходит по ссылке netdrop://… - и файл собирается у него на устройстве.
  • Прервалась закачка на 70% - продолжится с места обрыва.
  • Отправленное видно в списке "в облаке": одной кнопкой можно стереть с диска (освободить место - и тикет сразу перестаёт работать).

Как включить: 8 быстрых нажатий на логотип "netdrop" - откроется скрытая вкладка Cloud. Подключаете свой диск один раз (вход в аккаунт) - и дальше отправляете как обычно, только через облако.

На Android вход в Яндекс идёт через обычный браузер: приложение откроет страницу входа, после входа Яндекс покажет код подтверждения - скопируйте его и вставьте в поле на вкладке Cloud. Google подключается через браузер автоматически, без кода.

📮 Почта доверенных - "оставь, заберут сами"

Магия для своих устройств поверх Crypto Cloud: можно положить файл в облачный ящик доверенного устройства - и оно само его заберёт, когда выйдет в сеть. Отправитель к этому моменту может быть уже офлайн.

Пример: скидываете рабочему ноутбуку большой архив на ночь. Ноутбук выключен? Неважно - утром он проснётся, сам увидит посылку, скачает её и "отпишется" о получении. После этого файл автоматически сотрётся из облака, не занимая место.

  • Ящик настраивается автоматически: устройства обмениваются ключом ящика по защищённому каналу (или через QR сопряжения) - вам ничего вводить не надо.
  • Всё та же криптосхема: в облаке лежит только шифр, ключ есть лишь у пары ваших устройств.
  • Получатель проверяет почту сам (по таймеру или кнопкой), скачивает с докачкой и подтверждает приём; отправитель по подтверждению убирает посылку из облака.
  • На вкладке Cloud виден индикатор: сколько посылок "в пути" и когда была последняя проверка.

5. Почему это круто

Потому что NetDrop возвращает простую идею: ваши файлы - это ваши файлы.

  • Нет сервера - нет проблемы. Нечего взламывать, нечего сливать, нечему "упасть в 3 часа ночи". Пока живы два устройства и хоть какой-то интернет - передача пройдёт.
  • Нет аккаунта - нет слежки. Вы не логин, не email и не "пользователь №48293". Вы просто отправили файл.
  • Нет посредника - нет цензуры и лимитов. Никто не решает за вас, какой файл "слишком большой", "неправильного формата" или "нарушает условия использования, пункт 47.3".
  • Один инструмент вместо зоопарка. AirDrop для своих, облако для больших, мессенджер для быстрых, флешка для надёжных - NetDrop закрывает всё это в одном окне.

"Дайте людям инструменты, не требующие доверия к посреднику, - и посредник станет не нужен."

  • принцип, на котором стоит вся децентрализация

И да - это просто приятно: смотреть, как файл на 20 ГБ летит напрямую со скоростью вашего канала, пока облако ещё рисует крутилку "подготовка к загрузке".


6. Идеи для развития

  • Открытие файла в одно касание - принял на телефоне -> тап -> открылось в нужном приложении.
  • Счётчик скачиваний на мульти-тикете: сколько человек уже забрали файл и кто качает сейчас.
  • Текстовые заметки и буфер обмена - перекинуть ссылку или пароль между устройствами так же, как файл.
  • Папки-синхронизации между доверенными устройствами: положил в папку на ПК - появилось на телефоне.
  • iOS-версия - Tauri уже умеет, дело за сборкой.
  • Групповые "комнаты": несколько устройств семьи в одном доверенном круге.
  • Автоочистка истории и "исчезающие" передачи для параноиков (мы вас любим).
  • Профили скорости: "ночью - на всю", "днём - не мешать звонкам".
  • Плагины для проводника - "Отправить через NetDrop" в контекстном меню правой кнопки.

NetDrop - часть экосистемы SmartHoldem/NETFORY: децентрализованный интернет начинается с маленьких инструментов, которые не просят разрешения.

"Лучший способ предсказать будущее интернета - вернуть его людям."