## 1. 为什么要在安卓手机上折腾HomeAssistant？ 如果你和我一样，是个喜欢折腾智能家居的玩家，家里肯定少不了各种品牌的设备：小米的灯、涂鸦的插座、苹果的HomeKit配件……让它们在一个平台上统一管理，是很多人的梦想。HomeAssistant（简称HA）就是这个梦想的“集大成者”，它开源、免费，支持上千种设备，能把所有智能硬件“拧成一股绳”。 但问题来了，HA官方推荐在树莓派、NAS或者小型服务器上运行。对于很多只是想入门试试，或者手头刚好有台闲置安卓旧手机的朋友来说，专门买台设备似乎有点“兴师动众”。这时候，AidLux就进入了我们的视野。它本质上是一个在安卓系统上运行的Linux兼容环境，让你能在手机里直接运行Linux软件，听起来是不是很酷？ 然而，坑马上就来了。AidLux应用商店自带的Python版本最高只到3.9，而HomeAssistant从2023.7版本开始，就要求Python版本至少是3.10。这意味着，如果你直接用商店的Python，最高只能安装HA 2023.1左右的版本，会错过很多新功能和设备支持。更别提安装HACS（HomeAssistant社区商店）这个“神器”了，没有它，HA的扩展能力大打折扣。 所以，这篇教程的核心目标就明确了：**在AidLux里，手动编译安装Python 3.10，搭建一个专属于HA的虚拟环境，最终部署上最新的HomeAssistant 2023.7+版本，并成功安装HACS。** 整个过程我亲自踩了一遍坑，把最稳的路径和可能遇到的“雷”都给你标出来了，跟着走，大概率能成。 ## 2. 前期准备：给你的安卓手机“铺路” 在开始敲命令之前，有几件准备工作必须做扎实，这能避免后面一半以上的错误。 首先，确保你的安卓设备已经**解锁了开发者选项并开启了USB调试**。这个步骤因手机品牌而异，通常是在“关于手机”里连续点击“版本号”7次，然后在“系统设置”里找到“开发者选项”并打开。接着，去AidLux官网下载最新的APK安装包并安装。安装后打开，它会自动初始化一个Linux环境，这个过程需要联网，耐心等待完成。 初始化完成后，我强烈建议你通过同一局域网下的电脑浏览器来操作。在AidLux应用界面上，找到“Cloud_ip”选项，它会显示一个类似 `http://192.168.1.100:8000` 的地址。在电脑浏览器里输入这个地址，密码是 `aidlux`。用网页端操作的好处太大了：可以方便地复制粘贴命令、多开终端标签页、上传下载文件，比在手机小屏幕上戳来戳去效率高十倍。 准备工作最后一步，是更新系统软件源并安装一些基础工具。在网页端的终端里，依次输入以下命令： ```bash apt update apt upgrade -y apt install vim wget curl sudo -y ``` `apt update` 是刷新软件包列表，`upgrade` 是升级现有软件，后面安装的 `vim`（一个强大的文本编辑器）、`wget`（下载工具）、`curl`（网络工具）和 `sudo`（权限管理工具）在后续步骤中都会用到。执行完这些，我们的基础舞台就搭好了。 ## 3. 核心攻坚：手动编译Python 3.10 这是整个过程中最关键、也最耗时的一步。AidLux基于ARM架构，很多预编译的二进制包不兼容，所以我们得从源代码开始编译，虽然慢，但最稳妥。 ### 3.1 安装编译所需的依赖包 编译Python就像盖房子，需要先把各种建筑材料（依赖库）备齐。缺了任何一个，编译过程都可能报错中断。执行下面这条“一揽子”安装命令： ```bash apt install -y gcc make pkg-config build-essential libssl-dev libffi-dev zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libreadline-dev libbz2-dev libsqlite3-dev ``` 我来简单解释几个重要的“建筑材料”： - **gcc, make, build-essential**：这是编译器的“全家桶”，没有它们，源码无法转换成可执行文件。 - **libssl-dev** 和 **libffi-dev**：Python的 `pip` 包管理器和一些加密模块（比如 `cryptography`）依赖它们，HA里很多集成插件都需要。 - **zlib1g-dev**：处理压缩文件必需的库。 - **libsqlite3-dev**：这是重点！Python内置的 `sqlite3` 模块需要它。如果这个没装好，后面运行HA会直接报错 `No module named ‘_sqlite3‘`，我们后面会专门解决这个问题。 ### 3.2 下载并编译Python源码 依赖装好后，我们开始“盖房子”。首先，找一个合适的目录，比如 `/opt`，然后下载Python 3.10.12的源码。我实测这个版本与HA 2023.7+兼容性最好。 ```bash cd /opt wget https://www.python.org/ftp/python/3.10.12/Python-3.10.12.tgz tar xzf Python-3.10.12.tgz cd Python-3.10.12 ``` 解压后进入源码目录，接下来是配置编译选项。这里有个小技巧，使用 `--enable-optimizations` 参数可以让Python在编译时进行自我优化，运行效率会提升一些，当然编译时间也会更长。 ```bash ./configure --enable-optimizations --prefix=/usr/local/python3.10 ``` `--prefix=/usr/local/python3.10` 指定了安装目录，这样我们编译好的Python会独立安装在这个路径下，不会覆盖系统自带的Python 3.7，实现多版本共存。 配置完成后，开始编译。如果你的手机处理器是八核的，可以用 `-j8` 参数启用8个线程并行编译，能大大节省时间。 ```bash make -j8 ``` 这个过程会比较漫长，取决于你手机的性能，可能需要15-30分钟。期间CPU会满载，手机发热是正常的，最好插着电源操作。编译完成后，使用 `altinstall` 而不是 `install` 来安装： ```bash make altinstall ``` `make altinstall` 的精妙之处在于，它不会覆盖系统默认的 `python` 和 `pip` 命令。安装完成后，我们手动创建一个软链接，方便调用。 ```bash ln -s /usr/local/python3.10/bin/python3.10 /usr/bin/python3.10 ln -s /usr/local/python3.10/bin/pip3.10 /usr/bin/pip3.10 ``` 最后，验证一下是否安装成功： ```bash python3.10 --version pip3.10 --version ``` 如果分别显示 `Python 3.10.12` 和 `pip` 的版本号，那么恭喜你，最难的关卡已经过去了。 ## 4. 解决编译中的“拦路虎”：_sqlite3模块缺失 按照上面的流程，很多人会在最后运行HA时卡在一个经典错误：`ModuleNotFoundError: No module named ‘_sqlite3‘`。这是因为Python在编译时没有找到正确版本的SQLite开发库。别慌，我们有标准的解决流程。 首先，我们需要手动编译安装一个较新版本的SQLite。去官网查看最新稳定版的源码包，比如 `sqlite-autoconf-3420000.tar.gz`。 ```bash cd /opt wget https://www.sqlite.org/2023/sqlite-autoconf-3420000.tar.gz tar -xvzf sqlite-autoconf-3420000.tar.gz cd sqlite-autoconf-3420000 ./configure --prefix=/usr/local/sqlite make -j8 && sudo make install ``` 安装完成后，需要告诉Python编译器我们新SQLite的位置。回到Python的源码目录： ```bash cd /opt/Python-3.10.12 ``` 用 `vim` 或 `nano` 编辑器打开 `setup.py` 文件： ```bash vim setup.py ``` 在文件里搜索 `sqlite_inc_paths` 这个变量，它大概长这样： ```python sqlite_inc_paths = [ ‘/usr/include‘, ‘/usr/include/sqlite‘, ‘/usr/include/sqlite3‘, ‘/usr/local/include‘, ‘/usr/local/include/sqlite‘, ‘/usr/local/include/sqlite3‘, ] ``` 我们需要把我们刚安装的SQLite头文件路径加进去，修改后如下： ```python sqlite_inc_paths = [ ‘/usr/include‘, ‘/usr/include/sqlite‘, ‘/usr/include/sqlite3‘, ‘/usr/local/include‘, ‘/usr/local/include/sqlite‘, ‘/usr/local/include/sqlite3‘, ‘/usr/local/sqlite/include‘, # 新增这一行 ‘/usr/local/sqlite/include/sqlite3‘, # 新增这一行 ] ``` 保存退出后，**重新编译并安装Python**。是的，需要再来一遍，但这次因为只是配置变了，速度会快很多。 ```bash make -j8 && make altinstall ``` 安装完成后，可以检查一下编译出的 `_sqlite3` 模块文件是否存在： ```bash find /usr/local/python3.10 -name “*sqlite*.so“ ``` 你应该能看到一个类似 `_sqlite3.cpython-310-aarch64-linux-gnu.so` 的文件。至此，这个最棘手的问题就彻底解决了。 ## 5. 创建虚拟环境并安装HomeAssistant Python装好了，我们开始布置HA的“小家”。为什么用虚拟环境？因为它能为HA创建一个独立的、干净的Python运行空间，里面所有的包依赖都与系统其他部分隔离。这样，你以后安装其他Python应用，或者升级系统，都不会影响到HA的稳定运行。 首先，创建一个专门的目录并进入： ```bash mkdir -p /srv/homeassistant cd /srv/homeassistant ``` 使用我们刚编译好的Python 3.10来创建虚拟环境： ```bash python3.10 -m venv . ``` 这条命令会在当前目录（`.`）下生成一个虚拟环境。激活它： ```bash source bin/activate ``` 激活后，你的命令行提示符前面通常会多出一个 `(homeassistant)` 或括号包着的路径，这表示你已经在这个虚拟环境里了。**接下来所有操作，都要确保在这个激活的虚拟环境下进行。** 虚拟环境激活后，我们先升级一下pip，然后安装必要的工具包 `wheel`，它能加速后续一些二进制包的安装。 ```bash pip install --upgrade pip pip install wheel ``` 接下来就是安装HomeAssistant核心了。为了确保稳定，我们指定一个版本。你可以去HA官网查看最新的稳定版，比如在写这篇文章时，2023.8.4是个不错的选择。 ```bash pip install homeassistant==2023.8.4 ``` 这个下载和安装过程需要一段时间，因为HA的依赖包非常多。保持网络通畅，耐心等待。安装完成后，可以直接启动HA进行初始化： ```bash hass ``` 第一次启动会进行初始化配置，并自动在 `~/.homeassistant` 目录下生成配置文件。这个过程可能需要几分钟。当你看到日志里出现类似 `Home Assistant initialized in X.XXs` 和 `Starting Home Assistant` 的信息，并且没有大量红色错误时，就说明启动成功了。 此时，在同一局域网的电脑浏览器里，输入你的安卓手机IP地址加上端口号8123，例如 `http://192.168.1.100:8123`，就能看到HA的初始化引导界面了。按照提示创建账号、设置位置等基本信息，你就进入了HA的主界面。 ## 6. 安装HACS，开启无限扩展能力 原生的HA已经很强大了，但有了HACS（Home Assistant Community Store），才是真正的“完全体”。HACS是一个社区商店，里面有成千上万的第三方集成、主题和插件，让你能轻松接入官方未支持的设备，或者美化你的界面。 安装HACS需要在HA已经运行起来之后进行。我们首先需要下载安装脚本。由于网络环境问题，直接使用GitHub源可能很慢或失败，这里使用一个国内的镜像源，速度会快很多。 保持虚拟环境激活状态，在 `/srv/homeassistant` 目录下，执行以下命令： ```bash wget -O - https://ghproxy.com/raw.githubusercontent.com/hasscc/get/main/get | HUB_DOMAIN=ghproxy.com/github.com DOMAIN=hacs REPO_PATH=hacs-china/integration ARCHIVE_TAG=china bash - ``` 这条命令看起来复杂，其实原理很简单：`wget` 下载安装脚本并通过管道 `|` 交给 `bash` 执行。其中 `ghproxy.com` 是一个GitHub的代理，`hacs-china/integration` 是HACS的中国镜像仓库，能有效解决下载慢的问题。 脚本执行完成后，**重启HomeAssistant**。你可以在运行 `hass` 的终端按 `Ctrl+C` 停止，然后再次输入 `hass` 启动。或者新开一个终端，进入虚拟环境后执行 `hass`。 重启后，打开HA的网页界面，点击左下角的用户名进入“配置文件”，然后选择“高级模式”并开启它。接着，在侧边栏找到“配置” -> “设备与服务”。点击右下角的“添加集成”，在搜索框里输入 **HACS**。 正常情况下，HACS应该出现在搜索结果里。点击它，按照屏幕提示完成安装。流程中会要求你连接GitHub账号进行授权，这是为了HACS能获取你账户下的仓库信息（用于安装自定义仓库的插件），按照网页指引操作即可。 安装成功后，侧边栏会出现一个新的“HACS”选项。点进去，你就进入了这个宝藏商店。在这里，你可以搜索并安装像“Xiaomi Miot Auto”（小米米家设备集成）、“ESPHome”等强大的第三方集成，极大地扩展HA的能力。 ## 7. 优化与日常维护指南 一切部署完毕，但要让这个跑在手机上的HA稳定、长久地工作，还需要一些优化和设置。 **首先是开机自启动。** 我们不可能每次都手动打开AidLux，再敲命令启动HA。可以在AidLux内创建一个启动脚本。在 `/etc/init.d/` 目录下创建一个新文件，比如叫 `homeassistant`： ```bash sudo vim /etc/init.d/homeassistant ``` 文件内容如下： ```bash #!/bin/bash ### BEGIN INIT INFO # Provides: homeassistant # Required-Start: $local_fs $network $named $time $syslog # Required-Stop: $local_fs $network $named $time $syslog # Default-Start: 2 3 4 5 # Default-Stop: 0 1 6 # Description: Home Assistant ### END INIT INFO PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin DAEMON=/usr/bin/hass NAME=homeassistant USER=root PIDFILE=/var/run/$NAME.pid case "$1" in start) echo "Starting Home Assistant" cd /srv/homeassistant source bin/activate hass > /var/log/homeassistant.log 2>&1 & echo $! > $PIDFILE ;; stop) echo "Stopping Home Assistant" kill `cat $PIDFILE` rm $PIDFILE ;; *) echo "Usage: /etc/init.d/homeassistant {start|stop}" exit 1 ;; esac exit 0 ``` 保存后，赋予执行权限并添加到启动项： ```bash sudo chmod +x /etc/init.d/homeassistant sudo update-rc.d homeassistant defaults ``` 这样，每次AidLux启动时，HA就会自动在后台运行了。日志会输出到 `/var/log/homeassistant.log`，方便排查问题。 **其次是备份。** HA的所有配置、插件和数据库都在 `~/.homeassistant` 目录下（对于root用户，路径是 `/root/.homeassistant`）。定期将这个目录打包备份到手机存储或其他地方，是避免心血白费的最好习惯。 **最后是更新。** 当有新版本的HA发布时，更新步骤很简单：停止HA服务，激活虚拟环境，使用pip升级即可。 ```bash cd /srv/homeassistant source bin/activate pip install --upgrade homeassistant ``` 升级后重启HA即可。对于HACS里的集成和插件，也可以在HACS的界面里直接点击更新。 把闲置的安卓手机变成一台24小时在线的智能家居服务器，不仅物尽其用，更是一种极客的乐趣。整个过程虽然涉及编译、配置，但每一步都有其道理。我自己的小米6旧手机已经稳定运行这套环境好几个月了，日常控制灯具、插座毫无压力。最关键的是，你再也不用受限于AidLux商店里陈旧的Python版本，可以自由追逐HomeAssistant的最新特性了。如果在操作中遇到任何问题，不妨回头检查一下依赖是否装全、编译路径是否正确，或者去相关的社区论坛搜索一下错误信息，大概率能找到解决方案。