라이브러리 접근

라이브러리 접근을 사용하면 신뢰하는 기기가 사설 네트워크를 통해 데스크톱 앱에 연결할 수 있습니다. 앱에서는 현재 이 설정을 “자료실 접근”으로 표시하지만 이 문서에서는 “라이브러리 접근”으로 통일합니다.

라이브러리 접근 켜기

왼쪽 아래 계정 메뉴에도 “원격” 빠른 스위치와 “모바일 연결” 진입점이 있습니다. 원격 접근을 끄면 페어링된 기기가 더 이상 연결할 수 없지만 데스크톱의 로컬 라이브러리에는 영향이 없습니다.

LAN은 같은 가정 또는 사무실 네트워크의 기기를 데스크톱에 연결할 때 적합합니다. 기본 포트는 43127이며 TLS로 연결하고 로컬 네트워크 서비스 검색으로 클라이언트가 XiaDown을 찾도록 돕습니다.

Tailscale은 같은 tailnet에 있지만 같은 LAN에 있지 않은 기기를 연결할 때 적합합니다. XiaDown은 기본적으로 HTTPS 포트 443과 서비스 경로 /xiadown을 사용합니다.

사용 전에 데스크톱에 Tailscale이 설치되어 있고 로그인되어 있으며 Tailscale Serve가 켜져 있는지 확인하세요. XiaDown은 사설 tailnet에서만 접근을 제공하며 Funnel로 라이브러리를 공개 인터넷에 게시하지 않습니다.

상태가 “설치되지 않음” 또는 “사용할 수 없음”이면 Tailscale이 실행 중인지, 계정에 로그인했는지, Serve를 사용할 수 있는지 확인한 뒤 XiaDown에서 상태를 새로고침하세요.

연결 방식 하나 이상을 사용할 수 있게 되면 다음을 수행합니다.

QR 코드와 페어링 링크에는 일회성 비공개 자격 증명이 들어 있습니다. 다른 사람에게 보내거나 공개 스크린샷, 로그, 문제 제보에 포함하지 마세요.

새 기기는 기본적으로 “라이브러리 보기”와 “작업 보기”만 허용됩니다. “페어링된 기기”에서 기기 세부 정보를 열어 다음 권한을 각각 조정할 수 있습니다.

범위	부여 가능한 권한
라이브러리	라이브러리 보기.
음악	음악 라이브러리 보기, 음악 즐겨찾기와 재생 상태 업데이트, 음악 재생목록 및 색인 구성원 관리.
RSS	피드 보기, 피드 읽기 상태 업데이트, 공개 피드 관리, 명시적으로 공유된 공개 피드 가져오기.
작업	작업 보기, 작업 만들기, 작업 제어.

기기에 실제로 필요한 권한만 부여하세요. 유효한 기기마다 권한 하나 이상을 유지해야 합니다.

기기 상세 화면에는 최근 사용 시간이 표시됩니다. 기기를 잃어버렸거나 더 이상 사용하지 않거나 출처를 알 수 없다면 다음을 수행합니다.

취소 후 이전 자격 증명은 즉시 무효화됩니다. 이 기기는 나중에 새 QR 코드로 다시 페어링할 수 있습니다.

상황	확인 방법
원격 접근을 사용할 수 없음	원격 접근이 켜져 있고 LAN 또는 Tailscale 중 하나 이상이 “사용 가능”인지 확인합니다.
LAN으로 연결할 수 없음	기기가 같은 사설 네트워크에 있는지 확인하고 포트와 Windows 사설 네트워크 방화벽을 검사합니다.
Tailscale을 사용할 수 없음	Tailscale이 설치, 실행, 로그인되어 있고 Serve가 켜져 있는지 확인합니다.
QR 코드 만료	“QR 코드 새로고침”을 클릭하고 새 링크로 5분 안에 다시 페어링합니다.
특정 작업 권한이 없음	페어링된 기기 상세 화면에서 라이브러리, 음악, RSS 또는 작업 권한을 확인합니다.

자격 증명, 백업, 스크린샷 보안 안내는 데이터 및 개인정보 보호를 참고하세요.