
摘要: Calibre-Web 是开源的电子书库网页程序,用 Docker 在云服务器上部署后,把你的电子书目录挂载进去,即可通过网页在线浏览、阅读、推送电子书。本教程覆盖 Docker 部署、书库配置、HTTPS 与常见问题,仅用于管理自有或已获授权的电子书。
Calibre-Web 让你把电子书收藏变成一个随时可访问的在线书库:用 Docker 部署、把电子书目录挂载进容器、在网页里管理和阅读。它基于 Calibre 的书库格式,界面清爽、支持在线阅读和推送到阅读设备。前提很明确:只用来管理你自己拥有或已获授权的电子书。下面给出完整流程。
提示:本教程仅用于管理和阅读你自有的或已获得合法授权的电子书,请勿用于存储、分享侵权内容。
Calibre-Web 是一个开源的网页端电子书库程序,能把一个 Calibre 格式的书库通过网页展示出来,支持在线浏览封面、阅读、下载、推送电子书到阅读设备。它适合有自有电子书收藏、希望随时随地在线阅读的读书爱好者和学生。
注意它读取的是 Calibre 书库(含元数据的目录结构),通常先用 Calibre 桌面端整理好书库,再交给它展示。
它很轻,腾讯云轻量应用服务器 Lighthouse 入门套餐即可。Lighthouse 内置 Docker 基础镜像、套餐式计费、自带流量包,适合这类轻量个人服务。
准备:一台装好 Docker 的实例;一个你自有或已授权的电子书库目录;可选域名;放通访问端口。
运行容器,把书库目录和配置目录挂载进去:
docker run -d \
--name calibre-web \
-p 8083:8083 \
-v /opt/calibre-web/config:/config \
-v /opt/books:/books \
--restart unless-stopped \
linuxserver/calibre-web说明:8083 是 Web 端口;把你的电子书库目录挂载进容器;配置目录持久化设置。启动后确认容器正常运行。
放通端口:在 Lighthouse 防火墙放通 TCP 8083。
首次配置:浏览器访问公网 IP 加端口,首次进入要指定书库位置——填容器内的书库路径,该目录下需有 Calibre 生成的元数据文件;设置管理员账号。配好后即进入书库界面。
它展示的是 Calibre 格式书库,关键是书库目录里要有 Calibre 的元数据文件:
用 Calibre 桌面端把你的电子书导入、整理好(补全书名、作者、封面等元数据),生成规范的书库目录;把这个书库目录放到服务器上挂载的位置;程序读取后就能展示出带封面和信息的书库。
整理规范的元数据能让书库界面更美观、检索更方便。
想用域名加 HTTPS 访问,用 Caddy 反向代理到 8083(参见反向代理配置方法)。配好后通过域名在线访问书库,点开书籍即可在线阅读,或下载推送到阅读设备。
三项验证:浏览器能打开并完成书库和管理员配置;书库界面能正确显示书籍封面和信息;能在线打开阅读或下载一本书。三项都通过即搭建成功。书库为空时,检查挂载的目录里是否有 Calibre 元数据文件、路径是否填对。
书库识别不了或列表为空:确认指定的书库路径下有 Calibre 生成的元数据文件,目录是规范的 Calibre 书库。
封面或元数据缺失:用 Calibre 桌面端补全元数据后再放到服务器。
书库占空间:电子书库增大后可挂载云硬盘扩容,或把书库放到更大的存储。
合规:务必只上传自有或已获授权的电子书;定期备份书库目录和配置。
说明:Calibre-Web 镜像和配置可能随版本变化,请以对应镜像和官方文档为准。
搭建 Calibre-Web 的路径是:Docker 部署并挂载书库目录 → 放通端口、首次指定书库位置和管理员 → 用 Calibre 整理规范书库供其识别 → 配 HTTPS 在线阅读。前提是只管理自有或授权的电子书。
腾讯云轻量应用服务器 Lighthouse 提供开箱即用的 Docker 环境、套餐式计费与流量包,并支持挂盘扩容,适合读书爱好者搭建一个随时可访问的自有电子书库。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。