一、它到底是什么，能解决什么问题

入门

如果你用 Calibre（一款免费电子书管理软件，装在自己电脑上）整理过电子书，会知道它很方便，但有个限制：书都在本机。想在手机上看，或者出差时用笔记本访问，就得手动导出、传文件。

Calibre-Web 解决的就是这件事。它读取 Calibre 的书库数据库，然后生成一个网页界面。你在浏览器里打开它，就能像逛在线书店一样浏览、在线阅读、下载自己的电子书。

打个比方：Calibre 是你家书房，Calibre-Web 是给书房装了一扇能远程打开的门。书还是那些书，位置没变，但你在外面也能进去拿。

Calibre-Web 主界面

它支持多用户，可以给家人朋友各开一个账号，分别设置能不能上传、能不能下载、能看哪些书。界面自带中文，20 多种语言可选。

二、开始之前，你需要准备什么

入门

Calibre-Web 不是一个双击就能用的桌面软件，它属于服务端程序——意思是它跑在一台一直开着的机器上，别人通过网络访问它。所以你需要先想清楚把它装在哪。

常见的选择有两种：

  • 一台 Linux 服务器（云主机、家里的树莓派、NAS 都算），适合想让外网也能访问的人
  • 自己的电脑，适合只想在局域网内自己用，装完就能试

无论哪种，都需要满足这些前置条件：

  • Python 3.7 或更高版本（Python 是一种编程语言，Calibre-Web 是用它写的，所以运行环境里必须有）
  • 一个已经建好的 Calibre 书库，也就是包含 metadata.db 文件的文件夹
  • 如果书库里有 .rar 格式的压缩包，还需要系统里安装 unrar 命令，否则无法解压

注意：Calibre-Web 不会帮你管理图书元数据（书名、作者、封面这些）。这些信息由 Calibre 桌面版负责维护，Calibre-Web 只负责展示和分发。

三、安装：推荐用 pip 一条命令搞定

入门

官方推荐的方式是用 pip 安装。pip 是 Python 的软件安装器，类似手机上的应用商店，一条命令就能把程序拉下来。

在服务器的终端里执行：

pip install calibreweb

安装完成后，用下面这条命令启动它：

cps

默认情况下，它会监听本机的 8083 端口。在浏览器里打开 http://你的服务器地址:8083，就能看到登录页面。

首次登录的默认账号和密码是：

用户名：admin
密码：admin123

强烈建议第一次登录后立刻改掉密码，因为这是公开写在文档里的默认值，不改等于门没锁。

如果你更喜欢用 Docker（一种把软件打包成"集装箱"、随处可运行的工具），社区也维护了现成的镜像，省去配置 Python 环境的麻烦。搜索 calibre-web 相关的镜像即可，启动时把书库文件夹挂载进去就行。

四、配置书库：让它找到你的书

入门

装好只是第一步，接下来要告诉 Calibre-Web "书在哪里"。这一步在网页后台完成，不需要改配置文件。

登录后进入管理界面，找到「Calibre 数据库位置」这一项，填入你书库文件夹的路径。判断路径对不对的方法很简单：那个文件夹里应该有 metadata.db 这个文件。

填好后点保存。如果路径正确，回到首页就能看到书架了；如果报错，多半是路径写错，或者运行 Calibre-Web 的用户没有读取那个文件夹的权限。

项目预览图

还有几项建议顺手设置：

  • 上传功能默认是关的，需要在「基本设置」里手动打开才会出现上传入口
  • 用户权限可以逐个账号设置，比如给孩子只开阅读、不开下载
  • 语言在个人设置里切换成中文，界面会立刻变

五、常见坑和排查思路

进阶 · 推荐细读

新手最容易卡住的地方，通常不是安装本身，而是权限和路径。

书库读不出来：先确认 metadata.db 存在且没被占用。Calibre 桌面版如果正开着这个书库，有时会锁住文件，关掉再试。

上传按钮不见了：这是设计如此，上传默认关闭，去「基本设置」里打开。

页面很慢：书库太大、封面太多时会明显变慢。可以考虑给服务器加内存，或者清理书库里重复、无用的条目。浏览器缓存定期清一下也有帮助。

更新后配置丢了：如果你把 metadata.db 或配置文件放在了 Calibre-Web 自己的程序目录里，升级时可能被覆盖。建议把书库和配置都放在程序目录之外。

六、要不要用它，怎么判断

进阶 · 推荐细读

Calibre-Web 适合这几类人：电子书数量多、已经用 Calibre 管理、希望多设备访问、想给家人共享书库。

它不太适合的情况也有：只有几本书、不介意手动传文件，那用 Calibre 自带的"内容服务器"功能就够了，不必多装一套。

如果你决定长期使用，比较稳妥的做法是配合 Docker 运行，把书库挂载成外部目录，这样升级和备份都简单。再往前一步，可以配上反向代理（一种帮你转发网络请求、顺便加 HTTPS 加密的工具，比如 Caddy 或 Nginx），让外网访问更安全。

一句话总结：Calibre 管书，Calibre-Web 管"怎么把书送到你手上"。两者分工明确，配合使用体验最好。

项目信息

项目 值
仓库 janeczku/calibre-web
语言 Fluent
Star 18,267
Fork 1,868
主页 无

参考链接

延伸阅读

想继续探索？这些同领域的教程可能也适合你：