Windows 本地包部署 Kikoeru:单文件 exe 双击运行无需 Docker
适用场景
- 你只有一台 Windows 电脑,音声文件就在本地硬盘
- 不想或不能装 Docker
- 想最快跑起来试用
准备工作
- 下载 Windows 版 exe(从 GitHub Releases 或作者发布渠道)
- 下载前端构建产物
dist/目录(PWA 静态文件) - 把 exe 和 dist/ 放在同一个文件夹下,比如
C:\kikoeru\
最终目录结构:
C:\kikoeru\
├── kikoeru.exe
├── dist\ ← 前端文件
│ ├── index.html
│ ├── js\
│ ├── css\
│ └── ...
├── sqlite\ ← 首次运行自动创建
├── covers\ ← 首次运行自动创建
└── config\ ← 首次运行自动创建
运行
双击 kikoeru.exe,或者在 PowerShell 里运行:
cd C:\kikoeru
.\kikoeru.exe
启动后控制台会打印 Express listening on http://[::]:8888,浏览器打开 http://localhost:8888。
挂载音声库
Docker 方式用卷挂载路径,Windows 本地包不一样——音声文件本身就在你电脑上,直接在 Web 界面添加根文件夹时填入真实的绝对路径即可(比如 D:\ASMR\RJ12345)。
数据目录
exe 首次运行会在同级自动创建三个数据目录:
| 目录 | 用途 |
|---|---|
| sqlite\ | SQLite 数据库 |
| covers\ | DLSite 封面缓存 |
| config\ | 配置文件 |
把这些目录备份就等于备份了全部数据。 想搬家直接整个目录拷走。
设置开机自启(可选)
Windows 下最简单的方式:
Win + R输入shell:startup打开启动项文件夹- 在里面创建一个
kikoeru.bat,内容:
start "" "C:\kikoeru\kikoeru.exe"
- 下次开机自动运行
注意事项
- 首次双击 exe 可能被 Windows Defender 拦截(未知发布者),点"更多信息 → 仍要运行"即可
- 如果端口 8888 被占,可以在 config.json 里改 port 字段
- 想让局域网其他设备也能访问,确保 Windows 防火墙放行了 8888 端口