kikoeru 隐藏功能挖掘：你以为只是助眠APP，其实藏着自托管音声库系统
kikoeru 是什么
kikoeru 第一眼看上去就是个普通的助眠音效 APP——打开就能听到白噪音、雨声、ASMR，还有一堆从海外收集来的优质音声作品。5.81 兆的安装包轻量到几乎不占空间，界面干净，点开即播，日常用来当背景音、助眠、专注都够用。
但如果只把它当助眠工具用，那你只用了它的十分之一。kikoeru官网 本质上是一套自托管音声库管理系统——Android APP 只是它的客户端，背后可以挂一个你自己部署的服务器，把你硬盘上分散在各个盘、各个目录的音声文件统一扫描、索引、搜索。换句话说，它是个能装在手机上的私人 ASMR 图书馆。
安装
kikoeru下载 目前主要走 Android APK 分发渠道，5.81M 的体积装起来毫无压力。安装包本身没有什么特殊前置条件，安卓 8.0 以上设备都能直接装，但有两个坑值得提前注意：
一是旧版本残留。3.0.9 之前的老版本（尤其是 2.x 系列）卸载时可能在系统目录留下缓存数据库，重新安装后有时会出现"已收藏列表空白"或"扫描进度条卡住不动"的情况。遇到这种情况先在系统设置里手动清一下应用数据再装，不要直接覆盖安装。
二是首次启动如果选了"关闭服务器模式"就永远只是个本地音效播放器，要用到那些隐藏的进阶功能（比如多服务器切换、自定义根目录挂载），得在首次启动时选"连接已有服务器"，或者进设置里手动填入你部署好的后端地址。纯本地模式下很多设置项是灰的，别以为是软件 bug。
你以为它只是助眠 APP？其实还藏着这四个进阶玩法
折腾 kikoeru 三个月，我把它从一个单纯的背景音工具翻成了我私人音声库的核心。下面这四个功能，官方文档藏得深、社区讨论少，但真用起来每一个都能改变你的使用姿势。
1. 多服务器一键切换——同时连自己的库和朋友的库
我一开始以为 kikoeru 只能连一个固定的后端，直到在设置最深处翻到了"添加服务器"。这功能藏得真深：设置页面往下滑，找到一个不起眼的"服务器管理"入口，点进去才发现可以保存多个后端地址，每个命名一个标签——"主库""测试""朋友家"，随时点一下就切过去。
这个功能的原理很朴素：后端本身是单用户架构，所谓"多账户"其实是客户端在保存多个 URL，切换时重新连、重新拉 SQLite 数据。每个服务器的收藏、播放进度、星标互相独立，切换就是换数据源，不做合并。
什么人用得上？如果你自己搭了一个服务器当主库，同时偶尔想听听朋友那边的收藏，或者测试服务器和正式服务器分开管理，这个功能直接解决了装两个客户端的尴尬。纯局域网只用自己一套的人可以无视——对你来说意义不大。
2. 数据库自动清理——删了硬盘文件，数据库幽灵条目会自己消失
这个功能我是踩过坑才知道的。之前我把一个硬盘上的音声文件夹整个删掉了，但 Web 界面里那个专辑还挂在那里，点进去播放报错，手动找又找不到删除按钮，以为是 bug 去提了 issue 才被告知：跑一次扫描就行。
原来扫描器每次运行都会遍历数据库里每个作品的根文件夹路径，去硬盘上确认文件还在不在。不在的话就标记为"待清理"，扫描结束后那些幽灵作品自动就没了。这不是个独立按钮，是扫描过程的附带动作——换句话说，你平时定期跑的扫描，本身就在帮你清理数据库。
唯一要小心的是删除根文件夹时的行为：Web 界面点"删除根文件夹"并不会立即删数据库条目，只是标记为已移除，得再跑一次扫描才真正清理。这是故意设计的防误删，但如果你删完根文件夹忘了跑扫描，就会看到一堆幽灵条目挂在那里。习惯上删完文件夹立刻触发一次扫描就好。
3. 多根文件夹挂载——不同硬盘、不同目录，统一扫描
这个功能解决的是"音声文件分散在好几块盘"的问题。我的同人音声在 NAS 的磁盘 1，ASMR 在磁盘 2，还有一堆从 DLSite 以外收来的杂项存在本地 SSD——以前得分别打开各自的文件夹翻，现在 kikoeru 能把这三个目录同时挂进去，统一扫描、统一搜索。
操作也不复杂：Web 界面进"设置 → 音色库"，点"添加新文件夹"，填绝对路径就行。Docker 用户要特别注意一点：Web 里填的路径是容器内路径，不是宿主机路径。比如 docker-compose.yml 里写的是 /mnt/nas/audio/RJ:/mnt/audio/rj，Web 界面里就要填右边的 /mnt/audio/rj，填左边宿主机路径会报"目录不存在"。
加完跑一次完整扫描，三个盘里的音声就全部进到同一个索引里了。搜索时你不需要关心它在哪个盘，直接按标题、作者、标签搜就行。这个功能对音声量不大（就一两个文件夹）的人来说感知不强，但库大到跨盘了之后，它直接省了你自己管理文件夹的心智负担。
4. JWT 鉴权开关——局域网裸跑 vs 公网暴露的安全边界
这个功能藏在"设置 → 配置"里，默认大多数部署形态是关闭的——因为自托管场景大部分是内网裸跑，谁会给局域网加鉴权呢？但如果你想把服务器映射到公网，必须开 JWT，否则等于把整个音声库对全网开放。
开启后客户端第一次连接会收到 401，弹出登录界面，登录成功后后端签发一个 7 天有效期的 Token，后续请求带 Token 才能访问。配置方法两种：Web 界面直接改 jwt.enable 为 true，或者手动去 config/config.json 里加 jwt 块。公网部署最低限度也得配个 Cloudflare Tunnel 或者反代加 Basic Auth，裸奔加不开鉴权等于送人头。
有个细节要注意：目前后端是单用户架构，即使开了 JWT 也只有一组用户名密码能登录。想给家人朋友用你的库，得在 config.json 的 users 数组里手动加多个条目。真正的多用户隔离（每个人独立收藏、独立权限）还在作者的 TODO 列表里，没实现。
踩过的一个坑
多服务器切换虽然好用，但有个副作用容易忽略：每个服务器的收藏是独立的。我之前在朋友那边的服务器上收藏了十几张专辑，切回自己的库之后全没了，以为是 bug。其实就是这样设计的——客户端只切换数据源，不做数据合并。所以如果某个服务器的收藏对你特别重要，记得定期导出或者截图备份，换服务器就没了。
收尾
kikoeru 表面上是个轻量助眠 APP，底下其实是一套认真做的自托管音声库系统。多服务器切换、数据库自动清理、多盘挂载、JWT 鉴权——这些功能没有堆在首页显眼的位置，但每一个都是折腾党才会去碰、才会觉得好用的东西。把它用透，从"打开听两小时白噪音"变成"管理我一整个私人音声图书馆"，中间差的就是翻一下设置里那些不起眼的灰色按钮。
本文為個人基於網路公開資料整理編寫，非官方內容，僅供學習交流參考；軟體版權歸原作者所有，請支持正版；使用過程中遇到問題請查閱官方管道，本文不承擔任何責任。
