自托管音乐下载器PlaylistDL,Spotify和YouTube歌曲一键转MP3,内网穿透远程访问
作者
小编
发布时间

PlaylistDL是自托管音乐下载工具,支持从Spotify和YouTube一键下载歌曲、专辑或播放列表,转换为MP3格式。采用Flask后端和简洁网页界面,提供会话隔离、管理员模式、实时进度显示等功能。完全自托管,数据掌握在手,隐私安全有保障。支持Docker快速部署,内网穿透访问。
项目介绍
PlaylistDL 是一款自托管的音乐下载神器,专为音乐爱好者打造。它支持从 Spotify 和 YouTube 一键下载歌曲、专辑或整个播放列表,并将其转换为 MP3 格式。基于 Flask 后端和简洁的网页界面构建,PlaylistDL 提供了会话隔离、管理员模式、实时进度显示等强大功能。
无论你想备份喜爱的播放列表,还是离线收听音乐,PlaylistDL 都能轻松搞定。整个应用完全自托管,所有数据掌握在自己手中,隐私有保障。
项目地址:点我跳转
部署安装
如果你想在外出时也能访问这个应用,建议配置内网穿透服务。推荐使用帕斯内网穿透,先注册账号备用。具体操作步骤可以参考这份完整指南,涵盖全平台上手教程。
Docker 快速部署
打开你的 NAS 设备或本地 Docker 管理面板。
点击本地镜像- 添加镜像- 从 URL 添加,在镜像地址栏填入:
1tanner23456/playlistdl:v2
等待镜像下载完成后,点击启动按钮启动容器。
容器配置
勾选开机自动启动,然后进行以下配置:
端口映射设置:
容器内部端口:'5000'(这是应用运行的端口,不需要修改)
主机映射端口:'4827'(如果这个端口被占用,你可以改成其他端口,但要记住这个新端口号)
存储目录配置:
需要创建一个用于保存音乐下载文件的目录。建议在 NAS 上创建一个专门的文件夹(例如 '/mnt/music_downloads'),然后将其映射到容器内相同的路径。这样下载的所有音乐文件都会保存在这个目录中。
环境变量设置:
必须设置:
'ADMIN_USERNAME':管理员登录用户名(自定义,例如 'admin')
'ADMIN_PASSWORD':管理员登录密码(自定义,请设置强密码)
'AUDIO_DOWNLOAD_PATH':音乐文件下载保存路径(例如 '/mnt/music_downloads')
可选设置:
'CLEANUP_INTERVAL':临时会话文件夹清理间隔,单位为秒,默认值为 '300'(5分钟)。这个参数控制系统多久清理一次临时下载文件夹,通常不需要修改。
其他参数保持默认即可,直接点击启动完成部署。
访问应用
部署完成后,在浏览器中访问:
1http://你的NAS_IP:4827
(如果你修改了映射端口,请将 '4827' 替换为你设置的端口号)
此时应该能看到 PlaylistDL 的网页界面,就可以开始下载音乐了!
使用说明
普通用户模式:直接在网页上粘贴 Spotify 或 YouTube 的播放列表链接,点击下载即可。下载的文件会临时保存在会话目录中。
管理员模式:点击页面上的Admin按钮,用你设置的用户名和密码登录。登录后会看到红色提示'现在直接下载到服务器!',之后下载的文件会直接保存到你配置的 'AUDIO_DOWNLOAD_PATH' 目录中。管理员模式还支持修改下载路径,无需重启容器。
实时监控:下载过程中可以实时查看进度条和下载日志,了解每一步的处理情况。
文件组织
所有下载的音乐会按照艺术家 > 专辑的文件夹结构自动组织,方便后续查找和管理。
本篇教程结束
相关教程

Piwigo是功能强大的开源照片库管理系统,支持批量上传、相册组织、标签管理、用户权限控制等丰富功能。完全开源免费,可自行部署在服务器上,享受完全的数据控制权。适合摄影爱好者、组织和个人使用。

DouyinLiveRecorder是功能强大的多平台直播录制工具,支持抖音、TikTok、快手、B站、虎牙等50+平台自动录制。独有循环值守功能,主播上线即自动录制,让你轻松备份喜爱主播精彩内容。支持Docker一键部署到NAS,配置简单,永久自动化运行。

SPlayer是功能丰富的现代化音乐播放器,采用Vue3+TypeScript+Electron打造,支持网页端和客户端双端部署。集成网易云音乐API,支持账号登录、歌曲下载、云盘管理、本地音乐库、逐字歌词、MV播放等丰富功能。界面简洁优雅,支持Light/Dark/Auto多种主题模式,提供一站式音乐播放体验。

Gopeed是一款由Golang和Flutter打造的跨平台高速下载器,支持HTTP、BitTorrent、Magnet等多种协议。提供Windows、macOS、Linux、Android、iOS全平台版本,具有高度可定制化功能、API集成、浏览器扩展等特性。界面简洁易用,支持Docker一键部署,是全能下载利器的完美选择。