# Описание навчального посібника Noterich P2P Sync: Синхронізація між пристроями без використання хмарних сервісів > **Синхронізуйте свої нотатки між пристроями безпечно — без необхідності використання хмарних сховищ.** У епоху, коли конфіденційність даних є важливішою, чем будь-коли, Noterich пропонує революційний підхід до синхронізації між пристроями. Наша функція **P2P (Peer-to-Peer) Sync** дозволяє безперешкодно обмінюватися нотатками між пристроями, не покладаючись на хмарні сервери. Ваші дані залишаються у вас — завжди. ## Чому обрати P2P Sync? Традиційні додатки для зберігання нотаток зберігають дані на централізованих серверах. Це створює потенційні ризики для конфіденційності, необхідність платити за підписку та залежність від інфраструктури третьої сторони. Noterich обирає інший шлях: ```mermaid graph LR A[Ваш пристрій] <-->|Пряма з’єднання| B[Ваш інший пристрій] C[Хмарний сервер] -.->|Не потрібно| A C -.->|Не потрібно| B style A fill:#4CAF50,color:#fff style B fill:#4CAF50,color:#fff style C fill:#9E9E9E,color:#fff,stroke-dasharray: 5 5 ``` ### Основні переваги - **🔒 Перш за все — конфіденційність**: Ваші нотатки ніколи не торкаються серверів третьої сторони - **⚡ Швидкість та прямий зв’язок**: Пристрої спілкуються безпосередньо для швидшої синхронізації - **💰 Без підписки**: Безкоштовна P2P синхронізація без платних рівнів - **🌐 Діє на будь-якому місці**: Синхронізація через локальну мережу чи інтернет - **📱 Можливість роботи між платформами**: Робота між стільниковими, ноутбуками, планшетами та мобільними пристроями ## Як працює P2P Sync Noterich використовує **технологію WebRTC** у поєднанні з **PeerJS** для встановлення прямих з’єднань між пристроями. Коли ви ініціюєте синхронізацію: ```mermaid sequenceDiagram participant D1 as Пристрій A (Особа, яка надсилає) participant S as Сервер сигналізації participant D2 as Пристрій B (Особа, яка отримує) D1->>S: Запит на з’єднання ID S-->>D1: Генеруємо ID кімнати D1->>D2: Передаємо посилання на з’єднання (QR/URL) D2->>S: З’єднуємося за допомогою ID кімнати S-->>D2: Встановлюємо парні з’єднання D1->>D2: Шифруємо та надсилаємо нотатки D2->>D2: Декодуємо та імпортуємо нотатки Note over D1,D2: Пряме зашифроване передавання<br/>Немає даних, які зберігаються на сервері ``` ### Технології, які лежать в основі Реалізація P2P в Noterich використовує: 1. **Бібліотека PeerJS**: Обробляє складність WebRTC для зв’язку між браузерами 2. **Шифрування AES-GCM**: Військовий рівень шифрування для ваших нотаток 3. **Генерація ключів PBKDF2**: Захищена ключова шифрування на основі паролю 4. **Серіалізація MessagePack**: Ефективне бінарне кодування для швидких передач 5. **Зберігання IndexedDB**: Локальна база даних для офлайн-доступу ## Початок роботи з P2P Sync ### Передумови Перш ніж почати, переконайтеся, що у вас є: - ✅ Noterich встановлено на обох пристроях - ✅ Обидва пристрої підключені до інтернету (або в одній локальній мережі) - ✅ Сучасний веб-браузер (Chrome, Firefox, Edge, Safari) ### Крок 1: Ініціювання обміну з вихідного пристрою 1. Відкрийте нотатку, яку хочете поділити в Noterich 2. Натисніть кнопку **Share** у панелі інструментів 3. Виберіть опцію **"P2P Share"** 4. (Необов’язково) Встановіть пароль для додаткової безпеки - Паролі мають бути не менше 8 символів - Використовується шифрування AES-256-GCM 5. Чекайте, поки P2P сервер ініціалізується ```mermaid graph TD A[Відкрити нотатку] --> B[Натисніть кнопку Share] B --> C[Виберіть P2P Share] C --> D{Встановити пароль?} D -->|Так| E[Введіть пароль ≥8 символів] D -->|Ні| F[Пропустити шифрування] E --> G[Ініціалізувати P2P сервер] F --> G G --> H[Генерувати посилання та QR-код] ``` ### Крок 2: Передати посилання на з’єднання Як тільки P2P сервер починає працювати, Noterich генерує: - **Унікальне посилання для обміну**, яке містить параметри з’єднання - **QR-код** для швидкого сканування на мобільних пристроях Формат посилання виглядає так: ``` https://noterich.com/#dbshare=<infoHash>&server=<signaling-server> ``` **Способи обміну:** | Спосіб | Найкращий для | Як це зробити | |--------|----------|--------| | 🔗 Копіювання посилання | Електронна пошта, додатки для обміну повідомленнями | Натисніть кнопку "Копіювати посилання" | | 📱 QR-код | Мобільні пристрої | Скануйте його за допомогою камери пристрою | | 📧 Електронна пошта | Дистанційні колеги | Вставте посилання в електронну пошту | ### Крок 3: Отримати нотатки на приймальному пристрої На приймальному пристрої: 1. **Відкрити посилання на з’єднання** - Натисніть прямо на посилання, або - Скануйте QR-код за допомогою мобільного пристрою 2. **Переглянути надходжені нотатки** - Просунути заголовки та метадані нотаток - Перевірити інформацію відправника 3. **Введіть пароль** (якщо зашифровано) - Введіть пароль, вказаний відправником - Дані декодуються локально на вашому пристрої 4. **Виберіть місце для зберігання** - Виберіть існуюче місце для зберігання, або - Створіть нове місце для імпортованих нотаток 5. **Підтвердіть імпорт** - Нотатки декодуються та зберігаються в IndexedDB - Індекс пошуку автоматично оновлюється ```mermaid graph LR A[Відкрити посилання] --> B[З’єднатися з відправником] B --> C{Зашифровано?} C -->|Так| D[Введіть пароль] C -->|Ні| E[Переглянути метадані] D --> E E --> F[Переглянути нотатки] F --> G[Вибрати місце для зберігання] G --> H[Імпортувати та створити індекс] H --> I[Синхронізація завершена!] style I fill:#4CAF50,color:#fff ``` ## Надзвичайні функції ### Зашифровані передачі Для конфіденційних нотаток Noterich пропонує опціональне end-to-end шифрування: **Процес шифрування:** ```javascript // Пароль → Ключ шифрування (PBKDF2) password + salt → deriveKey() → Ключ AES-256-GCM // Дані нотатки → Зашифрований буфер noteData + key + iv → encrypt() → encryptedBuffer // Пакет передачі { encryptedBuffer: ArrayBuffer, salt: Uint8Array, // Для генерації ключа iv: Uint8Array // Інтервал ініціалізації } ``` **Функції безпеки:** - 🔐 100,000 ітерацій PBKDF2 для генерації ключа - 🔐 Випадковий соль та IV для кожної передачі - 🔐 Аутентифіковане шифрування AES-256-GCM - 🔐 Пароль ніколи не передається — використовується лише локально ### Блокове синхронізацію нотаток Ефективно передати кілька нотаток: 1. Отримати **Базу даних для передачі** з налаштувань 2. Вибрати режим **"P2P Sync"** 3. Вибрати нотатки для синхронізації 4. Отримувач отримує блоковий перегляд з варіантами вибору **Оптимізація продуктивності:** - Нотатки передаються блоками по 512KB - Неблокове асинхронне оброблення запобігає застряганню інтерфейсу - Ведення спостереження за прогресом з точністю байтового рівня - Скасування в будь-який час без пошкодження даних ### Розв’язання конфліктів Під час синхронізації нотаток, які існують на обох пристроях: ```mermaid graph TD A[Виявлення конфлікту] --> B{Порівняння часів} B -->|Локально новіші| C[Зберегти локальну версію] B -->|Новіші з роуму| D[Відобразити діалог про конфлікт] D --> E[Вибрати версію] E --> F[Локальна] E --> G[Роумові] E --> H[Можливість ручного злиття] B -->|Обидві видалені| I[Пропустити] style C fill:#2196F3,color:#fff style F fill:#2196F3,color:#fff style G fill:#4CAF50,color:#fff style H fill:#4CAF50,color:#fff ``` **Розв’язані типи конфліктів:** - `local-newer`: Ваша версія є новішою - `remote-newer`: Вхідна версія є новішою - `local-deleted`: Ви видалили цю нотатку локально - `remote-deleted`: Нотатка була видалена на пристрої відправника - `remote-restored`: Нотатка була відновлена ## Виправлення помилок ### Поширені проблеми та їх вирішення #### ❌ "Бібліотека PeerJS не завантажена" **Причина**: Блокування мережі PeerJS CDN або сервера сигналізації **Рішення:** 1. Перевірити інтернет-з’єднання 2. Перевірити, чи firewall дозволяє зв’язки WebRTC 3. Спробувати інший варіант мережі (мобільний hotspot) 4. Переконатися, що браузер підтримує WebRTC #### ❌ "Час обробки з’єднання" **Причина**: NAT/фаєрволи перешкоджають прямому зв’язку **Рішення:** 1. Обидва пристрої повинні бути в одній мережі 2. Тимчасово вимкнути VPN 3. Перевірити налаштування WebRTC на роутері 4. Використовувати QR-код для зв’язку на мобільних пристроях #### ❌ "Не вдалося розшифрувати" **Причина**: Неправильний пароль або пошкоджене передавання **Рішення:** 1. Перевірити, чи пароль збігається точно (будь-які розбіжності) 2. Запитати нове посилання на з’єднання від відправника 3. Переконатися, що під час передачі є стабільне з’єднання 4. Спробувати менші кількості передач #### ❌ "Помилка "Синхронізація в процесі"** **Причина**: Кілька одночасних спроб синхронізації **Рішення:** 1. Чекати, поки починається синхронізація 2. Закрити інші вкладки/вікна Noterich 3. Оновіть сторінку та спробуйте знову 4. Скасуйте кеш-пам’ять браузера, якщо проблема залишається ### Індикатори стану з’єднання | Стан | Значення | Дії | |--------|---------|--------| | 🔵 З’єднання | Встановлюється парні з’єднання | Чекати 5-10 секунд | | 🟡 Аналізуються відмінності | Аналізуються відмінності нотаток | Нормальний процес | | 🟠 Потрібно введення пароля | Потрібно введення пароля або підтвердження | Перевірити діалогове вікно | | 🟢 Передача починається | Передача нотаток до бази даних | Не закривати вкладку | | ✅ Успішно | Синхронізація завершена | Готові до використання нотатки | | 🔴 Помилка | Проблема з з’єднанням або передачей | Перевірити проблему | ## Навички безпеки ### Захист ваших даних Хоча P2P синхронізація є безпечним за своєю природою, дотримуйтесь цих рекомендацій: 1. **Використовуйте сильні паролі** - Мінімум 8 символів (рекомендується 12+) - Суміш великих, малих літер, цифр, символів - Ніколи не використовуйте однакові паролі з інших сервісів 2. **Перевіряйте адресатів** - Ділитися посиланнями лише з довіреніми пристроями - Використовувати QR-коди для передачі в ручному режимі - Уникати розголошення посилань у публічних каналах 3. **Слідкуйте за активними з’єднаннями** - Перевіряйте парні з’єднання під час синхронізації - Від’єднуйтеся після успішної передачі - Скасовуйте обмін посиланнями, якщо вони були зловживані 4. **Регулярно створюйте резервні копії** - Експортуйте важливі нотатки періодично - Зберігайте резервні копії в безпечному місці - Тестуйте процедури відновлення регулярно ## Майбутнє планування Noterich продовжує вдосконалювати можливості P2P: - 🔄 **Автоматична синхронізація в тіні**: Виявляє навколишні пристрої та синхронізує безплатно - 🌐 **Мережеві з’єднання**: Мережеві передачі через проміжні пристрої - 📦 **Селективна синхронізація**: Вибір конкретних частин нотаток для синхронізації - 🔔 **Повідомлення про синхронізацію**: Попередження про прийшові запити - 📊 **Аналіз синхронізації**: Візуалізація історії синхронізації та переданих даних - 📦 **Внутрішні посилання**: Пряме обмін нотатками з використанням посилань ## Висновок P2P Sync від Noterich представляє зміну у способі синхронізації нотаток. Виключенням хмарних сервісів, ми створили систему, яка поважає вашу конфіденційність, зменшує витрати та дає вам повний контроль над вашими даними. Незалежно від того, чи ви студент, який керує дослідницькими нотатками, професіонал, який організовує документацію для проектів, чи команда, яка співпрацює над конфіденційними матеріалами, P2P Sync забезпечує безпеку та гнучкість, які вам потрібні. **Почніть синхронізувати більш ефективно — ваші нотатки, ваші пристрої, ваш контроль.** --- ### Короткий посібник ``` ┌─────────────────────────────────────────────────────┐ │ НОВИЙ ПОСІБНИК ПРО P2P SYNC QUICK GUIDE │ ├─────────────────────────────────────────────────────┤ │ 1. Відкрити нотатку → Натисніть "Шифрувати" → Виберіть "P2P" │ │ 2. Встановіть пароль (за бажанням, але рекомендується) │ │ 3. Копіюйте посилання або перегляньте QR-код │ │ 4. На приймальному пристрої: Відкрити посилання / Сканувати QR-код │ │ 5. Введіть пароль, якщо зашифровано │ │ 6. Виберіть місце для зберігання → Підтвердіть імпорт │ │ 7. Чекати завершення → Почніть працювати! │ ├─────────────────────────────────────────────────────┤ │ 🔒 Шифрування: AES-256-GCM + PBKDF2 (100к ітерацій) │ │ ⚡ Технологічний набір: WebRTC + PeerJS + IndexedDB │ │ 📦 Розмір блоку: 512KB для оптимальної продуктивності │ │ 🌐 Сигналізація: www.noterich.com:443 │ └─────────────────────────────────────────────────────┤ ```