tomcullen92/emby-playlist-sync repository overview

EmbyPlaylistSync

一个用于将 QQ 音乐、酷狗音乐、酷我音乐、网易云音乐 歌单同步到 Emby Playlist 的 Docker 项目。

通过 Web 管理后台配置音乐平台和 Emby 信息，实现个人音乐收藏的统一管理。

⸻

✨ 功能特点

• ✅ Emby 歌单同步
• ✅ QQ 音乐歌单解析
• ✅ 酷狗音乐歌单解析
• ✅ 酷我音乐歌单解析
• ✅ 网易云音乐歌单解析（需要 Cookie）
• ✅ Web 管理后台
• ✅ Docker 部署
• ✅ Emby API Key 配置
• ✅ Emby User ID 配置
• ✅ 管理员登录保护
• ✅ 在线修改管理员密码
• ✅ 多平台歌单统一同步

⸻

📂 项目结构

EmbyPlaylistSync │ ├── server.js # 主服务 ├── public/ │ └── index.html # Web 管理页面 │ ├── music-api/ # 音乐平台解析服务 │ ├── main.py │ ├── app.py │ ├── musicapi.py │ └── ... │ ├── Dockerfile ├── docker-compose.yml ├── package.json ├── package-lock.json └── start.sh

⸻

🚀 Docker 部署

下载项目

git clone https://github.com/TomCullen1992/EmbyPlaylistSync.git⁠ cd EmbyPlaylistSync

启动

docker compose up -d

查看运行状态

docker ps

⸻

🐳 Docker Hub

也可以直接使用已经构建好的 Docker 镜像。

Latest

docker pull tomcullen92/emby-playlist-sync:latest

Version 1.0.0

docker pull tomcullen92/emby-playlist-sync:v1.0.0

Docker Hub：

https://hub.docker.com/r/tomcullen92/emby-playlist-sync⁠

⸻

🌐 Web 管理后台

默认访问：

http://服务器IP:18081⁠

例如：

http://192.168.1.100:18081⁠

192.168.1.100 仅作为示例，请替换为自己的服务器 IP。

⸻

🔐 默认登录信息

首次启动默认账号：

用户名：admin 密码：change-me-please

首次登录后建议立即修改管理员密码。

也可以通过 Docker 环境变量设置：

environment: ADMIN_USERNAME: admin ADMIN_PASSWORD: your-password

⸻

⚙️ Emby 配置

进入 Web 管理后台后填写：

• Emby 地址
• Emby API Key
• Emby User ID

获取 Emby API Key

Emby 控制台：

高级 → API Keys → 创建新的 API Key

⸻

🎵 音乐平台支持

QQ 音乐

支持：

• 歌单 ID
• 歌单分享链接

⸻

酷狗音乐

支持：

• 歌单 ID
• 歌单分享链接

⸻

酷我音乐

支持：

• 歌单 ID
• 歌单分享链接

⸻

网易云音乐

支持网易云音乐歌单解析。

需要登录网易云音乐获取 Cookie。

Cookie 需要包含：

MUSIC_U

Cookie 仅用于本地配置和请求网易云音乐接口，不会上传到 GitHub。

⸻

🔒 安全说明

本项目源码仓库不会包含：

• ❌ Emby API Key
• ❌ 网易云音乐 Cookie
• ❌ 用户密码
• ❌ 私人服务器地址
• ❌ 本地配置文件
• ❌ 个人歌单数据

首次运行后请自行配置相关信息。

请勿将自己的 Cookie、API Key 或密码提交到 GitHub。

⸻

⚠️ 注意事项

1. 本项目依赖第三方音乐平台接口。
2. 第三方音乐平台接口可能因平台更新而发生变化。
3. 部分平台可能需要登录信息或 Cookie。
4. 请合理使用，仅用于个人音乐管理。
5. 不要公开分享自己的 Cookie 或 API Key。

⸻

🐳 Docker Compose 示例

services: emby-playlist-sync: build: . container_name: EmbyPlaylistSync ports: - "18081:18081" restart: unless-stopped

如果直接使用 Docker Hub 镜像，可以使用：

services: emby-playlist-sync: image: tomcullen92/emby-playlist-sync:latest container_name: EmbyPlaylistSync ports: - "18081:18081" restart: unless-stopped