之前的文章 《别再给音箱充会员了！手把手教你把小爱音箱变成“私人点唱机”》 发布之后，很受大家的喜爱，评论区一下子热闹起来了。

但我也发现一个很明显的问题?

真正把人劝退的，不是小爱，不是音乐，而是：Docker

所以今天这篇文章， 不讲原理、不扯概念，只干一件事： ? 把 Docker 安装 + 部署这一关，彻底讲清楚

哪怕你之前从没碰过 Docker，照着做，也能跑起来。

一、你的 NAS / 电脑已经有 Docker？先看这里

如果你用的是 飞牛 NAS、群晖、极空间 这类设备，大概率已经自带 Docker 了。

下面我以 飞牛 NAS 为例，其它 NAS 以具体操作为准。

二、NAS 有 Docker 图形界面（最省心）

✅ 方式一：直接用 Docker 界面

1️⃣ 先下载镜像

在 Docker 镜像搜索里，输入：

hanxi/xiaomusic

如果下载速度慢、失败，可以换成国内地址：

docker.io/hanxi/xiaomusic

? 注意：镜像名字别打错，最好复制粘贴

PixPin2026-02-2421-09-53.png

2️⃣ 创建容器

镜像下载完成后，点击 创建容器

PixPin2026-02-2421-20-01.png

3️⃣ 配置端口、目录映射、环境变量（关键）

这一步是 最多人卡住的地方，我们慢慢来。

? 端口说明：

58090：对外暴露访问的端口
8090：对应docker容器内部端口

? 目录说明：

目录路径可以直接在 NAS 文件管理器里右键复制，不要手敲，避免路径错。

PixPin2026-02-2421-20-38.png

? 变量说明：

XIAOMUSIC_PUBLIC_PORT：公开端口，对应上面映射的 58090

PixPin2026-02-2421-21-49.png

配置完成后，启动容器即可。

✅ 方式二：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容器内部端口

? 目录说明：

⚠️ 重要提醒：

yaml 对缩进极其敏感
只能用 空格，不能用 Tab
缩进对齐不对，直接起不来

PixPin2026-02-2421-22-51.png

三、没有 Docker 界面？那就用终端（不难）

如果你的 NAS 没有图形界面，也别慌， 用 SSH 一样能搞定。

1️⃣ 开启 SSH

在 NAS 管理界面里，开启 SSH 服务。

PixPin2026-02-2421-25-21.png

2️⃣ 电脑连接 NAS

在你电脑终端里输入：

ssh 用户名@NAS的IP地址

例如：

ssh zhoupb@192.168.31.100

PixPin2026-02-2421-34-57.png

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

PixPin2026-02-2421-40-31.png

✅ 方式二：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 文件所在目录执行

PixPin2026-02-2421-42-13.png

五、你电脑上还没装 Docker？先装再说

Windows / macOS

直接下载官方桌面版：

https://www.docker.com/get-started/

一路下一步即可。

Linux 用户

只装引擎：

https://docs.docker.com/engine/install/

# 以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