TL;DR

XCQ0607/lxserver는 LX Music용 데이터 동기화 서버에 웹 음악 플레이어를 결합한 독립 실행형 Node.js 애플리케이션입니다. Express와 WebSocket이 동기화와 WebDAV 백업을 처리하고 Vanilla JS 웹 화면이 다중 소스 검색, 플레이리스트, 가사, 캐시 및 재생 제어를 담당합니다. Docker와 데스크톱 릴리스로 배포할 수 있으며 Subsonic 클라이언트 연동과 사용자별 접근 제어도 지원합니다. 다만 기본 비밀번호를 변경해야 하고 사용자 정의 음원 링크와 저작권 데이터의 적법성은 운영자가 직접 관리해야 합니다.

핵심 포인트

• 이 레포지토리는 LX Music 생태계에 속한 독립 실행형 Node.js 동기화 서버이자 웹 음악 플레이어입니다. Express와 WebSocket 백엔드가 동기화 및 WebDAV 백업을 처리하고 Vanilla JS 기반 Console과 WebPlayer가 각각 관리와 재생을 담당합니다. LX Music 데이터를 여러 기기에서 공유하면서 브라우저 재생까지 한 서버에 통합하려는 경우에 적합합니다.
• Web 플레이어는 여러 음악 플랫폼을 검색하고 다중 플랫폼 플레이리스트와 재생 대기열을 관리합니다. 검색 결과에서 곡을 선택하고 음질·재생 모드·가사·배속·수면 타이머를 조정하며, 가사 카드를 비율과 색상에 맞춰 이미지로 만들 수 있습니다. 화면에는 다크 모드와 여러 테마가 포함되어 있으며 제공된 이미지에서도 검색 화면, 플레이리스트 그리드, 곡 상세 및 재생 인터페이스가 확인됩니다.
• Docker, 데스크톱 릴리스, Git Clone 직접 실행을 지원해 self-hosting 경로가 분명합니다. 기본 포트는 9527이며 Docker에서는 data, logs, cache, music 디렉터리를 볼륨으로 연결하고 npm ci와 npm run build 뒤 npm start로 직접 실행합니다. Node.js 16 이상 환경에서 개인 서버나 가정용 음악 서비스로 배포하기 쉽지만 기본 관리자 비밀번호 123456은 외부 공개 전에 반드시 변경해야 합니다.
• 동기화 서버는 사용자별 경로와 루트 경로를 선택하고 WebDAV 증분 동기화 및 전체 백업을 설정할 수 있습니다. Subsonic 프로토콜과 online, local 및 음악 플랫폼별 검색 접두사를 지원해 음원 스트리밍 클라이언트와 연결할 수 있으며 캐시 용량 제한과 LRU 자동 정리도 제공합니다. 다만 음원 링크는 사용자 정의 소스가 반환하고 프로젝트가 권리나 정확성을 검증하지 않으므로 저작권, 공개 접근 제어, 외부 공개 시 보안 정책을 직접 관리해야 합니다.

이미지 분석