Skip to content

快速开始 ​

任选一种部署方式即可。通用 Linux / 其他环境可用 Docker Compose;飞牛 NAS 可用 飞牛 fnOS 应用包。

使用 Docker Compose 部署 ​

  1. 创建 docker-compose.yml 文件

    在您的部署目录中创建 docker-compose.yml 文件,内容如下:

yaml
services:
   olink:
     # arm镜像 registry.cn-zhangjiakou.aliyuncs.com/hperfect/olink:latest-arm64
     image: registry.cn-zhangjiakou.aliyuncs.com/hperfect/olink:latest
     network_mode: host
     container_name: olink
     privileged: false
     volumes:
       # 冒号左边请修改为你想保存配置的路径
       - ./data:/data   
     environment:
       - PUID=0
       - RUST_BACKTRACE=1
       - PGID=0
       - UMASK=000
       #监听端口
       - APP__server__listen=0.0.0.0:5512
       # 数据目录
       - APP__server__data_path=/data
     restart: always
  1. 启动服务

    在包含 docker-compose.yml 文件的目录中执行以下命令:

    bash
    docker-compose up -d
  2. 验证服务状态

    执行以下命令检查服务是否正常运行:

    bash
    docker-compose ps

    您应该看到 olink 服务处于 Up 状态。

  3. 访问控制台

    服务启动后,您可以通过浏览器访问 http://<服务器IP>:5512 打开 Olink Web 控制台。

飞牛 fnOS 部署 ​

适用于飞牛 NAS(fnOS)应用中心安装。

  1. 下载对应架构的 .fpk

    打开发布目录,下载与 NAS 架构匹配的 .fpk(以 v1.2.8 为例):

    按 NAS CPU 选择包(命名大致为 olink-1.2.8-fnos-amd64.fpk / olink-1.2.8-fnos-arm64.fpk):

    设备架构选择
    x86_64 / Intel / AMDamd64 的 .fpk
    ARM64arm64 的 .fpk

    两个架构包的应用名相同,同一台机器只能装其中一个,勿混装。

  2. 在应用中心安装

    打开飞牛 应用中心 → 手动安装 / 从本地安装(以当前 fnOS 界面为准)→ 选择刚下载的 .fpk → 按提示完成安装并启动。

  3. 访问控制台

    浏览器打开 http://<飞牛IP>:5512 进入 Olink Web 控制台。

后续版本可到对应版本目录(如 …/olink-fnos/v1.2.9/)换新版 .fpk,再在应用中心安装;或使用应用内更新(若当前通道已开放)。

前提条件 ​

  • 已按上述步骤之一部署并启动 Olink 服务端。

界面分区 ​

Web 控制台左侧为主导航,常见功能区包括:

  1. 品牌适配器入口(如「米家」)— 对应适配器的网关 / 账号授权、房间与映射管理(可选,非强制预装能力)。
  2. 出口配置(如「HomeKit」)— 桥接器 / 配件列表、配对与 TOML 配置。
  3. 接入设备 — 已纳入 Olink 统一模型的设备总览,按区域筛选与查看详情。

右上角一般提供账号或调试相关能力(以您构建的前端版本为准)。

推荐首次流程 ​

心智模型:

启用适配器 → 纳入统一设备模型 → 按需配置出口(HomeKit / Matter 等)

以「米家适配器 + HomeKit 出口」为例(也可换成其他适配器 / 出口组合):

  1. 在适配器页(如 米家)添加网关并完成授权(按界面引导打开授权链接或粘贴回调地址)。
  2. 对网关执行 加载设备,拉取家庭、房间与设备列表。
  3. 在 映射管理 中确认或补全「适配器侧实体 → Olink 设备」的映射(部分流程支持半自动;复杂设备可能需手动对齐)。
  4. 切换到出口页(如 HomeKit),添加桥接器并记下配对码(PIN)与端口;类别为「桥接器」时可在同一桥下挂载多个配件。
  5. 在配件列表中 从接入设备添加 或 手写配置,必要时用内置编辑器修改 TOML 并做配置校验。
  6. 打开客户端(如 iOS「家庭」),添加配件,扫描或手动输入 PIN,将桥或单个配件加入。
  7. 在 接入设备 页检查设备是否出现在预期区域,必要时使用 区域管理 整理分区。

更细说明见 品牌适配器:米家、HomeKit 出口与配件 与 常见问题。