本篇简单讲述如何使用安装Kavita和使用Komf插件。

使用到的项目：Komf，Komf-userscript，篡改猴

使用Docker安装Kavita

运行

docker run --name kavita -p 5000:5000 \
-v /media/manga:/manga \
-v /app/kavita/config:/kavita/config \
--restart unless-stopped \
-e TZ=Asia/Shanghai \
-d jvmilazz0/kavita:latest

然后登录IP:5000按照简单设置以下Kavita

• 注册

• 修改语言为中文

• 获取API Key

• 添加漫画库

如果是以我的命名方式一定是用manga（日漫）。其他的对应类型为美漫、图书、图片、轻小说、杂志。每种类型拥有不同的扫描方式，没有仔细了解过。

使用Docker安装Komf

在安装使用komf之前，需要在目标config文件夹内手动创建一个application.yml文件。其中的内容可以直接使用komf的模板不做修改，之后可以通过用户界面进行修改。
以我当前的模板application.yml为例

kavita:
  baseUri: "http://ip:5000" ##修改成你自己的
  apiKey: "b392ce38-dba2-4bf4-9770-6875357ce6cf" ##修改成你自己的API
  eventListener:
    enabled: true
  metadataUpdate:
    default:
      seriesCovers: true
      postProcessing:
        seriesTitle: true
        seriesTitleLanguage: "zh"
        alternativeSeriesTitles: true
        alternativeSeriesTitleLanguages:
        - "ja"
        - "ja-ro"
        - "en"
discord:
  templatesDirectory: "/config"
database:
  file: "/config/database.sqlite"
metadataProviders:
  defaultProviders:
    mangaUpdates:
      priority: 4
    mal:
      priority: 20
    nautiljon:
      priority: 30
    aniList:
      priority: 5
    yenPress:
      priority: 50
    kodansha:
      priority: 60
    viz:
      priority: 70
    bookWalker:
      priority: 2
    mangaDex:
      priority: 3
    bangumi:
      priority: 1
      enabled: true
      nameMatchingMode: "CLOSEST_MATCH"
    comicVine:
      priority: 110

运行Komf

docker run -d   --name komf   -p 8085:8085 -e KOMF_LOG_LEVEL=INFO   -v /app/komf/config:/config   --restart unless-stopped   sndxr/komf:latest

通过油猴安装用户浏览器插件

找到下载地址，点击komf.user.js
https://github.com/Snd-R/komf-userscript/releases
如果已经安装了篡改猴会自动弹出安装选项。
然后进油猴修改刚才安装的脚本。将箭头位置修改成你的Kavita网址。

保存设置后刷新你的kavita主页就会发现多了一个图标。

设置KAVITA地址、API和开关事件监听器。监听器启用后有新入库的文件会自动进行匹配数据。

设置元数据来源，大多数是英文和其他小语种网站，有提供中文的网站似乎只有bw(没用过)和bangumi。

元数据处理，我只用bgm所以合并其他元数据用不上，开启了本地化标题和替换系列封面。

discord联动，国内用不上。

系列页面也新增了一个图标，可以用于手动选择，自动匹配和重置元数据。

关于Komf的一些问题和建议。

• 公网使用IP地址设置问题

如果是安装在远程服务器上使用，需要使用浏览器插件似乎需要kavita和Komf同时暴露在公网上。使用内网地址会联通不了，不知道是否会产生安全问题。如果是本地网络使用似乎更安全一些。

• 配置好Komf后，即使不使用浏览器插件也可以直接使用。

配置好后只开启事件监听器监听新文件也能满足大部分的需求了。

• Komf可以支持http-endpoints,可以使用curl命名发送匹配请求

例如：curl -X POST "$MEDIA_SERVER_URL/$MEDIA_SERVER/match/library/$LIBRARY_ID"
假设我的kavita库地址是 "http://10.10.10.10:5000/library/3/series/2"；
运行 curl -X POST "http://10.10.10.10:5000/kavita/match/3"就可以请求重新匹配库中所有系列了。好处就是可以通过定时任务每隔一段时间进行一次刷新。建议设置完后关闭端口仅在内网使用，如果是在公网能直接请求就显得很不安全。