원본 포럼 게시물은 완전한 배포 기록이 아니라 소개와 외부 튜토리얼 링크를 제공하는 글입니다. Obsidian Self-hosted LiveSync를 CasaOS에 빠르게 설정하는 방법을 약속하지만, 게시물 자체에는 원본 영상에서 사용한 CouchDB 이미지, 볼륨 경로, 자격 증명, HTTPS 설정 또는 클라이언트 설정이 보존되어 있지 않습니다.
현재 설치하려면 유지 관리되고 있는 Self-hosted LiveSync 프로젝트를 기술적 기준으로 사용하세요. 업스트림 설정은 여전히 CouchDB를 중심으로 하며, Docker, 영구 CouchDB 데이터/구성, HTTPS 노출 및 Obsidian 클라이언트 설정을 위한 설정 URI를 명시적으로 안내합니다.
Self-hosted LiveSync는 Obsidian 앱 자체가 아니라 동기화 계층입니다
Obsidian은 데스크톱 또는 모바일 기기에 계속 설치되어 있어야 합니다. Self-hosted LiveSync는 커뮤니티 동기화 플러그인과 서버 측 데이터베이스를 추가하여 Obsidian의 유료 Sync 서비스에 의존하지 않고 여러 기기 간에 보관함 변경 사항을 동기화할 수 있게 합니다.
업스트림 프로젝트는 공식 Obsidian 서비스가 아니라 커뮤니티 소프트웨어입니다.
CouchDB는 핵심 서버 구성 요소입니다
현재 업스트림 설정 가이드는 CouchDB를 주요 셀프 호스팅 백엔드로 사용합니다. Docker 예제에서는 컨테이너를 시작하기 전에 CouchDB 데이터와 구성 모두를 위한 영구 디렉터리를 생성합니다.
동영상의 오래된 이미지 태그를 그대로 복사하지 말고 최신 Self-hosted LiveSync 서버 설정을 사용하세요.
일회성 컨테이너 외부에 CouchDB 데이터베이스를 영구 저장하세요
데이터베이스에는 노트의 동기화된 표현과 관련 상태가 포함됩니다. CouchDB의 데이터 및 구성 디렉터리를 영구 CasaOS 저장소에 매핑하여 컨테이너를 다시 만들어도 동기화 백엔드가 삭제되지 않도록 하세요.
해당 폴더를 일반적인 임시 Docker 레이어와 분리해 두세요.
고유한 CouchDB 자격 증명을 사용하세요
튜토리얼에 포함된 예시 사용자 이름이나 비밀번호를 그대로 사용하지 마세요. 강력하고 고유한 CouchDB 관리자 자격 증명을 만들고, 이를 스크린샷, 공유 Compose 파일 및 공개 포럼 게시물에 포함하지 마세요.
자격 증명이 노출된 경우 즉시 변경하고 외부에서 접근 가능한 CouchDB 인스턴스를 점검하세요.
원격 동기화에는 HTTPS를 사용해야 합니다
여러 기기를 LAN 외부에서 동기화해야 한다면 일반 HTTP를 인터넷에 직접 공개하지 말고 안전한 HTTPS 경로를 통해 CouchDB를 노출하세요. 업스트림 문서에는 리버스 프록시 예시와 도메인 구성 방법이 포함되어 있습니다.
자신의 기기만 접근해야 하는 경우 VPN/오버레이 네트워크를 사용하는 방법도 있습니다.
CORS 및 Origin 설정은 클라이언트 작업 흐름과 일치해야 합니다
서버에 연결할 수 있더라도 CouchDB 보안 구성으로 인해 브라우저 또는 웹뷰 요청이 차단될 수 있습니다. Self-hosted LiveSync의 설정 절차는 포트 5984가 열렸다고 해서 일반 데이터베이스 컨테이너 설정이 완료된 것으로 간주하지 않고, 필요한 CouchDB 동작을 구성합니다.
설정 URI를 신중하게 사용하세요
현재 업스트림 안내에서는 다른 Obsidian 기기가 연결 설정을 가져올 수 있도록 설정 URI를 생성할 수 있습니다. 이 URI에는 민감한 연결 정보가 포함될 수 있습니다.
설정 URI를 비밀 정보처럼 취급하세요. 신뢰할 수 있는 자신의 기기에만 전송하고, 다른 사람이 접근할 수 있는 스크린샷이나 채팅 기록에 게시하지 마세요.
실시간 동기화가 편집 충돌을 없애 주는 것은 아닙니다
두 기기에서 거의 동시에 같은 노트를 편집하면 여전히 충돌이 발생하거나 조정이 필요할 수 있습니다. 셀프 호스팅은 서버에 대한 제어권을 제공하지만, 분산 편집을 단일 작성자 파일 시스템으로 바꾸지는 않습니다.
중요한 노트의 유일한 사본을 마이그레이션하기 전에 임시 보관함으로 작업 흐름을 테스트하세요.
동기화는 백업이 아닙니다
노트가 삭제되고 해당 삭제가 모든 클라이언트에 동기화되었다면, 동기화 시스템은 제 역할을 다한 것입니다. Obsidian 보관함과 필요한 경우 CouchDB 데이터의 독립적인 버전 관리 백업을 유지하세요.
이렇게 하면 실수로 인한 삭제, 플러그인 버그, 데이터베이스 손상 또는 잘못된 대량 편집으로부터 보호할 수 있습니다.
원본은 CasaOS에 특화되어 있습니다
과거 튜토리얼은 CasaOS를 대상으로 했습니다. 호스트가 현재 ZimaOS라면 동일한 CasaOS 패키지 레이아웃을 가정하지 말고 최신 ZimaOS 앱 스토어/Compose 작업 흐름과 최신 저장소 경로를 사용하세요.
Obsidian LiveSync FAQ
원본 포럼 게시물에 전체 Compose 구성이 포함되어 있나요?
아니요. 주로 외부 Big Bear 튜토리얼로 연결합니다.
현재 Self-hosted LiveSync에서 문서화하는 백엔드는 무엇인가요?
현재 업스트림 설정은 CouchDB를 사용하며 Docker 배포 경로를 제공합니다.
셀프 호스팅 동기화가 백업을 대체하나요?
아니요. 삭제와 잘못된 편집 내용도 동기화될 수 있으므로 보관함의 독립적인 백업을 유지하세요.
