BookHeaven/BookHeaven.Server

어떤 프로젝트인가요?

핵심 기능

• 01책을 작가, 시리즈, 컬렉션, 태그별로 정리
• 02메타데이터와 표지 수정 및 변경 사항을 전자책 파일에 저장
• 03인터넷에서 표지와 메타데이터 가져오기
• 04프로필별 독서 진행 상황 추적 및 수동 조정
• 05/opds/v1의 OPDS 피드 및 KOReader Sync 지원
• 06BookHeaven Reader Android 앱의 서버 자동 검색

활용 사례

• 홈 서버에서 개인 전자책 라이브러리를 호스팅하고 여러 기기에서 읽기
• OPDS를 지원하는 전자책 앱에 카탈로그 제공
• KOReader와 중앙 서버 간 독서 진행 상황 동기화
• 책을 읽는 기기에서 사용할 사용자 지정 폰트 관리

빠른 시작

1. 1

   GitHub Container Registry에서 컨테이너 이미지를 pull합니다

   docker pull ghcr.io/bookheaven/bookheaven-server:latest
2. 2

   Docker run으로 서버를 시작하고 웹 UI 포트와 데이터 폴더를 매핑합니다

   docker run -d --name bookheaven --user 1000:1000 -p 8080:8080 -p 27007:27007/udp -v $PWD/data:/app/data -v $PWD/import:/app/import -e SERVER_URL=https://bookheaven.yourdomain.tld ghcr.io/bookheaven/bookheaven-server:latest
3. 3

   브라우저에서 포트 8080의 웹 UI를 엽니다

사용 전 알아둘 점

• !SQLite를 사용하므로 데이터 폴더를 네트워크 공유 위치에 저장하는 것은 권장하지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

BookHeaven.Server은(는) 무엇인가요?

OPDS, KOReader Sync, BookHeaven Reader Android 앱용 API를 제공하는 전자책 라이브러리 관리용 셀프 호스팅 웹 서버입니다. BookHeaven Server는 자신의 컴퓨터에서 전자책 라이브러리를 정리하고 읽을 수 있는 웹 애플리케이션입니다. 책을 작가, 시리즈, 컬렉션별로 분류하고 태그를 지원하며, 전자책 파일에서 메타데이터를 직접 읽습니다. 제목, 작가, 표지를 수정하면 변경 사항이 파일에 반영되며, 인터넷에서 표지와 메타데이터를 가져올 수도 있습니다.

BookHeaven.Server은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

BookHeaven.Server은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

BookHeaven.Server은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. BookHeaven.Server의 마지막 커밋은 2026년 11월 5일입니다.

BookHeaven.Server은(는) 어디에 사용할 수 있나요?

홈 서버에서 개인 전자책 라이브러리를 호스팅하고 여러 기기에서 읽기 OPDS를 지원하는 전자책 앱에 카탈로그 제공 KOReader와 중앙 서버 간 독서 진행 상황 동기화 책을 읽는 기기에서 사용할 사용자 지정 폰트 관리

BookHeaven.Server는 어떻게 설치하나요?

GitHub Container Registry에서 컨테이너 이미지를 pull합니다: docker pull ghcr.io/bookheaven/bookheaven-server:latest Docker run으로 서버를 시작하고 웹 UI 포트와 데이터 폴더를 매핑합니다: docker run -d --name bookheaven --user 1000:1000 -p 8080:8080 -p 27007:27007/udp -v $PWD/data:/app/data -v $PWD/import:/app/import -e SERVER_URL=https://bookheaven.yourdomain.tld ghcr.io/bookheaven/bookheaven-server:latest 브라우저에서 포트 8080의 웹 UI를 엽니다

BookHeaven.Server은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/BookHeaven/BookHeaven.Server