결론: 목표가 Obsidian 볼트라면 브라우저 컨테이너에서 Obsidian 데스크톱 UI를 실행하는 것부터 시작하지 마세요
2025년 설정은 LinuxServer Obsidian, Selkies, 리버스 프록시와 마운트된 볼트를 함께 사용했습니다. 이 방식도 작동할 수 있지만, 노트를 편집하기도 전에 브라우저 보안, WebSocket/HTTPS, 컨테이너 볼륨 매핑, Obsidian 데스크톱 프로세스라는 네 가지 별도 장애 계층이 생깁니다. 2026년에는 ZimaSpace가 백업, 클라우드 액세스 및 여러 기기 간 동기화를 위해 특별히 설계된 Obsidian용 OZSync를 제공하므로, 실제 목표가 “볼트를 ZimaOS에 보관하는 것”이라면 이 방법이 더 나은 첫 단계입니다.
Obsidian용 OZSync는 ZimaOS 플러그인 생태계에 OZSync를 등록해 두고 있습니다.
컨테이너를 고치기 전에 아키텍처를 선택하세요
실용적인 모델은 세 가지입니다.
- 일반 로컬 볼트 동기화: Obsidian은 Mac/PC에서 네이티브로 실행하고, 동기화 계층이 볼트를 ZimaOS에 유지합니다.
- 마운트된 파일 시스템을 통해 볼트 열기: 데스크톱 앱이 마운트된 공유 폴더를 가리키도록 합니다. 일반적인 지연 시간 및 오프라인 사용 관련 제약이 있습니다.
- 브라우저 컨테이너에서 Obsidian 자체 실행: LinuxServer/Selkies가 GUI를 원격으로 스트리밍합니다. 가장 복잡한 옵션입니다.
ZimaOS 저장소에 액세스하려면 브라우저 컨테이너가 필요하다고 생각해서 이 방식을 선택했다면, 먼저 구성을 단순화하세요.
컨테이너를 계속 사용한다면 호스트 경로와 컨테이너 경로를 별도로 확인하세요
볼트가 “절대 나타나지 않을” 때는 Obsidian UI보다 Docker 볼륨 매핑을 확인하세요.
# 예시
/media/Notes/MyVault -> /vaults/MyVault컨테이너 내부의 Obsidian은 오른쪽 경로만 볼 수 있습니다. ZimaOS 파일은 왼쪽 경로를 표시합니다. ZimaOS 앱 경로에서는 이 경계를 설명하며, Docker의 Docker 바인드 마운트에서는 런타임 동작을 정의합니다.
Selkies를 디버깅하기 전에 HTTPS를 해결하세요
브라우저로 스트리밍되는 데스크톱 컨테이너는 보안 브라우저 API와 WebSocket 연결에 의존할 수 있습니다. 앱이 처음에 “안전하지 않은 액세스”를 거부했다면 HTTPS로 리버스 프록시하는 것은 합리적인 해결책이었습니다. 하지만 볼트 마운트를 추가하기 전에 프록시 엔드포인트를 테스트하세요. Selkies 페이지의 기본 셸이 정상적으로 표시된다고 해서 Obsidian 프로세스나 해당 WebSocket 경로가 정상이라는 뜻은 아닙니다.
ZimaOS HTTPS 프록시에서 ZimaOS의 리버스 프록시 모델을 확인할 수 있습니다.
Selkies는 열리지만 Obsidian이 열리지 않을 때
컨테이너를 다시 시작했을 때 애플리케이션 없이 스트리밍 셸만 표시된다면, 일반적으로 컨테이너는 실행 중이지만 데스크톱 프로세스가 실패한 것입니다. 컨테이너 로그, 이미지 버전, 영구 설정의 소유권 및 사용 가능한 메모리를 확인하세요. GUI를 문제 해결하는 동안 볼트를 삭제하지 마세요.
docker ps -a
docker logs --tail=200 YOUR_OBSIDIAN_CONTAINER
ls -ld /media/Notes/MyVaultLinuxServer는 현재 웹에서 액세스할 수 있는 컨테이너로 Obsidian을 제공하지만, 해당 이미지는 여전히 영구 /config 및 호스트 볼륨 권한이 올바르게 설정되어 있어야 합니다. LinuxServer Obsidian 컨테이너가 업스트림 소스입니다.
컨테이너 없이도 복구할 수 있도록 볼트를 일반 파일로 유지하세요
Obsidian 볼트는 본질적으로 Markdown 파일과 .obsidian 설정으로 구성된 폴더입니다. 이 폴더를 일반 ZimaOS 데이터 저장소에 보관하고 별도로 백업하세요. 스트리밍 컨테이너에 문제가 생겨도 텍스트 편집기로 노트를 계속 읽을 수 있어야 합니다.
ZimaOS 백업 및 ZimaOS 앱 요구 사항에서 복구 및 리소스 산정에 관한 내용을 확인할 수 있습니다.
기존 볼트를 다시 만들지 않고 가져오기
Obsidian을 종료하고, 원하는 경우 숨김 .obsidian 설정을 포함한 전체 볼트를 호스트 디렉터리에 복사한 다음 소유권을 확인하세요. 이후 컨테이너를 시작하고 매핑된 컨테이너 경로를 여세요. 서로 독립적인 두 동기화 엔진이 볼트에 기록하는 동안 파일을 복사하지 마세요. 충돌 파일과 삭제된 노트는 단순한 마운트 문제보다 해결하기 어렵습니다.
여러 기기에서 편집한다면 브라우저 데스크톱보다 동기화를 사용하세요
노트북과 휴대폰에서는 동기화 중심의 설계를 통해 각 기기에서 Obsidian을 로컬로 빠르고 원활하게 사용할 수 있습니다. 또한 원격 브라우저 세션에 대한 의존성이 줄어들고 오프라인으로 노트를 작성할 수 있습니다. 중앙 집중식 GUI 액세스가 정말 필요한 경우에 브라우저 컨테이너 방식을 사용하세요. 데이터가 NAS에 있다는 이유만으로 사용할 필요는 없습니다.
자주 묻는 질문
마운트한 Obsidian 볼트가 나타나지 않는 이유는 무엇인가요?
컨테이너 측에서 가장 흔한 원인은 볼륨 경로 불일치입니다. Obsidian 설정을 변경하기 전에 호스트 경로, 컨테이너 경로 및 권한을 확인하세요.
ZimaOS에서 Obsidian에 HTTPS가 필요한가요?
네이티브 데스크톱 Obsidian은 NAS 웹 UI에서 편집기를 제공할 필요가 없습니다. 브라우저로 스트리밍되는 Selkies 컨테이너는 HTTPS 또는 올바른 보안 WebSocket 동작이 필요할 수 있습니다.
볼트를 SMB에 저장해야 하나요?
가능하지만, 일반적으로 로컬 볼트와 동기화를 함께 사용하는 편이 오프라인 작업에 더 쉽고 네트워크 중단에도 덜 민감합니다.
기존 Markdown 볼트를 직접 복사할 수 있나요?
예. 볼트는 파일 폴더입니다. 플러그인과 설정을 유지하려면 .obsidian을 포함한 전체 디렉터리를 복사한 다음, 선택한 Obsidian 인스턴스가 해당 경로를 가리키도록 하세요.
현재 ZimaOS에서 가장 간단한 Obsidian 설정은 무엇인가요?
목표가 여러 기기 간 볼트 동기화라면, 전체 브라우저 데스크톱 스택을 구축하기보다 먼저 현재 OZSync 통합을 검토하세요.
