logologo
  • 首页
  • 汉化专区
    • 官方网页汉化
    • 移动App汉化
    • Home Assistant 开发者文档
    • HASS Agent 汉化手册
    • ESPHome 准备开始
    • 其它汉化资源
  • 下载专区
  • 快速问答
  • 测评专区
  • 支持我
  • 关于
    • 关于本站
    • 搜索引擎
    • 重要事件
    • 服务器状态(China Only)

    #官方已经确定弃用

    #🖥️ Home Assistant Supervised 极速版

    #👨‍💻 版本修改作者:Alone

    #⚠️ 系统要求

    请确保您已了解系统要求

    #📖 简介

    此安装方法可在常规操作系统上提供完整的 Home Assistant 体验。这意味着将使用 Home Assistant 方法中的所有组件,除了 Home Assistant 操作系统。该系统将运行 Home Assistant Supervisor。Supervisor 不仅仅是一个应用程序,它是一个管理整个系统的完整设备。如果设置不再符合预期值,它将进行清理、修复或将设置重置为默认值。

    由于不使用 Home Assistant 操作系统,用户需要负责确保所有必需的组件都已安装并维护。所需的组件及其版本会随着时间的推移而变化。Home Assistant Supervised 作为社区支持的 DIY 解决方案的基础,按原样提供。我们只接受在全新安装、完全更新且没有额外软件包的 Debian 系统上重现的问题的错误报告。

    此方法被认为是高级的,仅适用于精通 Linux 操作系统、Docker 和网络管理的专家。

    #🛠️ 安装指南

    以 root 身份运行以下命令(在安装了 sudo 的机器上使用 su - 或 sudo su -):

    步骤 1:使用以下命令安装依赖项:

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

    如果您之前没有使用过 NetworkManager,您可能会看到有关如何让 NetworkManager 管理当前网络接口的说明。

    ...
    Setting up network-manager (1.42.4-1) ...
    
    The following network interfaces were found in /etc/network/interfaces
    which means they are currently configured by ifupdown:
    - enp1s0
    If you want to manage those interfaces with NetworkManager instead
    remove their configuration from /etc/network/interfaces.
    ...

    在继续之前,请按照以下步骤操作!

    步骤 2:使用以下命令安装 Docker-CE:

    curl -fsSL get.docker.com | sh

    步骤 3:安装 OS-Agent:

    OS-Agent 的安装说明可以在这里找到

    步骤 4:安装 Home Assistant Supervised Debian 包:

    wget -O homeassistant-supervised.deb https://github.com/hasscc/supervised-installer/releases/latest/download/homeassistant-supervised.deb
    apt install ./homeassistant-supervised.deb

    #🖥️ 支持的机器类型

    • generic-x86-64
    • odroid-c2
    • odroid-c4
    • odroid-n2
    • odroid-xu
    • qemuarm
    • qemuarm-64
    • qemux86
    • qemux86-64
    • raspberrypi
    • raspberrypi2
    • raspberrypi3
    • raspberrypi4
    • raspberrypi3-64
    • raspberrypi4-64
    • raspberrypi5-64
    • tinker
    • khadas-vim3

    #⚙️ 配置说明

    默认的 $DATA_SHARE 路径是 /var/lib/homeassistant(之前是 /usr/share/hassio)。 该路径用于存储所有与 Home Assistant 相关的内容。

    您可以在安装时通过以下方式重新配置该路径:

    DATA_SHARE=/my/own/homeassistant dpkg --force-confdef --force-confold -i homeassistant-supervised.deb

    #🛠️ 问题排查

    如果遇到问题,可以使用 journalctl -f 查看系统日志。如果您不熟悉 Linux 系统及其问题排查方法,我们建议您使用 Home Assistant OS。

    #🏠 Home Assistant Supervised(Docker) 极速版

    #👨‍💻 版本修改作者:Alone

    通过Docker安装Home Assistant Supervised (HassIO),并对国内网络环境进行优化

       HAOSSupervisedContainerCore
    自动化✅✅✅✅
    仪表盘✅✅✅✅
    集 成✅✅✅✅
    加载项✅✅❌❌
    升 级✅✅❌❌
    备 份✅✅✅✅

    #🐳 Compose 安装

    HASSIO=/usr/share/hassio
    mkdir -p $HASSIO
    cd $HASSIO
    wget https://ghrp2.hacs.vip/raw/hasscc/hass-super/main/compose.yml
    docker compose up -d

    /usr/share/hassio用于存储HassIO数据,包括HA配置及Add-ons配置等,可更改为其他路径

    compose.yml中的docker_lib用于存储HassIO容器及镜像等数据,会占用较大的空间,且对存储驱动有特殊要求,不要挂载到本地目录

    仅当DEFAULT_TZ=Asia/Shanghai时才会对国内网络环境进行优化

    #🖥️ 命令安装

    # 新建用于存储容器及镜像等数据的卷,对存储驱动有特殊要求,因此不能挂载到本地目录
    docker volume create hass_super_docker
    
    # 运行容器
    docker run -d \
      --name hass-super \
      -v /opt/hassio:/var/lib/homeassistant \
      -v /run/dbus:/run/dbus:ro \
      -v hass_super_docker:/var/lib/docker \
      -e DEFAULT_TZ=Asia/Shanghai \
      --device /dev/net/tun \
      --restart unless-stopped \
      --network host \
      --hostname hassio \
      --privileged \
      ghcr.nju.edu.cn/hasscc/hass-super

    首次安装时,需要较长时间安装环境及拉取镜像,请耐心等待

    通过http://192.168.xx.xx:4357可以查看系统状态

    通过http://192.168.xx.xx:8123进入Home Assistant

    #🛠️ 问题排查

    如果提示无网络连接no host internet connection,请尝试在网络配置中禁用IPv6

    如果安装后超过10分钟仍然无法进入Home Assistant,请尝试执行以下命令查看日志

    docker exec -it hass-super tail -f /tmp/hassio.log -n 500
    docker exec -it hass-super journalctl -f -u docker -n 100
    docker exec -it hass-super journalctl -f -u hassio-supervisor -n 200
    docker exec -it hass-super docker logs -f hassio_supervisor
    docker exec -it hass-super ha core info
    docker exec -it hass-super ha core start

    #🎉 鸣谢

    • NJU Mirror