这个项目能做什么
Calibre-Web Automated(CWA)是一个基于 Calibre-Web 构建的自托管数字图书馆项目。其既定目标是将 Calibre-Web 现代、轻量的网页界面与 Calibre 更广泛的功能集相结合,并加入更多自动化能力。README 解释说,容器化的 Calibre 依赖 KasmVNC 界面,在移动端操作不便且相对耗费资源,而原版 Calibre-Web 又缺少一些核心功能,因此许多用户不得不并行运行这两个服务。
CWA 保留了原版 Calibre-Web 的全部功能,包括响应式 Bootstrap HTML5 界面、按用户划分的权限、面向电子书阅读器应用的 OPDS 订阅源、元数据编辑及从可扩展来源下载、下载限制、公开注册、一键发送到阅读器、Kobo 设备同步、多种格式的浏览器内阅读、按分类和自定义列隐藏内容、Magic Link 登录、高级搜索与筛选,以及多语言界面。
README 中描述的 CWA 专属新增功能包括:
- 自动导入服务,支持 27 种电子书格式,并带有可配置的忽略和自动转换规则。
- 自动转换服务,默认开启,目标格式为 EPUB、MOBI、AZW3、KEPUB 或 PDF,支持 28 种输入文件类型。
- 自动强制写入通过网页界面所做的封面和元数据更改,使编辑内容写入图书文件本身,而不仅仅停留在界面中。
- 自动化备份服务,默认将原始文件存储在 /config/processed_books 中。
- 智能重复检测,使用混合 SQL 与模糊匹配,具备导入后检查、定时增量扫描、一键合并、批量操作和可选自动处理功能。
- Magic Shelves:基于规则的动态书架,支持 AND/OR 逻辑、预置模板、缓存计数和 Kobo 同步支持。
- 导入后自动发送到阅读器,可配置延迟、格式选择和多个收件人。
- 导入时自动获取元数据,带有提供方优先级和回退机制。
- 深度统计与分析,支持 CSV 导出、用户筛选和日期范围。
- 增强的发送到阅读器弹窗,支持多个设备和临时地址。
- 自动 EPUB 修复器,基于 innocenat 的 kindle-epub-fix,解决 UTF-8 编码、NCX 超链接问题、无效语言标签、游离图片标签、格式错误的 XML 以及损坏的 CSS/字体等问题;默认启用,并支持每次运行备份和全库批量处理。
- 多格式转换工具,可选择保留原始文件。
- 更多元数据提供方,包括通过 ibdb.dev 接入的 isbndb.com、Hardcover、Kobo 和 LitRes。
- KOReader 同步(KOSync),具备自动部分 MD5 校验和、KOReader、CWA 阅读状态与 Kobo 之间的统一进度、HTTP Basic Auth 以及可下载插件。
- 增强的 OAuth 2.0/OIDC 认证,支持自动发现、手动端点覆盖、JWT 字段映射、基于群组的管理员角色以及连接测试。
- 自动获取 Hardcover ID,作为后台任务运行。
- 图书馆自动检测:如果不存在 Calibre 图书馆则新建一个,或者递归查找并挂载现有图书馆,若发现多个则选择最大的一个。每个实例支持一个图书馆。
- 内部更新通知,将已安装版本与最新 GitHub 发布版本进行比较,每天向管理员显示一次。
- 手动刷新图书馆按钮,用于导入留在导入文件夹中的图书。
- 每天午夜前不久自动压缩备份文件。
- 在图书列表页面进行批量编辑和删除。
部署说明涵盖了网络共享:NETWORK_SHARE_MODE=true 会禁用 metadata.db 和 app.db 上的 SQLite WAL,跳过递归 chown,并将监视器切换为轮询模式。CWA_WATCH_MODE=poll 可以强制使用轮询。Docker Desktop 会被自动检测并使用轮询。在多个代理之后,可以设置 TRUSTED_PROXY_COUNT,因为 Werkzeug ProxyFix 默认只信任一个代理,这会影响会话保护。
安装通过 Docker Compose 进行,提供用于获取 compose 模板的快速安装 curl 命令、面向从原版 Calibre-Web 迁移用户的指南,以及包括默认管理员登录在内的安装后任务。README 还列出了路线图:基于 Svelte 的前端、新的网页阅读器、跨设备进度同步、全文搜索、Calibre 插件支持、拆分图书馆以及通知集成。关联项目包括用于图书下载的 Shelfmark 和基于 Flutter 的 Calibre-Web Companion 应用。
评论
0 人表达喜爱 · 满10人后显示 Deer Point
登录后参与讨论。