物联网后端前端【免费下载链接】ValetudoCloud replacement for vacuum robots enabling local-only operation项目地址https://gitcode.com/gh_mirrors/va/Valetudo点击查看免费下载导读本文围绕 Valetudo 的升级机制展开覆盖两条主线一是 Valetudo 2021.11.0 及以后版本内置的集成更新器integrated updater的架构、配置与安全校验流程二是针对 RoborockS5/V1/S6与 Dreame 机型的旧版本手动升级步骤包括 SSH 刷镜像、双系统切换、二进制替换等实操命令。读者读完后将能根据自己机器人型号与 Valetudo 版本选择最合适的升级路径并理解底层检查→下载→校验→应用的完整调用链避免升级中常见的 Text file busy、磁盘空间不足等问题。一、升级方式总览内置更新器与手动升级Valetudo 的升级策略以2021.11.0 版本为分界线如果你运行的 Valetudo 是2021.11.0 或更新版本应优先使用其**内置更新器integrated updater**功能无需 SSH、无需手动下载二进制文件升级过程由 Web 界面/API 触发并自动完成如果你运行的是更早的旧版本则只能走本文后面给出的手动升级路径Roborock 刷镜像、Dreame 替换二进制。内置更新器并非一个简单的下载即覆盖而是一个带状态机的多步骤流程。在源码中它由 backend/lib/updater/Updater.js 中的Updater类实现整个流程被拆解为三个阶段Step检查阶段ValetudoUpdaterCheckStep确认嵌入式环境、机器人状态、磁盘空间并从更新源获取版本清单下载阶段ValetudoUpdaterDownloadStep流式下载新二进制并做 SHA-256 校验应用阶段ValetudoUpdaterApplyStep把下载的二进制替换到当前可执行文件路径然后重启或重生。下面先说明内置更新器的工作原理与配置再给出旧版本的手动升级实操。二、内置更新器2021.11.0架构、配置与触发方式2.1 触发入口Web API 与状态查询内置更新器通过 HTTP API 暴露路由实现在 backend/lib/webserver/UpdaterRouter.jsGET /api/v2/updater/state查询更新器当前状态空闲、错误、待确认、下载中、待应用等PUT /api/v2/updater/触发动作body.action可取check、download、apply三种值其中check动作还可带force: true强制检查GET /api/v2/updater/config与PUT /api/v2/updater/config读写更新源updateProvider配置可选值为github与github_nightly。也就是说Web 前端点击检查更新 → 确认 → 应用的每一步最终都会落到Updater.triggerCheck()/triggerDownload()/triggerApply()这三个方法上。2.2 配置项与默认值更新器相关的配置集中在 backend/lib/res/default_config.json默认配置如下updater: { enabled: true, updateProvider: { type: github, implementationSpecificConfig: {} } }参数说明enabled是否启用内置更新器。若为falseUpdater会进入ValetudoUpdaterDisabledState不进行任何检查见 backend/lib/updater/Updater.jsupdateProvider.type更新源类型。github对应GithubValetudoUpdateProvidergithub_nightly对应GithubValetudoNightlyUpdateProvider。如果配置了无效类型会退化为NullUpdateProvider并记录错误日志implementationSpecificConfig扩展配置默认空对象。2.3 检查阶段Check嵌入式约束与前置条件ValetudoUpdaterCheckStepbackend/lib/updater/lib/steps/ValetudoUpdaterCheckStep.js在拿到检查更新请求后会依次完成如下前置校验任一不满足都会以ValetudoUpdaterError拒绝升级前置条件校验逻辑失败时的错误类型嵌入式模式this.embedded ! true则拒绝NOT_EMBEDDEDUpdating is only possible in embedded mode机器人状态可查询轮询robot.pollState()失败UNKNOWN机器人已回充StatusStateAttribute.value ! DOCKED则拒绝NOT_DOCKEDUpdating is only possible while the robot is docked二进制位置可写fs.accessSync(process.argv0, W_OK)失败NOT_WRITABLE磁盘空间充足由UpdaterUtils.storageSurvey()评估NOT_ENOUGH_SPACE磁盘空间评估逻辑见 backend/lib/updater/lib/UpdaterUtils.js常规二进制需要约40 MBSPACE_REQUIRED_REGULAR 40 * 1024 * 1024可用空间若空间不足但大于20 MBSPACE_REQUIRED_UPX更新器会自动改用UPX 压缩二进制文件名带.upx后缀若二进制所在分区的总容量本身小于40 MB * 3也会强制走 UPX 路径下载暂存位置按可用空间从大到小依次尝试/tmp与/dev/shm。架构与二进制选择方面backend/lib/updater/Updater.jsUpdater.ARCHITECTURES { arm: armv7, arm64: aarch64 };检查阶段会根据process.arch映射出armv7/aarch64目标并结合低内存主机Tools.IS_LOWMEM_HOST()与是否 UPX拼接出期望的二进制名valetudo-{arch}{-lowmem}{.upx}然后从发布源中精确匹配该文件名。2.4 发布源Update ProviderGitHub 与 NightlyGithubValetudoUpdateProviderbackend/lib/updater/lib/update_provider/GithubValetudoUpdateProvider.js实现了更新源接口通过 GitHub Releases APIhttps://api.github.com/repos/Hypfer/Valetudo/releases拉取发布列表只保留**非预发布prereleasefalse且非草稿draftfalse**的正式版本并按发布时间倒序排列每个 Release 还需要配套的valetudo_release_manifest.json清单文件清单内记录每个二进制的sha256sums与version清单版本与 Release 版本不一致即视为无效除清单外的其余 Release assets 会被解析为可下载的二进制携带downloadUrl与sha256sum。版本选择策略实现在determineReleaseToDownload()backend/lib/updater/lib/UpdaterUtils.js强制检查forcetrue时直接选最新版当前版本不在发布列表中时默认升到最新版当前版本在列表中且非最新时只升到下一个相邻版本逐级升级避免跨大版本直接跳升当前已是最新时返回updateRequired: false即无需更新。2.5 下载与校验流式下载 SHA-256 防篡改ValetudoUpdaterDownloadStepbackend/lib/updater/lib/steps/ValetudoUpdaterDownloadStep.js负责实际下载使用流式管道pipeline把 HTTP 响应流写入暂存文件并通过PipelineThroughputTracker按content-length计算下载进度百分比供 Web 界面展示下载完成后对文件计算SHA-256与 Release 清单中记录的expectedHash比对校验失败会以INVALID_CHECKSUM错误终止并清理暂存文件防止安装被篡改或损坏的二进制。下载完成后进入待应用状态等待用户确认。值得注意的是如果用户10 分钟内未确认更新器会自动清理下载文件并回到空闲状态见 backend/lib/updater/Updater.js。2.6 应用阶段原子替换与重启ValetudoUpdaterApplyStepbackend/lib/updater/lib/steps/ValetudoUpdaterApplyStep.js执行最后的替换动作从已校验的暂存文件复制内容到目标目录下的临时文件binary.upd并设置可执行权限fs.renameSync(tmpDestination, process.argv0)原子替换当前正在运行的二进制执行sync落盘若启用了 Phoenix 重生机制phoenixManager.canReincarnate()则以REBIRTH_REASONS.UPDATED触发进程重生携带新旧版本号否则执行reboot重启设备。因此升级完成后系统会自动重启或重生无需手动干预。2.7 常见错误速查内置更新器的错误类型定义在 backend/lib/updater/lib/ValetudoUpdaterError.js遇到失败时可在 Web 界面或/state接口中看到对应的type错误类型含义常见诱因not_embedded非嵌入式环境在 Docker/桌面环境运行not_docked机器人不在充电座升级前先让机器人回充not_writable二进制位置不可写权限/挂载问题not_enough_space空间不足需 ≥20MB常规 40MB存储被占满download_failed下载失败网络问题no_release无可用发布更新源异常no_matching_binary没有匹配架构的二进制架构不匹配invalid_checksum校验和不匹配下载损坏/被篡改三、手动升级 Roborock 吸尘器旧版本若你的 Valetudo 早于 2021.11.0没有内置更新器可按机型选择下面的手动方案。3.1 S5、V1 与 S6刷写新镜像双系统切换S5 / V1 / S6 的推荐升级方式是刷写新镜像前提是你拥有机器人的SSH 访问权限。完整步骤如下在 Dustbuilder 中选择Build for manual installation (requires SSH to install)选项之后会通过邮件收到一个tar.gz归档包的下载链接。SSH 登录机器人。将 tar.gz 下载到/mnt/data目录并解压cd /mnt/data wget url to tar from dustbuilder tar xzf file.tar.gz机器人存在A/B 双系统正在使用的系统不能被直接更新。默认你在系统 A因此先在系统 A 下更新系统 B然后重启进入系统 B./install_b.sh reboot重启后重新 SSH 登录此时已在系统 B反过来更新系统 A再重启回系统 A 正常运行cd /mnt/data ./install_a.sh rm -f file.tar.gz reboot完成上述步骤后机器人即运行最新版本。3.2 替代方案直接替换二进制除刷镜像外也可以停止 Valetudo 服务后用 scp 直接替换二进制/etc/init/S11valetudo stop # 通过 scp 上传新二进制到对应路径 # 然后重启或重新启动服务3.3 排障与兜底升级后出现 No Map Data 或设置丢失等问题建议直接做一次完整重刷full reflash这是官方文档明确给出的兜底手段没有 SSH 权限无法手动升级需要先对受支持的机型做**恢复出厂设置factory reset**以重新启用 OTA 更新然后走首次安装流程。四、手动升级 Dreame 吸尘器Dreame 机型的手动升级更为直接——替换二进制文件即可SSH 登录吸尘器并停掉正在运行的 Valetudokillall valetudo用新版本二进制替换/data/valetudo下的旧二进制wget https://github.com/Hypfer/Valetudo/releases/latest/download/valetudo-{armv7,armv7-lowmem,aarch64} -O /data/valetudo注意务必根据 supported robots 文档中的说明选择与机型匹配的正确二进制armv7、armv7-lowmem或aarch64如果遇到Text file busy错误说明 Valetudo 仍在运行先再次执行killall valetudo若问题依旧先删除旧二进制再上传新二进制。重启机器人rebootDreame 机型的 Text file busy 之所以出现是因为 Linux 不允许覆盖正在执行的二进制文件——这正是内置更新器在 ValetudoUpdaterApplyStep.js 中采用先写临时文件再rename原子替换这一做法的原因手动替换时则需要先确保进程退出。五、升级方式选择速查场景推荐方式关键动作Valetudo ≥ 2021.11.0内置更新器Web 界面/API 触发check → download → applyRoborock S5/V1/S6旧版刷镜像双系统install_b.sh→ reboot →install_a.sh→ rebootRoborock有 SSH旧版scp 替换二进制S11valetudo stop scp 重启Dreame旧版替换二进制killall valetudo wget 覆盖/data/valetudo reboot无 SSH 的旧版机器人恢复出厂设置重新启用 OTA 后走首次安装流程结语从内置更新器的check → download → apply状态机到 Roborock 的 A/B 双系统镜像刷写再到 Dreame 的二进制直替Valetudo 为不同版本、不同机型都设计了明确的升级路径。理解底层约束——嵌入式模式、机器人必须回充、磁盘空间门槛40MB/20MB UPX 兜底、SHA-256 校验与先写临时文件再原子替换的策略——不仅能帮你顺利完成升级也能在升级失败时快速定位根因。若升级后出现地图数据丢失等异常请务必回到完整重刷的兜底方案。赞分享物联网后端前端【免费下载链接】ValetudoCloud replacement for vacuum robots enabling local-only operation项目地址https://gitcode.com/gh_mirrors/va/Valetudo点击查看免费下载相关推荐Baiduwp-PHP更新升级指南从旧版本迁移到新版Baiduwp PHP更新升级指南从旧版本迁移到新版 想要快速安全地将你的Baiduwp PHP从旧版本升级到最新版吗这份终极升级指南将带你一步步完成从2.后端SwiftHub终极GitHub iOS客户端开发指南 - RxSwift与MVVM-C架构实践SwiftHub终极GitHub iOS客户端开发指南 RxSwift与MVVM C架构实践 SwiftHub是一款功能强大的GitHub iOS客户端应用Nokogiri版本升级指南从旧版本迁移到新版本的完整流程Nokogiri版本升级指南从旧版本迁移到新版本的完整流程 Nokogiri鋸是Ruby生态中最受欢迎的XML和HTML处理库让开发者能够轻松解析和操作后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考