slskd
SHA-256Soulseek 파일 공유 네트워크 기반의 모던 Web 클라이언트-서버 애플리케이션으로, 보안 접속 및 Docker 배포를 지원합니다.
브라우저로 Soulseek를 마스터하고, 파일을 손쉽게 원격으로 다운로드하세요.
주요 기능
- Web 인터페이스 관리: 클라이언트를 설치할 필요 없이 브라우저만 열면 검색 및 다운로드 가능
- 안전한 액세스: Token 인증 + 리버스 프록시 지원으로 공용 네트워크 노출에 적합
- Docker 원클릭 배포: PUID/PGID 지원, 미디어 서버와 완벽하게 통합
- 다운로드 관리: 사용자 및 폴더별 그룹화, 대기열 위치 표시, 일괄 작업
- 검색 기능: 다중 키워드 병렬 검색, 정렬 및 필터링 지원
할 수 없는 것
- •기본 사용자 이름과 비밀번호는 모두 slskd이며, 공용 네트워크에 노출되는 경우 즉시 변경하세요. 2. SLSKD_REMOTE_CONFIGURATION을 활성화하면 Web에서 구성을 수정할 수 있지만, 공용 네트워크에서 사용할 때는 주의하세요. 3. 포트 50300은 수신 연결을 위해 방화벽에서 열어야 합니다. 4. HTTPS는 자체 서명 인증서를 사용하며, 프로덕션 환경에서는 리버스 프록시와 Let's Encrypt를 함께 사용하는 것이 좋습니다.
사용 사례
- 자체 프라이빗 파일 다운로드 서버를 구축하고 Soulseek 다운로드 작업을 원격으로 관리
- Jellyfin/Plex 등 미디어 서버와 연동하여 음악/영화 다운로드 자동화
상세 설명
slskd는 Soulseek P2P 파일 공유 네트워크를 웹으로 옮겨온 현대적인 클라이언트-서버 애플리케이션입니다. 데몬 또는 Docker 컨테이너로 실행되며 브라우저를 통해 액세스할 수 있고, token 인증으로 보안을 유지합니다. 검색, 결과 정렬 및 필터링, 다운로드 관리(대기열 정보 포함), 사용자 공유 탐색, 채팅 등의 기능을 제공합니다. 셀프 호스팅을 위해 설계되었으며 리버스 프록시를 지원하여 홈 서버나 클라우드 배포에 매우 적합합니다. 공식 Soulseek 클라이언트와 비교하여 slskd는 깔끔한 웹 인터페이스를 제공해 원격 액세스가 편리하며, Docker 생태계의 미디어 관리 도구(*arr 제품군 등)와 원활하게 연동됩니다.
문제 해결 & FAQ (2)
문제 해결왜 slskd 0.25.1에서 "Property 'retry' not found"가 표시되고 retry 설정이 무시되나요?
retry 옵션은 slskd 0.25.1에서는 사용할 수 없습니다. 이 기능은 아직 릴리스되지 않았으며 master 문서에만 나와 있습니다. 0.25.1 stable을 실행하는 경우 slskd.yml에서 retry: 블록을 제거하세요. 릴리스되지 않은 retry 설정을 사용하려면 canary Docker 이미지로 전환하고 구성 변경이 있을 수 있음을 감안하세요. 그렇지 않으면 0.26.x와 같이 해당 기능이 포함된 stable 릴리스를 기다리세요. **System → Info**에서 실행 중인 버전을 확인하고, master가 아닌 사용 중인 릴리스 태그에 맞는 문서를 참조하세요.
문제 해결slskd에서 공유 디렉터리 별칭을 사용할 때 발생하는 "aliases may not contain path separators '/' or '\\'" 오류를 해결하는 방법
이는 slskd 0.24.5.0의 파싱 버그입니다: 별칭 파서가 첫 번째 ] 대신 마지막 ]를 사용하기 때문에 경로 뒷부분의 대괄호 문자(예: [id])가 별칭의 일부로 잘못 처리됩니다. 수정 사항이 포함된 canary 빌드 또는 다음 릴리스로 업그레이드하세요. 임시 해결 방법으로 공유 경로에서 대괄호를 제거하거나 별칭 접두사를 생략하세요.
태그
시작하기
소프트웨어 설치
배포판에 맞는 패키지를 설치 (dpkg / rpm / AppImage)
Docker 방식: docker run -d -p 5030:5030 -p 5031:5031 -p 50300:50300 -e SLSKD_REMOTE_CONFIGURATION=true -v /your/data:/app --name slskd slskd/slskd:latest 실행
http://localhost:5030 에 접속하여 기본 계정 slskd/slskd 로 로그인
Web 인터페이스에서 Soulseek 계정과 다운로드 경로를 설정한 후 사용 시작
- Docker 방식: docker run -d -p 5030:5030 -p 5031:5031 -p 50300:50300 -e SLSKD_REMOTE_CONFIGURATION=true -v /your/data:/app --name slskd slskd/slskd:latest 실행
- http://localhost:5030 에 접속하여 기본 계정 slskd/slskd 로 로그인
- Web 인터페이스에서 Soulseek 계정과 다운로드 경로를 설정한 후 사용 시작
SHA-256 체크섬 확인됨
GitHub 공식 Release 페이지에서 추출된 체크섬
SHA256 체크섬
5435531bd256a13c026180e30f3123a5d9f61e5653eca149cd93f1acfdbc2b99이 체크섬은 GitHub Release 페이지에서 추출되었습니다. 다운로드 후 파일 무결성을 확인하세요.
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
Docker 방식: docker rm -f slskd를 실행하고 데이터 볼륨을 삭제합니다. 바이너리 방식: 압축 해제 디렉터리와 ~/.local/share/slskd(Linux) 또는 %localappdata%/slskd(Windows) 디렉터리를 삭제합니다.
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
2 FAQs