The source YAML successfully launched BookLore on ZimaOS and is valuable as a proof that a two-service BookLore + MariaDB stack works on the platform. But it should not be copied unchanged today. BookLore's maintained deployment now uses updated image names, a clearer .env 원본 YAML은 ZimaOS에서 BookLore를 성공적으로 실행했으며, 플랫폼에서 2개 서비스로 구성된 BookLore + MariaDB 스택이 작동한다는 증거로서 가치가 있습니다. 하지만 현재 그대로 복사해서는 안 됩니다. BookLore의 유지 관리 배포 방식은 이제 업데이트된 이미지 이름과 더 명확한 DISK_TYPE.
원본은 BookLore 웹 서비스 자체가 ZimaOS에서 정상적으로 작동했음을 확인합니다.
원본은 BookLore와 MariaDB를 함께 사용했습니다
게시된 YAML은 비공개 Docker 네트워크에서 두 서비스를 생성했습니다. BookLore는 포트 6060에서 실행되고 LinuxServer MariaDB 컨테이너가 사용됩니다. 또한 애플리케이션 데이터, 책, bookdrop 및 MariaDB 구성을 영구 호스트 폴더에 매핑했습니다.
원본 비밀번호를 재사용하지 마세요 password BookLore 데이터베이스 비밀번호와 MariaDB 루트 비밀번호입니다. 해당 값은 공개된 예시일 뿐 안전한 자격 증명이 아닙니다.
현재 upstream 지침에서는 비밀 값을 다음으로 옮깁니다. .env 파일을 사용하며 사용자가 직접 값을 선택하도록 합니다.
현재 upstream은 booklore-app 이미지 네임스페이스를 사용합니다
현재 BookLore 문서에는 다음이 나와 있습니다 ghcr.io/booklore-app/booklore:latest 를 기본 이미지로 사용하며 MariaDB 11.4 기반 서비스를 계속 사용합니다.
2026년 2월의 이미지 태그를 고정하는 대신 현재 BookLore 배포 가이드를 사용하세요.
데이터, 책, BookDrop 및 데이터베이스 저장소를 분리해 유지하세요
현재 BookLore는 다음에 영구 매핑을 사용합니다.
-
/app/data— 애플리케이션 데이터 및 메타데이터 캐시; -
/books— 관리형 라이브러리; -
/bookdrop— 자동 가져오기/드롭 폴더; - MariaDB 저장소/구성 — 데이터베이스 상태입니다.
대용량 라이브러리를 ZimaOS-HD에 기본 저장하지 마세요
원본은 다음을 혼합했습니다 /media/ZimaOS-HD/AppData 및 /DATA/AppData. 현재 ZimaOS에서는 애플리케이션 데이터와 라이브러리를 시스템 드라이브에 가득 채우기보다 실제 스토리지 풀에 보관할 것을 권장합니다.
1000으로 가정하지 말고 USER_ID 및 GROUP_ID 확인
원본은 UID/GID를 1000으로 하드코딩했습니다. 한 환경에서는 작동할 수 있지만, 현재 컨테이너와 호스트 폴더는 선택한 저장 경로의 실제 소유권 및 권한과 대조하여 확인해야 합니다.
현재 Compose에는 BookLore 상태 확인이 추가되어 있습니다
최신 upstream Compose에는 BookLore용 HTTP 상태 확인과 데이터베이스 상태 의존성이 포함되어 있습니다. 이는 두 컨테이너를 단순히 시작한 뒤 MariaDB가 제때 준비되기를 기대하는 것보다 더 나은 시작 동작을 제공합니다.
출처의 모바일 문제는 ZimaOS 설치 실패가 아니었습니다.
작성자는 웹 인터페이스는 좋았지만 Komga 호환 모바일 연결 시도는 성공하지 못했다고 말했습니다. 이후 MoonReader는 OPDS를 통해 작동했다고 밝혔습니다.
이는 BookLore 서버 자체가 실패했다는 증거가 아니라 BookLore와 클라이언트 간 프로토콜 호환성 문제로 진단해야 합니다.
많은 독서 앱에는 OPDS가 더 적합합니다
현재 BookLore는 웹을 통한 독서 및 라이브러리 관리와 함께 OPDS를 강조합니다. 모바일 앱이 OPDS를 지원한다면 Komga 호환 계층을 억지로 사용하지 말고 BookLore의 최신 OPDS 엔드포인트와 인증된 사용자를 사용하세요.
데이터베이스와 라이브러리를 모두 백업하기
데이터베이스에는 메타데이터, 사용자, 책장, 독서 상태 및 설정이 포함되며, books 폴더에는 실제 파일이 들어 있습니다. 백업 계획은 두 항목을 모두 보호해야 합니다.
현재 BookLore는 LOCAL 및 NETWORK 스토리지를 구분합니다
최신 BookLore에는 다음 기능이 포함되어 있습니다: DISK_TYPE 설정입니다. BookLore가 파일을 직접 관리할 수 있을 때는 LOCAL이 일반 모드입니다. NETWORK는 NFS/SMB 방식의 스토리지를 위한 모드이며 일부 파일 재구성 작업을 비활성화합니다.
라이브러리가 마운트된 위치에 따라 모드를 선택하세요. 이 새로운 동작을 고려하지 않고 소스 YAML을 그대로 복사하지 마세요.
BookDrop은 가져오기용 받은 편지함이지 표준 라이브러리가 아닙니다
The /bookdrop 폴더는 BookLore가 가져올 파일을 위한 폴더입니다. 이 폴더를 다음 폴더와 분리해 두세요: /books 자동 가져오기로 새로 들어온 파일과 관리되는 라이브러리가 구분되지 않도록 합니다.
MariaDB를 일관된 방식으로 백업하기
실행 중인 데이터베이스 디렉터리를 복사하는 것이 일관된 데이터베이스 백업과 항상 동일한 것은 아닙니다. 중요한 라이브러리의 경우 MariaDB를 인식하는 덤프를 사용하거나 파일 시스템 수준의 백업 전에 데이터베이스를 정상적으로 중지한 다음 복원 절차를 확인하세요.
자동 업데이트 전에 버전 고정 또는 검토
출처에서 사용한 버전 최신 BookLore용입니다. 편리하지만 이후에 가져오기를 수행하면 애플리케이션 또는 데이터베이스 변경 사항이 예기치 않게 도입될 수 있습니다. 안정성이 중요하다면 업스트림 릴리스 노트를 검토하고 최신 이미지로 스택을 다시 만들기 전에 데이터베이스를 백업하세요.
ZimaOS의 BookLore FAQ
소스 YAML로 BookLore가 정상적으로 시작되었나요?
예. 작성자는 작동하는 BookLore 대시보드를 게시했습니다.
공개된 소스의 비밀번호 값을 재사용해야 하나요?
아니요. BookLore와 MariaDB에 사용할 고유한 자격 증명을 생성하세요.
출처 작성자에게 어떤 모바일 연결 방식이 작동했나요?
작성자는 MoonReader가 OPDS를 통해 작동했지만 Komga 호환 연결 시도는 성공하지 못했다고 보고했습니다.
