自托管音乐下载器PlaylistDL，Spotify和YouTube歌曲一键转MP3，内网穿透远程访问
作者
小编
发布时间
项目介绍
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' 目录中。管理员模式还支持修改下载路径，无需重启容器。
实时监控：下载过程中可以实时查看进度条和下载日志，了解每一步的处理情况。
文件组织
所有下载的音乐会按照艺术家 > 专辑的文件夹结构自动组织，方便后续查找和管理。
本篇教程结束