飞牛 OS 部署 Calibre-WebDocker 整理电子书库、上传 PDF 到固定公网访问前言我以前整理电子书最常做的事情不是阅读而是在一层层文件夹里找书小说、技术资料、PDF、EPUB 混着放临时下载的文件名看不出内容换到手机上又得重新翻一遍。把硬盘扩容并不能解决这件事真正缺的是能按书名、作者和简介查找的统一入口。Calibre-Web 恰好适合给已有书库做一个网页界面书还放在自己的设备上浏览器负责展示、搜索和访问不必因为换了阅读设备就重新整理文件。这次我用飞牛 OS 的 Docker 搭建这套书库。先准备config与books两个目录启动lscr.io/linuxserver/calibre-web:latest再连接/books下的metadata.db。打开后台以后继续修改中文显示、开启上传权限、上传一本 PDF 并补齐基本信息确认书籍确实出现在首页。局域网访问跑通再通过 cpolar 给8083配置随机公网地址最后预留固定二级子域名cw1。我会特别留意几个容易混淆的地方书籍文件和数据库不是同一回事浏览器能登录不等于书库初始化完成能生成公网地址也不代表默认管理员密码已经适合长期对外使用。我更愿意先拿一份熟悉的 PDF 把上传、保存和书目显示逐个确认再开始配置远程入口免得日后找不到书时分不清是网络还是书库本身出了问题。一、Calibre-Web 是书库入口不是另一个网盘我希望打开浏览器就能看到书名、封面和分类而不是面对一堆下载文件名。Calibre-Web 提供的正是这层书库界面它读取 Calibre 格式的书库及其metadata.db把书籍信息组织成可浏览、可查找的页面。实际文件仍存放在 NAS 的书库目录上传操作也会写入相应的存储位置“网页门面”不等于文件凭空脱离了本地硬盘。这类部署尤其适合已经把 PDF、EPUB、MOBI 和其他资料集中放在一台设备上的人。我的目标先定得简单一些完成数据库连接、显示一本上传的 PDF再从外网打开同一座书库。在线阅读、格式处理或跨设备阅读进度等具体体验应按实际格式与客户端分别确认不能仅凭首页截图就认定全部能力已经验证。二、在飞牛 OS 上准备 Docker 与书库目录打开飞牛 OS先进入 Docker。镜像仓库里搜索Calibre-Web按页面步骤下载镜像随后到文件管理器中建立docker文件夹并在下面准备books与config两个目录。前者作为书库位置后者保存应用配置。先把目录安排好再启动容器后面查文件、备份和排错都比较清楚。书库初始化的演示中还准备了一个metadata.db文件配套文件地址是https://xiaoxu.lanzoub.com/iYSDi2ae3xud 。这里要注意Calibre-Web 需要的是能够识别的 Calibre 书库数据库而不是任意零字节文件改个名字。若选中数据库后无法保存或读取书籍应先检查文件是否存在、是否是有效数据库以及/books的读写权限。通过终端远程进入飞牛 OS使用sudo -i切换到管理员用户在确认宿主机路径存在后执行 Docker 命令dockerrun-d--namecalibre-web-ePUID1000-ePGID1000-eTZAsia/Shanghai-p8083:8083-v/vol1/1000/docker/calibre/config:/config-v/vol1/1000/docker/books:/books--restartunless-stopped lscr.io/linuxserver/calibre-web:latest这条命令使用镜像lscr.io/linuxserver/calibre-web:latest容器名为calibre-web端口映射是8083:8083。PUID1000和PGID1000关系到容器写入文件时的权限TZAsia/Shanghai设置时区两个挂载分别是/vol1/1000/docker/calibre/config:/config和/vol1/1000/docker/books:/books。因此文件管理器里建目录时要核对完整路径命令中的配置目录比书籍目录多了一级calibre不要只看见同名config就以为已经对应上。三、先登录再把数据库指向 /books容器启动后在浏览器访问http://IP:8083其中IP换成飞牛 OS 的局域网地址。登录页使用的示例初始账号为admin密码为admin123。如果登录后反复跳回登录页可以先尝试强制刷新或清理浏览器缓存但在后面开放公网之前应该先改掉默认密码。登录成功后还不能把空页面当成已经有了图书馆。Calibre-Web 接下来需要知道书库数据库在哪里打开数据库路径选择器按页面操作返回上层目录再进入books选择metadata.db点击select并保存。目录结构与数据库文件要一起核对这一步决定应用能否读取后续上传与管理的书籍信息。四、切换中文、开放上传并用一本 PDF 验证数据库连接好以后先在用户设置里切换中文显示再进入管理权限和基本设置勾选上传权限并保存。这个权限开关很关键找不到“上传书籍”按钮时不一定是容器或端口出错也可能只是没有开放对应功能。随后选取一份 PDF 上传补充书名等基本信息再保存并返回书库查看。这比只展示登录页更能证明整条链路/books可以使用、数据库能够记录书籍、页面也能把上传结果展示出来。这里演示的是 PDF 上传不把其他格式的转换效果或阅读进度同步写成已经完成的测试。五、书库在内网能打开以后再安装 cpolar书已经能从飞牛 OS 的8083页面找到下一步才考虑人在外面怎样进入。cpolar 的职责只是把现有 Web 服务提供到公网书籍文件、数据库和 Calibre-Web 容器仍在 NAS 上不会因为有了公网地址就变成托管在外部的书库。先在飞牛 OS 设置中开启 SSH使用设备局域网 IP 远程连接。按 Linux 安装方式执行sudocurlhttps://get.cpolar.sh|sh安装后检查 cpolar 服务状态sudosystemctl status cpolar服务正常时通过飞牛 OS 的局域网 IP 加9200进入 cpolar 管理界面用已经注册的账号登录。这里需要区分两个端口9200是隧道管理页面真正需要被外部访问的书库仍是8083。六、先用随机域名验证公网访问进入隧道管理 → 创建隧道名称填写cw协议选 HTTP本地地址填8083域名类型选随机域名地区选China Top。创建后到在线隧道列表复制生成的地址再用另一台不在同一局域网内的设备打开确认看到的是 Calibre-Web 页面。这一层验证的是“外部浏览器 → cpolar → NAS 的8083→ Calibre-Web”不是重新部署一套书库。如果公网地址能打开但书籍打不开还应回到数据库、目录挂载及应用权限这一层继续排查。七、为经常使用的书库保留固定入口随机地址适合先试通网络需要长期从手机、平板或其他地方进入时固定二级子域名更方便收藏。进入 cpolar 的预留页面选择保留二级子域名地区为china top示例名称为cw1按提示填写备注并保留。名称有唯一性最终以自己账号实际保留成功的结果为准。再回到隧道管理 → 隧道列表找到前面名为cw的隧道点击编辑把域名类型改为二级子域名在Sub Domain中填写预留成功的名称地区选择China Top点击更新。到在线隧道列表查看新的固定地址并从外部浏览器再次访问确认。固定的是访问入口而不是容器永不停止或 NAS 永不断网。也不要忘记公开地址会扩大书库的可访问范围除了更改初始密码还应根据家庭使用范围管理账号、上传权限和藏书分享范围。电子书的上传、下载与分享也应遵守相应内容的使用授权。总结以前面对一整盘电子书我最花时间的是寻找和辨认文件现在有了 Calibre-Web能把查书、浏览书目信息和上传新书集中到一个页面。飞牛 OS 负责承载容器和书库/config保存应用配置/books对应藏书与书库数据库这三个位置弄清楚以后比只追求一个漂亮首页更便于长期维护。从本地的8083到 cpolar 随机地址再到固定二级子域名cw1远程访问只是最后一环。真正值得留意的还是数据库是否有效、目录是否准确、上传权限是否打开以及默认账号是否已经更换。把这些基础环节确认好这座私人图书馆才不只是能访问也能继续往里添书、整理和使用。