bndct-devops/tome

这是什么？

核心功能

• 01通过 TomeSync 插件记录 KOReader 的阅读会话，并双向同步进度。
• 02提供连续阅读、时段热力图、阅读速度和读完预估等阅读统计。
• 03内置 EPUB、CBZ/CBR 和 PDF 阅读器，支持双页和从右到左模式。
• 04提供 OPDS 订阅源，方便电子阅读器应用下载书籍。
• 05可从 Hardcover、Google Books 和 OpenLibrary 获取元数据并对比差异。
• 06支持可选的 OIDC 单点登录和基于角色的权限控制。

适用场景

• 在 NAS 或家庭服务器上为家人搭建共享电子书库，配合 KOReader 设备使用。
• 在电子阅读器和浏览器之间追踪阅读习惯与进度。
• 用浏览器阅读器管理漫画和漫画合集。
• 向局域网内的墨水屏阅读器提供 OPDS 书目服务。

快速上手

1. 1

   使用 Docker 启动 Tome（容器运行在 8080 端口）

   docker run -d --name tome --restart unless-stopped -p 8080:8080 -v ./data:/data -v ./books:/books -v ./bindery:/bindery ghcr.io/bndct-devops/tome:latest
2. 2

   打开 http://localhost:8080，按照设置向导创建管理员账户

使用前须知

• !需要 Docker 并运行 Tome 容器，且必须设置 TOME_SECRET_KEY。
• !完整的 KOReader 同步功能需要 KOReader v2024.07 或更新版本以及自定义的 TomeSync 插件。
• !部分功能依赖已配置的 Hardcover、Google Books 或 OIDC 服务。
• !采用 AGPL-3.0 许可证，属于具有网络使用约束的 Copyleft 许可证。

收录于专题

标签

常见问题

tome 是什么？

自托管电子书库服务器，内置阅读器，支持 KOReader 阅读同步、OPDS 订阅和阅读统计，以单个 Docker 镜像部署。 Tome 是一个自托管电子书库服务器，基于 FastAPI、React 和 SQLite 构建，以单个 Docker 镜像发布。它与 KOReader 深度集成：自研的 TomeSync 插件在阅读器上记录每次阅读会话，并在设备与网页之间双向同步阅读进度，设备离线时也能正常工作。

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

tome 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

tome 还在维护吗？

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

tome 适合用来做什么？

在 NAS 或家庭服务器上为家人搭建共享电子书库，配合 KOReader 设备使用。 在电子阅读器和浏览器之间追踪阅读习惯与进度。 用浏览器阅读器管理漫画和漫画合集。 向局域网内的墨水屏阅读器提供 OPDS 书目服务。

tome 怎么安装和运行？

使用 Docker 启动 Tome（容器运行在 8080 端口）: docker run -d --name tome --restart unless-stopped -p 8080:8080 -v ./data:/data -v ./books:/books -v ./bindery:/bindery ghcr.io/bndct-devops/tome:latest 打开 http://localhost:8080，按照设置向导创建管理员账户

在哪里获取 tome？

源代码和安装说明在 GitHub 上：https://github.com/bndct-devops/tome