개요

BookOrbit은 전자책(EPUB·MOBI 등), PDF, 만화(CBZ·CBR), 오디오북을 내가 운영하는 서버 한 곳에 모으고, 웹 리더·Kobo·KOReader·iPhone/Apple Watch 어디서든 읽던 자리에서 이어 보게 하는 셀프호스팅 독서 플랫폼이다. GeekNews #36261(xguru, 2026-10-30)이 소개했고, 원문 링크는 GitHub 저장소 bookorbit/bookorbit이다.

수집 시점(2026-10-31) 저장소 지표는 스타 5,993개, 포크 404개, TypeScript(서버 NestJS, 클라이언트 Vue), AGPL-3.0이다. 생성이 2026-05-09이니 약 6개월 된 프로젝트이고 최신 릴리스는 v3.6.0(10-28)이다. 홈페이지 bookorbit.app에 가입 없이 써 볼 수 있는 라이브 데모가 있다(공공 도메인 도서 샘플, 관리 기능 일부 제한).

핵심: 읽던 자리를 기기 사이에서 잇는다

차별점은 기능 나열보다 동기화 범위다.

  • 3자 양방향 동기화: Kobo 단말, KOReader, BookOrbit 웹 리더 사이에서 진행 위치와 주석(하이라이트 삭제 포함)이 서로 오간다.
  • KOReader 플러그인: 서버에서 내려받은 bookorbit.koplugin을 단말의 koreader/plugins/에 복사하면 된다. 서버 주소·자격증명이 미리 들어 있어 단말에서 입력할 것이 없다. 단말 안에서 서버의 책을 검색·다운로드하고 읽기 상태와 평점도 관리한다.
  • 글+낭독 EPUB(Read Along): 낭독되는 문장을 표시하고, 듣기를 멈춘 자리에서 바로 눈으로 읽기로 넘어간다. 가진 EPUB과 같은 내용의 오디오북으로 이 EPUB을 만드는 기능이 있으며, 정렬 생성(STAlign)과 QuartzNet 하드웨어 가속은 선택 사항이다. 저자의 사용 예는 “책 한 권당 읽기 위치 하나”: iPhone으로 듣고, Apple Watch에 담아 달리기에서 듣고, Kobo(KOReader)에서 읽고, 노트북에서 이어 읽는다.

기능 요약

영역내용
형식전자책 EPUB·KEPUB·MOBI·AZW3·AZW·FB2, PDF, 만화 CBZ·CBR·CB7, 오디오 M4B·MP3·M4A·OPUS·OGG·FLAC를 내장 리더로 처리
주석웹·KOReader·Kobo 하이라이트를 한 곳에서 검색, 색·스타일·출처로 필터, Markdown·CSV·JSON 내보내기
외부 연동Hardcover(상태·진행·날짜·평점, 과거 기록 역으로 가져오기도 가능), StoryGraph(상태·진행), Readwise(새 하이라이트·메모 자동 전송)
메타데이터Google Books·Open Library·Amazon·Goodreads·Kobo·Hardcover·Audible 등 여러 제공자, 만화는 ComicVine, 라이트노벨은 RanobeDB. 외부 제공자(Douban·FantLab 등)는 별도 컨테이너로 추가
정리라이브러리별 폴더·스캔 규칙·형식 우선순위, 규칙 기반 저장 필터(Smart Scopes)
통계일별 독서 시간, 히트맵, 연속 기록, 연간 목표, 월간 챌린지, 업적 50개 이상
계정사용자별 권한·독서 기록 분리, OIDC로 Authentik·Keycloak·Authelia 연동
전달·유입OPDS, 이메일 Send-to-Kindle, 브라우저 업로드, 폴더 감시 자동 가져오기(Book Dock)
이전Audiobookshelf·Calibre-Web Automated에서 책 정보와 독서 기록을 가져오는 도구

설치와 운영

Docker Compose로 서버 + PostgreSQL을 띄운다. .env에서 반드시 채울 값은 APP_URL, BOOKS_HOST_PATH(책 폴더), POSTGRES_PASSWORD, JWT_SECRET, SETUP_BOOTSTRAP_TOKEN(최초 설정 마법사용 일회성 토큰)이다. 책 폴더 소유자가 UID 1000이 아니면 PUID/PGID를 맞춰야 하며, README는 이것을 첫 스캔 권한 오류의 가장 흔한 원인으로 꼽는다. 서버를 직접 운영하기 싫으면 외부 업체 Zenith의 호스팅도 안내돼 있다.

모바일 앱은 iOS만 정식이다. 공식 iPhone·Apple Watch 앱은 App Store에서 받고, 서버 v3.0.0 이상과 iOS 26/watchOS 26 이상이 필요하다. Android 앱은 Google Play 비공개 테스트 중이라 베타 테스터를 모집하고 있다.

도입 전에 알아둘 것

GeekNews 요약에는 없고 README에만 있는 제약이 도입 판단에 더 중요하다.

  • NAS·네트워크 스토리지 미지원: 책 폴더, 가져오기 폴더, 앱 데이터, PostgreSQL 데이터 모두 로컬 파일시스템이어야 한다. SMB/CIFS, NFS, FUSE·클라우드 마운트에 두면 원자적 rename·잠금·파일 알림 차이로 라이브러리 상태 불일치나 데이터 손상이 날 수 있다고 경고하며, 그런 구성은 지원도 이슈 접수도 하지 않는다. 책을 NAS에 두는 사람이 많은 만큼 가장 먼저 확인할 항목이다.
  • API는 안정된 공개 인터페이스가 아니다: 공식 클라이언트와 함께 진화하며, 서드파티 클라이언트 호환은 보장하지 않는다. 안정적인 연결 수단은 공식 앱, OPDS, Kobo sync, KOReader 플러그인이다.
  • AGPL-3.0 + 추가 조건: 네트워크로 서비스를 제공하면 소스 공개 의무가 따른다. 일부 자료에는 저자 귀속을 요구하는 추가 조건(ADDITIONAL_TERMS)이 별도로 붙는다. 개인 운영에는 영향이 작지만, 수정해서 외부에 제공할 계획이면 전문을 읽어야 한다.
  • 기능 범위가 넓다: README는 도서 요청(indexer·다운로드 클라이언트 연동)과 암호화 키 설정까지 문서화한다. 단순 서재 이상으로 쓰려면 bookorbit.app 문서를 따로 읽어야 한다.

GeekNews 소개와 README의 차이

GeekNews 글(댓글 0개)은 README 기능 절을 한국어로 압축한 것이라 새 사실을 더하지 않는다. 대조해 보니 다음이 어긋나거나 확인되지 않는다.

  • GeekNews는 “iPhone/iPad 앱”이라 쓰지만, README 본문은 iPhone과 Apple Watch만 언급한다. iPad 지원은 README로는 확인되지 않는다.
  • README 서두는 메타데이터 제공자를 “14개”라 하지만 기능 절 제목은 “12개”이고 외부 제공자는 따로 센다. 숫자는 문서 안에서도 일관되지 않으니 쓰지 않는 편이 안전하다.

한계

  • 직접 설치·실행해 확인하지 않았다. 근거는 GeekNews 글과 저자 README 두 가지이고, 동기화 안정성이나 Kobo 호환 범위 같은 동작 품질은 확인되지 않는다.
  • 스타 수는 빠르게 늘고 있지만(6개월 약 6천) 이는 관심도일 뿐 안정성의 근거가 아니다. v3.x까지 올라간 점은 릴리스가 잦다는 뜻이기도 해서, 업그레이드 전 변경 이력을 보는 편이 낫다.
  • 같은 부류의 셀프호스팅 서버로 2026-03-21-project-nomad(오프라인 지식 서버)가 있으나 목적이 다르다. 지식·도구 허브 목록은 moc-productivity, GeekNews 소개 글 모음은 moc-geeknews에서 이어서 볼 수 있다.