Rozwiązanie społecznościowe

Konfiguracja samodzielnie hostowanej synchronizacji LiveSync Obsidian na CasaOS: CouchDB, HTTPS i bezpieczeństwo synchronizacji

A March 2025 CasaOS post linking to an external Big Bear tutorial for Obsidian Self-hosted LiveSync. The forum body does not preserve the actual Compose configuration, so a durable page must keep the historical source while using current upstream LiveSync/CouchDB guidance.

Źródłowy wpis na forum jest wprowadzeniem i linkiem do zewnętrznego poradnika, a nie kompletnym zapisem wdrożenia. Obiecuje szybkie skonfigurowanie CasaOS dla Obsidian Self-hosted LiveSync, ale sam wpis nie zachowuje obrazu CouchDB, ścieżek woluminów, danych uwierzytelniających, konfiguracji HTTPS ani konfiguracji klientów użytych w oryginalnym filmie.

W przypadku aktualnej instalacji jako podstawy technicznej użyj utrzymywanego projektu Self-hosted LiveSync. Konfiguracja upstream nadal opiera się na CouchDB i szczegółowo opisuje użycie Dockera, trwałe przechowywanie danych i konfiguracji CouchDB, udostępnianie przez HTTPS oraz identyfikator URI konfiguracji służący do konfigurowania klientów Obsidiana.

Miniatura poradnika Big Bear dotyczącego uruchamiania Obsidian Self-hosted LiveSync w CasaOS
Wpis społecznościowy głównie odsyła do tego zewnętrznego poradnika z 2025 roku, zamiast przechowywać konfigurację wdrożenia bezpośrednio na forum.

Self-hosted LiveSync to warstwa synchronizacji, a nie sama aplikacja Obsidian

Obsidian pozostaje zainstalowany na komputerach stacjonarnych lub urządzeniach mobilnych. Self-hosted LiveSync dodaje społecznościową wtyczkę synchronizującą oraz bazę danych po stronie serwera, dzięki czemu zmiany w skarbcach mogą być przesyłane między urządzeniami bez korzystania z płatnej usługi Obsidian Sync.

Projekt upstream jest oprogramowaniem społecznościowym, a nie oficjalną usługą Obsidiana.

CouchDB to podstawowy komponent serwera

Aktualny przewodnik konfiguracji upstream wykorzystuje CouchDB jako główny samodzielnie hostowany backend. Jego przykład dla Dockera tworzy trwałe katalogi zarówno na dane CouchDB, jak i na konfigurację, zanim uruchomi kontener.

Skorzystaj z aktualnej konfiguracji serwera Self-hosted LiveSync, zamiast kopiować stare tagi obrazów z filmu.

Przechowuj bazę CouchDB poza nietrwałym kontenerem

Baza danych zawiera zsynchronizowaną reprezentację notatek i powiązany stan. Zmapuj katalogi danych i konfiguracji CouchDB na trwałą pamięć CasaOS, aby odtworzenie kontenera nie usunęło backendu synchronizacji.

Przechowuj te foldery oddzielnie od zwykłych tymczasowych warstw Dockera.

Używaj unikatowych danych uwierzytelniających CouchDB

Nie używaj przykładowych nazw użytkowników ani haseł z poradnika. Utwórz silne, unikatowe dane administratora CouchDB i nie umieszczaj ich na zrzutach ekranu, w udostępnianych plikach Compose ani w publicznych wpisach na forum.

Jeśli dane uwierzytelniające zostaną ujawnione, natychmiast je zmień i sprawdź każdą instancję CouchDB dostępną zdalnie.

Zdalna synchronizacja powinna korzystać z HTTPS

Jeśli wiele urządzeń ma synchronizować dane spoza sieci LAN, udostępniaj CouchDB przez bezpieczne połączenie HTTPS zamiast publikować zwykłe HTTP bezpośrednio w Internecie. Dokumentacja upstream zawiera przykłady odwrotnego proxy i konfiguracji domeny.

Sieć VPN lub nakładkowa to kolejna możliwość, gdy dostęp jest potrzebny wyłącznie własnym urządzeniom.

Ustawienia CORS i origin muszą odpowiadać sposobowi pracy klienta

Konfiguracja zabezpieczeń CouchDB może blokować żądania przeglądarki lub webview, nawet gdy serwer jest osiągalny. Procedura konfiguracji Self-hosted LiveSync ustawia wymagane zachowanie CouchDB, zamiast uznawać ogólny kontener bazy danych za gotowy tylko dlatego, że port 5984 jest otwarty.

Ostrożnie korzystaj z identyfikatora URI konfiguracji

Aktualne wytyczne upstream mogą wygenerować identyfikator URI konfiguracji, aby inne urządzenie z Obsidianem mogło zaimportować ustawienia połączenia. Taki identyfikator URI może zawierać poufne szczegóły połączenia.

Traktuj go jak sekret: wysyłaj go wyłącznie na własne zaufane urządzenie i nie umieszczaj go na zrzutach ekranu ani w historii czatu dostępnej dla innych osób.

Synchronizacja w czasie rzeczywistym nie eliminuje konfliktów edycji

Dwa urządzenia edytujące tę samą notatkę niemal w tym samym czasie nadal mogą powodować konflikty lub wymagać uzgodnienia zmian. Samodzielne hostowanie zapewnia kontrolę nad serwerem, ale nie zamienia rozproszonej edycji w system plików z jednym autorem.

Przetestuj ten sposób pracy na tymczasowym skarbcu, zanim przeniesiesz jedyną kopię ważnych notatek.

Synchronizacja nie jest kopią zapasową

Jeśli notatka zostanie usunięta i usunięcie zsynchronizuje się ze wszystkimi klientami, zsynchronizowany system wykonał swoje zadanie. Przechowuj niezależne kopie zapasowe z wersjonowaniem skarbca Obsidiana oraz, gdy jest to uzasadnione, danych CouchDB.

Chroni to przed przypadkowym usunięciem, błędami wtyczki, uszkodzeniem bazy danych lub omyłkową masową edycją.

Źródło dotyczy konkretnie CasaOS

Historyczny poradnik był przeznaczony dla CasaOS. Jeśli hostem jest obecnie ZimaOS, użyj aktualnego procesu wdrażania w Sklepie aplikacji ZimaOS lub przez Compose oraz bieżących ścieżek pamięci, zamiast zakładać, że układ pakietów CasaOS pozostał taki sam.

Najczęściej zadawane pytania dotyczące Obsidian LiveSync

Czy oryginalny wpis na forum zawiera pełną konfigurację Compose?

Nie. Przede wszystkim odsyła do zewnętrznego poradnika Big Bear.

Jaki backend opisuje obecnie Self-hosted LiveSync?

Aktualna konfiguracja upstream korzysta z CouchDB i udostępnia ścieżkę wdrożenia za pomocą Dockera.

Czy samodzielnie hostowana synchronizacja zastępuje kopie zapasowe?

Nie. Przechowuj niezależną kopię zapasową skarbca, ponieważ usunięcia i błędne edycje również mogą zostać zsynchronizowane.