安装指南#

Hass-Panel 提供了多种安装方式，您可以根据自己的需求选择合适的安装方法。

安装方式#

1. Docker 安装（推荐）#

使用以下命令启动 Hass-Panel：

docker run \
  --name hass-panel \
  --restart unless-stopped \
  --network host \
  -v ./data/:/config/hass-panel \
  -d \
  registry.cn-hangzhou.aliyuncs.com/hass-panel/hass-panel:latest

这个命令会：

• 创建一个名为 hass-panel 的容器
• 设置容器自动重启
• 将配置文件保存在主机的 ./data/ 目录
• 使用最新版本的 Hass-Panel 镜像
• 访问地址：http://your-docker-host:5123

2. Home Assistant 插件安装#

方式一：一键添加（推荐）#

点击下面的按钮将 Hass-Panel 添加到您的 Home Assistant：

方式二：手动添加#

1. 在 Home Assistant 的侧边栏中，点击"配置" -> "加载项" -> "加载项商店"
2. 点击右上角的三个点，选择"存储库"
3. 添加存储库地址：https://github.com/mrtian2016/hass-panel
4. 点击"添加"并刷新页面
5. 在加载项商店中找到并安装"Hass Panel"
6. 启动后即可在侧边栏访问

升级说明#

Docker 版本升级#

# 拉取最新镜像
docker pull registry.cn-hangzhou.aliyuncs.com/hass-panel/hass-panel:latest

# 停止并删除旧容器
docker stop hass-panel
docker rm hass-panel

# 使用新镜像重新创建容器
docker run \
  --name hass-panel \
  --restart unless-stopped \
  -v ./data/:/config/hass-panel \
  -d \
  registry.cn-hangzhou.aliyuncs.com/hass-panel/hass-panel:latest

Home Assistant 插件版本升级#

1. 在 Home Assistant 的加载项商店中找到 Hass Panel
2. 点击"更新"按钮
3. 等待更新完成后重启插件