gonic
SHA-256Subsonic API를 구현하고 다양한 클라이언트를 지원하는 무료 음악 스트리밍 서버.
자체 구축 개인 음악 서버, 가볍고 빠르며 다중 클라이언트 지원.
주요 기능
- 폴더 또는 태그로 음악을 탐색하고 원본 디렉토리 구조 유지
- 실시간 오디오 트랜스코딩 및 캐싱 (ffmpeg 필요)
- 팟캐스트 구독 및 관리 지원
- 다중 사용자 시스템, 사용자별 독립적인 재생 목록 및 환경 설정 제공
- Last.fm / ListenBrainz 통합으로 재생 기록 저장
할 수 없는 것
- •첫 스캔은 시간이 오래 걸립니다. 트랜스코딩 기능을 사용하려면 ffmpeg를 별도로 설치해야 합니다. HTTPS는 기본적으로 활성화되어 있지 않으므로 리버스 프록시를 통해 TLS를 구성하는 것이 좋습니다. 일부 고급 기능(예: Jukebox)은 mpv를 추가로 구성해야 합니다.
사용 사례
- 가정용 프라이빗 음악 서버를 구축하여 언제 어디서나 휴대폰/컴퓨터로 음악 감상
- 상용 스트리밍 서비스를 대체하고 개인 음악 컬렉션의 프라이버시 보호
상세 설명
Gonic은 Subsonic API를 구현한 무료 경량 음악 스트리밍 서버입니다. 폴더 또는 태그별로 음악 컬렉션을 탐색하고, 오디오를 실시간으로 트랜스코딩하며, 팟캐스트를 관리하고, 다중 사용자 맞춤 설정을 지원합니다. Go 언어로 작성되었으며 Raspberry Pi와 같은 저전력 기기에서도 효율적으로 실행할 수 있습니다. Last.fm 및 ListenBrainz와 통합되어 재생 기록을 기록하고 아티스트 정보를 가져옵니다. 서버에는 Web 관리 인터페이스가 내장되어 있으며 DSub, Symfonium, Strawberry 등 다양한 클라이언트와 호환됩니다.
문제 해결 & FAQ (2)
문제 해결gonic에서 포괄 규칙 없이 트랜스코딩을 활성화하는 방법은?
gonic을 버전 0.20 이상(master branch)으로 업데이트하세요. 서버는 서버 측 트랜스코드 환경설정이 설정되지 않아도 클라이언트가 최대 비트레이트 또는 형식을 요청하는 경우 오디오를 트랜스코딩합니다. 트랜스코딩된 트랙에서 탐색을 위해 gonic은 timeOffset 파라미터를 지원합니다. 클라이언트(예: Symfonium)가 적절한 트랜스코드 요청을 전송하는지 확인하세요.
문제 해결gonic과 wrtag를 함께 실행할 때 /tmp/go-taglib-wasm에서 발생하는 'permission denied' 오류를 해결하는 방법
gonic과 wrtag는 모두 /tmp/go-taglib-wasm을 먼저 실행한 사용자의 소유권과 0700 권한으로 생성하므로, 두 번째로 실행되는 앱은 permission denied 오류로 실패합니다. 이 문제는 최신(아직 릴리스되지 않은) 코드에서 수정되었습니다: gonic/wrtag를 소스(HEAD)에서 빌드하면 사용자별 디렉터리 /tmp/go-taglib-wasm-<uid>를 대신 사용하게 됩니다. 업그레이드 후에는 rm -rf /tmp/go-taglib-wasm으로 기존 공유 디렉터리를 삭제하세요. 릴리스된 버전에서의 임시 해결 방법으로는 chmod 0777 /tmp/go-taglib-wasm을 실행하여 두 사용자 모두 접근할 수 있도록 하세요.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
Docker로 실행: docker run -d -p 4747:4747 -v /path/to/music:/music -v /path/to/data:/data sentriz/gonic
브라우저를 열어 http://사용자IP:4747 에 접속한 후 기본 계정 admin/admin으로 로그인하세요
Web 인터페이스에서 음악 경로를 설정하고 스캔을 시작하면 지원되는 클라이언트에서 재생할 수 있습니다
- Docker로 실행: docker run -d -p 4747:4747 -v /path/to/music:/music -v /path/to/data:/data sentriz/gonic
- 브라우저를 열어 http://사용자IP:4747 에 접속한 후 기본 계정 admin/admin으로 로그인하세요
- Web 인터페이스에서 음악 경로를 설정하고 스캔을 시작하면 지원되는 클라이언트에서 재생할 수 있습니다
SHA-256 체크섬 확인됨
GitHub 공식 Release 페이지에서 추출된 체크섬
SHA256 체크섬
ab1607c34e2c8edff432ffcc557bfc28a0736fa1901a4ca9f4d24935aacccb1e이 체크섬은 GitHub Release 페이지에서 추출되었습니다. 다운로드 후 파일 무결성을 확인하세요.
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
Docker를 사용하는 경우 Docker 컨테이너를 중지하고 삭제하고, 그렇지 않은 경우 바이너리 파일과 데이터 디렉터리를 삭제하면 됩니다.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
2 FAQs