本文介绍在香橙派3B（ 3B）第一版硬件上安装的全过程。由于是稍旧的版本，因此必须用23.8.2的镜像，采用版本更新的社区版本不能正常启动。但是23.8.2安装后升级是能够正常使用的。对于第二版的硬件，因为还没有收到货，所以还没测试，各位可以自行尝试用新的社区版本，看看能不能正常启动。

由于的社区版本也是一直更新的，因此对于老版本要自己稍微搜索一下，这里老胡节省大家时间，给出链接：

第一步、当然是下载社区IMG镜像并烧写到TF卡上。

在这一步，老胡建议大家采用来完成。选择下载好的IMG镜像，然后选择对应的目标磁盘，然后烧录即可。这个过程可以说是完全傻瓜化的，就不多讲述了。

第二步、配置系统，以满足运行的需要

1、把烧录好的TF卡插入香橙派TF卡槽内，接好显示器和键盘，以及插好网线，就可以上电开机了。

2、按照屏幕提示，输入root用户密码并确认用的shell（建议选BASH），然后Ctrl+C，终断其他用户设置（因为根本用不到别的用户）。

3、修改/etc/os-中的为” GNU/Linux 12 ()”

nano /etc/os-release

对于第一次用这个编辑工具的朋友会感觉有点别扭，老胡也更喜欢VI，但这是系统默认带的，如果没有太强烈的需求，将就着用就行，反正除了编辑一下配置文件，其它地方几乎用不到了。只需要注意，Ctrl+O用于保存文件修改，Ctrl+X用于退出。

4、更新系统预安装包

‍

apt update && apt upgrade -y

5、安装HA需要的库

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

6、安装

由于某种原因，目前在国内是被阻断的，所以我们必须采用一些科学手段才能访问。先设置代理

export https_proxy=http://your-proxy-server:port

然后就可以用下面的语句来安装了。

curl -fsSL https://get.docker.com -o get-docker.sh 
sh ./get-docker.sh

7、生成科学上网的配置

同样由于前面提到的原因，虽然安装了，但访问各种应用库也是被阻断的，因此在的辅助代理配置文件中，也需要设置好代理。

mkdir -p /etc/systemd/system/docker.service.dnano /etc/systemd/system/docker.service.d/http-proxy.conf

文件的内容如下：

[Service]Environment="HTTP_PROXY=http://your-proxy-server:port"Environment="HTTPS_PROXY=http://your-proxy-server:port"Environment="NO_PROXY=localhost,127.0.0.1"

8、设置主机名和时区

hostnamectl set-hostname homeassistanttimedatectl set-timezone "Asia/Shanghai"

其中，为在mdns搜索时可以找到的设备名称，这是为了后续访问可以用:8123来快速访问，不需要知道ip地址。

9、重启并检查配置是否生效

reboot

重启并重新回到登录界面，用root和设置的root密码再次登录，然后用指令

systemctl show --property=Environment docker

可以检查代理是否设置正确，正确的返回消息包含代理信息。

10、修改的设置为v1，并重新编译新内核

echo "extraargs=apparmor=1 security=apparmor systemd.unified_cgroup_hierarchy=false systemd.legacy_systemd_cgroup_controller=false" >> /boot/armbianEnv.txt

然后重新生成一下开机引导镜像，以使用新的设置。

update-initramfs -u

再次重启，以确保应用新的规则

需要重新登录，后面不再重复累赘描述了。

11、安装OS Agent以及

安装OS Agent

wget https://github.com/home-assistant/os-agent/releases/download/1.6.0/os-agent_1.6.0_linux_aarch64.deb dpkg -i os-agent_1.6.0_linux_aarch64.deb

装

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

在安装过程中，会提示选择设备类型，请选择-64，这是类型单片机通用的类型。

接下来很长的一段时间会没有任何反应，其实是在后台下载应用镜像并安装，根据代理的能力，耗时可能不一样，大概半个小时能完成。

过程当中可以用以下指令看看状态。

systemctl status docker

以上指令用于检查是不是在工作，可以看到各个镜像下载安装的状态。

12、等本体安装并初始化好，就可以通过.local:8123来访问HA的界面了。首次设置完成，配置中提示系统不健康，没有提权，是因为这个时候HA的没有正确加入的权限设置中，重启即可。

到这里，香橙派3B安装的工作就完成了，后面我们会转到浏览器上完成后续的安装设置工作。

写在文末：

第一个问题，为什么要自己手动安装来跑。这里主要有两个原因：

第一是因为国内目前对的限制，如果用官方HAOS镜像来直接烧录TF卡，然后插到官方建议的树莓派或者官方自己的Green硬件或者硬件，都只有一个结局，根本无法正常安装各种组件，导致无法正常使用。

自己手动安装的系统，因为可以根据自己的需求来设置代理，因此可以正常安装运行。

第二，国内有一些现成的用淘汰软路由改HA的设备，也有一些号称可以提供更新的改良版HAOS，例如某瓜，为什么不采用？

这个问题是这样，做HA，是为了实现家庭智能化控制，可不是为了让别人控制自己家的东西，因此注意网络安全性非常重要。由淘汰软路由修改的设备，当然是可以用的，但要小心鉴别，不要用被预埋了后门的。

而某瓜的HAOS版本，之前老胡也是建议用的，但最近被挖出来一个瓜，就是不知道什么原因，作者似乎忘记了一个ssh的 key在系统里没有清理了。懂linux安全的人都会知道这个坑有多大，简单的说，就是如果有一个人，他知道你的设备ip地址，又有对应的 key，那么就可以随手ssh登录你的HA服务器，而且是root权限的，随便修改和控制了。老胡带着善意希望某瓜只是为了测试忘记了而已。

第二个问题，为什么选香橙派3B？

国内现在arm单板机开发板可以说是蓬勃发展了，各种品牌，性能的单板机很多，为什么老胡会选香橙派3B呢？

第一、香橙派3B用的性能优良且价格便宜，具体不展开了，技术参数是可以网上查到的，而且有NPU，有0.8TOPS的算力，以后增加AI机能也是可以的；价格也在淘宝上摆着，比树莓派同性能的可要便宜得多。

第二、香橙派3B自带了EMMC扩展接口，这个是老胡选择香橙派3B最重要的原因，因为大部分的TF卡其实并不适合频繁读写，而作为智能家居系统，各种数据的更新读写，是避免不了的，这种场景下，把系统写入到EMMC中，从EMMC来执行，会是一种更好的使用方法。本文没有描述，如果大家对此感兴趣，可以留言或者私信问老胡。