Kikoeru 的三种发布形态与客户端选择：Docker、Windows 包、npm 源码

后端部署形态

Docker 镜像（推荐）

社区维护的 Docker Hub 镜像 number17/kikoeru:latest 是当前最活跃的版本。docker-compose 一条命令拉起，数据卷分离方便迁移。端口默认暴露 8888，数据目录（SQLite 库、封面、配置、音声库）都通过卷挂载。

适合 Linux / NAS / OpenWRT / 任何装了 Docker 的环境。升级只需 docker compose pull && docker compose up -d。

Windows 本地包

作者用 pkg 把后端打成了 Windows 下的单文件 exe。适合不想折腾 Docker 的 Windows 用户——下载 exe 双击就能跑（需要把前端 dist/ 目录和 exe 放在一起）。数据文件（SQLite、封面、配置）会在 exe 同级目录下自动生成。

npm 源码包

npm i kikoeru-express 适合开发者或想自己改代码的人。需要 Node.js 环境，并且自己把 kikoeru-quasar 构建出的 dist/ 目录放进来。适合二次开发或嵌入式场景。

版本差异说明

• 后端 npm 包最新版本 0.6.2，GPL-3.0 协议
• Docker 镜像 number17/kikoeru 在基础版本上持续迭代（v0.6.14、v0.6.16 等），功能更活跃
• 三套发布功能基本一致，Docker 版本通常更新更快

前端与客户端

Web PWA（标配）

任何后端形态都自带 Web PWA 界面。打开浏览器访问服务器地址（默认端口 8888）即可。支持"添加到桌面"安装成 APP 图标。

iOS TestFlight 客户端

number17 开发的原生 iOS 客户端，持续更新中。加入 TestFlight 测试渠道后可以安装，后台连播 bug（iOS 17.3+）已修复。特色功能：离线模式（标题带"作品（离线）"标识）、手动切换在线/离线。

Android 第三方客户端（KikoFlu）

社区开发的 KikoFlu 是功能比较完整的 Android 客户端，特色包括：

• 强大的高级搜索（多标签/排除标签）
• 多维度筛选（标签、评分、发售日期）
• 多账户支持（多个 Kikoeru 服务器）
• 自定义服务器地址、连接延迟测试
• 缓存大小限制和清理策略
• 主题模式和配色方案
• 可简洁可详细的 UI 自定义

客户端与服务器的版本匹配

客户端（Web / iOS / Android）对后端 API 有最低版本要求。如果遇到"部分功能缺失"或"连接失败"，先确认后端版本是否过旧，再考虑升级。