pluggemi/roon-web-controller

Roon Web Controller 2.0.0 ALPHA

注意：这是Alpha版本软件，存在功能缺失。

当前状态请查看https://github.com/pluggemi/roon-web-controller/tree/alpha%E3%80%82

Docker / Kubernetes支持

Docker是使用Roon Web Controller的首选方式，镜像将发布至Docker Hub的https://hub.docker.com/repository/docker/pluggemi/roon-web-controller%E3%80%82

环境变量选项

以下环境变量可用于配置Roon Web Controller镜像：

• ROON_HOST：设置Roon Core的IP地址（或主机名，需DNS正常）。若未设置，将尝试自动发现Roon Core。
• ROON_PORT：设置Roon Core运行的端口，默认值为9100，通常无需修改。

示例运行命令

以下是运行该Docker容器的示例命令：

docker run -d \
  -p 8080:8080 \
  -e ROON_HOST="<你的Roon Core IP>" \
  pluggemi/roon-web-controller:alpha

若需发布live/ready/health端点（见下文）：

docker run -d \
  -p 8080:8080 \
  -p 9090:9090 \
  -e ROON_HOST="<你的Roon Core IP>" \
  pluggemi/roon-web-controller:alpha

Kubernetes的Live和Ready端点

该Docker镜像包含适用于Kubernetes部署的Live、Ready和Health端点，健康端点在容器内的9090端口运行：

• /live：软件运行时返回HTTP 200状态码（OK）。
• /ready：软件运行且已与Roon Core配对时返回HTTP 200状态码（OK），否则返回HTTP 503状态码（服务不可用）。
• /health：返回包含详细健康状态的JSON payload，示例输出如下：

javascript
{
  "app": {
    "name":"Roon Web Controller",
    "version":"2.0.0-alpha.0",
    "address":["172.17.0.2"]
  },
  "health":{
    "roon":"ready",
    "express":"ready",
    "socketio":"ready"
  }
}