它解决的是阅读入口，而不是下载来源
Kavita 扫描你已经合法拥有的 EPUB、PDF、CBZ 等文件，生成书架、系列和阅读进度，再通过浏览器提供统一阅读体验。它适合 NAS、家用服务器或常开小主机，让电脑、平板和手机不必各自维护一份重复文件。
第一次部署不要直接指向多年未整理的总目录。我会先拿十几本不同格式做测试库，观察作者、系列、卷号和封面怎样被识别，再按结果调整目录和文件命名。元数据错误一旦扩散到几千本书，后面清理会比前期试验更费时间。
先把文件结构整理成可维护的书架
不同内容应拆成独立资料库，例如技术书、漫画和工作文档，因为扫描规则、阅读模式和访问权限往往不同。目录中混入压缩包、临时下载和重复版本，会让封面与系列识别变得混乱。
- 统一系列与卷号命名，避免同一本书出现多个写法；
- 把损坏、加密或测试文件放到隔离目录；
- 为不同家庭成员建立账号，不共享管理员权限；
- 先备份原文件，再批量修改封面和元数据。
网页阅读和 OPDS 各有适合的设备
内置阅读器适合随手继续阅读，漫画的单页、双页和长条模式也比普通文件列表友好。电子墨水设备或已有阅读应用的用户，可研究 OPDS 接入，但不同客户端对进度同步和格式支持并不一致，需要先用一本书验证完整流程。
PDF 阅读体验取决于文件本身。扫描版大 PDF 在手机上可能仍然笨重，文字重排也不如 EPUB。遇到这类材料，可先用 PDF24 或其他可信工具拆分、压缩和 OCR，但务必保留原始文件。
公开到互联网前先完成权限和备份
Kavita 不是安装后就能裸露在公网的静态书架。应启用独立账号、强密码和 HTTPS，及时更新版本，并限制管理入口。家庭使用如果可以通过 VPN 访问，通常比直接开放端口更简单。版权受限资料也不应向无授权用户公开。
数据库保存用户、进度和元数据，书籍文件则在资料目录中，两部分都要进入备份并定期试恢复。这样即使容器或服务器损坏，也不会只剩下一个无法对应原文件的配置备份。
