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 -y2、设置时区
执行下方指令设置时区
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字样
至此本教程完结
扫一扫
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
