群晖部署

本教程使用 Container Manager 的「项目」方式部署。开始前，请在群晖中创建一个用于保存配置的文件夹，例如 docker/ha-bridge。

1. 准备 Compose 文件

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

name: ha-bridge

services:
  ha-bridge:
    # 默认阿里云镜像，拉取失败时可换 Docker Hub
    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:
      - /volume1/docker/ha-bridge/data:/data # 持久化仪表盘、图片和数据库
      - /volume1/docker/ha-bridge/secrets:/run/secrets # 保存 HA 凭据和授权密钥

2. 创建项目

1. 打开 Container Manager。
2. 进入「项目」→「新增」。
3. 选择刚才存放 compose.yaml 的文件夹。
4. 项目名称填写 ha-bridge，然后开始创建。

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

3. 打开 HA Bridge

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

http://群晖 IP:18080

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

提示

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