Kikoeru 自托管音声管理与收听平台完整指南

这是什么

Kikoeru 是一套面向 同人音声 / ASMR 收藏者 的自托管流媒体管理平台。它的思路不是"又一个播放器"，而是：把你硬盘上已经积累的大量音声文件，通过 DLSite 的番号元数据自动整理成一个 可搜索、可筛选、多端同步 的私人音声库。

核心架构分为两部分：后端 kikoeru-express（Node.js + SQLite）负责扫描文件夹、抓取元数据、提供 HTTP 接口；前端 kikoeru-quasar（Vue + Quasar）以 PWA 形式提供 Web 界面。后端有三种发布形态（Docker 镜像、Windows exe、npm 包），前端还延伸出 iOS TestFlight 和 Android 客户端。

谁适合用

• 本地已经有 GB 甚至 TB 级的同人音声 / ASMR 文件，需要整理索引
• 想在手机、平板、电脑上随时随地收听自己的收藏
• 介意把私人音频上传到第三方云服务，希望数据完全留在自己手里
• 喜欢折腾服务器、Docker、自托管应用的用户

档案速览

结构导览

下面按实际使用顺序分组，点进去看：

第一步：认识 Kikoeru — 先搞懂这套东西到底由哪些组件拼起来、为什么选它而不是别的。→ 它到底能干嘛

第二步：部署安装 — Docker 一条命令最快，Windows 本地包对新手友好，源码方式适合开发者。→ Docker Compose 部署

第三步：音声库管理 — 添加文件夹、触发扫描、看 DLSite 元数据自动入库。→ 添加根文件夹

第四步：检索与标签 — Kikoeru 的标签系统是精华，支持多标签筛选、排除标签、组合条件。→ 关键字搜索

第五步：播放与收听 — Web 播放器、倍速、定时睡眠、LRC 歌词、书签进度。→ Web 播放器概览

第六步：收藏与评价 — 星标、打星、评语、进度标记，评价过的作品优先展示。→ 星标收藏

第七步：多端客户端 — PWA 添加到桌面、iOS TestFlight、Android 第三方。→ PWA 安装桌面

第八步：进阶设置 — JWT 鉴权、Web 端改配置、AI 翻译、自定义 CSS 主题。→ JWT 鉴权配置

第九步：排查与 FAQ — 扫描卡住、封面缺失、客户端连不上怎么办。→ 扫描卡住排查

一句话使用流程

部署服务器（Docker / exe / npm）→ 在 Web 界面添加音声文件夹 → 手动扫描入库 → 元数据自动从 DLSite 抓取 → 开始搜索、打标签、收听 → 手机/平板连同一个服务器继续听。