Docker Compose 一键部署 Kikoeru 完整步骤与配置详解

前置条件

Linux / NAS / OpenWRT 等任意装了 Docker 的环境
Docker 和 Docker Compose 已就绪
音声文件已经在某个硬盘目录下（比如 /mnt/media/VoiceWork）

步骤一：创建目录结构

mkdir -p /opt/kikoeru/{sqlite,covers,config}
cd /opt/kikoeru

四个子目录的用途：

目录	用途	说明
sqlite	SQLite 数据库文件	全部索引、收藏、进度都在这里
covers	下载的专辑封面	DLSite 抓取的封面会缓存到这里
config	配置文件	Web 界面里修改的配置会存这里
VoiceWork	你的音声库目录	挂载自硬盘上的实际音声目录

步骤二：写 docker-compose.yml

典型模板如下（根据你的实际情况改端口和路径）：

services:
  kikoeru:
    image: number17/kikoeru:latest
    container_name: kikoeru
    ports:
      - 48488:8888
    volumes:
      - ./sqlite:/usr/src/kikoeru/sqlite
      - ./covers:/usr/src/kikoeru/covers
      - ./config:/usr/src/kikoeru/config
      - /mnt/media/VoiceWork:/usr/src/kikoeru/VoiceWork
    restart: unless-stopped

关键说明：

端口：容器内 Kikoeru 监听 8888，左边的 48488 是主机上你想暴露的端口，可以随便改
音声库卷：左边是宿主机上你音声文件的实际路径，右边容器内路径建议保持 /usr/src/kikoeru/VoiceWork 不变（Web 界面添加根文件夹时会用到这个路径）
restart：unless-stopped 确保机器重启后容器自动拉起

步骤三：启动

docker compose up -d

等待几秒容器启动，浏览器打开 http://<服务器IP>:48488 就能看到 Web 界面。

步骤四：防火墙放行（如有）

sudo ufw allow 48488

云服务器还要记得在安全组里放行对应端口。

关闭与重启

docker compose down      # 停止并删除容器（数据卷保留）
docker compose up -d     # 重新启动
docker compose down && docker compose up -d  # 重启（改了配置后需要）

升级

docker compose pull && docker compose up -d