mStream
SHA-256가장 사용하기 쉬운 셀프 호스팅 음악 스트리밍 서버로, 원본 폴더 구조를 그대로 유지하며 스캔 없이 바로 재생할 수 있습니다.
스캔 없이, 라이브러리 구축 없이, 폴더를 그대로 플레이어처럼 사용하는 음악 서버.
주요 기능
- 파일이 곧 음악: 디렉터리에 파일을 추가하고 웹페이지를 새로고침하면 즉시 재생 가능
- 웹 파일 관리자: 업로드, 새 폴더 생성, 이름 변경, YouTube 동영상 다운로드
- 공용 모드: LAN 내에서 계정 불필요, 설치 즉시 사용 가능
- 세분화된 쓰기 권한: 전역 쓰기 잠금, 업로드/생성/수정 개별 비활성화
- 데스크톱 서버 앱(트레이 실행, 부팅 시 자동 시작) 및 독립 데스크톱 플레이어
할 수 없는 것
- •Subsonic 프로토콜 클라이언트(예: DSub)는 메타데이터를 표시하려면 먼저 스캔을 실행해야 하며, 즉시 재생 환경은 네이티브 UI에서만 지원됩니다
- •공개 모드는 사용자 비밀번호를 설정하지 않으므로 신뢰할 수 있는 로컬 네트워크에서만 사용하는 것을 권장합니다
- •YouTube에서 다운로드하는 기능은 yt-dlp에 의존하므로 직접 설치하고 네트워크 연결이 가능한지 확인해야 합니다
- •처음 사용할 때 폴더 내 음악이 많다면 커버와 파형 미리보기를 생성하기 위해 먼저 스캔을 한 번 실행하는 것을 권장합니다(관리 인터페이스에서 실행 가능)
사용 사례
- 개인 음악 라이브러리 셀프 호스팅: 로컬 음악 폴더를 나만의 비공개 Spotify로 만들기
- 가족/소규모 팀 공유: 공개 모드에서 가족과 친구가 로그인 없이 음악 감상
상세 설명
mStream은 원본 폴더 구조를 그대로 존중하는 셀프 호스팅 음악 스트리밍 서버입니다. 스캔하여 라이브러리에 등록해야 하는 기존 방식과 달리 디스크에서 파일을 직접 스트리밍하므로 새로 추가된 음악을 즉시 사용할 수 있습니다. 웹 기반 파일 관리자를 기본 제공하며 업로드, 새 폴더 만들기, 이름 변경, YouTube 음악 다운로드를 지원합니다. 신뢰할 수 있는 네트워크에서 계정 없이 사용할 수 있는 '퍼블릭 모드'와 데스크톱 서버 및 플레이어 앱을 제공합니다. Subsonic 프로토콜, DLNA 캐스팅, 실시간 트랜스코딩과 호환되며 Rust 멀티스레드 스캐너를 채택했습니다. 가볍고 크로스 플랫폼이며 SQLite에만 의존하므로 외부 데이터베이스가 필요하지 않습니다.
문제 해결 & FAQ (1)
문제 해결mStream의 recently-played 및 most-played API가 limit 파라미터를 사용하는 대신 모든 결과를 반환하는 이유는 무엇인가요?
이것은 mStream의 버그였습니다: recently-played 및 most-played 데이터베이스 쿼리에 .limit(req.body.limit)이 적용되지 않았습니다. 수정 사항이 포함된 최신 커밋 또는 릴리스로 mStream을 업데이트하십시오. 이전 설치 버전을 패치하는 경우, /api/v1/db/recent/added 엔드포인트에서 사용된 구현과 동일하게 src/api/db.js의 해당 쿼리에 .limit(req.body.limit)을 추가하십시오.
태그
시작하기
소프트웨어 설치
배포판에 맞는 패키지를 설치 (dpkg / rpm / AppImage)
공식 웹사이트 또는 GitHub Releases에서 해당 시스템용 설치 패키지를 다운로드한 후 더블클릭하여 실행합니다 (또는 npm install을 통해 소스에서 설치)
마법사를 실행하고(npm run-script wizard 또는 첫 실행 화면) 음악 폴더 경로와 관리자 비밀번호를 설정합니다
애플리케이션을 시작한 후 브라우저에서 http://localhost:3333에 접속하면 바로 사용할 수 있습니다
- 공식 웹사이트 또는 GitHub Releases에서 해당 시스템용 설치 패키지를 다운로드한 후 더블클릭하여 실행합니다 (또는 npm install을 통해 소스에서 설치)
- 마법사를 실행하고(npm run-script wizard 또는 첫 실행 화면) 음악 폴더 경로와 관리자 비밀번호를 설정합니다
- 애플리케이션을 시작한 후 브라우저에서 http://localhost:3333에 접속하면 바로 사용할 수 있습니다
SHA-256 체크섬 확인됨
GitHub 공식 Release 페이지에서 추출된 체크섬
SHA256 체크섬
8620206f76616484de8f697b1176d2611513580bc7823deac9e7999242b9837e이 체크섬은 GitHub Release 페이지에서 추출되었습니다. 다운로드 후 파일 무결성을 확인하세요.
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
Windows는 「제어판 → 프로그램 및 기능」으로 이동하여 제거하고, macOS는 앱을 휴지통으로 드래그하며, Linux는 설치 디렉터리와 ~/.config/mstream 설정 폴더를 삭제하면 됩니다.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
1 FAQ