# Calibre-Web 让家里的电子书库在浏览器里随时可读

> Calibre-Web 为现有 Calibre 书库提供网页入口，支持搜索、在线阅读、下载、个人书架和账号权限，还能通过 OPDS 连接阅读应用，适合已有电子书收藏并愿意维护家庭服务器的读者。

## 关键信息

- 分类：开源自托管
- 支持平台：Web
- 收费方式：开源免费，服务器、存储和维护成本自理
- 开源协议：GPL-3.0
- 官网：https://github.com/janeczku/calibre-web
- 源码仓库：https://github.com/janeczku/calibre-web
- 标签：Calibre-Web、电子书、书库管理、自托管
- 收录日期：2026-11-01 10:35:00

电子书放在电脑里时，整理和阅读往往分成两件事。
电脑上已经分好了作者、系列和类别，换到平板却还要翻文件夹、找版本、传文件。
如果你已经用 Calibre 管理藏书，Calibre-Web 可以为这套书库增加一个网页入口，让其他设备通过浏览器找书和阅读。

## 网页书架沿用已有的 Calibre 书库

[Calibre-Web](https://github.com/janeczku/calibre-web) 是一款开源电子书网页应用，核心用途是浏览、阅读和下载 Calibre 数据库中的书籍。
它依赖有效的 Calibre 书库，部署时要指定包含 `metadata.db` 的目录。
因此，已经整理好 Calibre 藏书的人更容易用起来；只有一堆散落文件的读者，需要把书库结构一并准备好。

网页里可以搜索书名，使用高级检索与筛选，也可以按作者、系列和类别浏览。
个人书架适合另外整理“正在读”“工作参考”或“准备重读”的书，不必为了不同阅读计划频繁改动原有分类。
如果书名、作者等信息不完整，项目也提供元数据编辑及从外部来源补充信息的能力。

![Calibre-Web 官方示例中的电子书封面、分类侧栏与搜索框](/assets/post-images/calibre-web-library-ui.png)

*图片来自 Calibre-Web 官方 Wiki，展示书架界面及其分类入口。*

## 浏览器和阅读应用都有接入方式

Calibre-Web 支持在浏览器中阅读多种格式，也允许按权限下载书籍。
在平板上临时翻资料，可以直接打开网页；习惯使用专门阅读应用的人，可以考虑它提供的 OPDS 目录。
OPDS 相当于供兼容阅读器访问的书目入口，应用是否支持这套协议需要查看自己的阅读器设置。
项目默认服务端口为 `8083`，OPDS 路径为 `/opds`。

电子书格式转换由额外的 Calibre 程序承担，需要安装转换工具并在设置中填写对应路径。
如果某本书在目标设备上打不开，可以检查文件格式及转换工具配置，保留原文件作为后续处理的基础。
项目还提供向电子阅读器发送图书、Kobo 同步及 Magic Link 登录等能力，相关功能需要分别配置；选择部署方式时，应把实际会用到的阅读设备列入检查清单。

## 家人共用书库时把权限分开

Calibre-Web 提供用户管理和细分权限，可以按账号控制书库使用范围。
管理员负责维护书籍信息，普通读者使用自己的账号浏览和阅读，这样更容易区分管理操作与日常使用。
对于只需阅读的家庭成员，可以按需开放浏览和下载，将上传、编辑等权限留给负责整理的人。

[配置文档](https://github.com/janeczku/calibre-web/wiki/Configuration)也列出了匿名浏览、公开注册和上传开关。
建立私人书库时，建议保持公开注册关闭，按需要创建账号，并检查访客权限。
需要让家庭网络之外的设备访问时，应配置加密连接和反向代理，避免把带默认配置的管理入口直接暴露出去。

## 部署前要准备好数据库目录和运行环境

官方 README 推荐使用 Python 虚拟环境安装，基本操作如下。

```bash
python3 -m venv calibre-web-env
source calibre-web-env/bin/activate
pip install calibreweb
cps
```

这是 Python 环境中的安装入口；服务长期运行、权限分配和远程访问还需要结合服务器环境配置。
项目 README 也列出了 LinuxServer 提供的 Docker 镜像入口，使用容器时要核对书库挂载位置及可选转换组件。

打开服务后，在管理员设置中的 `Location of Calibre database` 填写书库目录。
根据官方配置说明，这里填写包含 `metadata.db` 的文件夹路径，路径末尾不要附上数据库文件名。
服务进程必须能够访问该目录；若网页没有正常显示藏书，可以从目录设置和文件权限开始检查。

首次进入后台后应修改默认管理员密码。
启用上传功能需要调整相应设置，EPUB 封面提取等功能还会涉及 ImageMagick 等可选依赖。
日常维护时，建议一起备份书库文件和数据库，升级前保留可恢复副本。

## 适合已经积累藏书并愿意维护服务的人

Calibre-Web 采用 GPL v3 开源许可证，软件可自行部署，设备、存储、电费或云服务器费用由使用者承担。
它适合把已有电子书收藏整理成长期可访问的家庭书库，也适合在电脑、平板与兼容阅读应用之间使用同一套书目。

开始时可以选一小批自己有权使用的电子书，检查搜索、网页阅读、下载和常用设备访问是否符合需求。
等书库路径、账号权限及备份方式安排妥当，再决定迁入多少藏书。
图书文件需要自行准备，并遵守相应的使用与传播许可。

### 官方入口

- [项目仓库与安装说明](https://github.com/janeczku/calibre-web)
- [配置文档](https://github.com/janeczku/calibre-web/wiki/Configuration)
- [完整 Wiki](https://github.com/janeczku/calibre-web/wiki)

---

网页版：https://aronshare.com/posts/calibre-web-library/
发现线索：Calibre-Web 官方仓库与配置文档 https://github.com/janeczku/calibre-web
来源站点：AronShare 资源库（https://aronshare.com）