极空间部署

极空间不同机型的目录结构可能不同，因此推荐把 Compose 文件、data 和 secrets 放在同一个应用文件夹中。

1. 建立应用文件夹

例如创建：

docker/ha-bridge

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

name: ha-bridge

services:
  ha-bridge:
    image: weidaye1122/ha_bridge:latest
    container_name: HaBridge
    user: root
    restart: unless-stopped
    ports:
      - "18080:8000"
    volumes:
      - ./data:/data
      - ./secrets:/run/secrets
      - /etc/machine-id:/host/etc/machine-id:ro

data 和 secrets 会保存在 compose.yaml 旁边，你不需要事先手动建立这两个文件夹。

2. 通过 Compose 创建应用

1. 打开极空间的 Docker / Compose 管理功能。
2. 新建应用，选择 compose.yaml 所在文件夹。
3. 确认容器名称为 HaBridge，然后部署。

3. 打开服务

在浏览器访问：

http://极空间 IP:18080

如果看到管理员设置页，继续完成 首次设置与激活。

提示

• 请保留 Compose 文件旁的 data 与 secrets 文件夹。
• 不建议把 app.db 单独映射到其他位置；保持整个 data 文件夹映射最稳定。
• 端口冲突时，将 18080:8000 改为 其他端口:8000。