在懒猫微服上把 Eufy 摄像头接入 Home Assistant

这篇教程带你一步步把 Eufy Security 摄像头（包括 2C Pro 这类电池款）接入跑在懒猫微服上的 Home Assistant。搞完之后就能看实时画面，电池摄像头也会在检测到移动时自动唤醒。

原理简介

Eufy 云端 ──── eufy-security-ws（懒猫应用） ──── Home Assistant（懒猫应用）
                      端口 3000（宿主网络）          Eufy Security 集成（HACS）

eufy-security-ws 是个 WebSocket 桥接服务，用你的账号连到 Eufy 云端，帮摄像头建立 P2P 流，同时给 HA 的 Eufy Security 插件提供本地接口。它直接跑在懒猫盒子宿主网络的 3000 端口上。

开始前准备

• 懒猫微服上已经装好并在跑的 Home Assistant
• 一个专用 Eufy 小号 —— 新建一个 Eufy 账号，把摄像头共享给它用。别用主账号，桥接服务会一直占着登录状态，容易和手机上的 Eufy App 打架。
• 你的 Eufy 云端区域代码（比如 AU、US、DE、GB）

第一步 —— 装好 Eufy Security WS

1. 打开懒猫盒子的应用商店，搜索 Eufy Security WS 安装。

2. 安装后第一次打开会让你填几个参数：

   • Eufy 账号用户名 —— 小号的邮箱
   • Eufy 账号密码 —— 小号的密码
   • 国家代码 —— 你的区域（比如 AU），不确定就留空用默认值

   这些信息以部署参数的方式存在懒猫里，以环境变量注入容器，不会写死进镜像。

3. 在懒猫应用管理界面启动 Eufy Security WS 项目。

4. 看一下日志，确认连上了：

   lzc-cli project log eufy-security-ws
   

   看到 Eufy 云端连接成功的日志就没问题。

第二步 —— 用局域网端口转发工具暴露端口

HA 的 Eufy Security 集成需要直接 TCP 连到 WebSocket 服务。用局域网端口转发工具把 eufy-security-ws 的端口映射出来，HA 才能连上它。

1. 打开懒猫盒子上的局域网端口转发工具。
2. 新增一条转发规则：
   • 目标应用： 选择 eufy-security-ws，服务选 ws，端口填 3000
   • 导出网卡： 选择微服虚拟网卡
   • 导出端口： 随意选一个可用端口（比如 3003），记下来，后面要填到 HA 里
   • 保存。

第三步 —— 在 Home Assistant 里装 HACS

已经装了 HACS 的话直接跳过这步。

1. 打开 Home Assistant。
2. 按 HACS 安装指南装好 HACS。
3. 装完重启 HA，走完 HACS 初始化流程。

第四步 —— 装 Eufy Security 集成

1. 在 HA 里进 HACS → 集成。
2. 搜索 Eufy Security，安装。
3. 按提示重启 HA。

第五步 —— 把 Home Assistant 连上 eufy-security-ws

1. 进 设置 → 设备与服务 → 添加集成。
2. 搜索 Eufy Security 选中。
3. 填连接信息：
   • Host（主机）： host.lzcapp
   • Port（端口）： 第二步里设置的导出端口（比如 3003）
   • TLS： 关闭
4. 提交，HA 就会连上桥接服务了。

等几秒钟，你的 Eufy 设备就会出现——摄像头、移动传感器、门铃之类的都有。

第六步 —— 给电池摄像头加上按需唤醒自动化

电池款 Eufy 摄像头（2C、2C Pro 等）平时会深度睡眠省电，HA 默认没法直接拉睡着的摄像头的流。下面两条自动化会在检测到移动时唤醒摄像头，移动结束后再让它休眠。

进 设置 → 自动化与场景 → 创建自动化 → 以 YAML 编辑，把下面的内容粘进去。把 entity_id 列表换成你自己摄像头和移动传感器的实体 ID。

自动化 1 —— 检测到移动，唤醒摄像头

alias: Eufy wake camera on motion
description: Turn on camera when motion detected to start P2P stream
mode: parallel
max: 4
triggers:
  - trigger: state
    entity_id:
      - binary_sensor.side_motion_detected
      - binary_sensor.garage_motion_detected
      - binary_sensor.backyard_motion_detected
      - binary_sensor.backyard_2_motion_detected
    to: 'on'
conditions: []
actions:
  - action: camera.turn_on
    target:
      entity_id: >-
        {{ trigger.entity_id
           | replace('binary_sensor.', 'camera.')
           | replace('_motion_detected', '') }}

自动化 2 —— 移动结束，摄像头回去睡觉

alias: Eufy sleep camera after motion clears
description: Turn off camera when motion clears to preserve battery
mode: parallel
max: 4
triggers:
  - trigger: state
    entity_id:
      - binary_sensor.side_motion_detected
      - binary_sensor.garage_motion_detected
      - binary_sensor.backyard_motion_detected
      - binary_sensor.backyard_2_motion_detected
    to: 'off'
    for:
      seconds: 30
conditions: []
actions:
  - action: camera.turn_off
    target:
      entity_id: >-
        {{ trigger.entity_id
           | replace('binary_sensor.', 'camera.')
           | replace('_motion_detected', '') }}