Kavita 0.9.1.4 介绍与选型指南
Kavita（kareadita/Kavita）自托管阅读服务器全景：漫画/条漫/电子书一体化、OPDS 订阅、多用户与阅读进度同步，附 Komga/Calibre-Web/Audiobookshelf 量化选型对比，基于 v0.9.1.4 联网溯源（2026-10-31）。
KavitaKavita漫画电子书媒体服务器自托管.NET2026/10/31
Kavita 0.9.1.4 介绍与选型指南
> 目标：面向自托管读者的全面评估——Kavita 是什么、能做什么、技术架构如何、与 Komga / Calibre-Web / Audiobookshelf 等同类该如何取舍。本篇为联网溯源介绍篇，全部事实均标注来源与查询日期（2026-10-31），不依赖本地实测；安装部署、配置参数与 API 实战见同专栏后续篇章。
一、环境信息
本篇为联网溯源篇，不含本地实测结论，溯源环境与信息源清单如下：
- 溯源日期：2026-10-31（Asia/Shanghai）
- 软件名称：Kavita（项目仓库 Kareadita/Kavita）
- 版本基线：v0.9.1.4（官方 GitHub Releases 最新稳定版，Release 标题 "Hardcover Recommendations + Hotfix"，发布于 2026-09-02，来源 Releases 页，2026-10-31 查询）
- 主要信息源：
- GitHub 仓库主页与 README（定位、功能清单、许可、Demo 地址）
- GitHub Releases 最新版页面（版本号、发布日期、变更清单）
- Kavita 官方 Wiki（安装与第三方客户端对接）
- 仓库代码结构分析（DeepWiki 镜像，OPDS 标准支持）
- 竞品各自的 GitHub 仓库/发布页与 awesome-selfhosted 目录（对比数据）
- 同专栏实战篇：部署见 《Kavita 0.9.1.4 Docker Compose 部署指南》、配置见 《Kavita 0.9.1.4 配置参数详解》、API 见 《Kavita 0.9.1.4 REST API 使用详解》。
二、软件概述
2.1 定位与愿景
Kavita 官方对自身的定义是（GitHub 仓库描述，2026-10-31 查询）：
Kavita is a fast, feature rich, cross platform reading server. Built with the goal of being a full solution for all your reading needs. Setup your own server and share your reading collection with your friends and family.
翻译成工程视角：Kavita 是一个自托管阅读服务器，一个进程同时服务三类内容——漫画/条漫（Manga/Webtoons）、连环画/杂志（Comics）、电子书与轻小说（Books/Light Novel），并配齐 Web 阅读器、多用户、阅读进度同步与元数据管理。它与 Plex/Jellyfin 在影音领域的角色类似，但专注"读"而非"看/听"：文件躺在服务器磁盘上，Kavita 负责扫描、组织、渲染和记账（谁读到第几页）。
README 明确列出的能力边界（来源：仓库 README，2026-10-31 查询）：
- 漫画/Webtoon/Comic 服务：cbr、cbz、zip/rar/rar5、7zip、原始图片目录
- 图书服务：epub、pdf
- 多端自适应阅读器（手机/平板/桌面）
- 主题自定义（官方 Theme Repo）
- 富元数据：过滤、搜索、智能过滤器（Smart Filters）
- 三种组织形态：Collections（合集）、Reading Lists（阅读清单，支持 CBL 导入）、Want to Read（想读）
- 基于角色的用户管理：年龄分级限制、能力控制、OIDC 单点登录
- Webtoon 阅读模式、连续阅读模式、epub 虚拟分页
- 仪表盘与侧边栏可按用户自定义（流排序、开关、智能过滤器）
- 全量本地化（Weblate 平台协作翻译）
- epub 批注/高亮
2.2 开源许可与维护方
| 项目 | 事实 | 来源（2026-10-31 查询） |
|---|---|---|
| 代码许可 | GPL-3.0 | GitHub 仓库 LICENSE 徽标 |
| 主维护者 | majora2007（Kareadita） | 仓库 README |
| 商业模式 | 核心开源 + Kavita+ 付费订阅（联网型增值功能：scrobbling 到 AniList/MangaUpdates、智能合集、Hardcover 推荐等） | README "Kavita+" 章节 |
| 资金 | OpenCollective / Paypal 赞助 | README |
💡 说明：Kavita+ 是可选订阅，不购买也不影响本地核心功能（阅读、用户、进度、OPDS）；它主要把"联网获取元数据/评分/推荐"这类需要服务端长期轮询外部站点的能力做成了付费服务。v0.9.1.4 版本的更新主题正是 Kavita+ 的 Hardcover OAuth 与推荐（Release Notes，2026-09-02）。
2.3 版本与成熟度
- 当前最新稳定版：v0.9.1.4（2026-09-02 发布）。从 v0.9.1.4 的变更清单看，官方仍以较高频率交付修复与新特性（该版含 2 项 Kavita+ 新增、10+ 项修复）。
- 成熟度声明：README 中官方明确写出——"Kavita is being actively developed and should be considered beta software until the 1.0.0 release"，即 1.0.0 之前官方自我定位为 beta，平台行为可能变化，极端情况可能需要重建数据。
- 社区规模：GitHub Stars 约 12k（shields.io 徽标实测，2026-10-31）；累计提交 3,456 次（仓库页，2026-10-31）。
- 在线 Demo：官方提供演示站 demo.kavitareader.com（账号 demouser / Demouser64），可在部署前零成本体验完整功能。
三、核心架构
3.1 技术栈
Kavita 是典型的现代 .NET 单体 Web 应用（来源：仓库代码结构与发行包组成，2026-10-31 查询）：
- 后端：ASP.NET Core（C#，发行包主程序为 Kavita.dll，自包含 .NET 运行时）
- 前端：Angular 单页应用（内嵌于服务端，浏览器直开即用，无独立前端进程）
- 数据库：SQLite 单文件库（部署数据目录中的 kavita.db），配置通过 appsettings.json（连接串、JWT 密钥、端口等）
- 后台任务：Hangfire 调度（库扫描、元数据刷新、进度统计等周期任务）
- 单进程形态：除数据库文件外无外部依赖，不需要消息队列、缓存服务等中间件，这让它在 NAS/小主机上非常省资源
3.2 数据组织模型
Kavita 对内容的抽象分四层：Library（库，按内容类型定义：Manga/Comic/Book…）→ Series（系列，按目录结构聚合）→ Volume（卷）→ Chapter（章节/单文件）。扫描器负责把磁盘目录树映射成这四层结构，阅读进度、评分、元数据都挂在对应层级上。这决定了目录规划的重要性：一个 Library 对应一种内容类型，目录层级会被直接解读成卷/章关系（官方 Wiki 安装指引，2026-10-31 查询）。
3.3 访问通道
同一份数据，Kavita 提供三条访问通道：
- Web 阅读器：浏览器访问服务端口（默认 5000），即开即读，含漫画/Webtoon/图书三种阅读器。
- OPDS 订阅源：兼容 OPDS 1.2 与 OPDS-PSE（分页流扩展），第三方阅读客户端（Mihon/Tachiyomi 系、Moon+ Reader 等）可订阅拉取（来源：DeepWiki 对仓库源码的分析 + 官方 Wiki 第三方客户端指南，2026-10-31 查询）。OPDS 地址形如
http://<host>:5000/api/opds/<api-key>，API Key 即凭据（来源：justread.app 2026 年 OPDS 指南，2026-10-31 查询）。 - REST API：
/api前缀的完整 REST 接口（JWT 认证），官方 Web UI 本身就构建在这套 API 之上，因此能力覆盖等同于界面功能（来源：仓库源码结构；实测细节见本专栏 D5 篇）。
四、功能特性
4.1 内容格式支持
| 内容类型 | 支持格式 | 说明 |
|---|---|---|
| 漫画/条漫/连环画 | cbr、cbz、zip、rar、rar5、7zip、原始图片目录 | README 明示 |
| 电子书 | epub、pdf | README 明示；epub 支持批注/高亮与虚拟分页 |
| 听书/播客 | 不支持 | 该场景属于 Audiobookshelf（见七、对比） |
4.2 阅读器体验
- 三套阅读器各司其职：Manga 阅读器（右起翻页/双页）、Webtoon 阅读器（垂直长条、无页间距）、Book 阅读器（epub 排版、字体/主题可调、虚拟分页）。
- 连续阅读：读完一话不退出阅读器直接进入下一话（README：continuous reading mode）。
- 阅读进度服务端记账：换设备接着读，进度即时同步（多用户各自的进度互不干扰）。
- v0.9.1.4 修复了"单页章节翻页时进度不保存"等问题（Release Notes，2026-09-02），可见阅读进度这一核心链路仍在持续打磨。
4.3 组织与元数据
- Collections（手工合集）、Reading Lists（有序阅读清单，支持导入 CBL 格式）、Want to Read 三种组织维度。
- 智能过滤器（Smart Filters）保存为可复用的动态视图，并可挂到仪表盘/侧边栏。
- 元数据字段覆盖：系列名、作者、画师、出版信息、年龄分级、标签、Genre、People 等，支持批量编辑与服务端全局过滤。
- v0.9.1.4 修复了"系列年龄分级未从标签推导"等元数据链路问题（Release Notes）。
4.4 多用户与权限
- 用户体系为服务端本地账户，按角色管理（README：Role-based management）：管理员可精确控制每个用户能否下载、能否看到成人内容、年龄分级上限（Age Restriction）等。
- OIDC 支持：可对接 Authelia/Authentik 等统一认证（README 明示 OIDC）。
- 阅读进度、书架、想读清单均为每用户独立，这是"家庭共享一台服务器"场景的关键能力。
- 无内置邮件找回等企业级账户能力，账户管理界面化、面向家庭/小团队规模。
4.5 主题与本地化
- 官方维护 Theme Repo，用户可上传/切换主题（README）。
- 全量 i18n 由 Weblate 社区协作，中文界面开箱可用（README + Weblate 平台）。
4.6 Kavita+ 增值服务（付费）
- Scrobbling：阅读/评分行为同步到 AniList、MangaUpdates 等外部账户。
- 智能合集（Smart Collections）、外部推荐（Hardcover Recommendations，v0.9.1.4 起支持 OAuth 授权）。
- 定位是"联网型功能"的可持续 funding 模式，核心本地功能不受影响（README）。
五、快速开始（最小可用示例）
Kavita 的最小可用路径只有三步（本篇仅描述流程，命令级实测见部署篇）：
- 取回并启动服务：官方主推容器化交付（官方镜像
kizaing/kavita），数据目录为/kavita/config（配置、SQLite 数据库、封面缓存全在里面），书库目录额外挂载即可。完整 compose 文件、目录规划与首次启动实测见 《Kavita 0.9.1.4 Docker Compose 部署指南》。 - 首次向导：浏览器打开
http://<服务器>:5000，首次访问进入初始化向导，创建管理员账户（本专栏示例统一使用admin / q1w2e3r4）。 - 建库开读：管理界面添加 Library（选择内容类型如 Manga/Book，指向挂载的内容目录），触发扫描后即可阅读；阅读进度、OPDS 订阅地址在用户设置中获取。
💡 技术拓展：
/kavita/config是 Kavita 的"状态重心"——appsettings.json（参数）、kavita.db（SQLite 数据）、covers/ 与 cache/（封面与缓存）都在其中。备份这个目录 = 备份整个 Kavita 的账户、进度与元数据；内容文件本身是只读被扫描对象，可另行管理。
六、适用场景与限制
6.1 适用场景
- 家庭漫画/轻小说图书馆：NAS 或小主机上一套服务，全家各自账户、各自进度、年龄分级管控未成年人可见范围。
- 条漫/连载追更场景：Webtoon 阅读模式 + 连续阅读 + CBL 阅读清单，配合目录化归档的连载内容体验最好。
- 多端阅读（Web + OPDS 客户端）：桌面浏览器 + 手机第三方阅读器（Mihon/Moon+ Reader 等 OPDS 客户端）共用同一份进度。
- 个人知识库外借：把 epub/pdf 技术书或出版物借给朋友/团队，用下载权限与用户隔离控制边界。
6.2 限制与边界
- 官方自述 beta（1.0.0 前）：升级跨度大时建议先备份数据目录（README Notice）。
- 不做有声书/播客：需要听书服务请选 Audiobookshelf。
- 不管理"Calibre 式"转换：不做格式转换/DRM 处理，输入什么格式就读什么格式（epub/pdf 之外的核心是容器化漫画格式）。
- 元数据联网能力大部分在付费层：本地刮削可用，但 AniList/MAL 级别的 scrobbling、外部推荐需要 Kavita+。
- 规模边界：面向个人/家庭/小团队设计，无集群/多节点形态；超大规模（数十万文件）依赖 SQLite 单文件与定时扫描，需要自行评估（官方 Wiki 建议 SSR 场景做好库拆分）。
七、同类选型对比
7.1 候选概览
| 软件 | 一句话定位 | 许可 | Stars（约） | 最新稳定版（2026-10-31 查询） |
|---|---|---|---|---|
| Kavita 0.9.1.4 | 漫画+电子书一体化阅读服务器（Webtoon 友好） | GPL-3.0 | 12k（shields 徽标） | v0.9.1.4（2026-09-02，Release 页） |
| Komga | 漫画/杂志/电子书媒体服务器，工具生态强 | MIT | 4k+（GitHub 镜像页） | 1.29.2（2026-10-28，Release 页） |
| Calibre-Web | Calibre 书库的 Web 前端（以 epub 为主） | GPL-3.0 | 未取证（上游维护放缓） | 上游 0.6.26（2026-05，techdigest.site）；社区续作 Calibre-Web-NextGen v4.1.39（2026-08-21，homelabor.net） |
| Audiobookshelf | 有声书/播客服务器（附带 epub） | GPL-3.0 | 14.8k（awesome-selfhosted，2026-10-23） | v2.37.1（2026-09-30，releasealert.dev） |
7.2 能力维度量化对比
| 维度 | Kavita | Komga | Calibre-Web | Audiobookshelf |
|---|---|---|---|---|
| 漫画/Webtoon 阅读 | ✅ 专有 Webtoon 模式、连续阅读 | ✅ 强项（Webtoon 双页/长条） | ❌ 非目标 | ⚠️ 附带能力弱 |
| epub 电子书阅读 | ✅ 虚拟分页+批注高亮 | ✅ | ✅ 强项（依托 Calibre） | ⚠️ 基础 |
| 有声书/播客 | ❌ | ❌ | ❌ | ✅ 核心能力 |
| OPDS 输出 | ✅ OPDS 1.2 + OPDS-PSE | ✅ OPDS + Kobo Sync + KOReader Sync | ✅ | ✅ |
| 多用户/权限 | ✅ 角色制+年龄分级+OIDC | ✅ 用户+年龄限制 | ⚠️ 基础用户/匿名 | ✅ 多用户+进度同步 |
| 阅读进度同步（服务端） | ✅ 每用户 | ✅ 每用户 | ⚠️ 部分（KOReader 同步需插件） | ✅（音频为主） |
| 元数据刮削 | ✅ 本地+Kavita+ 联网（AniList/Hardcover） | ✅ 本地+Komga 系列元数据文件 | ⚠️ 依赖 Calibre 库 | ✅ 听书元数据 |
| REST API | ✅ 全功能（UI 同源） | ✅ 成熟（社区工具多） | ⚠️ 有但覆盖较窄 | ✅ |
| 数据库 | SQLite 单文件 | 内嵌 H2/可选 PostgreSQL | 依赖 Calibre 的 metadata.db | SQLite/PostgreSQL |
| 版本节奏 | 快（2026 年持续月级修复） | 快（2026-10-28 仍在发版） | 上游放缓（社区分叉续命） | 稳（官方 FAQ：约每月一版） |
7.3 选型建议（如果…则…）
- 如果你主要读漫画/条漫/连载 + 一些 epub 轻小说，想要一个服务全覆盖、开箱即用：Kavita——Webtoon 模式、连续阅读、中文界面、多用户年龄分级一步到位。
- 如果你是硬核漫画收藏者，需要成熟工具生态（Kobo 同步、KOReader 同步、丰富社区脚本）且在意宽松许可（MIT）：Komga。
- 如果你已有 Calibre 桌面端书库并只想给它加 Web 访问，书籍以 epub 为主：Calibre-Web（注意上游维护放缓，需在原版与社区分叉间做选择）。
- 如果你的主体内容是有声书/播客：Audiobookshelf，Kavita 明确不做音频。
- 如果你要的是"漫画+书+听书全家桶"：Kavita + Audiobookshelf 组合（内容域不重叠，两台服务各管一摊），而非强行找一个全能服务。
八、参考链接
- Kavita GitHub 仓库（定位/README/许可）：https://github.com/Kareadita/Kavita （2026-10-31 查询）
- Kavita 最新 Release v0.9.1.4：https://github.com/Kareadita/Kavita/releases/latest （2026-10-31 查询）
- Kavita 官方 Wiki（安装/功能/第三方客户端）：https://wiki.kavitareader.com/ （2026-10-31 查询）
- Kavita 在线 Demo：https://demo.kavitareader.com/ （README 提供）
- OPDS 支持与 OPDS-PSE（源码分析）：https://deepwiki.com/Kareadita/Kavita/1.2-key-features （2026-10-31 查询）
- OPDS 客户端对接实践（API Key 形式 URL）：https://justread.app/el/posts/how-to-set-up-opds-on-iphone-ipad （2026-10-31 查询）
- Komga 仓库与许可（MIT）：https://github.com/gotson/komga （2026-10-31 查询）
- Komga Release 1.29.2：https://github.com/gotson/komga/releases （2026-10-31 查询）
- Calibre-Web 现状与分叉生态：https://techdigest.site/apps/calibre-web/ （2026-10-28 发布，2026-10-31 查询）
- Calibre-Web-NextGen 审计对比：https://docs.homelabor.net/proxmox/39_Auditing_a_Community_Fork/ （2026-10-31 查询）
- Audiobookshelf 仓库与许可（GPL-3.0）：https://github.com/advplyr/audiobookshelf （2026-10-31 查询）
- Audiobookshelf v2.37.1：https://releasealert.dev/github/advplyr/audiobookshelf （2026-10-31 查询）
- awesome-selfhosted（Audiobookshelf 星标）：https://awesome-selfhosted.github.io/awesome-selfhosted-html/tags/media-streaming---audio-streaming.html （2026-10-31 查询）
章节目录