roflcoopter/valetudo-mapper

Valetudo Mapper 镜像说明

镜像概述

Valetudo Mapper是Valetudo的配套服务，针对扫地机器人CPU和内存资源有限的问题，将地图PNG生成等资源密集型任务转移到外部主机执行，提升整体效率。

核心功能

1. 地图渲染：支持绘制路径、充电器位置、机器人位置、禁止区域、虚拟墙等元素，可配置裁剪、缩放、边框等参数；
2. MQTT集成：与MQTT broker连接，向HomeAssistant等平台推送地图数据或图片；
3. Web服务：启用后可通过HTTP接口访问地图PNG图片；
4. 灵活配置：通过映射配置文件自定义MQTT参数、地图设置、Web端口等。

使用场景

1. 搭配Valetudo使用，为扫地机器人（如Rockrobo）生成地图；
2. 与HomeAssistant、FHEM、ioBroker等智能家居平台集成，展示扫地机器人地图；
3. 为Lovelace Valetudo Map Card提供解析后的地图数据支持。

配置说明

通过映射/app/config.json文件修改配置，示例配置如下：

json
{
    "mqtt": {
        "identifier": "rockrobo",
        "topicPrefix": "valetudo",
        "autoconfPrefix": "homeassistant",
        "broker_url": "mqtt://user:pass@example.com:port",
        "caPath": "",
        "mapSettings": {
            "drawPath": true,
            "drawCharger": true,
            "drawRobot": true,
            "drawForbiddenZones": true,
            "drawVirtualWalls": true,
            "border": 2,
            "scale": 4,
            "gradientBackground": true,
            "crop_x1": 30,
            "crop_y1": 70,
            "crop_x2": 440,
            "crop_y2": 440
        },
        "mapDataTopic": "valetudo/rockrobo/map_data",
        "minMillisecondsBetweenMapUpdates": 10000,
        "publishMapImage": true,
        "publishMapData": false
    },
    "webserver": {
        "enabled": false,
        "port": 3000
    }
}

部署示例

Docker Run

bash
docker run -d \
  --name valetudo-mapper \
  -v /path/to/your/config.json:/app/config.json \
  -p 3000:3000 \
  roflcoopter/valetudo-mapper

说明

• 替换/path/to/your/config.json为本地配置文件路径；
• 若启用Web服务，需映射对应端口（如3000）。