HomeAssistant 教程

1
2
3
4
5
6
7
8

# 查看你的 Debian 版本代号
lsb_release -a

# 输出示例
Distributor ID: Debian
Description:    Debian GNU/Linux 12 (bookworm)
Release:        12
Codename:       bookworm

1

sudo apt install -y ca-certificates curl gnupg lsb-release

1
2

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

1
2

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

1

deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian bookworm stable

1

sudo apt update

1

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

1
2
3
4
5

# 检查版本
sudo docker --version

# 正常输出类似
Docker version 25.0.5, build xxxxxxx

1
2
3
4
5
6
7
8
9

docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -e TZ=Asia/Shanghai \
  -v /PATH_TO_YOUR_CONFIG:/config \
  -v /run/dbus:/run/dbus:ro \
  --network=host \
  ghcr.io/home-assistant/home-assistant:stable

1

-v /home/piliqiu/homeassistant/config:/config

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

# 下载地址
https://get.hassbox.cn/hassbox_store.zip

# 进到 custom_components 目录下
cd homeassistant/config/custom_components/

# 创建文件夹
mkdir hassbox_store

# 进入目录
cd hassbox_store

# 上传压缩包解压
unzip hassbox_store.zip

# 重启 HA 服务生效

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 1. 进入 config 目录
cd /home/piliqiu/homeassistant/config

# 2. 创建 custom_components（如果还没有）
mkdir -p custom_components/hacs

# 3. 进入 hacs 目录
cd custom_components/hacs

# 4. 下载 HACS 最新版本
curl -sL https://github.com/hacs/integration/releases/latest/download/hacs.zip -o hacs.zip

# 5. 安装 unzip（如果未安装）
sudo apt update && sudo apt install unzip -y

# 6. 解压并清理
unzip hacs.zip
rm hacs.zip

# 7. 修复权限，确保容器能读取
chmod -R 777 /home/piliqiu/homeassistant/config/*

# 8. 安装后需要重启容器

1
2
3
4
5
6
7
8

/home/piliqiu/homeassistant/config/
├── ...（其他文件）
└── www/
    └── clock/
        ├── __init__.py
        ├── index.html
        ├── script.js
        └── style.css

1
2
3
4
5

mqtt-server/
├── docker-compose.yml
├── mosquitto/
│   ├── mosquitto.conf
│   └── passwd       # 用户密码文件（可选）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

version: '3.8'

services:
  mosquitto:
    image: eclipse-mosquitto:2.0
    container_name: mosquitto
    restart: unless-stopped
    ports:
      - "1883:1883"    # MQTT 协议
      - "9001:9001"    # WebSocket 支持
      # - "8883:8883"  # TLS（可选，需配置证书）
    volumes:
      - ./mosquitto/mosquitto.conf:/mosquitto/config/mosquitto.conf
      # - ./mosquitto/passwd:/mosquitto/config/passwd  # 认证文件
      - mosquitto_data:/mosquitto/data
      - mosquitto_log:/mosquitto/log

    # 可选：设置时区
    environment:
      - TZ=Asia/Shanghai
    # 网络模式（可选）
    # network_mode: host

volumes:
  mosquitto_data:
  mosquitto_log:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

# 监听端口
listener 1883
protocol mqtt

# WebSocket 支持
listener 9001
protocol websockets

# 持久化设置
persistence true
persistence_location /mosquitto/data/

# 日志
log_dest file /mosquitto/log/mosquitto.log
log_type all
# 关闭时间戳（Docker 日志已有）
log_timestamp false

# ==================================================
# 🔐 认证配置（可选：开启用户名密码）
# ==================================================
allow_anonymous true    # 允许匿名访问
# password_file /mosquitto/config/passwd

# ==================================================
# 🔐 TLS 配置（可选：开启 HTTPS/WebSocket Secure）
# ==================================================
# listener 8883
# protocol mqtt
# cafile /mosquitto/config/certs/ca.crt
# certfile /mosquitto/config/certs/server.crt
# keyfile /mosquitto/config/certs/server.key
# require_certificate false

1
2
3
4
5
6
7
8
9

# 进入 mosquitto 目录
cd mqtt-server/mosquitto

# 创建 passwd 文件（第一次用 -c）
mosquitto_passwd -c passwd your_username

# 输入密码
# 再添加其他用户用（去掉 -c）
# mosquitto_passwd passwd another_user

1
2

allow_anonymous false
password_file /mosquitto/config/passwd

1
2

ports:
  - "8883:8883"

1
2
3
4

frigate/
├── docker-compose.yml
├── config/
│   └── config.yml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

services:
  frigate:
    container_name: frigate
    restart: unless-stopped
    stop_grace_period: 30s
    image: docker.cnb.cool/frigate-cn/frigate:stable
    volumes:
      - ./config:/config
      - ./storage:/media/frigate
      - type: tmpfs # 可选：1GB内存，减少SSD/SD卡损耗
        target: /tmp/cache
        tmpfs:
          size: 1000000000
    ports:
      - "8971:8971"
      - "8554:8554" # RTSP 视频流
      - "5050:5000" # Web UI

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

mqtt:
  enabled: true
  host: mosquitto
  port: 1883
  user: # 没有可以删除
  password: # 没有可以删除

# 录制配置，保留7天的陆续变动
record:
  enabled: true
  retain:
    days: 7
    mode: motion
  alerts:
    retain:
      days: 30
  detections:
    retain:
      days: 30
snapshots:
  enabled: true
  retain:
    default: 30


cameras:
  camera_name: # <--- 此处改为你摄像头的名称，仅支持英文数字下划线与连接符
    enabled: true
    ffmpeg:
      inputs:
        - path: rtsp://账号:密码@摄像头IP:554/stream1 # <--- 此处改为你摄像头的rtsp地址
          roles:
            - detect
            - record
    detect:
      enabled: true
      width: 3840 # <- 可选，默认Frigate会尝试自动检测分辨率
      height: 2160 # <- 可选，默认Frigate会尝试自动检测分辨率
    objects:
      filters:
        person:
          mask: 0.005,0.008,0.421,0.009,0.452,0.988,0.007,0.995
    motion:
      mask: 0.007,0.008,0.421,0.009,0.452,0.988,0.007,0.995

go2rtc:
  streams:
    tplink_dw: ## <- 这里的back为摄像头名称，根据你的实际情况进行调整
      - "ffmpeg:rtsp://账号:密码@摄像头IP:554/stream1/cam/realmonitor?channel=1&subtype=2#video=copy#audio=copy#audio=aac#hardware"

  
version: 0.16-0