解馋，用AI手搓音乐播放器！打造你的专属私有云音乐库！

🌟前言

买了 NAS 存了几TB 的无损音乐，官方TV版音乐播放器遥遥无期？找不到在电视上用的播放器？
今天给大家分享一个我用AI手搓的NAS 私有云音乐播放器，先解解馋。

它适配安卓TV和安卓手机，直接读取 NAS 里的音乐文件，支持歌词显示、可视化效果，数据完全私有！

（叠甲：能力有限，别指望我修复BUG和定期更新哈哈）

---

✨ 核心功能亮点
1. 📺 专为电视打造的沉浸式体验，对遥控器进行适配。
2. 📱 手机端无缝衔接，对竖屏适配。
3. 🎵 强大的播放内核，支持：MP3, FLAC, WAV, APE, M4A, OGG等。
4. 📂 极简管理，按歌手、专辑自动归类。保留最原始的文件夹浏览模式，找歌更直观。

---

🛠️ 安装教程 (保姆级)

本项目分为 服务端 (NAS) 和 客户端 (安卓App) 两部分。
服务端负责读取文件，客户端负责播放。

第一步：部署服务端 (Docker)

我们要使用绿联 NAS 的 Docker 功能来运行后端服务。

方法一：使用 Docker Compose (推荐)
1.在 NAS 的共享文件中，创建一个文件夹，例如 docker/nas-music​。
2.在电脑上新建一个文本文件，命名为 docker-compose.yml​，把以下代码粘贴到文件中并保存。

1. version: '3'
   
2. services:
   
3.   app:
   
4.     image: node:18-alpine
   
5.     container_name: music-server-v2
   
6.     restart: unless-stopped
   
7.     ports:
   
8.       - "3010:3010"
   
9.     volumes:
   
10.       # 映射代码目录
    
11.       - ./:/app
    
12.       # ⚠️ 必须修改：冒号左边改为您NAS的真实音乐路径
    
13.       - /volume1/音乐:/music
    
14.     working_dir: /app
    
15.     # 核心修改：将所有命令合并为一行，彻底避免文件格式问题
    
16.     # 注意：不要手动修改下面这行引号里的内容
    
17.     command: sh -c "npm config set registry https://registry.npmmirror.com && npm install && node server.js"
    
18.     environment:
    
19.       - TZ=Asia/Shanghai

复制代码

注意：Nas存储音乐文件夹的路径请自行修改，可在文件管理器中点击文件夹右键，选择“属性”后复制文件夹路径。端口默认是3010，如有占用可自行修改。

3.关键步骤：下载夸克网盘中的服务端代码的压缩包：server_code.zip​。

链接：https://pan.quark.cn/s/9adc722454f0
提取码：wYWJ

①解压后，将压缩包的文件上传到 docker/nas-music​ 下。上传完后，目录结构应该是：

②打开绿联 NAS 的 Docker 管理器 -> 项目 -> 创建 -> 输入名称（music-server） -> 选择路径（docker/nas-music​） -> 导入之前创建的docker-compose.yml​文件（或者把上面的代码粘贴在文本框） ->立即部署 。

提醒：要是部署不成功，可以完全参照我的文件夹路径：
①Docker项目路径：/volume1/docker/nas-music
②Nas音乐存储路径：/volume1/音乐
端口保持：3010，不要修改。

---

第二步：安装客户端 (App)
1.下载夸克网盘中的NAS Music.APK
2.安装到手机或者TV端。
3.初次配置。打开 App后点击侧边栏底部的 “连接设置” 。输入你的 NAS IP 地址和端口，例如：192.168.0.20:3010​，点击“保存并刷新”，如果界面左上角显示绿色“已连接”即可开始听歌！

📸 效果图
TV版：





手机版：


⚠️ 常见问题
Q: 歌词不显示？
A: 请确保 LRC 歌词文件和音乐文件同名且在同一目录下。
Q: 外网能用吗？
A: 需要你的 NAS 有公网 IP 或者配置了内网穿透 (FRP/DDNS)，在设置里填写公网地址即可。
Q: 为什么部分封面不显示？
A: 目前优先读取音频文件内嵌的封面。如果文件夹里有 cover.jpg，后续版本会支持。
Q：为什么TV端使用卡顿不流畅。
A：TV端由于性能配置较低的原因，导致应用卡顿。目前TV端主打一个能听，还在进一步优化中~

有什么问题可以在评论区反馈~但是不一定会解决。。。

666

niu人！无私👍