calibre web

Calibre-Web

Calibre-Web 是一款网络应用程序，提供干净直观的界面，用于使用有效的 Calibre 数据库浏览、阅读和下载电子书。

目录（点击展开）

1. 关于
2. 特征
3. 安装
   • 通过pip安装（推荐）
   • 快速启动
   • 要求
4. Docker 镜像
5. 故障排除
6. 贡献者认可
7. 接触
8. 为 Calibre-Web 做出贡献

该软件是库的一个分支，并根据 GPL v3 许可证获得许可。

特征

• 现代且响应迅速的 Bootstrap 3 HTML5 界面
• 完整的图形设置
• 全面的用户管理以及细粒度的每用户权限
• 管理界面
• 支持 20 多种语言的多语言用户界面（受支持的语言）
• 电子书阅读器应用程序的 OPDS 源
• 高级搜索和过滤选项
• 定制书籍收藏（书架）创建
• 电子书元数据编辑和删除支持
• 从各种来源下载元数据（可通过插件扩展）
• 通过 Calibre 二进制文件转换电子书
• 对登录用户的电子书下载限制
• 公共用户注册支持
• 只需单击一下即可将电子书发送到电子阅读器
• 将 Kobo 设备与您的 Calibre 库同步
• 浏览器内电子书阅读支持多种格式
• 上传各种格式的新书，包括音频格式
• Calibre 自定义列支持
• 根据每个用户的类别和自定义列内容隐藏内容
• 自我更新能力
• “Magic Link”登录可轻松访问电子阅读器
• LDAP、Google/GitHub OAuth 和代理身份验证支持

安装

通过pip安装（推荐）

1. 创建虚拟环境：隔离 Calibre-Web 安装以避免依赖性冲突至关重要。您可以通过运行以下命令来创建虚拟环境：

    python3 -m venv calibre-web-env
   

2. 激活虚拟环境：

    source calibre-web-env/bin/activate
   

3. 安装 Calibre-Web ：使用 pip 安装应用程序：

    pip install calibreweb
   

4. 安装可选功能：对于附加功能，您可能需要安装可选功能。有关可安装内容的详细信息，请参阅此页面。
5. 启动 Calibre-Web ：安装后，您可以通过以下方式启动应用程序：

    cps
   

注意：Raspberry Pi 操作系统的用户可能会遇到安装问题。如果这样做，请尝试升级 pip 和/或安装 Cargo，如下所示：

 ./venv/bin/python3 -m pip install --upgrade pip
sudo apt install cargo

重要链接

• 有关其他安装示例，请检查以下内容：
  • 手动安装
  • Linux Mint 安装
  • 云提供商设置

快速入门

1. 访问 Calibre-Web ：打开浏览器并导航至：

    http://localhost:8083
   

   或者对于 OPDS 目录：

    http://localhost:8083/opds
   

2. 登录：使用默认管理员凭据：
   • 用户名：管理员
   • 密码： admin123
3. 数据库设置：如果您没有 Calibre 数据库，请从以下位置下载示例：

    https://github.com/janeczku/calibre-web/raw/master/library/metadata.db
   

   将其移出 Calibre-Web 文件夹以避免更新期间被覆盖。
4. 配置 Calibre 数据库：在管理界面中，将Location of Calibre database设置为包含 Calibre 库的文件夹路径（ metadata.db所在的位置），然后单击“保存”。
5. Google Drive 集成：要在 Google Drive 上托管您的 Calibre 库，请参阅 Google Drive 集成指南。
6. 管理配置：通过管理页面配置您的实例，请参阅基本配置和 UI 配置指南。

要求

• Python 版本：确保您有 Python 3.7 或更高版本。
• Imagemagick ：从 EPUB 中提取封面所需。 Windows 用户可能还需要安装 Ghostscript 来提取 PDF 封面。
• 可选工具：
  • Calibre 桌面程序：推荐用于即时转换和元数据编辑。在设置页面设​​置 Calibre 转换器工具的路径。
  • Kepubify 工具：Kobo 设备支持所需。下载该工具并将二进制文件放置在 Linux 上的/opt/kepubify或 Windows 上的C:Program Fileskepubify中。

Docker 镜像

预构建的 Docker 镜像可用：

Linux 服务器 - x64、aarch64

• Docker 中心：linuxserver/calibre-web
• GitHub : linuxserver/docker-calibre-web
• 可选的 Calibre 层：linuxserver/docker-mods

要包含 Calibre ebook-convert二进制文件（仅限 x64），请添加环境变量：

 DOCKER_MODS=linuxserver/mods:universal-calibre

在您的 Docker 运行/撰写文件中。对于轻量级图像，省略此变量。

• 路径配置：
  • 将Calibre 二进制文件的路径设置为/usr/bin 。
  • 将Unrar 的路径设置为/usr/bin/unrar 。

故障排除

• 常见问题：

  • 如果您在启动应用程序时遇到问题，请检查位于logs目录中的日志文件中是否有错误消息。
  • 如果电子书无法加载，请验证Location of Calibre database是否设置正确以及数据库文件是否可访问。

• 配置错误：确保您的 Calibre 数据库兼容且格式正确。有关维护数据库的指导，请参阅 Calibre 文档。

• 性能问题：

  • 如果应用程序速度缓慢，请考虑增加为服务器分配的资源（CPU/RAM）或通过删除重复项和不必要的条目来优化 Calibre 数据库。
  • 定期清除网络浏览器中的缓存以缩短加载时间。

• 用户管理问题：如果用户无法登录或注册，请检查管理界面中的用户权限设置。确保已启用注册并且为用户分配了适当的角色。

• 支持资源：如需更多帮助，请考虑访问 wiki 的常见问题解答部分或在 Discord 社区中发布您的问题。

贡献者认可

我们要感谢 Calibre-Web 的所有贡献者和维护者为该项目提供的宝贵意见和奉献精神。非常感谢您的贡献。

接触

加入我们的 Discord

有关更多信息、操作方法和常见问题解答，请访问 Wiki

为 Calibre-Web 做出贡献

如需贡献，请查看我们的贡献指南。我们欢迎来自社区的问题、功能请求和拉取请求。

报告错误

如果您遇到错误或问题，请在存储库的问题部分中报告。请务必包含有关您的设置和遇到的问题的详细信息。

功能请求

我们欢迎对新功能提出建议。请在存储库中创建一个新问题来讨论您的想法。

其他资源

• 文档：Calibre-Web wiki 上提供了全面的文档。
• 社区贡献：探索社区贡献，了解正在进行的工作以及如何参与。

---

感谢您使用 Calibre-Web！我们希望您喜欢使用我们的工具管理您的电子书库。