bmartin5692/bumper

Bumper

镜像概述和主要用途

Bumper是Ecovacs扫地机器人中央服务器的独立自托管实现。它让用户能够完全控制自己的Ecovacs机器人，无需机器人或应用程序与Ecovacs官方服务器通信，从而避免数据传输到家庭外部网络。

核心功能和特性

• 独立自托管：作为独立服务运行，不依赖Ecovacs官方中央服务器
• 离线可用：在无互联网连接或Ecovacs服务器故障时仍能正常工作
• 性能优化：消息无需往返Ecovacs服务器，减少通信延迟
• 安全隔离：将机器人完全与公共互联网隔离，保护用户数据隐私

使用场景和适用范围

适用于拥有Ecovacs Wi-Fi扫地机器人的用户，特别是：

• 关注数据隐私，希望避免机器人数据上传至外部服务器的用户
• 需要在无互联网环境下控制机器人的场景
• 追求更快速响应的机器人控制体验的用户

兼容性

由于协议***和自托管服务器的开发仍在进行中，Bumper的测试范围有限。它理论上兼容大多数使用Ecovacs Android/iOS应用或Ecovacs Home Android/iOS应用的Wi-Fi机器人，但目前仅在以下型号上测试通过：

使用方法和配置说明

文档和入门指南

详细文档请参见 https://bumper.readthedocs.io。

Docker部署示例

使用docker run命令

bash
docker run -d --name bumper -p 80:80 -p 443:443 docker.xuanyuan.run/bmartin5692/bumper:latest

使用docker-compose配置

yaml
version: '3'
services:
  bumper:
    image: docker.xuanyuan.run/bmartin5692/bumper:latest
    container_name: bumper
    ports:
      - "80:80"
      - "443:443"
    restart: unless-stopped

注意事项

• 当前master分支不稳定，处于积极开发中
• 本软件为实验性软件，尚未准备好用于生产环境，使用风险自负

社区支持

已创建Gitter社区，用户可在GitHub之外进行交流和讨论问题：

测试需求

Bumper需要用户协助测试以确保兼容性！如果您已使用Bumper测试过您的机器人，请提交issue说明测试结果或遇到的问题。

致谢

特别感谢原项目创建者@torbjornaxelsson，没有他的工作，本项目的构建将花费更长时间。
Bumper的存在离不开https://github.com/wpietri/sucks——一个Ecovacs机器人的开源客户端。感谢@wpietri和所有贡献者！