stepman0/sonos-kids-controller

Sonos-Kids-Controller Docker 镜像文档

镜像概述和主要用途

Sonos-Kids-Controller Docker镜像提供了Sonos儿童控制器的容器化部署方式，用于简化家庭环境中儿童对Sonos音频设备的控制。该镜像需通过配置文件连接Sonos设备（基于node-sonos-http-api）和Spotify音乐服务，并支持数据持久化，确保重启容器后保留已添加的艺术家和专辑信息。

核心功能和特性

• 配置管理：需自定义config.json文件，包含Sonos设备连接信息（服务器地址、端口、房间）和Spotify API凭证（clientId、clientSecret）
• 数据持久化：data.json文件存储在挂载卷中，容器重启后仍可保留艺术家/专辑数据
• 端口要求：需开放容器8200端口以提供Web访问界面

使用场景和适用范围

适用于家庭环境中需要为儿童提供简化的Sonos设备控制界面，结合Spotify音乐服务播放儿童喜爱的音乐内容，尤其适合需要持久化保存音乐偏好设置的场景。

使用方法和配置说明

前置准备

1. 准备本地配置目录，用于存放config.json文件
2. 确保已获取Spotify开发者账号的clientId和clientSecret（需在Spotify开发者平台注册应用获取）

配置文件说明

需在本地配置目录中创建config.json，格式如下：

json
{
    "node-sonos-http-api": {
        "server": "127.0.0.1",  // Sonos HTTP API服务器地址
        "port": "5005",         // Sonos HTTP API端口
        "rooms": [              // 要控制的Sonos房间列表
            "Livingroom",
            "Kitchen"
        ]
    },
    "spotify": {
        "clientId": "your_id",      // Spotify客户端ID
        "clientSecret": "your_secret" // Spotify客户端密钥
    }
}

Docker部署示例

基础运行命令（适用于Docker Desktop for Mac x64等环境）

bash
docker run -p 8200:8200 -v /your/local/path/for/config:/Sonos-Kids-Controller-master/server/config/ murmeltier08/sonos-kids-controller

• -p 8200:8200：映射容器8200端口到主机，用于访问Web界面
• -v /your/local/path/for/config:/Sonos-Kids-Controller-master/server/config/：挂载本地配置目录到容器内配置路径，实现配置和数据持久化

注意事项

• 容器重启后，data.json中的艺术家/专辑数据会通过挂载卷保留
• 首次运行需确保config.json配置正确，否则可能无法连接Sonos设备或Spotify服务
• 详细配置说明可参考项目GitHub仓库：https://github.com/Thyraz/Sonos-Kids-Controller