This project is licensed under a Personal-Use Only License.
- 个人免费、可修改、可分发
- 商业使用需获得作者授权
查看完整协议请见：LICENSE。
AudioDock（声仓） 是一个基于现代 Web 技术构建的音乐和有声书一体的本地化播放器，包含桌面端、移动端、web端、小程序。以及本地化后端服务
- 多端支持 💻：包含移动端、web端、桌面端、小程序、电视端！
- 双模式无缝切换 ♻️：有声书、音乐模式一键无缝切换，记忆不同模式下的播放信息！
- 支持 docker 部署 📦：可以通过 docker 部署服务端和 web 端！
- 多用户支持 👥：支持多用户交互联动！
- 设备接力 📱：支持多设备之间无缝切换！
- 解析元数据 🖼️：如果是带元信息的歌曲，可以展示歌词、封面等信息！
代码编号：soundx
最新版本看这里：
- web 和桌面端
- 移动端
- 小程序（待开发）
- 电视端（待开发）
- 服务端
✅：完成 ❌：未开发/未完成开发 🚫：无设计
| 功能描述 | web / 桌面端 | 移动端 | 小程序 | 电视端 |
|---|---|---|---|---|
| 切换有声书和音乐模式 | ✅ | ✅ | ❌ | ❌ |
| 自动导入数据 | ✅ | ✅ | ❌ | ❌ |
| 播放器功能 | ✅ | ✅ | ❌ | ❌ |
| 歌词展示 | ✅ | ✅ | 🚫 | ❌ |
| 专辑、艺术家 | ✅ | ✅ | ❌ | ❌ |
| 聚合搜索 | ✅ | ✅ | ❌ | ❌ |
| 边听边存 | ❌ | ❌ | 🚫 | ❌ |
| 多端同步 | ✅ | ✅ | ❌ | ❌ |
| 迷你播放器 | ✅ | 🚫 | 🚫 | ❌ |
| 多用户同步播放 | ✅ | ✅ | ❌ | ❌ |
| 播放记录 | ✅ | ✅ | ❌ | ❌ |
| 收藏记录 | ✅ | ✅ | ❌ | ❌ |
| 桌面歌词 | ✅ | ❌ | 🚫 | ❌ |
| 和系统交互 | ✅ | ✅ | 🚫 | ❌ |
| TTS 生成有声书 | ❌ | ❌ | 🚫 | ❌ |
| 云盘聚合 | ❌ | ❌ | 🚫 | ❌ |
- 需要先设置后端服务地址，然后登陆，没有就先注册
- 注册成功后刷新页面即可
- 先拉取镜像
- 复制 docker-compose.yml 文件内容到 NAS 上启动（一般是创建项目的位置）
- 记得修改文件映射路径
- 复制 nginx.conf 到 NAS 上可访问文件根目录
- 创建服务即可
version: "3.8"
services:
# 1. API 后端服务 (Node.js)
api:
platform: linux/amd64
image: mmdctjj/audiodock-api:latest
container_name: audiodock-api
# 容器内部端口 (3000) 默认对内部网络开放，无需 ports 字段映射到宿主机
# 如果要直接测试 API，可以加上 ports: - "3000:3000"
ports:
- "8858:3000"
environment:
- AUDIO_BOOK_DIR=/audio
- MUSIC_BASE_DIR=/music
- CACHE_DIR=/covers
- DATABASE_URL=file:/data/dev.db
# 挂载数据文件和缓存，使用 Docker 命名卷更安全
volumes:
- /volume1/audio:/audio
- /volume1/music:/music
- ./covers:/covers
- api-db:/data
restart: unless-stopped
networks:
- audiodock-network
# 2. Web 前端服务 (Nginx) - 用于托管静态文件和反向代理
web:
platform: linux/amd64
image: mmdctjj/audiodock-web:latest
container_name: audiodock-web
ports:
- "9958:9958" # <--- 将 Web 服务的 80 端口映射到宿主机的 8080 端口
volumes:
- ./nginx.conf:/etc/nginx/nginx.conf:ro
depends_on:
- api # 确保 API 容器先启动
networks:
- audiodock-network
volumes:
api-cache: # 命名卷用于缓存
api-db: # 命名卷用于 SQLite 或其他数据文件
networks:
audiodock-network:
- Node.js (推荐 v22+)
- pnpm (推荐 v10+)
- Docker (可选，用于本地数据库或完整部署)
- 复制 services/api、 packages/db 包 根目录下的 .env.example 文件，修改名称为 .env
- 修改下面文件路径
AUDIO_BOOK_DIR=./music/audio
MUSIC_BASE_DIR=./music/music
CACHE_DIR=./music/cover
然后运行下面的命令，自动打开桌面端
nvm use 22
pnpm install
npm run dev移动端需要进入 /apps/mobile 目录启动：
npx expo run:ios --device
修改 docker-compose 的环境变量 和 volumes：
environment:
- AUDIO_BOOK_DIR=/audio
- MUSIC_BASE_DIR=/music
- CACHE_DIR=/covers
- DATABASE_URL=file:/data/dev.db
# 挂载数据文件和缓存，使用 Docker 命名卷更安全
volumes:
- ./audio:/audio
- ./music:/music
- ./covers:/covers
- api-db:/data
根目录下运行构建命令：
docker-compose build --no-cache
docker-compose up