bcleonard/calibre-cops

calibre-cops

该Docker镜像包含构建Calibre与COPS（Calibre OPDS (and HTML) PHP Server）容器所需的Dockerfile及全部必要文件。

COPS（[***]

此容器基于calibre镜像（https://hub.docker.com/r/bcleonard/calibre%EF%BC%89%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%9C%80%E4%BE%9D%E8%B5%96Calibre%E6%95%B0%E6%8D%AE%E5%BA%93%EF%BC%88%E7%94%B1%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%94%9F%E6%88%90%EF%BC%89%E4%BD%9C%E4%B8%BA%E5%89%8D%E7%AB%AF%E8%BF%90%E8%A1%8C%E3%80%82

镜像概述与主要用途

• Calibre：功能全面的电子书管理系统，负责电子书的组织、转换和管理。
• COPS：轻量级Web服务前端，通过OPDS和HTML协议提供电子书访问能力。
• 本容器整合二者，实现电子书库的本地化存储、管理及Web访问功能。

核心功能与特性

• 集成Calibre电子书管理核心，支持多格式电子书（epub、mobi、pdf等）的存储与管理。
• 提供COPS轻量级Web服务，支持OPDS协议（适用于电子书阅读器）和HTML页面（适用于浏览器）访问。
• 包含书籍添加、列出、删除等基础管理脚本。
• 支持通过环境变量自定义库名称，便于多实例区分。

使用场景

• 个人或小型团队搭建私有电子书库，实现电子书集中管理与Web访问。
• 替代Calibre原生内容服务器，提供更轻量的Web服务方案。
• 需要通过OPDS协议供电子书阅读器（如Kindle、Kobo等）访问本地书库的场景。

准备工作

运行容器前，需在主机上预创建以下目录：

sh
library
addbooks

• library目录：用于存放书籍及数据库。
• addbooks目录：用于向库中添加书籍。

示例路径（下文指令将基于此路径）：

sh
/home/books/data/library
/home/books/data/addbooks

请确保在启动容器前创建上述目录。

使用方法

运行容器

sh
docker run -d --name=calibre-cops -v /home/books/data:/data -p 80:80 bcleonard/calibre-cops

• -d：后台运行容器。
• --name=calibre-cops：指定容器名称为calibre-cops。
• -v /home/books/data:/data：将主机的/home/books/data目录挂载到容器内的/data目录（包含library和addbooks子目录）。
• -p 80:80：将容器的80端口映射到主机的80端口，用于Web访问。

访问COPS服务

通过浏览器访问：

http://<docker_host>/

其中<docker_host>替换为Docker主机的IP地址或域名。

COPS配置选项

支持通过环境变量COPSLIBRARYNAME自定义库名称（默认名称为"COPS"）。修改时，在docker run命令中添加--env参数：

sh
docker run -d --name=calibre-cops -v /home/books/data:/data -p 80:80 --env COPSLIBRARYNAME="新库名称" bcleonard/calibre-cops

该功能便于在单台主机上运行多个容器时区分不同书库。

其他操作

列出库中书籍

sh
docker exec calibre-cops /scripts/list-books.sh

从库中删除书籍

sh
docker exec calibre-cops /scripts/remove-books.sh -i <book_id>

其中<book_id>为书籍的ID。

注意事项

1. 关于基础容器的详细说明，请参考calibre镜像文档（https://hub.docker.com/r/bcleonard/calibre/%EF%BC%89%E3%80%82
2. 若需使用基础容器的所有选项，请将容器名称替换为--name=calibre-cops（原基础容器名称为--name=calibre）。
3. 建议拉取版本化容器镜像，而非使用latest标签，以确保稳定性。