dmkif/icantbelieveitsnotvaletudo

I can't believe it's not Valetudo

镜像概述

这是https://github.com/Hypfer/Valetudo%E7%9A%84%E5%9C%B0%E5%9B%BE%E7%94%9F%E6%88%90%E9%85%8D%E5%A5%97%E6%9C%8D%E5%8A%A1%EF%BC%8C%E8%A7%A3%E5%86%B3%E6%89%AB%E5%9C%B0%E6%9C%BA%E5%99%A8%E4%BA%BACPU%E5%92%8C%E5%86%85%E5%AD%98%E6%9C%89%E9%99%90%E7%9A%84%E9%97%AE%E9%A2%98%EF%BC%8C%E5%B0%86%E7%AC%AC%E4%B8%89%E6%96%B9%E7%BB%84%E4%BB%B6%E7%9A%84PNG%E5%9C%B0%E5%9B%BE%E7%94%9F%E6%88%90%E5%B7%A5%E4%BD%9C%E8%BD%AC%E7%A7%BB%E8%87%B3%E6%AD%A4%E3%80%82%E6%9C%8D%E5%8A%A1%E9%80%9A%E8%BF%87MQTT%E6%8E%A5%E6%94%B6%E6%9C%BA%E5%99%A8%E4%BA%BA%E5%8E%9F%E5%A7%8B%E5%9C%B0%E5%9B%BE%E6%95%B0%E6%8D%AE%EF%BC%8C%E6%B8%B2%E6%9F%93%E4%B8%BAPNG%E5%9B%BE%E5%83%8F%EF%BC%8C%E5%B9%B6%E9%80%9A%E8%BF%87MQTT%E5%8F%91%E5%B8%83%E6%88%96%E5%86%85%E7%BD%AEweb%E6%9C%8D%E5%8A%A1%E5%99%A8%E6%8F%90%E4%BE%9B%E3%80%82

核心功能

• 接收机器人通过MQTT发送的原始地图数据
• 渲染生成PNG格式的地图图像
• 支持通过MQTT发布地图图像
• 内置web服务器提供地图图像接口
• 提供地图自定义功能（裁剪、缩放、颜色调整、叠加层等）

使用场景

• 智能家居自动化系统集成（如FHEM、ioBroker），展示扫地机器人的实时地图
• 通过web服务器接口在其他应用中嵌入地图
• 自定义地图样式以适配不同的家居场景

配置说明

基本配置

创建config.json文件（运行时自动生成默认配置），Docker部署时需映射到/app/config.json。示例配置：

json
{
    "mapSettings": {
        "drawPath": true,
        "drawCharger": true,
        "drawRobot": true,
        "scale": 4
    },
    "mqtt": {
        "identifier": "rockrobo",
        "topicPrefix": "valetudo",
        "broker_url": "mqtt://user:pass@mqtt.example.com",
        "mapDataTopic": "valetudo/rockrobo/map_data",
        "publishMapImage": true
    },
    "webserver": {
        "enabled": true,
        "port": 3000
    }
}

高级配置

• 裁剪：通过crop_x1/crop_y1（左上角）和crop_x2/crop_y2（右下角）设置裁剪区域
• 缩放：调整scale参数（默认4倍），使用最近邻插值避免模糊
• 颜色：通过colors对象自定义地板、障碍物、路径等颜色
• 叠加层：通过underlay_path/overlay_path添加背景或覆盖图像

Docker部署示例

Docker Run

bash
docker run -d \
  --name icantbelieveitsnotvaletudo \
  -v /path/to/your/config.json:/app/config.json \
  -p 3000:3000 \
  docker.xuanyuan.run/dmkif/icantbelieveitsnotvaletudo

Docker Compose

yaml
version: "3"
services:
  icantbelieveitsnotvaletudo:
    image: docker.xuanyuan.run/dmkif/icantbelieveitsnotvaletudo
    volumes:
      - ./config.json:/app/config.json
    ports:
      - "3000:3000"
    restart: unless-stopped

地图图像可通过http://localhost:3000/api/map/image访问（需启用webserver）。 ===END===