Skip to content

飞牛部署

本教程使用飞牛的 Docker Compose 项目方式部署。开始前,请在飞牛中创建一个用于保存配置的文件夹,例如 docker/ha-bridge

1. 准备 Compose 文件

复制下面的全部内容,在部署文件夹中创建 compose.yaml

yaml
name: ha-bridge

services:
  ha-bridge:
    image: crpi-w1apw3w3zzp43y80.cn-shanghai.personal.cr.aliyuncs.com/weidaye1122/ha_bridge:latest
    container_name: ha-bridge
    user: root
    restart: unless-stopped
    network_mode: host
    environment:
      APP_PORT: 18080
    volumes:
      - /vol1/1000/docker/ha-bridge/data:/data
      - /vol1/1000/docker/ha-bridge/secrets:/run/secrets

2. 创建项目

  1. 打开飞牛的 Docker / Compose 管理页面。
  2. 进入「Compose」→「新建」。
  3. 选择刚才存放 compose.yaml 的文件夹。
  4. 项目名称填写 ha-bridge,然后开始创建。

等待镜像下载并启动完成。

3. 打开 HA Bridge

在同一局域网浏览器中打开:

text
http://飞牛 IP:18080

首次打开会进入管理员设置页,后续请继续阅读 首次设置与激活

提示

  • 不要删除或换空 datasecrets 文件夹;它们分别保存运行数据以及 HA 连接和授权运行所需信息。
  • 如果 18080 已被占用,将 APP_PORT 改为其他未占用端口,例如 18081,然后通过 飞牛 IP:18081 访问。
  • 如果你的存储卷编号不同,例如不是 /vol1/1000,只修改两行左侧的宿主机路径;右边的 /data/run/secrets 不要修改。
  • 默认镜像为阿里云个人镜像仓库;若无法拉取,可把 image 改为备用 Docker Hub 镜像 weidaye1122/ha_bridge:latest

让 Home Assistant 的日常使用更直观。