玩客云安装 Home Assistant

玩客云安装 Home Assistant 及 HACS Xiaomi home 插件教程

一、准备工作

  1. 设备要求：

    • 玩客云（S805 芯片，1GB 内存，8GB 存储）。
    • 已刷入 Armbian 系统（教程使用 https://github.com/hzyitc/armbian-onecloud/releases/download/ci-20250305-162012-UTC/Armbian-unofficial_25.05.0-trunk_Onecloud_bookworm_current_6.12.17.burn.img.xz 镜像）。
    • 网络环境：有线连接优先，确保可访问互联网。

  2. 工具准备：

    • SSH 客户端（如 xshell8，其他）。
    • 文件传输工具（如 xftp8，其他）。

二、安装 Home Assistant（Docker 版）

1. 安装 Docker

1
sudo curl -fsSL https://get.docker.com| bash -s docker --mirror Aliyun

2. 拉取 Home Assistant 镜像

1
docker pull homeassistant/home-assistant:stable

3. 启动容器

1
2
3
4
5
6
7
docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -v /homeassistant:/config \
  --network=host \
  homeassistant/home-assistant:stable

注意事项：

  • -v /homeassistant:/config：配置目录映射，确保路径正确。
  • 若启动失败，检查命令拼写，避免镜像名或参数错误。

4. 访问 Home Assistant

浏览器输入 http://玩客云IP:8123，按向导初始化账户。

三、安装 HACS 社区商店（Home Assistant 米家集成一样最下面有链接）

1. 进入配置目录

1
2
3
cd /homeassistant
mkdir -p custom_components
cd custom_components

2. 下载并解压 HACS

1
2
3
wget https://ghproxy.com/https://github.com/hacs/integration/releases/latest/download/hacs.zip
unzip hacs.zip -d hacs  # 必须解压到 hacs 子目录
rm hacs.zip

3. 重启 Home Assistant

1
docker restart homeassistant

4. 配置 HACS

  1. 登录 Home Assistant → 「配置」→「设备与服务」→「添加集成」。
  2. 搜索 HACS → 点击安装。
  3. 根据提示访问 GitHub 授权页面：
    • 输入 GitHub 账号 → 生成授权码。
    • 将授权码粘贴回 Home Assistant。

四、解决 HACS 无法访问 GitHub

方法 1：修改 hosts

  1. 进入容器终端：

    1
    docker exec -it homeassistant bash

  2. 添加 GitHub 域名解析：

    1
    2
    echo "199.232.68.133 raw.githubusercontent.com" >> /etc/hosts
    echo "140.82.113.3 github.com" >> /etc/hosts

  3. 退出并重启：

    1
    2
    exit
    docker restart homeassistant

五、验证 HACS 安装

  1. 登录 Home Assistant → 侧边栏出现 HACS 菜单。
  2. 在 HACS 中搜索并安装插件（如 Xiaomi Miot）：
    • 点击 「下载」 → 重启 Home Assistant。
    • 在 「集成」 中添加设备。

六、常见问题解决

1. Home Assistant拉取失败

配置镜像加速

1
sudo vi /etc/docker/daemon.json
1
2
3
4
5
6
7
{
    "registry-mirrors": [
        "https://docker.m.daocloud.io",
        "https://docker.1panel.live",
        "https://hub.rat.dev"
    ]
}
1
sudo service docker restart

2. HACS 无法初始化

  • 症状：卡在 GitHub 授权页面。
  • 解决：
    • 检查 hosts 文件是否生效。
    • 尝试手机热点或全局代理。

3. 文件权限错误

  • 症状：日志提示 Permission denied。
  • 修复：
    1
    chmod -R 755 /homeassistant/custom_components

4. 容器启动失败

  • 查看日志：
    1
    docker logs homeassistant

总结

通过本教程，你已成功在玩客云上部署 Home Assistant 并集成 HACS。后续可通过 HACS 安装更多插件（如天气、摄像头支持），打造个性化智能家居系统。遇到网络问题优先使用 镜像源 和 hosts 修改，保持系统轻量化以适配玩客云的有限硬件资源。

来源