bermudasunfish/calibre-web

Calibre Web 镜像（支持旧设备与OpenID Connect）

镜像概述

本镜像基于Calibre Web构建，是一个轻量级Web应用，用于管理和访问Calibre电子书库。相较于标准版本，其特别增强了对旧设备的兼容性，并集成OpenID Connect认证功能，提升系统安全性与可扩展性。

核心功能与特性

• 旧设备支持：优化对低配置或老旧设备（如旧款电子书阅读器、低端浏览器）的兼容性，确保在这些设备上正常访问和使用电子书库。
• OpenID Connect集成：支持通过OpenID Connect协议进行身份认证，可与主流身份提供商（如Keycloak、Auth0等）集成，实现统一身份管理和单点登录。
• Calibre Web基础功能：包含标准Calibre Web的全部功能，如电子书上传/下载、元数据管理、分类标签、阅读历史记录等。

使用场景与适用范围

• 个人电子书管理：个人用户通过Web界面便捷管理本地或远程存储的电子书库。
• 家庭共享：家庭内部多设备（包括旧款设备）共享电子书资源，无需安装Calibre客户端。
• 企业/组织环境：结合OpenID Connect实现企业级身份认证，适用于需要统一权限管理的组织电子书库。

使用方法与配置说明

基本部署（docker run）

bash
docker run -d \
  --name calibre-web \
  -p 8083:8083 \
  -v /path/to/calibre/library:/books \
  -v /path/to/config:/config \
  [镜像名称]

参数说明：

• -p 8083:8083：映射容器端口8083到主机，默认Web访问端口。
• -v /path/to/calibre/library:/books：挂载本地Calibre库目录到容器内/books。
• -v /path/to/config:/config：挂载配置目录，用于持久化应用设置。

OpenID Connect配置

通过环境变量设置OpenID Connect参数（具体参数需参考镜像文档）：

• OIDC_ENABLED=true：启用OpenID Connect认证。
• OIDC_PROVIDER_URL=https://your-oidc-provider.com：OIDC提供商URL。
• OIDC_CLIENT_ID=your-client-id：客户端ID。
• OIDC_CLIENT_SECRET=your-client-secret：客户端密钥。

旧设备优化

默认启用旧设备兼容模式，自动适配低分辨率屏幕和旧版浏览器，无需额外配置。

注意事项

• 首次启动需通过Web界面完成初始设置，包括Calibre库路径配置。
• 确保挂载的Calibre库目录具有读写权限，避免权限问题导致无法管理电子书。
• OpenID Connect配置需与身份提供商的设置匹配，否则可能导致认证失败。