msmi/nodejs-poolcontroller

nodejs-poolcontroller 镜像文档

镜像概述和主要用途

nodejs-poolcontroller镜像是基于https://github.com/tagyoureit/nodejs-poolController%E6%9E%84%E5%BB%BA%E7%9A%84Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E7%94%A8%E4%BA%8E%E6%8E%A7%E5%88%B6%E4%B8%8EPentair%E5%85%BC%E5%AE%B9%E7%9A%84%E6%B3%B3%E6%B1%A0%E8%AE%BE%E5%A4%87%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E9%80%9A%E8%BF%87RS-485%E9%80%82%E9%85%8D%E5%99%A8%E4%B8%8E%E6%B3%B3%E6%B1%A0%E8%AE%BE%E5%A4%87%E9%80%9A%E4%BF%A1%EF%BC%8C%E5%B9%B6%E6%8F%90%E4%BE%9BWeb%E7%AE%A1%E7%90%86%E7%95%8C%E9%9D%A2%EF%BC%88%E9%BB%98%E8%AE%A4%E7%AB%AF%E5%8F%A34200%EF%BC%89%EF%BC%8C%E5%AE%9E%E7%8E%B0%E5%AF%B9%E6%B3%B3%E6%B1%A0%E8%AE%BE%E5%A4%87%E7%9A%84%E8%BF%9C%E7%A8%8B%E7%9B%91%E6%8E%A7%E5%92%8C%E6%8E%A7%E5%88%B6%E3%80%82

核心功能和特性

• 支持控制Pentair兼容的泳池设备
• 通过RS-485接口与设备通信（默认设备路径/dev/ttyUSB0）
• 提供Web管理界面，默认通过4200端口访问
• 支持持久化存储配置文件、数据和日志
• 可与dashPanel客户端配合使用，增强用户界面体验
• 可选socat服务实现跨Docker主机的设备通信

使用场景和适用范围

适用于需要对Pentair兼容泳池设备进行集中管理和控制的场景，包括家庭泳池、小型商业泳池设施等。尤其适合希望通过Docker容器化部署实现设备控制与管理的用户。

使用方法和配置说明

快速测试

若需快速测试，且RS-485适配器位于默认端口/dev/ttyUSB0，可使用以下命令：

bash
docker run --rm -it -u node:dialout -p 4200:4200 --device /dev/ttyUSB0 msmi/nodejs-poolcontroller

Docker Compose配置示例

基础服务器版（最小配置）

适用于简单部署，包含基本服务定义：

yaml
services:
  poolcontroller:
    user: node:dialout
    devices:
      - /dev/ttyUSB0
    ports:
      - "4200:4200"
    image: msmi/nodejs-poolcontroller

带持久化存储的服务器版

支持配置文件、数据和日志的持久化存储：

yaml
services:
  poolcontroller:
    container_name: poolcontroller
    restart: always
    user: node:dialout
    devices:
      - /dev/ttyUSB0
    ports:
      - "4200:4200"
    volumes:
      - /data/poolcontroller/config.json:/app/config.json  # 配置文件持久化
      - /data/poolcontroller/data:/app/data              # 数据目录持久化
      - /data/poolcontroller/logs:/app/logs              # 日志目录持久化
    image: msmi/nodejs-poolcontroller

服务器与dashPanel客户端组合

包含服务端和dashPanel客户端，提供增强的Web界面：

yaml
services:
  poolcontroller:
    container_name: poolcontroller
    restart: always
    user: node:dialout
    devices:
      - /dev/ttyUSB0
    ports:
      - "4200:4200"
    volumes:
      - /data/poolcontroller/config.json:/app/config.json
      - /data/poolcontroller/data:/app/data
    image: msmi/nodejs-poolcontroller
  poolcontroller-dashpanel:
    restart: always
    container_name: poolcontroller-dashpanel
    ports:
      - "5150:5150"  # dashPanel客户端端口
    volumes:
      - /data/poolcontroller-dashpanel/config.json:/app/config.json
    image: msmi/nodejs-poolcontroller-dashpanel
    depends_on:
      - poolcontroller  # 依赖poolcontroller服务

Docker socat转发示例

通过socat实现跨Docker主机的RS-485设备访问（可选配置）：

yaml
services:
  poolcontroller:
    container_name: poolcontroller
    restart: always
    ports:
      - "4200:4200"
    volumes:
      - /data/poolcontroller/config.json:/app/config.json
      - /data/poolcontroller/data:/app/data
    image: msmi/nodejs-poolcontroller
  socat:
    command: tcp-listen:9801,fork,reuseaddr file:/dev/ttyUSB0,b9600,raw,echo=0
    container_name: socat
    restart: always
    ports:
      - "9801:9801"  # socat转发端口
    devices:
      - /dev/ttyUSB0
    image: alpine/socat

注意事项

• socat服务为可选组件，适用于需要跨Docker主机访问RS-485设备的场景，稳定性高
• 卷映射非必需，仅在需要持久化配置、数据或日志时使用
• 确保RS-485适配器设备路径正确（默认/dev/ttyUSB0，需根据实际情况调整）
• 使用node:dialout用户确保容器对RS-485设备有访问权限