之前的文章 《别再给音箱充会员了！手把手教你把小爱音箱变成“私人点唱机”》 发布之后，很受大家的喜爱，评论区一下子热闹起来了。
但我也发现一个很明显的问题👇
真正把人劝退的，不是小爱，不是音乐，而是：Docker
所以今天这篇文章，不讲原理、不扯概念，只干一件事：
👉 把 Docker 安装 + 部署这一关，彻底讲清楚
哪怕你之前从没碰过 Docker，照着做，也能跑起来。
一、你的 NAS / 电脑已经有 Docker？先看这里
如果你用的是 飞牛 NAS、群晖、极空间 这类设备，大概率已经自带 Docker 了。
下面我以 飞牛 NAS 为例，其它 NAS 以具体操作为准。
二、NAS 有 Docker 图形界面（最省心）
✅ 方式一：直接用 Docker 界面
1️⃣ 先下载镜像
在 Docker 镜像搜索里，输入：
hanxi/xiaomusic
如果下载速度慢、失败，可以换成国内地址：
docker.io/hanxi/xiaomusic
📌 注意：镜像名字别打错，最好复制粘贴
2️⃣ 创建容器
镜像下载完成后，点击 创建容器
3️⃣ 配置端口、目录映射、环境变量（关键）
这一步是最多人卡住的地方，我们慢慢来。
📦 端口说明：
58090：对外暴露访问的端口8090：对应docker容器内部端口
📁 目录说明：
conf：配置文件目录music：你自己的音乐存放目录
目录路径可以直接在 NAS 文件管理器里右键复制，不要手敲，避免路径错。
📌 变量说明：
XIAOMUSIC_PUBLIC_PORT：公开端口，对应上面映射的58090
配置完成后，启动容器即可。
✅ 方式二：Docker Compose（强烈推荐）
如果你不想每次都在界面里点来点去，那 compose 是最舒服的方式。
新建一个 docker-compose.yml 文件，内容如下👇
services:
xiaomusic:
image: hanxi/xiaomusic
container_name: xiaomusic
restart: unless-stopped
ports:
- 58090:8090
environment:
XIAOMUSIC_PUBLIC_PORT: 58090
volumes:
- /vol1/1000/xiaomusic/music:/app/music
- /vol1/1000/xiaomusic/conf:/app/conf
📦 端口说明：
58090：对外暴露访问的端口8090：对应docker容器内部端口
📁 目录说明：
conf：配置文件目录music：你自己的音乐存放目录
⚠️ 重要提醒：
yaml对缩进极其敏感- 只能用 空格，不能用 Tab
- 缩进对齐不对，直接起不来
三、没有 Docker 界面？那就用终端（不难）
如果你的 NAS 没有图形界面，也别慌，用 SSH 一样能搞定。
1️⃣ 开启 SSH
在 NAS 管理界面里，开启 SSH 服务。
2️⃣ 电脑连接 NAS
在你电脑终端里输入：
ssh 用户名@NAS的IP地址
例如：
ssh zhoupb@192.168.31.100
3️⃣ 切换到 root 用户
sudo -i
4️⃣ 确认 Docker 是否正常
docker ps
能正常输出，就说明 Docker 没问题。
四、命令行部署（照抄即可）
✅ 方式一：docker run
# 📦 端口说明：
# `58090`：对外暴露访问的端口
# `8090`：对应docker容器内部端口
# 📁 目录说明：
# `conf`：配置文件目录
# `music`：你自己的音乐存放目录
docker run -d \
--name xiaomusic \
--restart always \
-p 58090:8090 \
-v /vol1/1000/xiaomusic/music:/app/music \
-v /vol1/1000/xiaomusic/conf:/app/conf \
hanxi/xiaomusic
✅ 方式二：docker compose（依然推荐）
新创建文件 docker-compose.yml
# 📦 端口说明：
# `58090`：对外暴露访问的端口
# `8090`：对应docker容器内部端口
# 📁 目录说明：
# `conf`：配置文件目录
# `music`：你自己的音乐存放目录
# ⚠️ 重要提醒：
# `yaml` 对缩进极其敏感
# 只能用 **空格，不能用 Tab**
# 缩进对齐不对，直接起不来
services:
xiaomusic:
image: hanxi/xiaomusic
container_name: xiaomusic
restart: unless-stopped
ports:
- 58090:8090
environment:
XIAOMUSIC_PUBLIC_PORT: 58090
volumes:
- /vol1/1000/xiaomusic/music:/app/music
- /vol1/1000/xiaomusic/conf:/app/conf
确保在yaml文件当前目录下执行：
docker compose up -d
📌 注意：一定要在 yml 文件所在目录执行
五、你电脑上还没装 Docker？先装再说
Windows / macOS
直接下载官方桌面版：
一路下一步即可。
Linux 用户
# 以Centos(9/10)为例
# 0. Uninstall old versions
sudo dnf remove docker \
docker-client \
docker-client-latest \
docker-common \
docker-latest \
docker-latest-logrotate \
docker-logrotate \
docker-engine
# 1. Set up the repository
sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
# 2. Install Docker Engine
sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
# 3. Start Docker Engine
sudo systemctl enable --now docker
装好之后，再回头执行前面的 docker run 或 docker compose。
六、关于xiaomusic怎么配置
启动后，在浏览器输入：http://你的服务IP:58090，然后就可以界面化操作了。
你可以查看之前的文章《别再给音箱充会员了！手把手教你把小爱音箱变成“私人点唱机”》，里面有详细介绍。
七、补充参考（不同环境）
- 群晖 Nas：
https://xdocs.hanxi.cc/issues/101.html - 极空间 Nas：
https://xdocs.hanxi.cc/issues/297.html - 1Panel：
https://xdocs.hanxi.cc/issues/600.html - Android TV 连xiaomusic：
https://xdocs.hanxi.cc/issues/767.html - 问题集合：
https://xdocs.hanxi.cc/issues/99.html
写在最后
如果你已经看到这里，说明一句话：
你不是不会，是之前没人把 Docker 这一步讲清楚
等这一关过去了，后面不管是
- 扔音乐
- 调音质
- 绑定小爱
都只是“填内容”的事。
如果你在某一步 报错 / 起不来 / 页面打不开
👉 直接把报错截图或报错发评论区
我可以帮你分析看看。
