原文链接:零基础用NAS搭建XiaoMusic,小爱音箱秒变家庭音乐中心 - cpolar 极点云官网

前言

你是否想过——家里的小爱音箱,除了听新闻、查天气,还能变成一个完全由你掌控的家庭音乐中心?

不用开会员、不依赖网络曲库,只要你的 NAS上存了音乐,就能随时对小爱说:“播放周杰伦”、“随机播放轻音乐”、“循环我的收藏歌单”……

这一切,只需一个开源神器:XiaoMusic。

本教程专为零基础用户 打造,无需懂代码、不用配环境,只要你有一台支持 Docker的NAS(如群晖、威联通、极空间等),跟着步骤操作,30 分钟内即可完成部署。

从此,你的小爱音箱将彻底摆脱平台限制,真正实现 “本地音乐自由” ——

image-20251217102204350

1.在极空间部署xiaomusic

1.1ssh远程连接到极空间

  • 开启【SSH 服务】

  • 使用终端(Windows PowerShell / Mac Terminal)登录:

ssh root@IP

Bash

没有ssh的小伙伴可以

957c00e3b3f0ce8aa95df96aa41b8715

再吃灰了!开启SSH,秒变全能服务器! – cpolar 极点云官网

957c00e3b3f0ce8aa95df96aa41b8715

1.2验证docker是否开启

使用命令:

docker -v 
systemctl status -v

Bash

没有docker的小伙伴可

image-20251017103712618

程访问保姆级教程,30分钟上手! – cpolar 极点云官网

image-20251017103712618

2.在极空间部署xiaomusic

使用docker部署的两种方式:

docker启动命令如下:

docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic

Bash

对应的docker compose配置如下:

services:
  xiaomusic:
    image: hanxi/xiaomusic
    container_name: xiaomusic
    restart: unless-stopped
    ports:
      - 58090:8090
    environment:
      XIAOMUSIC_PUBLIC_PORT: 58090
    volumes:
      - /xiaomusic_music
67a20536fc0723942ccf9890c2070ebc

设备就添加成功了:

33848edf4ce59fdfc538dfb299c337e5

点击搜索,搜索我们想听的歌:

b6adc6d96fd78141c86b5c5f2f5c2ffd

我这里搜索周杰伦:

76c3b5c49d956086a6a2bc42248bf05f

后续也可以添加我们想听的歌:

66788d3f50dfe3a42db3ae61b6bd1b9f
b29b675fc04f99153ae375d31ff52bf5
1e6b503153e7c9909026a41259870408

我们搜索的歌会在播放列表上,直接点击听就可以:

dff840a03107f8927cf69de96bfa3f2c

它还有很多主题供我们选择:

image-20251217152920486

在完成XiaoMusic的 NAS 本地部署后,你已经可以让小爱音箱畅听局域网内的音乐了。但如

dd0b619f8e43e991bbb538a6b1ba28fa

S 上运行的XiaoMusic

8534577289dadd4031f6b645f8c0862b

H、Web、数据库)映射到公网。即使你在家里或外出时,也可以通过公网地址连接回本地运行的开发环境。

❤️以下是安装cpolar步骤:

官网在此:https://www.cpola

cfcdb619870c5ec4bed211122e2c3590
/g
33848edf4ce59fdfc538dfb299c337e5

76c3b5c49d956086a6a2bc42248bf05f
do syste
b6adc6d96fd78141c86b5c5f2f5c2ffd
aa03713b56d9eef12a4da6b99d2e46ac

Cpolar安装和成功启动服务后,在浏览器上输入虚拟机主机IP加9200端口即:

66788d3f50dfe3a42db3ae61b6bd1b9f

的账号登录,登录后即可看到cp

1e6b503153e7c9909026a41259870408

管理——创建隧道:

  • 隧道名称:可自定义,本例使用了:xiaomusic,注意不要与已有的隧道名称重复

  • 协议:http

  • 本地地址:58090

  • 域名类型:随机域名

  • 地区:选择China Top

image-20251217151500902

创建成功后,打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址,接下来就可以在其他电脑或者移动端设备(异地)上,使用地址访问。

image-20251217151514464

访问成功。

image-20251217151530797

6.保留固定公网地址

使用cpolar为其配置二级子域名,该地址为固定地址,不会随机变化。

image-20250918151358733

点击左侧的预留,选择保留二级子域名,地区选择china Top,然后设置一个二级子域名名称,我使用的是xiaomusic,大家可以自定义。填写备注信息,点击保留。

image-20251217151652396

登录cpolar web UI管理界面,点击左侧仪表盘的隧道管理——隧道列表,找到所要配置的隧道,点击右侧的编辑

image-20251217151725812

修改隧道信息,将保留成功的二级子域名配置到隧道中

  • 域名类型:选择二级子域名

  • Sub D

    e464b045413a024674a93ea472511b0f

    区: China Top

点击更新

image-20251217151756777

更新完成后,打开在线隧道列表,此时可以看到随机的公网地址已经发生变化,地址名称也变成了保留和固定的二级子域名名称。

image-20251217151818497

最后,我们使用固定的公网地址在任意设备的浏览器中访

aa03713b56d9eef12a4da6b99d2e46ac

能轻松在NAS上部署XiaoMusic,将闲置的小爱音箱彻底“盘活”——不再受限于在线曲库或会员权限,只需把音乐存入NAS,就能用语音自由点播本地歌曲,打造真正属于你的私人家庭音乐中心。

整个过程无需编程、不碰命令行(或仅需简单复制几条指令),借助Docker的便捷性和XiaoMusic的强大功能,几分钟内即可完成配置。更进一步,结合cpolar内网穿透,你还能实现外网远程控制,无论身在何处,一句“播放我的歌单”,家中的小爱音箱立刻为你响起熟悉的旋律。

现在,你的NAS不只是存储设备,更是智能生活的中枢。快去试试吧,让音乐,随你心意流淌在家的每个角落