Tuya-Cloudcutter项目：实现涂鸦IoT设备本地化控制与固件刷写指南
项目地址: https://gitcode.com/gh_mirrors/tu/tuya-cloudcutter 项目概述
Tuya-Cloudcutter是一个专业工具链，用于将涂鸦(Tuya)智能设备从云端服务中解放出来，使其能够完全在本地网络中运行。通过替换设备的安全密钥，切断设备与涂鸦云服务器的连接，同时支持刷写第三方自定义固件。
重要警告
使用本工具前，请务必注意：
- 操作后将永久失去涂鸦官方App和云服务的所有功能
- 过程不可逆，请确认设备不再需要官方服务
- 操作存在风险，可能导致设备无法正常工作
环境准备
硬件要求
- 带有WiFi适配器的笔记本电脑或台式机
- 待处理的涂鸦智能设备（如智能灯泡、插座等）
软件要求
- Ubuntu操作系统（建议实体机安装，非虚拟机）
- 其他使用NetworkManager的Linux发行版可能兼容但未经测试
- 已安装Docker环境
- 当前用户需加入docker用户组
- 若刚安装Docker，建议重启使组设置生效
操作流程详解
第一步：识别设备型号
-
通过以下方式确定设备信息：
- 查找设备型号对应的小写字母数字组合（如
avatar-asl04-tv-backlight） - 若无法确定型号，可通过涂鸦App获取固件版本：
- 打开Tuya Smart/SmartLife应用
- 选择设备（即使离线状态）
- 点击右上角编辑图标
- 进入"设备更新"
- 记录"主模块"版本号
- 查找设备型号对应的小写字母数字组合（如
-
运行交互式命令：
sudo ./tuya-cloudcutter.sh
选择"By firmware version and name"选项并输入获取的版本信息。
第二步：执行云端连接禁用
- 准备命令参数：
sudo ./tuya-cloudcutter.sh -s <WiFi名称> <WiFi密码>
- 使用
-p参数指定设备配置文件名称 - 密码含特殊字符时需用单引号包裹
- 可选
-r参数重置NetworkManager连接（解决部分WiFi适配器问题）
-
设备进入AP模式：
- 快速开关设备6次（间隔约1秒）
- 灯泡类设备会进入慢闪模式
- 若出现快闪，需再开关3次
-
自动化流程：
- 工具自动连接设备AP（通常为"SmartLife-*"）
- 执行密钥替换操作（此时云端连接已切断）
- 设备将冻结并自动重启
-
手动干预步骤：
- 工具会创建"cloudcutterflash"热点
- 再次开关设备进入AP模式
- 设备连接工具创建的热点（密码：abcdabcd）
- 配置本地访问密钥并加入指定WiFi
-
完成验证：
- 终端显示激活请求
- 密钥文件保存在
configured-devices目录 - 可使用
tinytuya等工具进行本地控制
常见问题处理
- 若2分钟内无响应：
- 重新开关设备进入AP模式
- 使用SmartLife类App手动连接设备至"cloudcutterflash"热点
固件刷写指南
准备工作
- 将自定义固件(.bin/.UG/.UF2文件)放入
custom-firmware目录 - 确认设备型号（方法同上）
执行刷写
sudo ./tuya-cloudcutter.sh -p 设备名称 -f 固件文件名
- 参数
-p和-f可选 - 按提示操作设备进入AP模式（同前述方法）
固件选择建议
项目已内置常见第三方固件，用户也可自行提供：
- 确保固件兼容设备硬件
- 推荐使用经过社区验证的稳定版本
- 刷机前备份原始固件（如可能）
技术原理浅析
Tuya-Cloudcutter通过以下机制工作：
- 密钥替换：修改设备与云端通信的认证密钥，使其无法连接官方服务器
- 中间人攻击：在设备配网过程中拦截并修改通信数据
- 固件注入：利用涂鸦设备的OTA机制写入自定义固件
安全提示
- 操作过程中确保网络环境安全
- 生成的本地密钥应妥善保管
- 自定义固件需从可信来源获取
- 建议在测试网络环境中首次尝试
结语
通过Tuya-Cloudcutter，用户可彻底掌握涂鸦设备的控制权，实现真正的本地化智能家居管理。本指南详细介绍了从环境准备到最终实现的完整流程，建议操作前充分理解每个步骤的技术含义。对于复杂场景，可参考项目文档获取更深入的技术支持。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
