[IT/기술] Obsidian Self-hosted LiveSync 설정 가이드

관리자 Lv.1
02-09 09:20 · 조회 0 · 추천 0

Obsidian Self-hosted LiveSync 설정 가이드

CouchDB 기반 실시간 노트 동기화 플러그인 설정

CouchDB 서버가 준비되었다면, Obsidian에서 Self-hosted LiveSync 플러그인을 설치하고 동기화를 설정할 차례입니다. 이 플러그인은 WebDAV 대신 CouchDB를 사용하여 실시간 양방향 동기화를 제공합니다.


1. 플러그인 설치

Step 1: Obsidian을 실행합니다.

Step 2: 좌측 하단 톱니바퀴 아이콘(Settings)을 클릭합니다.

Step 3: 왼쪽 메뉴에서 Community plugins를 선택합니다.

Step 4: Browse 버튼을 클릭합니다.

Step 5: 검색창에 "Self-hosted LiveSync"를 입력합니다.

Step 6: 플러그인을 찾아 Install 클릭 후 Enable을 클릭합니다.

참고: Community plugins를 처음 사용하는 경우, "Turn on community plugins" 버튼을 먼저 눌러 활성화해야 합니다.

2. Setup Wizard 실행

플러그인을 처음 활성화하면 Setup wizard 팝업이 자동으로 나타납니다. 만약 팝업이 나타나지 않았다면:

1. Settings → Community plugins → Self-hosted LiveSync 옆의 톱니바퀴 아이콘 클릭

2. 플러그인 설정 페이지에서 Setup wizard 버튼 클릭


3. CouchDB 연결 설정

Setup wizard에서 "Use CouchDB"를 선택한 후 다음 정보를 입력합니다:

항목입력값설명
CouchDB URIhttp://NAS_IP:5984NAS의 CouchDB 주소
Usernameadmindocker-compose에서 설정한 사용자명
Password(설정한 비밀번호)docker-compose에서 설정한 비밀번호
Database nameobsidian-vaultCouchDB에서 생성한 DB 이름
모바일 사용 시: URI를 https://your-domain.com/couchdb 형태의 HTTPS 주소로 입력해야 합니다. iOS/Android 앱은 HTTP 연결을 차단합니다.

4. 동기화 모드 선택

Setup wizard에서 동기화 모드를 선택합니다:

모드설명권장 대상
LiveSync실시간 양방향 동기화. 변경사항이 즉시 반영됨데스크톱 + 항상 연결된 환경
Periodic Sync일정 간격으로 동기화 (배터리 절약)모바일 기기
On Startup + On Close앱 시작/종료 시에만 동기화간헐적 사용자
권장 설정: 데스크톱에서는 LiveSync, 모바일에서는 Periodic Sync를 선택하면 배터리와 실시간성을 적절히 균형잡을 수 있습니다.

5. 두 번째 기기 설정

첫 번째 기기에서 설정을 완료한 후, 두 번째 기기(모바일 등)에서 동기화하려면:

1. 두 번째 기기에서 Obsidian 설치 후 빈 Vault 생성

2. Self-hosted LiveSync 플러그인 설치 및 활성화

3. Setup wizard에서 동일한 CouchDB 정보 입력

4. "Fetch from remote"를 선택하여 서버의 데이터를 가져옴

5. 동기화 모드 선택 후 완료

주의: 두 번째 기기에서는 반드시 빈 Vault에서 시작해야 합니다. 기존 데이터가 있으면 충돌이 발생할 수 있습니다.

6. 유용한 추가 설정

설정권장값설명
Hidden files syncEnable.obsidian 설정 폴더도 동기화
Conflict resolutionNewer wins충돌 시 최신 버전 유지
Batch size250한 번에 동기화할 문서 수
Periodic sync interval60 (초)모바일에서 주기적 동기화 간격
완료! 이제 Obsidian 노트가 CouchDB를 통해 여러 기기 간 실시간으로 동기화됩니다. WebDAV의 경로 길이 제한 문제에서 완전히 자유로워집니다. 모바일에서도 사용하려면 HTTPS 설정이 필요합니다.
💬 0 로그인 후 댓글 작성
첫 댓글을 남겨보세요!