음악 소스가 연결되지 않거나 로그인에 실패하거나 스캔에서 노래를 찾지 못하는 경우

1단계: 소스 점검 실행

1. 설정 → 소스 관리를 여세요.
2. 문제가 있는 소스를 길게 누르고 소스 진단를 선택하거나, 왼쪽으로 쓸어 넘긴 후 점검을 탭하세요. Mac에서는 소스 메뉴에서 소스 진단를 선택하세요.
3. ‘연결 및 스캔 준비 상태를 확인하는 중...’이 끝날 때까지 기다린 후 검사 항목 아래의 구성, 자격 증명, 연결 등의 항목을 확인하세요.

결과는 ‘스캔 준비됨’, ‘준비됨(경고 있음)’, ‘조치 필요’ 세 가지입니다. 문제를 고친 후 다시 실행을 탭하여 확인하세요.

점검 메시지별 해결 방법

주소와 네트워크

소스를 추가하거나 편집하는 중에 연결에 실패하면 Primuse는 실제로 시도한 주소와 함께 ‘연결 실패’과 힌트를 표시합니다.

• 이 주소는 내부 네트워크 주소라서 같은 네트워크에 있을 때만 연결됩니다.
• 도메인으로 접속할 때 포트는 보통 443이나 80입니다. 서비스 자체 포트는 대개 내부 네트워크에서만 열려 있습니다.
• 이 주소는 암호화 없이 인터넷을 지나기 때문에 많은 서버가 거부합니다.
• 제조사 중계를 거칩니다. 기기가 온라인인지, 원격 접속이 켜져 있는지 확인하세요.

주소 변경을 탭하면 바로 변경할 수 있습니다. 로컬 네트워크의 기기에 처음 연결하면 시스템이 로컬 네트워크 권한을 요청합니다. Primuse가 NAS 기기, 미디어 서버 및 기타 음악 소스를 검색하고 연결하려면 로컬 네트워크 접근 권한이 필요합니다. 이전에 거부했다면 시스템 개인정보 보호 설정에서 Primuse의 로컬 네트워크를 다시 켜세요.

HTTPS 인증서

서버가 자체 서명 인증서나 호스트 이름과 일치하지 않는 인증서를 사용하면 연결할 때 인증서를 확인하라는 요청이 표시됩니다. 확인하면 Primuse가 해당 인증서를 고정하며, 나중에 인증서가 바뀌면 ‘서버 인증서가 변경됨’이 표시됩니다. 현재 서버 인증서가 이전에 확인한 인증서와 다릅니다. 신뢰를 업데이트하기 전에 정보를 확인하세요.

신뢰하는 항목은 설정 → 신뢰하는 도메인(보안 그룹)에서 관리합니다. 수동으로 추가한 엔드포인트도 첫 연결 시 인증서를 확인해야 합니다. 확인한 항목은 인증서 지문에 고정되며 인증서가 바뀌면 다시 묻습니다. 쓸어서 제거할 수 있습니다.

공용 주소의 HTTP

로컬 네트워크 주소는 HTTP를 바로 사용할 수 있습니다. HTTP를 사용하는 공용 호스트에는 ‘안전하지 않은 HTTP 연결을 허용할까요?’이 표시되며, 연결하려면 HTTP 계속 허용을 탭해야 합니다. 허용하지 않은 경우 다음이 표시됩니다. 호스트 ‘…’에는 공용 HTTP 사용 권한이 없습니다. HTTPS를 사용하거나 보안 설정에서 이 호스트를 명시적으로 허용하세요. iPhone과 iPad에서는 허용된 호스트가 신뢰하는 도메인 → HTTP 허용 호스트에 표시됩니다. 이 공용 호스트만 암호화되지 않은 HTTP를 사용할 수 있습니다. 계정 정보, 세션 및 미디어가 노출될 수 있으므로 HTTPS를 우선 사용하세요.

로그인 실패

백그라운드 동기화 중 서버가 비밀번호를 거부하면 ‘로그인 실패’과 ‘로그인에 실패했습니다. 자격 증명 또는 NAS 상태를 확인하세요.’가 표시됩니다. 비밀번호 다시 입력를 탭하여 다시 입력하세요. SMB 소스에는 ‘SMB: 사용자 이름 또는 암호가 잘못되었습니다’가 표시될 수도 있습니다. 2단계 인증을 사용하는 서버(예: Synology)는 한 번 다시 연결하세요.

연결되었지만 노래가 없는 경우

• 점검에서 폴더가 비어 있다고 표시되는 경우: 빈 폴더이거나, 필터링된 보기이거나, 권한이 제한된 계정일 수 있습니다.
• SMB와 NFS는 먼저 공유 또는 내보내기 경로를 설정하세요(먼저 한 번 연결하고 공유 폴더를 선택하면 스캔이 더 빠르고 안정적입니다.).
• 스캔은 백그라운드에서 일시 중지될 수 있으며 앱으로 돌아오면 계속됩니다. 라이브러리 스캔, 새로 고침, 정리 문서를 참고하세요.

여전히 해결되지 않는 경우

진단 정보를 수집해 개발자에게 보내기에 설명된 대로 진단 정보를 보내고, 소스 유형, 로컬 네트워크와 인터넷 중 어느 쪽으로 연결하는지, 문제가 발생한 시점을 함께 알려 주세요.

관련 문서

• 음악 소스 추가 및 관리: 지원 유형, 추가 위치, 자주 쓰는 작업
• NAS 또는 네트워크 공유 연결: Synology, QNAP, SMB, WebDAV, FTP, SFTP, NFS, S3, UPnP
• 미디어 서버 연결: Jellyfin, Emby, Plex, Subsonic/Navidrome, Audiobookshelf, fnOS Music 등
• 클라우드 드라이브 연결: Baidu Netdisk, Aliyun Drive, Google Drive, OneDrive, Dropbox, 123pan, Guangya, pCloud, Drime, InfiniCLOUD

연결 실패의 원인은 대개 다음 중 하나입니다. 기기와 서버가 같은 네트워크에 있지 않음, 주소나 포트가 잘못됨, HTTPS 인증서를 확인할 수 없음, 공용 주소에서 암호화되지 않은 HTTP를 사용함, 비밀번호나 토큰이 만료됨, 클라우드 드라이브 권한이 만료됨, 선택한 폴더를 읽을 수 없음, 서비스 제공업체가 일시적으로 요청을 제한함.