calibrain/shelfmark

这是什么？

核心功能

• 01可搜索元数据服务，也可直接查询已配置的来源
• 02通过 torrent、usenet、IRC、Soulseek 和 debrid 客户端下载电子书与有声书
• 03多用户账号，支持请求与审批流程
• 04支持本地账号、OIDC 单点登录、反向代理认证和 Calibre-Web 数据库登录
• 05可选的 Library Check，跳过书库中已有的书籍
• 06统一的下载队列，实时显示状态

适用场景

• 为家庭或小团体搭建共享的图书请求入口
• 将下载内容自动投递到 Calibre-Web-Automated 或 Audiobookshelf 的导入目录
• 在一个搜索界面中统一管理多个书籍和有声书来源

快速上手

1. 1

   下载 docker-compose 文件

   curl -O https://raw.githubusercontent.com/calibrain/shelfmark/main/compose/docker-compose.yml
2. 2

   启动服务

   docker compose up -d
3. 3

   打开 http://localhost:8084 网页界面并配置所需的数据源

使用前须知

• !功能已稳定，但仅以尽力而为的方式维护，且暂无新功能路线图。
• !标准 Docker 镜像在使用直接下载时，容器至少需要 2 GB 可用内存。
• !通用搜索模式依赖 Hardcover API 密钥来进行元数据搜索。

收录于专题

标签

常见问题

shelfmark 是什么？

自托管的网页工具，可跨多个来源搜索和请求电子书、有声书，支持多用户与请求审批。 Shelfmark 是一个自托管的网页工具，用于搜索和下载电子书与有声书，可用的来源由使用者自行配置。它既能通过 Hardcover、Open Library、Google Books 等元数据服务搜索书籍，也能直接查询已配置的来源，下载任务可交给 torrent、usenet、IRC、Soulseek（slskd）或 Webshare 等渠道，并支持多种debrid 服务。

shelfmark 可以免费使用吗？用的什么许可证？

shelfmark 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

shelfmark 还在维护吗？

活跃维护中。shelfmark 最近一次提交是在 2026年11月6日。

shelfmark 适合用来做什么？

为家庭或小团体搭建共享的图书请求入口 将下载内容自动投递到 Calibre-Web-Automated 或 Audiobookshelf 的导入目录 在一个搜索界面中统一管理多个书籍和有声书来源

shelfmark 怎么安装和运行？

下载 docker-compose 文件: curl -O https://raw.githubusercontent.com/calibrain/shelfmark/main/compose/docker-compose.yml 启动服务: docker compose up -d 打开 http://localhost:8084 网页界面并配置所需的数据源

在哪里获取 shelfmark？

源代码和安装说明在 GitHub 上：https://github.com/calibrain/shelfmark