b站安装视频：我又用三天时间写了一个HomeAssistant Supervised百分百部署成功的教程（树莓派4B+Debian12+Supervised+HACS极速版）_哔哩哔哩_bilibili

目录

阅前须知

材料清单

（一）树莓派 

（二）SD卡

（三）【网线】/【显示器+键盘】 

（四）树莓派壳子

（五）登录github的能力

（六）一款SSH软件

一、安装操作系统

（一）下载烧录器与操作系统镜像

（二）烧录

（三）SSH准备

（四）登录操作系统

1、换源

2、设置时区

3、新增普通账号 

4、设置无线连接（网线读者跳过） 

二、安装宝塔操作面板

三、安装HASS Supervised

（〇）修改hosts

（一）安装所需的包

（二）安装docker 

（三）安装OS-Agent

（四）安装HASS Supervised

（五）HASS初始设置

四、安装HACS极速版

---

阅前须知

本文章的前身是我的另一篇文章

Home Assistant安装指北（树莓派+Debian12+HASS Container+HACS极速版）-程序员宅基地

该文章（后文称为“Container版”）前言部分写了我的四个改善网络环境的思路，其中第一个更改hosts的想法我之前验证过，但是失败了，所以认为改hosts无效。但是Container版出视频的时候我最后改hosts遇到了一些挫折，这就启发到我了，可能是之前改hosts时所用的host已经失效了，需要先验证更改的host可用才行。于是我于2024.2.4晚上尝试了这个想法，发现安装Supervised版本的时候比较顺利（然而2024.2.53晚在写教程的时候又卡在Supervised部署上了），因此写出本教程供大家参考。

本文从材料清单章节到第二章安装宝塔面板章节与Container版内容实际一致，但为了避免阅读时出现需要俩文章来回跳的情况，本文还是会再写一遍。如果不需要再看这部分内容的话，请直接从第三章安装HASS看起。

材料清单

 HASS官网针对HASS OS的清单https://www.home-assistant.io/installation/raspberrypi，不过我们是要安装Debian12而不是HASS OS。

（一）树莓派 

我的规格是Raspberry Pi 4 Model B 8GB RAM，在完成本文的所有内容后，其资源占用情况如下，大家可根据自己的需要选择RAM大小。

（二）SD卡

HASS只对HASS OS操作系统给出了32GB的建议，并没有对安装在Debian上需要购买存储卡的大小给出建议，因此我购买了64GB A2的SD卡，注意在此处一定要买A2的。

（三）【网线】/【显示器+键盘】 

网线在此十分好用，只要插到路由器上就能直接有网。然后能直接SSH进去管理；否则就只能显示器+键盘进行线下配置了（你说无线网？不好意思，我从来没预配置成功过，如果你足够幸运或许你可以不需要本条目中的内容，因为似乎从Debian 12开始，就不再支持预配置设置无线网络了，或许将来可能会重新支持吧）。

（四）树莓派壳子

大致有两种可选择，一是带风扇的主动散热，二是全金属壳的被动散热。我一开始买的带风扇的主动散热，好家伙噪音那叫一个飞起，后来我换成了被动散热的壳子，平常摸起来就是温温的，我觉得这个散热程度可以接受，综上我比较推荐被动散热。

（五）登录github的能力

这个看情况，如果运气好了，裸连也能完成关键操作步骤。否则只能科学（改hosts，本文用的方法）或魔法（嗯，魔法）。

（六）一款SSH软件

可以选择PuTTY（https://putty.org/）或者Xshell（https://www.xshell.com/zh/free-for-home-school/），后文我用的Xshell。

一、安装操作系统

Debian 12安装过程借鉴https://raspberrytips.com/install-debian-on-raspberry-pi/，文中含有Debian 12（for Raspberry Pi）下载链接https://raspi.debian.net/tested-images/。

Raspberry Pi官方对使用Raspberry Pi Imager安装操作系统的教程https://www.raspberrypi.com/documentation/computers/getting-started.html#install-using-imager

（一）下载烧录器与操作系统镜像

首先我们需要去树莓派官网（https://www.raspberrypi.com/software/）下载烧录器，稍后其将帮助我们把操作系统镜像烧录到SD卡上。

然后去本章开头给的链接下载Debian 12镜像，注意需要根据自己的树莓派型号进行选择。 

（二）烧录

将SD卡连接到电脑上，打开烧录器

在“CHOOSE DEVICE”处选择你的树莓派型号；在“选择操作系统”处选择之前下载好的Debian 12镜像（点击按钮之后拉到最底下的“Use custom”选择已有文件）；在“选择SD卡”处选择你插入的SD卡。完成后点击NEXT

弹出提示是否应用操作系统自定义，我们选择“不”

然后会提示是否确认清除SD卡数据，选择是，然后就开始烧录了

（三）SSH准备

下方内容为选择使用网线进行远程配置的人看的，选择使用屏幕+键盘的直接使用root无密码登录就行，然后跳转到SSH登录之后的内容接着看就行。

打开Xshell，点击“用户密钥管理者”按钮（在工具选项卡里也有）

在弹出界面点击“生成”按钮（下图已经存在的RaspberryPI是我之前创建的）

按照下图默认的配置选择即可，点击下一步

等待密钥生成，完成后点击下一步

给密钥起个名称，然后设置密码，之后点击下一步

选中公钥全部内容进行复制，或停留在该页面上备用

打开SD卡找到sysconf.txt文件，去掉“root_authorized_key=”前的#，然后在等号后面粘贴上图复制的内容（实际上暴露该内容没啥危害，毕竟是公钥）。

保存文档，弹出SD卡，将SD卡插到树莓派上并给树莓派上电。使用网线连接路由器和树莓派。查看自己的路由器管理界面，等待设备连接。设备连接到网络后记录其ip地址（如果是长期使用网线，建议在此将该ip设为固定分配；若稍后长期使用WiFi，同理也建议稍后将WiFi分配的ip设为固定分配）

在Xshell上新建一连接

为其设置一个名称，然后主机处填写刚才的ip，完成后在左侧点击用户身份验证

用户名为root，然后在方法中勾选Public Key，然后选中Public Key后点击设置

选择刚刚生成的密钥，并输入该密钥密码，完成后点击确定

可以先把Password的勾去掉，这样等下就不会提示密码错误了

完成后点击连接，正常的话就可以SSH登录到树莓派了。

（四）登录操作系统

接下来的内容选择屏幕+键盘的可以接着看啦

1、换源

借鉴https://www.cnblogs.com/smlile-you-me/p/17727308.html，注意如果自己去网上找，一定要看链接里是不是包含bookworm字样，否则会导致版本问题

首先为了可恢复，备份一下原文件

cp /etc/apt/sources.list /etc/apt/sources.list.bak

 编辑/etc/apt/sources.list

nano /etc/apt/sources.list

将下方内容覆盖掉sources.list原内容（nano里ctrl+k可以删除行）

deb https://mirrors.aliyun.com/debian/ bookworm main non-free non-free-firmware contrib
deb-src https://mirrors.aliyun.com/debian/ bookworm main non-free non-free-firmware contrib
deb https://mirrors.aliyun.com/debian-security/ bookworm-security main
deb-src https://mirrors.aliyun.com/debian-security/ bookworm-security main
deb https://mirrors.aliyun.com/debian/ bookworm-updates main non-free non-free-firmware contrib
deb-src https://mirrors.aliyun.com/debian/ bookworm-updates main non-free non-free-firmware contrib
deb https://mirrors.aliyun.com/debian/ bookworm-backports main non-free non-free-firmware contrib
deb-src https://mirrors.aliyun.com/debian/ bookworm-backports main non-free non-free-firmware contrib

保存sources.list文件后记得在终端执行“apt update”以及“apt upgrade”（很重要）。 

apt update
apt upgrade -y

2、设置时区

执行下方指令设置时区

timedatectl set-timezone Asia/Shanghai

完成之后可以执行“timedatectl”查看是否设置成功。

3、新增普通账号 

这里仅是对新增普通账号的演示，实际后文一直用的是root账户在操作。

首先装一下sudo

apt install sudo

在终端输入下方指令进入新增用户流程

adduser 用户名

 随后设置密码及其他信息。

添加刚刚新建的用户到sudo组

usermod -aG sudo 用户名

更新登录信息并将密码登录设置为首位

再次连接默认登录的就是刚刚新建的用户。

4、设置无线连接（网线读者跳过） 

编辑/etc/network/interfaces.d/wlan0文件

nano /etc/network/interfaces.d/wlan0

根据文件提示去除注释，并配置wifi名称和密码，完成之后按ctrl+x退出，会询问是否保存，按y保存即可，然后会询问保存位置，直接按回车即可

完成之后在终端输入“systemctl reboot”重启

systemctl reboot

稍等片刻可以在路由器终端上看到以无线方式新加入的树莓派

二、安装宝塔操作面板

宝塔官网https://www.bt.cn/new/download.html

首先先安装wget 

apt install wget

 然后按照宝塔官网的说明，在终端上输入从宝塔官网复制的安装脚本，如下图

在终端上运行复制的安装脚本，一开始会问你要不要把面板安到/www目录下，确认之后就开始滚屏幕了，安装过程在树莓派上耗时会有点长（下图计时为27min）。完成安装后请妥善保存弹出的提示消息

注意！安装宝塔后记得运行相应服务前要在宝塔面板上开放相关端口！

三、安装HASS Supervised

（〇）修改hosts

首先下载UsbEAm Hosts Editor

UsbEAm Hosts Editor下载地址https://www.dogfight360.com/blog/475/

下载完成后打开，选中github.com规则

点击检测延迟

完成延迟检测后IP从上到下依次尝试应用选中，会有两种结果，如下两图。应应用一个理论可用的ip后在自己的主机上尝试裸连github，如果无法连接就继续换ip，直到能裸连为止 

然后选中GitHub Release下载（非源码）[Fastly]规则并进行测速

仍依次从上到下对ip进行应用选中，直到成功写入为止

点击编辑Hosts

找到刚刚写入的内容备用

 在终端编辑/etc/hosts文件，将刚刚应用的hosts添加到最顶端后保存hosts文件，同时将自己的系统名称增加到127.0.0.1后面。

nano /etc/hosts

修改hosts部分到此结束，下面进入HASS Supervised安装过程

HASS官方安装HASS Supervised教程

https://www.home-assistant.io/installation/linux#install-home-assistant-supervised

其中包含对环境的要求

https://github.com/home-assistant/architecture/blob/master/adr/0014-home-assistant-supervised.md

OS Agent安装说明

https://github.com/home-assistant/os-agent

OS Agent下载链接

https://github.com/home-assistant/os-agent/releases/latest

HASS Supervised安装说明

https://github.com/home-assistant/supervised-installer

（一）安装所需的包

根据HASS Supervised安装说明，执行下方命令

apt install \
apparmor \
cifs-utils \
curl \
dbus \
jq \
libglib2.0-bin \
lsb-release \
network-manager \
nfs-common \
systemd-journal-remote \
systemd-resolved \
udisks2 \
wget -y

（二）安装docker 

首先配置DNS，执行下方命令

rm /etc/resolv.conf
touch /etc/resolv.conf
nano /etc/resolv.conf

执行完成之后就到了resolv.conf的编辑界面，在路由器管理界面找到DNS服务器地址，写入到resolv.conf中，格式如下。

nameserver 你路由器里给出的DNS服务器地址

保存退出，执行下方命令重启网络服务，注意该操作可能引起远程连接中断，可能需要重连一下

systemctl restart networking.service

然后根据HASS Supervised安装说明，执行下方命令

curl -fsSL get.docker.com | sh

（三）安装OS-Agent

 OS Agent下载链接https://github.com/home-assistant/os-agent/releases/latest

由于树莓派是aarch64架构，所以我们需要下载后缀为aarch64的包（查看系统架构可用“uname -m”命令）。

下载好OS-Agent安装包后可以用宝塔面板的文件功能或者前文提到的Xftp将文件传输至树莓派。我将其放到了/root目录下

在终端进入你存放OS-Agent安装包的文件夹，执行下方命令，注意最后包的名字要和你上传的文件的名字对应

dpkg -i os-agent_1.6.0_linux_aarch64.deb

完成安装后，可执行“gdbus introspect --system --dest io.hass.os --object-path /io/hass/os”指令验证是否安装成功，如果没有任何报错且弹出了interface的对象内省，那就说明安装成功了

（四）安装HASS Supervised

根据HASS Supervised安装说明，先执行下方命令（注意，这一步其实也在测树莓派是否可以连接到github，若下载失败，请回到本章节第〇部分重新配置）

wget -O homeassistant-supervised.deb https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb

下载成功后将文件移动到/mnt目录下并对其赋予777权限

mv ./homeassistant-supervised.deb /mnt/homeassistant-supervised.deb
chmod 777 /mnt/homeassistant-supervised.deb

 完成之后先将终端窗口调整到一个不小的大小（因为后面会蹦出来一下图形界面），再执行下方命令

apt install /mnt/homeassistant-supervised.deb

完成之后提示需要重启

执行下方命令重启

systemctl reboot

重启之后执行“ps -aux | grep docker”可以看到docker正在拉取hass相关文件。

到这一步之后就是纯纯等待了，可以隔一会儿过来执行一下上述命令看看现在状态，实在不行睡一觉明天起来就好了。

不过趁这个时间，我们可以去宝塔上放行一下8123端口（HASS主页面）和4357端口（HASS运行状况监控页面）

第一个部署下来的是hassio_supervisor容器

再等待一会儿后总共会有七个容器部署下来

访问树莓派IP:8123，如果一切顺利的话会是欢迎界面（部署完成之后），此时跟着本章的（五）HASS初始设置走就行。如果不幸遇到了下图红字内容，那么需要重新执行本章的（〇），然后使用下方命令重新安装Home Assistant Supervised。如果重装后还是遇到该问题，重复该过程直到Home Assistant界面显示欢迎。注意一定要出现下图开头的“Error installing Home Assistant”才需要重装，如果是什么什么大约耗时20min，你就睡觉去。

apt reinstall /mnt/homeassistant-supervised.deb

（五）HASS初始设置

接下来的教程替换为https://www.home-assistant.io/getting-started/onboarding/

 点击红框处可通过发送请求来定位自己大致位置，如果地图没刷出来可以稍微等一会儿，或者先下一步稍后去系统里设置。

上面步骤完成之后就进入了系统，如果你收到下图通知，在终端使用“systemctl reboot”重启树莓派即可解决

 硬件级重启后HASS可能需要较长时间才能完成启动，可以访问树莓派IP:4357查看当前HASS状态

这时再刷新HASS界面就进去了

四、安装HACS极速版

HACS极速版链接https://gitee.com/hacs-china

因为我们是Supervised版本，直接在终端使用命令行安装即可，执行下方指令

wget -O - https://hacs.vip/get | bash -

HACS下载完成后去HASS界面重启HASS

 重启完成后在配置->设备与服务->添加集成中搜索HACS

把前面选项都打上勾后点击提交

 由于一开始就配置过hosts，因此您应当十分顺利地获取到授权码，如果没有，则需要重新执行第三章的（〇）小节，并重启docker

复制授权码后打开上图中蓝字链接，输入授权码后点Continue

 点击Authorize hacs

完成之后回到HASS界面，可以看到成功的提示，并且左侧出现了HACS字样

至此本教程完结