小米摄像头自定义固件yi-hack-v5刷机全攻略:免费RTSP推流、ONVIF接入与彻底的数据私有化
2026/8/15 19:38:38 网站建设 项目流程

小米摄像头自定义固件yi-hack-v5刷机全攻略:免费RTSP推流、ONVIF接入与彻底的数据私有化

【免费下载链接】yi-hack-v5Even newer Custom Firmware for Xiaomi Cameras based on Hi3518ev200 Chipset. It includes free RTSP, ONVIF and other improvements based on the work by roleoroleo项目地址: https://gitcode.com/gh_mirrors/yi/yi-hack-v5

你有没有过这样的憋屈时刻:家里的摄像头明明连着自家的Wi-Fi,画面却要先绕到别人的云服务器上转一圈,再回到你的手机。网络一抖,回放卡成PPT;官方App改版,功能说砍就砍;想接入Home Assistant,却发现官方固件既不开放RTSP,也不支持ONVIF,仿佛这摄像头从来就不是你的,只是你替云服务商租的。

好消息是,针对基于 Hi3518ev200 芯片的小米/小蚁摄像头,开源社区给出了一个近乎完美的答案——yi-hack-v5。这是一款完全开源的第三方自定义固件,它把被官方阉割掉的能力全部还给你:免费RTSP推流、完整ONVIF协议、MQTT事件推送、SSH远程登录,甚至允许你一键关停所有云功能,让画面只在你的局域网里流动。本文不写天花乱坠的功能清单,只带你走完从"被云绑架"到"数据完全私有"的完整旅程。

一、动手之前:确认你的摄像机"够格"

yi-hack-v5 基于 Hi3518ev200 芯片组开发,所以第一件事不是下载固件,而是核对机型。目前社区确认支持的型号如下:

摄像机型号状态说明
Yi 1080p Home 48US / 20US✅ 确认兼容刷机体验最成熟
Yi Home 17CN / 27US / 47US✅ 确认兼容老款经典,资料最多
Yi Dome✅ 确认兼容快照与ONVIF对CPU压力偏大
Yi 1080p Dome / Cloud Dome / Outdoor✅ 理论兼容作者无实机,需自行验证

📌 一句话判断:只要是 Hi3518ev200 芯片的 Yi 系摄像头,基本都在射程范围内。拿不准就在刷机前多查一轮型号,避免白忙一场。

二、第一道坎:为什么一张 FAT32 的存储卡能决定成败

刷写 yi-hack-v5 不需要拆机、不需要编程器,官方固件自带"从SD卡升级"的机制,我们要做的只是"骗"它加载我们的自定义固件。而这一切的前提,是一张格式正确的 microSD 卡。

2.1 容量与格式的双重限制

  • 容量:建议 16GB 及以下,作者实测 32GB 卡不格式化直接拷贝也能用;
  • 格式必须是 FAT32。exFAT 格式的卡,摄像头直接无视,刷机必失败。

问题来了:Windows 10 对大于 32GB 的卡只提供 NTFS 和 exFAT 两个选项,根本不给你选 FAT32。怎么办?在 64GB 大卡上手动划出一个 4GB 的小 FAT32 分区,剩下的空间留给录像存储——摄像头只认这个分区里的固件文件,其余空间它照样正常读写。

Windows 图形化操作:Win+X 打开磁盘管理 → 删除卡上全部分区 → 在"未分配"区域右键"新建简单卷" → 卷大小填 4096MB → 文件系统选 FAT32,一路下一步即可。

命令行硬核操作:管理员权限打开 cmd,依次执行diskpartlist diskselect disk 7(换成你的卡)→ 删除旧分区 →format FS=FAT32 QUICK

2.2 固件文件:像搬家行李一样分开打包

不同机型对应不同的分区镜像文件,必须严格匹配,拷贝时绝不能改名:

摄像机型号rootfs 分区文件home 分区文件
Yi Home 17CN / 27US / 47USrootfs_y18home_y18
Yi 1080p Homerootfs_y20home_y20
Yi Domerootfs_v201home_v201
Yi 1080p Domerootfs_h20home_h20
Yi 1080p Cloud Domerootfs_y19home_y19
Yi Outdoorrootfs_h30home_h30

你可以把这两个分区文件理解为"搬家时分开打包的行李":rootfs 装的是系统内核和基础运行环境,home 装的是应用和配置,摄像头刷机时会分别把它们"搬"进对应的分区。把这两个文件连同yi-hack-v5文件夹一起放到存储卡根目录,准备工作就完成了。

三、刷机实战:从指示灯读懂整个流程

准备工作就绪后,刷机本身比想象中平静得多。全程不需要电脑连接,摄像头指示灯就是你唯一的进度条:

  1. 断电→ 插入准备好的存储卡 →重新上电
  2. 黄灯闪烁约 30 秒:固件正在写入(第一阶段刷写);
  3. 黄灯再次常亮,持续最长 2 分钟:最后阶段的刷写与系统初始化;
  4. 蓝灯亮起:Wi-Fi 连接成功,刷机完成 🎉。

刷完先别急着欢呼,打开浏览器访问摄像机的 Web 管理界面:

http://[摄像机IP地址]:8080

如果主机名访问不通,去 Yi Home App 里查 IP:摄像机设置 → 网络信息 → IP 地址。家里有多台摄像机的,务必给每台配置不同的主机名,否则 Web 界面只能靠 IP 区分访问。

⚠️ 重要提醒:yi-hack-v5文件夹必须和两个分区文件一起放在卡根目录。漏放它,刷机看似成功,Web 界面却永远打不开——这是新手踩得最多的坑。

四、刷完你会看到什么:四大能力逐个数

yi-hack-v5 的价值不在于"能刷",而在于刷完之后的开放程度。下面按"对你有用"的优先级排个序。

4.1 免费RTSP推流:VLC 直接看,告别云中转

这是大多数人刷它的第一理由。开启 RTSP 后,任何支持 RTSP 的播放器都能直连取流,完全绕过官方云

rtsp://[摄像机IP地址]:554/ch0_0.h264 # 高清主码流 rtsp://[摄像机IP地址]:554/ch0_1.h264 # 流畅子码流 rtsp://[摄像机IP地址]:554/ch0_2.h264 # 音频流

把上面的地址填进 VLC 或 FFmpeg,一条命令就能持续录制到本地:

ffmpeg -i rtsp://192.168.1.5:554/ch0_0.h264 -c copy /data/record_$(date +%F).mp4

配合 Home Assistant、Blue Iris 等监控系统,24/7 不间断录制不再是云会员的专属特权。底层由h264grabber抓取视频、rRTSPServer提供推流,配置里还能选择 high / low / both 三种码流模式(见src/static/static/home/yi-hack-v5/script/launch.sh)。

4.2 ONVIF 协议接入:专业监控系统的"普通话"

ONVIF 是安防行业的标准协议,让不同品牌的 NVR、录像机、监控软件能互相"对话"。yi-hack-v5 内置onvif_srvd服务,默认提供 Profile_0(高清)和 Profile_1(标清)两个档位,支持设备发现、快照拉取、事件订阅等标准能力。开启后,你的海康/大华 NVR 甚至可以直接"发现"这台小米摄像头——想象一下,几百块的消费级摄像头和几万块的专业录像机同台工作,这种反差本身就是刷机最大的乐趣。

4.3 MQTT 联动:让摄像头开口"说话"

现代智能家居的核心是事件驱动,yi-hack-v5 的 MQTT 客户端把这台摄像头变成了一个"会说话"的传感器。默认配置下(见src/static/static/home/yi-hack-v5/etc/mqttv4.conf),它会向yicam/motion_detection主题发布motion_start/motion_stop消息,还有 AI 人形检测、婴儿哭声、声音检测等独立主题:

yicam/motion_detection → motion_start / motion_stop yicam/ai_human_detection → human yicam/baby_crying → crying

在 Home Assistant 里订阅这些主题,你就能在电视、手机、甚至智能音箱上收到实时告警,而不是等官方 App 的推送姗姗来迟。

4.4 SSH 与 Web 管理:一台"敞开的"摄像头

刷机后 SSH 默认开启(Telnet 默认关闭),意味着你可以像管理一台 Linux 服务器一样登录摄像头;Web 界面则把系统配置、PTZ 云台控制、快照抓拍、录像管理全部图形化。camera.conf里甚至可以调整官方 App 才有的参数:

SWITCH_ON=yes SAVE_VIDEO_ON_MOTION=yes SENSITIVITY=low AI_HUMAN_DETECTION=no LED=yes ROTATE=no IR=yes

五、进阶调优:三份核心配置一次讲透

刷完只是开始,真正的乐趣在调优。yi-hack-v5 的配置体系集中在三份文件里,理解它们,你就掌握了这台摄像机的"命门"。

5.1 system.conf:服务总开关

这份文件控制所有服务的启停,默认值偏保守(src/static/static/home/yi-hack-v5/etc/system.conf):

HTTPD=yes # Web 管理界面,端口 8080 SSHD=yes # SSH 远程登录 TELNETD=no # Telnet,默认关闭 MQTT=no # MQTT 客户端,按需开启 RTSP=no # RTSP 推流,开启后填 RTSP_STREAM=high/low/both ONVIF=no # ONVIF 服务,端口 80 DISABLE_CLOUD=no # 一键关停云功能,追求完全私有化时打开 NTPD=no # 时间同步

我的建议:先只开 RTSP,确认画面稳定后再逐个开启其他服务。嵌入式设备的资源就那么多,贪多反而卡顿。

5.2 camera.conf:画质与行为调校

如 4.4 节所示,这份文件控制灵敏度、指示灯、红外、旋转等参数。注意SENSITIVITY从 low 到 high 共三档,配合AI_HUMAN_DETECTION可以减少宠物、树叶晃动带来的误报。

5.3 mqttv4.conf:事件流的"接线图"

重点看主题前缀和消息格式,改一个MQTT_PREFIX就能接入你现有的 MQTT Broker,多台摄像头用MQTT_CLIENT_ID区分。QoS 建议保持 1,保证运动事件不丢包——这是安防场景的底线。

六、翻车自救:五个高频问题的排查手册

任何刷机都有翻车的可能,yi-hack-v5 的社区已经帮你把坑踩得差不多了:

Q1:Wi-Fi 已连上、能 ping 通,但 Web 界面打不开?99% 是忘了把yi-hack-v5文件夹放进卡根目录。补上,重启摄像头即可。

Q2:配对成功,但断电重启后 Wi-Fi 设置丢失?检查你用的是不是Yi Home官方 App。Xiaomi Home 虽然也能生成可用的二维码,但重启后设置会丢,这是固件与 App 的兼容性差异。

Q3:多台摄像头互相冲突?给每台设置唯一主机名。同名设备在网络上会互相"抢答",导致只能靠 IP 访问。

Q4:exFAT 的卡刷不了?重新按第 2 节流程分出 FAT32 分区。这一步没有捷径。

Q5:刷完变砖了?别慌。作者在 README 里明确说"变砖多数情况下可恢复",常见的自救思路是:重新格式化存储卡、放回官方原厂固件文件、重新走一遍刷机流程。操作前建议先备份原厂固件。

七、不止于刷机:当你想动手改固件

如果你不满足于"用",还想"造",yi-hack-v5 的模块化构建系统对开发者相当友好。源码目录src/下每个子模块都带独立的init.*compile.*install.*脚本,scripts/compile.sh会按顺序自动完成全部模块的初始化、编译与安装:

git clone https://gitcode.com/gh_mirrors/yi/yi-hack-v5 cd yi-hack-v5 ./scripts/compile.sh

想加功能?src/里有现成的样例:h264grabber管视频抓取、mqtt-config管配置校验、wsdd管网络设备发现……每一块都是可以单独编译、单独替换的积木。唯一需要注意的是交叉编译工具链路径(脚本默认指向/opt/arm-hisiv300-linux/bin),环境对不上会在编译阶段报错。

写在最后

从官方固件里的"用户",变成自定义固件下的"主人",这中间的跨越并不大——一张 FAT32 存储卡、两个分区文件、十分钟等待。但跨过去之后,你的摄像头将不再是一台只会往云端传数据的终端,而是一台真正属于你的、可编程、可接入、可卸载云的监控设备。

最后把丑话说在前面:刷写自定义固件存在变砖和失去保修的风险,项目作者在文档里明确声明不对任何使用或损坏负责。动手前请确认自己理解风险,重要设备建议先拿闲置的旧摄像头练手。

社区在持续更新(当前版本 0.4.0),如果你也在折腾智能家居、RTSP 录像或 ONVIF 接入,不妨从克隆这个仓库开始,让家里的摄像头"重获自由"。

git clone https://gitcode.com/gh_mirrors/yi/yi-hack-v5

刷机有风险,折腾需谨慎;但一旦成功,你会收获一台真正属于自己的摄像头。祝刷机顺利 🎉

【免费下载链接】yi-hack-v5Even newer Custom Firmware for Xiaomi Cameras based on Hi3518ev200 Chipset. It includes free RTSP, ONVIF and other improvements based on the work by roleoroleo项目地址: https://gitcode.com/gh_mirrors/yi/yi-hack-v5

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询