元のYAMLはZimaOS上でBookLoreを正常に起動しており、2サービス構成のBookLore＋MariaDBスタックがこのプラットフォームで動作することを示す有用な証拠です。ただし、現在のままコピーすべきではありません。BookLoreのメンテナンスされているデプロイ構成では、更新されたイメージ名、より明確な .env モデル、ヘルスチェック、次のような明示的なストレージ動作 DISK_TYPE.
元の設定ではBookLoreとMariaDBを使用していました
このYAMLは、プライベートDockerネットワーク上に2つのサービスを作成しました。ポート6060のBookLoreと、LinuxServerのMariaDBコンテナです。また、アプリケーションデータ、書籍、bookdrop、MariaDB設定を永続的なホストフォルダーにマッピングしました。
元のパスワードを再利用しない
元のYAMLでは次を使用していました パスワード BookLoreデータベースのパスワードおよびMariaDBのrootパスワード用。これらは公開例であり、安全な認証情報ではありません。
現在のアップストリームのガイダンスでは、シークレットを次のファイルに移します。 .env ファイルを使用し、ユーザーが独自の値を選択することを想定しています。
現在のアップストリーム版では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のヘルスチェックが追加されています
最新の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用に一意の認証情報を生成してください。
情報源の著者には、どのモバイル接続方法が機能しましたか？
OPDS経由でMoonReaderは動作した一方、Komga互換の試行は成功しなかったと報告されています。
