Kikoeru 端口映射与数据卷挂载详解：音声库路径怎么配才对
端口说明
Kikoeru 后端默认监听 8888 端口。不同部署形态的端口配置方式：
| 部署方式 | 容器/程序内端口 | 宿主机端口 | 访问地址 |
|---|---|---|---|
| Docker | 8888 | 自定义（如 48488） | http://服务器IP:48488 |
| Windows exe | 8888 | 8888 | http://localhost:8888 |
| npm | 8888 | 8888 | http://localhost:8888 |
如果想改默认端口，在 config/config.json 里修改 port 字段（Web 界面也能改），改完重启生效。
音声库路径：最容易踩坑的地方
Docker 方式
docker-compose.yml 里的卷挂载：
volumes:
- /host/actual/path/VoiceWork:/usr/src/kikoeru/VoiceWork- 左边：宿主机上音声文件的真实路径
- 右边：容器内的绝对路径
关键：Web 界面里点"添加根文件夹"时，填的是容器内路径（也就是右边那个），不是宿主机路径。比如上面的配置里，Web 界面里填 /usr/src/kikoeru/VoiceWork。
一个常见错误是把 Windows 宿主机的盘符路径填进容器——容器里没有 D:\ASMR 这种路径，必须是 Linux 风格的。
Windows exe / npm 方式
直接在 Web 界面的"添加根文件夹"里填真实的绝对路径即可，比如 D:\ASMR\RJ12345。
支持多个根文件夹
Kikoeru 支持挂载多个不同的根文件夹。Docker 里多写几条 volume 就行：
volumes:
- /mnt/disk1/VoiceWork:/mnt/audio/disk1
- /mnt/disk2/VoiceWork:/mnt/audio/disk2
- /mnt/disk3/ASMR:/mnt/audio/asmrWeb 界面里分别添加 /mnt/audio/disk1、/mnt/audio/disk2、/mnt/audio/asmr 三个根文件夹。
数据目录说明
无论哪种部署方式，都有三类数据需要持久化：
| 目录 | 内容 | 备份频率 |
|---|---|---|
| sqlite/ | SQLite 数据库（索引、标签、收藏、进度） | 每次升级前备份 |
| covers/ | DLSite 下载的封面图片缓存 | 可重下，丢失影响不大 |
| config/ | config.json 配置文件 | 改完后备份 |
Docker 方式靠卷挂载持久化，Windows/npm 方式靠在固定目录运行来持久化。
NAS 部署注意
如果你的音声库在 NAS 上（比如 Unraid、群晖），通常需要把共享目录挂到跑 Kikoeru 的主机上，再映射进容器。具体挂载方式取决于 NAS 软件——Unraid 的 user shares、群晖的 File Station 挂载都行。
挂载后确保容器有读取权限（至少能遍历目录和读取音频文件）。写权限不需要，Kikoeru 不会改动你的音声文件。