4 常见问题
[TOC]
无线网卡不能使用的临时解决方案
访问http://homeassistant.local:7681
出现ha提示符后输入login回车，进入命令行界面
编辑 /mnt/boot/cmdline.txt 文件
在console=tty0 后面增加 net.ifnames=0（和前面用空格隔开）
保存，重启就可以正常使用了。
如果修改后，又升级了homeassistant的版本，那可能会又不能使用。如果是这样，可以再来一次上面的操作。
预计下一版会修正
Homeassistant Box忘记密码怎么办？
如果只是忘记密码，用户名没忘记
-
在浏览器访问http://homeassistant.local:7681（或者用ip访问，比如http://192.168.3.198:7681/），
-
在ha提示符后面执行
authentication reset --username "用户名" --password "新密码"
再回到http://homeassistant.local:8123登陆即可
想清除Homeassistant Box 账户信息怎么弄？
如果用户名和密码都忘记了，或者你就是想单纯的清除账户信息
-
在浏览器访问http://homeassistant.local:7681（或者用ip访问，比如http://192.168.3.198:7681/），
-
在ha提示符后输入login回车
- 在#提示符下执行，注意是大写字母C
再回到http://homeassistant.local:8123登陆即可
重置Homeassistant盒子，恢复出厂设置
-
在浏览器访问http://homeassistant.local:7681（或者用ip访问，比如http://192.168.3.198:7681/），
-
在ha提示符后输入login回车
-
删除隐藏目录，没有任何提示，删除后执行reboot重启，命令：
rm -rf /mnt/data/supervisor/homeassistant/.storage/
reboot
侧边栏没有supervisor菜单项
-
访问http://homeassistant.local:7681
-
输入login回车，进入root模式
-
输入ha-install -c 强制重配（然后重启系统看看），注意是小写字母c
connect: no route to host
Get “http://supervisor/network/info“: dial tcp 172.30.32.2:80: connect: no route to host
-
访问http://homeassistant.local:7681
-
ha提示符下输入login回车，执行下面的命令
wget -O - http://ota.wghaos.com/su7 | bash -
Home Assistant CLI not starting! Jump into emergency console
这个问题是之前政府大力打击docker的时候常出现的问题，现在应该很少见了
-
访问http://homeassistant.local:7681
-
输入login回车进入root模式
-
提示符下执行下面三条命令
wgturbo docker.io fastgh
wgturbo ghcr.io fastgh
wgturbo apply -D
Homeassistant Box磁盘空间快满了，怎么办？
1）清理过时的docker镜像文件
我们在使用 Docker 一段时间后，系统一般都会残存一些临时的、没有被使用的镜像文件，可以通过以下命令进行清理：
- 访问http://homeassistant.local:7681
- 输入login回车进入root模式
- 执行 docker image prune
2）清理历史记录
在configuration.yaml里添加或修改
recorder:
purge_keep_days: 5
3）删除备份文件
设置-系统-备份
4 常见问题 的子部分
core 2025.3.0 bemfa 问题临时解决方案
Homeassistant core 2025.3.0 bemfa 无法加载配置向导问题的临时解决方案
临时解决方案：
\homeassistant\custom_components\bemfa文件夹下
manifest.json中的
“requirements”: [“paho-mqtt==1.6.1”]
修改为
“requirements”: [“paho-mqtt>=2.0.0”]
mqtt.py中
self._mqttc = mqtt.Client(uid, mqtt.MQTTv311)
修改为
self._mqttc = mqtt.Client(mqtt.CallbackAPIVersion.VERSION1, client_id=uid, protocol=mqtt.MQTTv311)
保存 重启HA 后生效
Homeassistant磁盘空间快满
Homeassistant Box磁盘空间快满了，怎么办？
1）清理过时的docker镜像文件
我们在使用 Docker 一段时间后，系统一般都会残存一些临时的、没有被使用的镜像文件，可以通过以下命令进行清理：
- 访问http://homeassistant.local:7681
- 输入login回车进入root模式
- 执行 docker image prune
2）清理历史记录
在configuration.yaml里添加或修改
recorder: purge_keep_days: 5
3）删除备份文件
设置-系统-备份
Homeassistant重置密码
如果只是忘记密码，用户名没忘记
- 在浏览器访问http://homeassistant.local:7681（或者用ip访问，比如http://192.168.3.198:7681/），
- 在ha提示符后面执行
authentication reset --username "用户名" --password "新密码"
再回到http://homeassistant.local:8123登陆即可
侧边栏没有supervisor菜单项
- 访问http://homeassistant.local:7681
- 输入login回车，进入root模式
- 输入ha-install -c 强制重配（然后重启系统看看），注意是小写字母c
清除Homeassistant Box 账户信息
想清除Homeassistant Box 账户信息怎么弄？
如果用户名和密码都忘记了，或者你就是想单纯的清除账户信息
- 在浏览器访问http://homeassistant.local:7681（或者用ip访问，比如http://192.168.3.198:7681/），
- 在ha提示符后输入login回车
- 在#提示符下执行，注意是大写字母C
再回到http://homeassistant.local:8123登陆即可
无线网卡不能使用的临时解决方案
访问http://homeassistant.local:7681
出现ha提示符后输入login回车，进入命令行界面 编辑 /mnt/boot/cmdline.txt 文件
在console=tty0 后面增加 net.ifnames=0（和前面用空格隔开）
保存，重启就可以正常使用了。
如果修改后，又升级了homeassistant的版本，那可能会又不能使用。如果是这样，可以再来一次上面的操作。
预计下一版会修正
重新安装最新的小米官方插件
最近homeassistant core 升级到2025.5.3，好几个插件不好使，小米官方插件也未能幸免，不过小米官方立即发布了新版本，修复了存在的问题。但是我也需要好几个客户小米官方插件已经更新到最新版本还是不能用。
那么，怎么重装小米官方插件呢？
1，浏览器访问http://homeassistant.local:7681 ，输入login后回车
2,导航到/mnt/data/supervisor/homeassistant/custom_components/
cd /mnt/data/supervisor/homeassistant/custom_components/
3、删除原来的目录ha_xiaomi_home（也有可能是xiaomi_home）
rm -rf ha_xiaomi_home
4、下载xiaomi官方插件最新版（当前为0.2.1）
wget https://github.com/XiaoMi/ha_xiaomi_home/releases/download/v0.2.1/xiaomi_home.zip
5、解压到ha_xiaomi_home目录
unzip xiaomi_home.zip -d ha_xiaomi_home
6、重启
reboot
7、重启完成后，在设置-设备与服务 添加集成 输入xiaomi找到xiaomi home就可以用了
如果下载不了文件，请自行搜索github加速下载，或者使用冬瓜伴侣
重置Homeassistant盒子，恢复出厂设置
- 在浏览器访问http://homeassistant.local:7681（或者用ip访问，比如http://192.168.3.198:7681/），
- 在ha提示符后输入login回车
- 删除隐藏目录，没有任何提示，删除后执行reboot重启，命令：
rm -rf /mnt/data/supervisor/homeassistant/.storage/
reboot