thebiftek/valetudo-mapper

Valetudo Mapper镜像说明

镜像概述

该镜像为https://github.com/Hypfer/Valetudo%E7%9A%84%E5%9C%B0%E5%9B%BE%E7%94%9F%E6%88%90%E8%BE%85%E5%8A%A9%E6%9C%8D%E5%8A%A1%EF%BC%8C%E6%97%A8%E5%9C%A8%E5%88%86%E6%8B%85%E6%9C%BA%E5%99%A8%E4%BA%BA%E7%9A%84%E5%9C%B0%E5%9B%BE%E6%B8%B2%E6%9F%93%E5%8E%8B%E5%8A%9B%EF%BC%88%E5%9B%A0%E6%9C%BA%E5%99%A8%E4%BA%BACPU%E5%92%8C%E5%86%85%E5%AD%98%E8%B5%84%E6%BA%90%E6%9C%89%E9%99%90%EF%BC%89%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%E7%9A%84%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%E5%90%8E%EF%BC%8C%E5%8F%AF%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%E4%BE%9B%E5%A4%96%E9%83%A8%E8%AE%BF%E9%97%AE%E3%80%82

核心功能

1. 接收机器人通过MQTT发送的原始地图数据
2. 渲染地图为PNG格式，支持自定义样式（裁剪、缩放、旋转、颜色配置等）
3. 通过MQTT发布渲染后的地图图像
4. 可选内置Web服务器，提供地图图像API接口

使用场景

• 家庭自动化系统集成：如FHEM、ioBroker等平台可通过Web API或MQTT获取并展示机器人地图
• 自定义地图样式：根据需求调整地图颜色、缩放比例、叠加背景/前景图等

配置说明

需创建config.json配置文件，核心配置项如下：

地图设置（mapSettings）

• autoCrop：是否自动裁剪地图空白区域（默认开启）
• scale：地图缩放倍数（默认4）
• rotate：地图旋转角度
• colors：自定义地图颜色（地板、障碍物、路径、区域等）
• underlay_path/overlay_path：背景/前景图路径及位置、缩放配置

MQTT设置（mqtt）

• broker_url：MQTT broker地址（含认证信息）
• mapDataTopic：接收原始地图数据的MQTT主题
• publishMapImage：是否发布渲染后的地图图像

Web服务器设置（webserver）

• enabled：是否启用Web服务器（默认关闭）
• port：Web服务器端口（默认3000），启用后可通过http://host:port/api/map/image获取地图图像

Docker部署示例

Docker Run命令

bash
docker run -d \
  --name valetudo-mapper \
  -v /path/to/your/config.json:/app/config.json \
  -p 3000:3000 \ # 仅当webserver.enabled=true时需要
  thebiftek/valetudo-mapper

Docker Compose示例

yaml
version: '3'
services:
  valetudo-mapper:
    image: thebiftek/valetudo-mapper
    container_name: valetudo-mapper
    volumes:
      - ./config.json:/app/config.json
    ports:
      - "3000:3000" # 仅启用Web服务器时暴露
    restart: unless-stopped