01
더 완전한 음악 스캔
음악 파일이 특정 폴더 구조를 따라야 할 필요는 없습니다.
다음과 같은 환경을 지원합니다.
- 복잡한 디렉터리 구조
- 멀티 디스크 앨범
- CUE
- 불완전한 Metadata
- Artist / Album Artist 불일치
- 다양한 오디오 형식
목표는 단순합니다. 폴더 구조나 Metadata가 완벽하게 정리되어 있지 않다는 이유만으로 음악이 누락되지 않도록 하는 것.
Mossca Server
음악 라이브러리를 최대한 빠짐없이 스캔하고 Album과 Artist 중심으로 정리하며, Tag와 Metadata 보조 기능으로 라이브러리를 체계적으로 관리할 수 있습니다.
Web, Mac, iOS에서 접근할 수 있으며 NAS와 대규모 개인 음악 라이브러리에 적합합니다.
Self-hosted · Docker · NAS · Web · macOS · iOS

이미 Navidrome이 있는데 왜 Mossca Server가 필요한가요?
개인 음악 라이브러리를 더 완전하게, 더 명확하게, 그리고 더 쉽게 관리할 수 있도록.
더 강력한 스캔 · 더 빠르고 나은 정리와 탐색 · 더 적은 수작업
더 강력한 스캔: 음악 파일이 어떤 구조로 저장되어 있더라도 가능한 한 빠짐없이 라이브러리에 포함하도록 설계되었습니다.
더 빠르고 나은 정리: 대규모 라이브러리에 최적화되어 있으며 Artist와 Album을 중심으로 하고 Tag를 통해 콘텐츠를 연결합니다.
더 적은 수작업: 라이브러리 원본 데이터의 문제를 자동으로 찾아내고 부족한 정보를 보완하고 정리할 수 있도록 돕습니다.
01
음악 파일이 특정 폴더 구조를 따라야 할 필요는 없습니다.
다음과 같은 환경을 지원합니다.
목표는 단순합니다. 폴더 구조나 Metadata가 완벽하게 정리되어 있지 않다는 이유만으로 음악이 누락되지 않도록 하는 것.
02
Mossca Server는 Album · Artist를 중심으로 음악 라이브러리를 구성합니다.
Mossca는 개인 음악 컬렉션의 핵심이 Artist와 Album이라고 생각합니다. 하나의 앨범은 하나의 완전한 작품 표현입니다.
03
Genre, Year 같은 고정 필드 외에도 Tag를 이용해 Album과 Artist를 구성할 수 있습니다.
사용자가 직접 Tag를 편집하고 만들 수도 있습니다.
Tag는 기존의 고정 분류보다 더 유연하게 음악 라이브러리를 구성할 수 있는 방법입니다.
04
Mossca Server는 음악 라이브러리의 Metadata 문제를 지속적으로 감지할 수 있습니다.
누락된 정보에는 보완 후보를 제안할 수 있습니다. 잘못되었을 가능성이 있는 Metadata는 우선 수정 제안을 제공하고, 사용자가 확인한 뒤에만 실제로 기록해 앨범을 하나씩 수동으로 수정하는 번거로움을 줄입니다.
05
수만 장의 Album을 포함하는 대규모 라이브러리에서도 원활하게 사용할 수 있도록 최적화되었습니다.
06
하나의 Mossca Server 음악 라이브러리를 다양한 환경에서 사용할 수 있습니다.
Web
브라우저에서 바로 접근합니다.
Mac / iOS
Mossca 클라이언트에서 탐색하고 재생합니다.
CarPlay
개인 음악 라이브러리를 차량에서도 편리하게 사용할 수 있습니다.
LAN / 원격 접근
가정 내 네트워크에서 사용할 수 있으며, 자체 원격 접근 솔루션과 결합해 외부에서도 접속할 수 있습니다.
하나의 음악 라이브러리, 다양한 환경에서 끊김 없이.
07
개인 음악 컬렉션을 위한 셀프 호스팅 배포, 스캔, 정리 및 멀티 디바이스 접근 기능.
배포 및 실행
배포 방식
Docker · NAS / Home Server · Desktop Server
지원 환경
Synology · QNAP · Unraid · TrueNAS · Linux · macOS with Docker · Windows Desktop
이미지 및 포트
ghcr.io/fungansar/mossca-server:latest
기본 포트: 45331
음악 라이브러리 및 스캔
음악 디렉터리
음악 디렉터리를 /music에 마운트합니다. 복잡한 하위 폴더, 다중 계층 구조 및 대규모 음악 라이브러리를 지원합니다.
지원 형식
FLAC · WAV · AIFF · ALAC / M4A · MP3 · AAC · DSD (DSF / DFF) · CUE
스캔 기능
전체 스캔 · 증분 스캔 · 멀티 디스크 앨범 · CUE · Album / Artist 집계 · 백그라운드 스캔
구성 및 Metadata
핵심 엔터티
Album · Artist · Track
Metadata
Title · Album · Artist · Album Artist · Track Number · Disc Number · Genre · Year / Date · Composer · Artwork
보조 정리
누락 정보 감지, 보완 후보 제안, 잘못되었을 가능성이 있는 Metadata 경고 및 사용자 확인 후 기록.
접근 및 데이터
클라이언트
Web · macOS · iOS · CarPlay
네트워크 접근
LAN 접근을 지원합니다. 인터넷을 통한 원격 접근은 자체 도메인, Reverse Proxy 또는 터널링 솔루션과 결합할 수 있습니다.
데이터 저장
Server 데이터는 /data에 연결된 Docker 볼륨에 저장되며 음악 파일은 읽기 전용으로 마운트됩니다.
사양 안내
일부 Metadata 보조 정리 기능과 Tag 구성 기능은 아직 개발 중입니다. 실제 사용 가능한 기능은 현재 배포 버전을 기준으로 합니다.
더 완전한 스캔, Album과 Artist 중심 구성, Tag를 통한 지속적인 정리, Metadata 보완, 그리고 대규모 라이브러리를 위한 최적화.
이것이 Mossca Server입니다.
Mossca Server
Docker가 익숙하지 않다면 Docker / Container Manager를 사용하세요. 터미널은 필요하지 않습니다.
1. NAS, Mac, Windows 또는 Linux에 Docker를 설치합니다.
2. Docker / Container Manager에서 아래 이미지를 검색해 다운로드합니다.
ghcr.io/fungansar/mossca-server:latest3. 컨테이너를 만듭니다. 포트 45331 → 45331, 음악 폴더 → /music(읽기 전용), 데이터 폴더 → /data를 설정합니다.
Your Music Folder → /music
Server Data Folder → /data
Port → 453314. 컨테이너를 시작하고 브라우저에서 로컬 주소를 엽니다. SERVER_IP는 실행 장치의 IP 주소로 바꾸세요.
http://SERVER_IP:453315. 컨테이너 Logs에서 Pairing code를 찾아 복사합니다.
6. Mossca의 Music Server → Add Server → Mossca Server에서 주소와 코드를 입력합니다.
외부 접속은 선택 사항입니다. 집에서는 로컬 주소만으로 사용할 수 있습니다.
Docker를 사용해 배포합니다. Docker, 음악 디렉터리, 그리고 NAS, Mac, Windows 또는 Linux 기기만 있으면 됩니다.
1. compose.yaml 만들기
새 폴더를 만들고 compose.yaml 파일을 생성합니다. /path/to/Music을 실제 음악 디렉터리 경로로 변경하세요.
services:
mossca-server:
image: ghcr.io/fungansar/mossca-server:latest
restart: unless-stopped
ports:
- "45331:45331"
volumes:
- /path/to/Music:/music:ro
- mossca-data:/data
volumes:
mossca-data:2. Mossca Server 시작
해당 디렉터리에서
docker compose up -d를 실행한 뒤
docker ps로 컨테이너가 정상 실행 중인지 확인합니다.
3. 페어링 코드 확인
docker compose logs mossca-server | grep "Pairing code"를 실행하고 터미널에 표시된 페어링 코드를 기록합니다.4. Mossca 클라이언트에 추가
Music Server → Add Server → Mossca Server를 선택하고 http://서버IP:45331을 입력한 뒤 페어링 코드를 입력합니다.5. Web Player 접속
로컬 네트워크에서는 http://서버IP:45331을 열면 됩니다. 원격 접속에는 자체 도메인, Reverse Proxy 또는 터널링 솔루션을 사용할 수 있습니다.
6. 버전 업데이트
compose.yaml이 있는 디렉터리에서
docker compose pull을 실행한 뒤
docker compose up -d를 실행합니다.
자주 사용하는 명령어
docker compose up -d # 시작
docker compose down # 중지
docker compose logs -f # 로그 보기
docker compose pull # 업데이트 가져오기음악 폴더는 /music에 읽기 전용으로 마운트되며 Server 데이터는 Docker 볼륨 mossca-data에 저장됩니다.
닫기 버튼: 닫기