b站安装视频:我又用三天时间写了一个HomeAssistant Supervised百分百部署成功的教程(树莓派4B+Debian12+Supervised+HACS极速版)_哔哩哔哩_bilibili
目录
阅前须知
本文章的前身是我的另一篇文章
Home Assistant安装指北(树莓派+Debian12+HASS Container+HACS极速版)-CSDN博客
该文章(后文称为“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安装说明
(一)安装所需的包
根据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字样

至此本教程完结