# AudioDock

**Repository Path**: xiaofan797/AudioDock

## Basic Information

- **Project Name**: AudioDock
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-03
- **Last Updated**: 2026-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## License

This project is licensed under a **Personal-Use Only License**.

- 个人免费、可修改、可分发
- 商业使用需获得作者授权

查看完整协议请见：**[LICENSE](./LICENSE)**。

# AudioDock

<p align="center">
<img src="./images/logo.png" width="200" />
</p>

AudioDock（声仓） 是一个基于现代 Web 技术构建的音乐和有声书一体的本地化播放器，包含桌面端、移动端、web端、小程序。以及本地化后端服务

- **多端支持 💻**：包含移动端、web端、桌面端、小程序、电视端！
- **多端数据源支持 🔌**：支持 emby、jellyfin、Navidrome 数据源接入！
- **多协议数据入库 ⚡️**：支持 strm、webdav 数据源入库！
- **双模式无缝切换 ♻️**：有声书、音乐模式一键无缝切换，记忆不同模式下的播放信息！
- **支持 docker 部署 📦**：可以通过 docker 部署服务端和 web 端！
- **多用户支持 👥**：支持多用户交互联动！
- **设备接力 📱**：支持多设备之间无缝切换！
- **解析元数据 🖼️**：如果是带元信息的歌曲，可以展示歌词、封面等信息！

<p align="center">
<img src="./images/audiodock_light.png" width="500" />
</p>

> 代码编号：soundx

## 下载

### 国内下载通道

- 客户端下载：https://www.audiodock.cn/#download
- 服务端下载：
```
services:
  app:
    platform: linux/amd64
    image: hub.audiodock.cn/audiodock/audiodock
```

### 原生下载通道

最新版本看这里：

- **[web端和服务端](https://github.com/mmdctjj?tab=packages&repo_name=AudioDock)**：找到每个包最新的下载命令 docker 下载即可
- **[桌面端、移动端](https://github.com/mmdctjj/AudioDock/releases)**：下载对应平台的版本

## 开发进度

- [x] web 和桌面端
- [x] 移动端
- [x] 小程序
- [x] 电视端（待上线）
- [x] 服务端

### 功能规划

✅：完成 ❌：未开发/未完成开发 🚫：无设计

| 功能描述             | web / 桌面端 | 移动端 | 小程序 | 电视端 |
| -------------------- | ------------ | ------ | ------ | ------ |
| 切换有声书和音乐模式 | ✅           | ✅     | ✅     | ✅     |
| 自动导入数据         | ✅           | ✅     | ✅     | ✅     |
| 播放器功能           | ✅           | ✅     | ✅     | ✅     |
| 歌词展示             | ✅           | ✅     | ✅     | ✅     |
| 专辑、艺术家         | ✅           | ✅     | ✅     | ✅     |
| 聚合搜索             | ✅           | ✅     | ✅     | ❌     |
| 边听边存             | ✅           | ✅     | 🚫     | ❌     |
| 多端同步             | ✅           | ✅     | ✅     | ✅     |
| 迷你播放器           | ✅           | 🚫     | 🚫     | 🚫     |
| 多用户同步播放       | ✅           | ✅     | ✅     | ✅     |
| 播放记录             | ✅           | ✅     | ✅     | ✅     |
| 收藏记录             | ✅           | ✅     | ✅     | ✅     |
| 桌面歌词             | ✅           | ❌     | 🚫     | 🚫     |
| 和系统交互           | ✅           | ✅     | 🚫     | 🚫     |
| TTS 生成有声书       | ✅           | ✅     | 🚫     | 🚫     |
| 云盘聚合             | ✅           | ✅     | 🚫     | 🚫     |

<p align="center">
<img src="./images/wechat_qr.jpg" width="100" />
</p>

<p align="center">产品动态欢迎关注官方公众号：声仓</p>

## 页面操作指南

- 需要先设置后端服务地址，然后登陆，没有就先注册
- 注册成功后刷新页面即可

## NAS 部署指南

- 先拉取镜像
- 复制 docker-compose.yml 文件内容到 NAS 上启动（一般是创建项目的位置）
  - 记得修改文件映射路径
- 复制 nginx.conf 到 NAS 上可访问文件根目录
- 创建服务即可

> 文件目录配置：环境变量 `TXT_BASE_DIR` / `AUDIO_BOOK_DIR` / `MUSIC_BASE_DIR` / `MV_BASE_DIR` 直接控制服务端媒体目录路径，相对路径以 api 子项目目录为基准解析。

```yaml
version: "3.8"

services:
  app:
    platform: linux/amd64
    image: mmdctjj/audiodock
    container_name: audiodock-app
    ports:
      - "8860:3000" # Node API
      - "9961:9958" # Web UI
    environment:
      - NODE_ENV=production
      - TXT_BASE_DIR=/txt # 电子书目录
      - AUDIO_BOOK_DIR=/audio # 有声书目录
      - MUSIC_BASE_DIR=/music # 音乐目录
      - MV_BASE_DIR=/mv # mv视频目录
      - CACHE_DIR=/covers # 封面目录
      - DATABASE_URL=file:/data/dev.db # 数据库
      - JWT_SECRET=/.jwt_secret # 这个是文件，不是目录
      - PORT=3000
      - DISABLE_TTS=${DISABLE_TTS:-false} # 是否禁用 tts 服务，不用tts功能可注释
      - DISABLE_ASR=${DISABLE_ASR:-false} # 是否禁用 tts 服务，不用语音助手可注释
      - DISABLE_MI=${DISABLE_MI:-false} # 是否禁用 mi 服务，不用小爱音箱功能可注释
      - VOICE_KEYWORDS=小苍小苍 # 语音唤醒关键词，多个用英文逗号分隔，按最长匹配优先

    # 挂载数据文件和缓存，使用 Docker 命名卷更安全
    volumes:
      # 这里可以根据需要调整物理机的挂载路径
      - /volume1/迅雷下载/TXT:/txt
      - /volume1/迅雷下载/有声书:/audio
      - /volume1/迅雷下载/音乐:/music
      - /volume1/迅雷下载/MV:/mv
      - ./covers:/covers
      - app-db:/data
      - ./.jwt_secret:/.jwt_secret
    restart: unless-stopped
    networks:
      - audiodock-network

volumes:
  app-db: # 命名卷用于持久化数据库，下面的两行是保留旧数据的关键，没有旧数据
    external: true # 如果新部署，请注释，
    name: audiodock2_api-db # audiodock2 是我的旧 compose 名称，请相应的替换下

networks:
  audiodock-network:
    driver: bridge
```

## 本地运行

### 前置要求

- 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
```

然后运行下面的命令，自动打开桌面端

```bash
nvm use 22
pnpm install
npm run dev
```

移动端需要进入 /apps/mobile 目录启动：

```
npx expo run:ios --device
```

## docker 启动

修改 docker-compose 的环境变量 和 volumes：

```
environment:
  - AUDIO_BOOK_DIR=/audio
  - MUSIC_BASE_DIR=/music
  - CACHE_DIR=/covers
  - DATABASE_URL=file:/data/dev.db
  - JWT_SECRET=/.jwt_secret # JWT 密钥

# 多目录示例（使用英文逗号或分号分隔）
# environment:
#   - AUDIO_BOOK_DIR=/audio,/audio2
#   - MUSIC_BASE_DIR=/music,/music2
#   - TXT_BASE_DIR=/txt,/txt1

# 挂载数据文件和缓存，使用 Docker 命名卷更安全
volumes:
  - ./audio:/audio
  - ./music:/music
  - ./covers:/covers
  - api-db:/data
  - ./jwt_secret:/.jwt_secret

# 多目录示例：每个宿主目录需要挂载到不同的容器路径
# volumes:
#   - ./audio:/audio
#   - ./audio2:/audio2
#   - ./music:/music
#   - ./music2:/music2
#   - ./txt:/txt
#   - ./txt1:/txt1
#   - ./covers:/covers
#   - api-db:/data
#   - ./jwt_secret:/.jwt_secret
```

根目录下运行构建命令：

```
docker-compose build --no-cache
docker-compose up
```