# Tutorial Noterich P2P Sync: Cross-Device Bez Usług Cloud > **Zsynchronizuj swoje notatki między urządzeniami bezpiecznie — bez potrzeby usług cloudowego przechowywania.** W epoce, gdy prywatność danych jest ważniejsza niż kiedykolwiek, Noterich oferuje rewolucyjne rozwiązanie dla współdzielenia notatek między urządzeniami. Nasza funkcja **P2P (Peer-to-Peer) Sync** umożliwia bezprzewodowe udostępnianie notatek między urządzeniami bez konieczności korzystania z serwerów cloudowych. Twoje dane pozostają tylko twoje — zawsze. ## Dlaczego wybrać P2P Sync? Tradycyjne aplikacje do robienia notatek przechowują dane na centralnych serwerach. To stwarza potencjalne ryzyka dotyczące prywatności, koszty subskrypcji i zależność od infrastruktury trzecich. Noterich wybiera inną drogę: ```mermaid graph LR A[Twoje Urządzenie] <-->|Połączenie bezpośrednie| B[Twoje Inne Urządzenie] C[Serwer Cloud] -.->|Nie jest wymagany| A C -.->|Nie jest wymagany| B style A fill:#4CAF50,color:#fff style B fill:#4CAF50,color:#fff style C fill:#9E9E9E,color:#fff,stroke-dasharray: 5 5 ``` ### Główne zalety - **🔒 Prywatność na pierwszym miejscu**: Twoje notatki nigdy nie stykają się z serwerami trzecich - **⚡ Szybkość i bezpośredniość**: Urządzenia komunikują się bezpośrednio dla szybszej synchronizacji - **💰 Bez subskrypcji**: Bezpłatna synchronizacja P2P bez poziomów premium - **🌐 Praca w dowolnym miejscu**: Synchronizacja przez lokalną sieć lub internet - **📱 Cross-Platform**: Praca między komputerami, laptopami, tablety i urządzeniami mobilnymi ## Jak działa P2P Sync Noterich wykorzystuje **technologię WebRTC** w połączeniu z **PeerJS** do nawiązywania bezpośrednich połączeń między urządzeniami. Kiedy uruchamiasz synchronizację: ```mermaid sequenceDiagram participant D1 jako Urządzenie A (Odbiorca) participant S jako Serwer Sygnalizacji participant D2 jako Urządzenie B (Odbiorca) D1->>S: Prosi o połączenie ID S-->>D1: Wygeneruj ID pokoju D1->>D2: Podziel się linkiem połączenia (QR/URL) D2->>S: Połącz się za użyciem ID pokoju S-->>D2: Ustanowić połączenie peer-to-peer D1->>D2: Zaszyfować i wysłać notatki D2->>D2: Rozwiązać szyfrowanie i zainstalować notatki Nota nad D1,D2: Bezpośrednie przekazanie szyfrowane<br/>Żadne dane nie są przechowywane na serwerze ``` ### Technologia stojąca za tą rozwiązaniem Implementacja P2P Noterich wykorzystuje: 1. **Biblioteka PeerJS**: Obsługuje złożoność WebRTC dla komunikacji między przeglądarkami 2. **Szyfrowanie AES-GCM**: Szyfrowanie wojskowe dla danych notatek 3. **Wygenerowanie kluczy PBKDF2**: Bezpieczne generowanie kluczy szyfrowania opartego na hasłach 4. **Serializacja MessagePack**: Efektywne kodowanie danych binarnych dla szybkich przekazów 5. **Przechowywanie IndexedDB**: Baza danych lokalna dla dostępu offline ## Rozpoczęcie użytkowania P2P Sync ### Wymagania predykatoryjne Przed rozpoczęciem upewnij się, że masz: - ✅ Noterich zainstalowane na obu urządzeniach - ✅ Oba urządzenia połączone z internetem (lub w tym samym lokalnym netcie) - ✅ Nowoczesną przeglądarkę (Chrome, Firefox, Edge, Safari) ### Krok 1: Uruchomienie udostępniania z urządzenia źródłowego 1. Otwórz notatkę, którą chcesz udostępnić w Noterich 2. Kliknij przycisk **Udostępnić** w narzędziu 3. Wybierz opcję **"P2P Udostępnij"** 4. (Opcjonalnie) Ustaw hasło dla dodatkowej bezpieczeństwa - Haseł musi być co najmniej 8 znaków - Używa szyfrowania AES-256-GCM 5. Zaczekaj, aż serwer P2P zainicjuje się ```mermaid graph TD A[Otworzyć Notatkę] --> B[Kliknąć przycisk Udostępnić] B --> C[Wybrać P2P Udostępnij] C --> D{Ustaw hasło?} D -->|Tak| E[Wprowadzaj hasło ≥8 znaków] D -->|Nie| F[Pominij szyfrowanie] E --> G[Zainicjuj serwer P2P] F --> G G --> H[Wygeneruj link udostępnienia i kod QR] ``` ### Krok 2: Udostępnienie linku połączenia Gdy serwer P2P zaczyna działać, Noterich generuje: - **Unikalny link do udostępnienia** zawierający parametry połączenia - **Kod QR** do szybkiego skanowania na telefonie Format linku wygląda tak: ``` https://noterich.com/#dbshare=<infoHash>&server=<signaling-server> ``` **Metody udostępniania:** | Metoda | Najlepiej dla | Jak to zrobić | |--------|----------|--------| | 🔗 Kopiowanie linku | E-mail, aplikacje komunikacyjne | Kliknij przycisk "Kopiować link" | | 📱 Kod QR | Urządzenia mobilne | Skanuj kod QR za pomocą aparatu | | 📧 E-mail | Współpracownicy zdalni | Wpisz link w e-mailu | ### Krok 3: Otrzymanie na urządzeniu docelowym Na urządzeniu odbiorcy: 1. **Otwórz link udostępniony** - Kliknij bezpośrednio link, lub - Skanuj kod QR za pomocą urządzenia mobilnego 2. **Przeanalizuj przychodzące notatki** - Przeglądaj tytuły notatek i metadane - Sprawdź informacje o odbiorcy 3. **Wprowadzaj hasło** (jeśli jest szyfrowane) - Wprowadzaj hasło podane przez odbiorcę - Dane są rozwiązywane lokalnie na twoim urządzeniu 4. **Wybierz obszar roboczy docelowy** - Wybierz istniejący obszar roboczy, lub - Stwórz nowy obszar roboczy dla zainstalowanych notatek 5. **Potwierdź import** - Notatki są rozwiązywane i zapisane do IndexedDB - Indeks przeglądany jest automatycznie ```mermaid graph LR A[Otworzyć Link] --> B[Połączyć się z odbiorcą] B --> C{Zaszyfrowane?} C -->|Tak| D[Wprowadzaj hasło] C -->|Nie| E[Otrzymaj Metadane] D --> E E --> F[Przeglądaj Notatki] F --> G[Wybierz Obszar Roboczy] G --> H[Importuj i Indexuj] H --> I[Synchronizacja zakończona!] style I fill:#4CAF50,color:#fff ``` ## Funkcje zaawansowane ### Przekazywanie zaszyfrowane Dla poufnych notatek Noterich oferuje opcjonalne szyfrowanie end-to-end: **Proces szyfrowania:** ```javascript // Hasło → Klucz szyfrowania (PBKDF2) password + salt → deriveKey() → Klucz AES-256-GCM // Dane notatki → Bufor zaszyfrowany noteData + klucz + iv → encrypt() → encryptedBuffer // Pakiet przekazania { encryptedBuffer: ArrayBuffer, salt: Uint8Array, // Dla generowania klucza iv: Uint8Array // Wektor inicjalny } ``` **Cechy bezpieczeństwa:** - 🔐 100 000 iteracji PBKDF2 dla generowania klucza - 🔐 Losowe solty i IV dla każdego przekazania - 🔐 Zabezpieczone szyfrowanie AES-256-GCM - 🔐 Hasło nigdy nie jest przekazywane — używane tylko lokalnie ### Synchroniczne udostępnianie w zbiorze Przekaż kilka notatek w sposób efektywny: 1. Uzyskać **Przekazanie Bazy Danych** z ustawień 2. Wybrać tryb **"P2P Sync"** 3. Wybrać notatki do synchronizacji 4. Odbiorca otrzymuje przegląd w zbiorze z opcjami wyboru **Optymalizacja wydajności:** - Notatki przekazywane w odcinkach (512KB każdy) - Nieblockowy przetwarzanie asynchroniczny zapobiega zawieszeniu UI - Obserwacja postępów z dokładnością bajtową - Zrezygnować w dowolnym momencie bez uszkodzenia danych ### Rozwiązywanie konfliktów Kiedy synchronizują się notatki, które istnieją na obu urządzeniach: ```mermaid graph TD A[Zauważ konflikt] --> B{Porównanie daty stempli} B -->|Lokalnie nowsze| C[Zachowaj wersję lokalną] B -->|Remote nowsze| D[Pokaż dialog o konflikcie] D --> E[Wybierz wersję] E --> F[Lokalnie] E --> G[Remote] E --> H[Mieć dołącz do manualnie] B -->|Oba usunięte| I[Pominij] style C fill:#2196F3,color:#fff style F fill:#2196F3,color:#fff style G fill:#4CAF50,color:#fff ``` **Rozwiązywane typy konfliktów:** - `lokalnie-najnowsze`: Twoja wersja jest nowsza - `remote-najnowsze`: Przychodząca wersja jest nowsza - `lokalnie-usunięte`: Usunęłaś tę notatkę lokalnie - `remote-usunięte`: Notatka została usunięta na urządzeniu odbiorcy - `remote-przywrócone`: Notatka została ponownie utworzona ## Rozwiązywanie problemów ### Powszechne problemy i rozwiązania #### ❌ "Biblioteka PeerJS nie została zainstalowana" **Przyczyna**: Blokowanie sieciowe CDN PeerJS lub serwer sygnalizacji **Rozwiązania:** 1. Sprawdź połączenie z internetem 2. Upewnij się, że firewall pozwala na połączenia WebRTC 3. Spróbuj alternatywnej sieci (hotspot mobilny) 4. Upewnij się, że przeglądarka obsługuje WebRTC #### ❌ "Czas oczekiwania połączenia" **Przyczyna**: NAT/firewall przeszkadza w bezpośrednim połączeniu **Rozwiązania:** 1. Obie urządzenia na tej samej sieci pomagają 2. Wyłącz VPN tymczasowo 3. Sprawdź ustawienia routera WebRTC 4. Użyj kodu QR do połączeń mobilnych #### ❌ "Szyfrowanie nie powiodło się" **Przyczyna**: Błędne hasło lub uszkodzony przekaz **Rozwiązania:** 1. Sprawdź, czy hasło jest dokładnie takie samo (rozróżniające się na przypadki) 2. Zażądaj nowego linku udostępnienia od odbiorcy 3. Upewnij się, że połączenie jest stabilne podczas przekazania 4. Spróbuj mniejszych ilości przekazów #### ❌ Błąd "Synchronizacja trwa" **Przyczyna**: Kilka jednocześnie prób synchronizacji **Rozwiązania:** 1. Poczekaj, aż obecna synchronizacja się zakończy 2. Zamknij inne okna/wiersze Noterich 3. Odśwież stronę i spróbuj ponownie 4. Wyczyść kachek przeglądarki, jeśli problem utrzymuje się ### Indikatory stanu połączenia | Stan | Znaczenie | Działanie | |--------|---------|--------| | 🔵 Przyłączanie | Ustalanie połączenia peer-to-peer | Poczekaj 5-10 sekund | | 🟡 Analiza | Analiza różnic w notatkach | Proces normalny | | 🟠 Czekanie na użytkownika | Potrzeba hasła lub potwierdzenia | Sprawdź dialogy modalne | | 🟢 Zastosowanie | Importowanie notatek do bazy danych | Nie zamykaj okna | | ✅ Sukces | Synchronizacja zakończona pomyślnie | Gotowe do użycia notatki | | 🔴 Błąd | Połączenie lub przekaz nie powiodło się | Sprawdź rozwiązania problemów | ## Zasady bezpieczeństwa ### Ochrona twoich danych Chociaż synchronizacja P2P jest z natury bezpieczna, postępuj zgodnie z następującymi zasadami: 1. **Używaj silnych hasł | - Minimalnie 8 znaków (zalecane 12+) - Mieszaj wielkie i małe litery, cyfry, symboly - Nigdy nie używaj hasł z innych usług | 2. **Sprawdź odbiorców** - Udostępniaj linki tylko z godnymi użytkownikami - Używaj kodów QR dla przekazów przy bliskim połączeniu - Unikaj publikowania linków w kanałach publicznych 3. **Monitoruj aktywne połączenia** - Sprawdź połączone partnerzy podczas synchronizacji - Rozłącz się po pomyślnym przekazaniu - Wykreśl linki udostępnione, jeśli zostały zainfekowane 4. **Regularne zapisywanie** - Eksportuj ważne notatki regularnie - Przechowuj zapisy w odległej lokalnej lokalizacji - Testuj regularnie procedury restauracji 5. **Ochrona przed własnymi wpływami** - Unikaj używania własnych hasł - Nie używaj hasła do wysyłania linków - Upewnij się, że połączenie jest stabilne podczas przekazania - Spróbuj mniejszych ilości przekazów ## Przyszła droga rozwoju Noterich nadal rozwija możliwości P2P: - 🔄 **Automatyczne synchronizacja w tle**: Wykrywa obecne urządzenia i synchronizuje się w tle - 🌐 **Sieci wielopętlowe**: Przekazywanie przez urządzenia pośrednie - 📦 **Synchronizacja selektywna**: Wybieranie określonych sekcji notatek do synchronizacji - 🔔 **Powiadomienia push**: Ostrzeganie o przybyciu zapytań synchronizacyjnych - 📊 **Analiza synchronizacji**: Visualizacja historii synchronizacji i przekazanych danych - 🔗 **Łączenia głębokie**: Bezpośrednie udostępnianie notatek za pomocą linków ## Wniosek P2P Sync Noterich stanowi zmianę w sposobie myślenia o synchronizacji notatek. Poprzez wyeliminowanie pośrednika cloudowego stworzyliśmy system, który szanuje twoją prywatność, redukuje koszty i daje ci pełną kontrolę nad swoimi danymi. Czy jesteś studentem, który zarządza notatkami naukowymi, profesjonalistą organizującym dokumentację projektową, czy zespołem pracującym nad delikatnymi materiałami? P2P Sync zapewnia bezpieczeństwo i elastyczność, które potrzebujesz. **Zacznij synchronizować mądrze dziś — twoje notatki, twoje urządzenia, twoja kontrola.** --- ### Krótki przewodnik ``` ┌─────────────────────────────────────────────────────┐ │ NOTERICH P2P SYNC KURTYKULATY PRZYCZYNEK │ ├─────────────────────────────────────────────────────┤ │ 1. Otwórz notatkę → Kliknij Udostępnić → Wybierz P2P │ │ 2. Ustaw hasło (opcjonalnie, ale zalecane) │ │ 3. Kopiuj link lub pokazuj kod QR │ │ 4. Na odbiorcy: Otwórz link / Skanuj kod QR │ │ 5. Wprowadzaj hasło, jeśli jest szyfrowane │ │ 6. Wybierz obszar roboczy → Potwierdź import │ │ 7. Czekaj na zakończenie → Zacznij pracować! │ ├─────────────────────────────────────────────────────┤ │ 🔒 Szyfrowanie: AES-256-GCM + PBKDF2 (100k iteracji) │ │ ⚡ Architektura: WebRTC + PeerJS + IndexedDB │ │ 📦 Rozmiar odcinków: 512KB dla optymalnej wydajności │ │ 🌐 Sygnalizacja: www.noterich.com:443 │ └─────────────────────────────────────────────────────┘ ``` --- <div class="flex flex-wrap gap-2 mt-8 mb-12"> <span class="px-3 py-1 bg-[#f4f4f5] border border-[#eaeaea] rounded-full text-xs font-medium text-[#666]">P2P</span> <span class="px-3 py-1 bg-[#f4f4f5] border border-[#eaeaea] rounded-full text-xs font-medium text-[#666]">Prywatność</span> <span class="px-3 py-1 bg-[#f4f4f5] border border-[#eaeaea] rounded-full text-xs font-medium text-[#666]">Lokalne-Przede</span> <span class="px-3 py-1 bg-[#f4f4f5] border border-[#eaeaea] rounded-full text-xs font-medium text-[#666]">PKM</span> <span class="px-3 py-1 bg-[#f4f4f5] border border-[#eaeaea] rounded-full text-xs font-medium text-[#666]">WebRTC</span> <span class="px-3 py-1 bg-[#f4f4f5] border border-[#eaeaea] rounded-full text-xs font-medium text-[#666]">Szyfrowanie</span> <span class="px-3 py-1 bg-[#f4f4f5] border border-[#eaeaea] rounded-full text-xs font-medium text-[#666]">Cross-Device</span> <span class="px-3 py-1 bg-[#f4f4f5] border border-[#eaeaea] rounded-full text-xs font-medium text-[#666]">Bez-Cloud</span> </div>