Home Assistant 搭建指南

博主： huoyu
发布时间：2025 年 10 月 26 日
76 次浏览
暂无评论
3946字数
分类：技术教程

### 简介

Home Assistant（以下简称HASS）是一款智能家居自动化平台，旨在帮助用户将各种智能设备整合在一起，从而实现更便捷、更高效、更智能的生活方式。通过HASS，用户可以轻松地控制家中的照明、温度、安防、音频、视频等各类设备，实现更智能、更个性化的家庭体验。HASS支持众多的智能设备品牌和协议，用户可以根据自己的需求进行定制和配置，实现智能家居的全面升级。

### 准备环境

HASS是基于Docker开发的，已经为云原生的生产环境做好了准备。上至运行在服务器上的k8s集群，下至小巧的嵌入式设备，都能运行HASS。下面给出`Docker`与`k8s-pods`的安装方法。

### Docker-compose

* 执行`mkdir home-assistant && cd home-assistant`创建文件夹，并且新建文件`docker-compose.yaml`，写入如下的配置文件：

```ymal
services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - /home/huoyu/WorkSpace/Home_Assistant:/config  # 这里替换成你的目录
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    restart: unless-stopped
    privileged: true
    network_mode: host
    environment:
      - TZ=Asia/Shanghai
    devices:  # 如果没有 USB 设备（如 Zigbee 棒），可以删掉这部分
      - /dev/ttyUSB0:/dev/ttyUSB0
```

* > Tips: 网络模式`host`仅能在`Linux`下使用。HomeKit扩展依赖`mDNS`功能，仅在`host`模式下可用。
  >
* 运行`docker-compose up -d`启动。

### K8s deployment yaml

将以下内容写入`hass.yaml`:

```yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  finalizers:
    - kubernetes.io/pvc-protection
  name: homeassistant
  namespace: default
spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 10Gi
  storageClassName: 外挂存储的名字
  volumeMode: Filesystem
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: homeassistant
spec:
  replicas: 1
  selector:
    matchLabels:
      app: homeassistant
  template:
    metadata:
      labels:
        app: homeassistant
    spec:
      containers:
        - name: homeassistant
          image: homeassistant/home-assistant
          ports:
            - containerPort: 8123
          resources:
            limits:
              cpu: 200m
              memory: 512Mi
            requests:
              cpu: 10m
              memory: 64Mi
          volumeMounts:
            - mountPath: /config
              name: data
      volumes:
        - name: data
          persistentVolumeClaim:
            claimName: homeassistant
---
apiVersion: v1
kind: Service
metadata:
  labels:
    app: homeassistant
  name: homeassistant
spec:
  externalTrafficPolicy: Cluster
  ports:
  - protocol: TCP
    port: 8123
    targetPort: 8123
  selector:
    app: homeassistant
  sessionAffinity: None
  type: NodePort
```

* `kubectl apply -f homeassistant.yaml`
  最后，访问`http://server_ip:8123`来进行初始化，设置用户名、密码等。

### 安装插件

HASS的高扩展性主要来源于它丰富的插件与扩展。本章节将以米家与HomeKit为例，讲述插件的安装与配置过程。

### 安装Home Assistant Community Store (HACS)

* 进入容器内部，并cd进入到HASS配置目录：
  `docker exec -it homeassistant bash`
* 使用命令行安装：
  `wget -O - https://hacs.vip/get | bash -`
  如果上面的命令执行后卡住不动，或没有提示安装成功，请尝试下面的命令：
  `wget -O - https://hacs.vip/get | HUB_DOMAIN=ghproxy.com/github.com bash -`

### 安装hass-xiaomi-miot米家插件

#### 方式一

启动时自动映射（不用每次打开都去配置）

去项目[链接]([https://](https://github.com/al-one/hass-xiaomi-miot))下载并复制`custom_components/xiaomi_miot`文件夹到服务器的Home_Assistant根目录下的`custom_components`文件夹

**这是目录结构**

![image.png](http://type.zimopy.com/usr/uploads/2026/01/4127128582.png)

然后启动`docker-compose up -d`

访问Home Assistant `http://host:8123/config/integrations/dashboard`添加集成

![image.png](http://type.zimopy.com/usr/uploads/2026/01/2133617211.png)

#### 方式二

进入到docker里面去（建议这种方式就直接使用docker去安装，不要用docker-compose，否则下一次启动时，这个集成可能会消失），然后先运行下面的代码

```sh
docker exec -it homeassistant bash
wget -q -O - https://cdn.jsdelivr.net/gh/al-one/hass-xiaomi-miot/install.sh | HUB_DOMAIN=hub.fastgit.org bash -
exit
docker-compose restart
```

### 配置

* 配置 - 集成 - 管理集成 - 添加集成；
* 搜索`xiaomi`，选择 `xiaomi-miot-auto`；
* 选择“账号集成模式”；
* 输入小米账号（手机号）密码，选择”云端模式“；
  此时，所有米家物联网设备已经接入完毕。

### 安装 Apple HomeKit 插件

* 前往配置 - 集成 - 管理集成 - 添加集成 - Homekit；
* 使用iOS设备上的家庭APP扫描网页“通知”面板上的二维码来添加HASS网关；
* 跟着苹果提示，把设备都添加到“家庭”中。

最后修改：2026 年 01 月 11 日

如果觉得我的文章对你有用，请随意赞赏

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱

地址

Home Assistant 搭建指南

huoyu • 2025 年 10 月 26 日

### 简介

### 准备环境

### Docker-compose

* 执行`mkdir home-assistant && cd home-assistant`创建文件夹，并且新建文件`docker-compose.yaml`，写入如下的配置文件：

* > Tips: 网络模式`host`仅能在`Linux`下使用。HomeKit扩展依赖`mDNS`功能，仅在`host`模式下可用。
  >
* 运行`docker-compose up -d`启动。

### K8s deployment yaml

将以下内容写入`hass.yaml`:

* `kubectl apply -f homeassistant.yaml`
  最后，访问`http://server_ip:8123`来进行初始化，设置用户名、密码等。

### 安装插件

HASS的高扩展性主要来源于它丰富的插件与扩展。本章节将以米家与HomeKit为例，讲述插件的安装与配置过程。

### 安装Home Assistant Community Store (HACS)

### 安装hass-xiaomi-miot米家插件

#### 方式一

启动时自动映射（不用每次打开都去配置）

**这是目录结构**

![image.png](http://type.zimopy.com/usr/uploads/2026/01/4127128582.png)

然后启动`docker-compose up -d`

访问Home Assistant `http://host:8123/config/integrations/dashboard`添加集成

![image.png](http://type.zimopy.com/usr/uploads/2026/01/2133617211.png)

#### 方式二

进入到docker里面去（建议这种方式就直接使用docker去安装，不要用docker-compose，否则下一次启动时，这个集成可能会消失），然后先运行下面的代码

```sh
docker exec -it homeassistant bash
wget -q -O - https://cdn.jsdelivr.net/gh/al-one/hass-xiaomi-miot/install.sh | HUB_DOMAIN=hub.fastgit.org bash -
exit
docker-compose restart
```

### 配置

### 安装 Apple HomeKit 插件

Home Assistant 搭建指南

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

速注册OpenAi（ChatGPT），国内也可以

Frida 代码自动补全

ubuntu 实现内网穿透

最新Fiddler Web Debugger v5.0 20202.18177中文版

关闭雷电模拟器的capture.exe

Python调用dll文件实现方法拓展

MacOS上的伪透明代理配置方法

Mac 安装使用frida 提示zsh: command not found: frida

python--修改系统代理

搭建bark 使用docker和docker-compose并设置开机自启

Home Assistant 搭建指南

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

Home Assistant 搭建指南

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款