fmossott/roomba980
fmossott
该Docker镜像提供本地服务器和REST接口，用于在局域网内控制iRobot Roomba 9xx系列扫地机器人，支持实时地图监控、OpenMetrics指标输出及基础认证/HTTPS配置，可集成到家庭自动化系统。
下载次数: 0状态：社区镜像维护者：fmossott仓库类型：镜像最近更新：5 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Roomba980
https://travis-ci.org/fmossott/Roomba980.svg?branch=master](https://travis-ci.org/fmossott/Roomba980) https://david-dm.org/fmossott/Roomba980.svg](https://david-dm.org/fmossott/Roomba980)
Roomba980通过HTTP服务器将https://github.com/koalazak/dorita980%E7%9A%84%E6%89%80%E6%9C%89%E6%96%B9%E6%B3%95%E6%98%A0%E5%B0%84%E4%B8%BAREST API，用于在局域网内控制iRobot Roomba 980扫地机器人。
核心功能
- REST API控制：支持本地和云接口（仅适用于固件1.6.x），提供清洁动作（启动、停止、回充等）、设备信息查询及配置修改功能。
- 实时地图监控：通过Web界面查看机器人实时活动及历史清洁任务地图。
- OpenMetrics指标：输出电池状态、清洁状态等指标，可集成到Prometheus和Grafana进行可视化。
- 安全配置：支持基础认证、HTTPS加密及反向代理路径设置。
使用场景
- 家庭自动化系统集成（如Home Assistant）。
- 远程监控机器人状态及清洁进度。
- 通过Prometheus+Grafana分析清洁数据。
配置说明
可通过编辑config/default.json或设置环境变量配置服务：
| 配置文件项 | 环境变量 | 描述 |
|---|---|---|
| port | PORT | 默认3000，HTTP服务端口 |
| blid | BLID | 必填，Roomba设备ID |
| password | PASSWORD | 必填，Roomba设备密码 |
| robotIP | ROBOT_IP | 可选，机器人IP（跳过发现加速启动） |
| firmwareVersion | FIRMWARE_VERSION | 可选，固件版本（1或2，默认1） |
| enableLocal | ENABLE_LOCAL | 可选，是否启用本地API（默认yes） |
| enableCloud | ENABLE_CLOUD | 可选，是否启用云API（默认yes） |
| keepAlive | KEEP_ALIVE | 可选，是否保持连接（默认yes，设为no则每次请求重新连接） |
| basicAuthUser | BASIC_AUTH_USER | 可选，基础认证用户名（需与密码同时设置） |
| basicAuthPass | BASIC_AUTH_PASS | 可选，基础认证密码（需与用户名同时设置） |
| sslKeyFile | SSL_KEY_FILE | 可选，HTTPS密钥文件路径（需与证书同时设置） |
| sslCertFile | SSL_CERT_FILE | 可选，HTTPS证书文件路径（需与密钥同时设置） |
| rootPath | ROOT_PATH | 可选，API基础路径（适用于反向代理场景） |
获取BLID和密码：
bashdocker run -it docker.xuanyuan.run/fmossott/roomba980 npm run getpassword <RoombaIP>
Docker部署示例
拉取镜像
bashdocker pull docker.xuanyuan.run/fmossott/roomba980
运行容器
bashdocker run -p 3000:3000 -v roomba:/usr/src/app/missions \ -e BLID=你的BLID -e PASSWORD=你的密码 -e ROBOT_IP=机器人IP \ docker.xuanyuan.run/fmossott/roomba980
Docker Compose配置
创建docker-compose.yml：
yamlversion: '2' services: roomba-map: image: docker.xuanyuan.run/fmossott/roomba980 environment: - BLID=你的BLID - PASSWORD=你的密码 - ROBOT_IP=机器人IP - ROOT_PATH=/roomba ports: - "3000:3000" restart: always volumes: - roomba:/usr/src/app/missions volumes: roomba:
启动命令：
bashdocker-compose up --remove-orphans -d
本地构建镜像
bashgit clone https://github.com/fmossott/Roomba980.git cd Roomba980 docker build . -t fmossott/roomba980
API使用示例
启动清洁
httpGET http://服务器IP:3000/api/local/action/start
成功响应：
json{"ok":null,"id":23}
获取电池状态
httpGET http://服务器IP:3000/api/local/info/mission
成功响应（示例）：
json{"ok":{"flags":0,"cycle":"none","phase":"charge","pos":{"theta":179,"point":{"x":102,"y":-13}},"batPct":99,"expireM":0,"rechrgM":0,"error":0,"notReady":0,"mssnM":0,"sqft":0},"id":2}
实时地图
访问http://服务器IP:3000/map查看机器人实时活动及历史任务地图。
指标监控
访问http://服务器IP:3000/metrics获取OpenMetrics格式指标，可导入Prometheus并使用Grafana dashboard可视化。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 roomba980 镜像标签
docker pull docker.xuanyuan.run/fmossott/roomba980:<标签>
DockerHub 原生拉取命令
docker pull fmossott/roomba980:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"