快速开始
部署 Olink 服务
任选一种部署方式即可。通用 Linux / 其他环境可用 Docker Compose;飞牛 NAS 可用 飞牛 fnOS 应用包。
使用 Docker Compose 部署
创建 docker-compose.yml 文件
在您的部署目录中创建
docker-compose.yml文件,内容如下:
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启动服务
在包含
docker-compose.yml文件的目录中执行以下命令:bashdocker-compose up -d验证服务状态
执行以下命令检查服务是否正常运行:
bashdocker-compose ps您应该看到 olink 服务处于
Up状态。访问控制台
服务启动后,您可以通过浏览器访问
http://<服务器IP>:5512打开 Olink Web 控制台。
飞牛 fnOS 部署
适用于飞牛 NAS(fnOS)应用中心安装。
下载对应架构的
.fpk打开发布目录,下载与 NAS 架构匹配的
.fpk(以 v1.2.8 为例):- 发布站:https://release.hperfect.cn/olink-fnos/v1.2.8/
- CDN(可加快下载,文件相同):http://cdn.hperfect.cn/olink-fnos/v1.2.8/
也可先打开 http://cdn.hperfect.cn/ ,再进入olink-fnos/v1.2.8/。
按 NAS CPU 选择包(命名大致为
olink-1.2.8-fnos-amd64.fpk/olink-1.2.8-fnos-arm64.fpk):设备架构 选择 x86_64 / Intel / AMD amd64 的 .fpkARM64 arm64 的 .fpk两个架构包的应用名相同,同一台机器只能装其中一个,勿混装。
在应用中心安装
打开飞牛 应用中心 → 手动安装 / 从本地安装(以当前 fnOS 界面为准)→ 选择刚下载的
.fpk→ 按提示完成安装并启动。访问控制台
浏览器打开
http://<飞牛IP>:5512进入 Olink Web 控制台。
后续版本可到对应版本目录(如 …/olink-fnos/v1.2.9/)换新版 .fpk,再在应用中心安装;或使用应用内更新(若当前通道已开放)。
前提条件
- 已按上述步骤之一部署并启动 Olink 服务端。
界面分区
Web 控制台左侧为主导航,常见功能区包括:
- 品牌适配器入口(如「米家」)— 对应适配器的网关 / 账号授权、房间与映射管理(可选,非强制预装能力)。
- 出口配置(如「HomeKit」)— 桥接器 / 配件列表、配对与 TOML 配置。
- 接入设备 — 已纳入 Olink 统一模型的设备总览,按区域筛选与查看详情。
右上角一般提供账号或调试相关能力(以您构建的前端版本为准)。
推荐首次流程
心智模型:
启用适配器 → 纳入统一设备模型 → 按需配置出口(HomeKit / Matter 等)
以「米家适配器 + HomeKit 出口」为例(也可换成其他适配器 / 出口组合):
- 在适配器页(如 米家)添加网关并完成授权(按界面引导打开授权链接或粘贴回调地址)。
- 对网关执行 加载设备,拉取家庭、房间与设备列表。
- 在 映射管理 中确认或补全「适配器侧实体 → Olink 设备」的映射(部分流程支持半自动;复杂设备可能需手动对齐)。
- 切换到出口页(如 HomeKit),添加桥接器并记下配对码(PIN)与端口;类别为「桥接器」时可在同一桥下挂载多个配件。
- 在配件列表中 从接入设备添加 或 手写配置,必要时用内置编辑器修改 TOML 并做配置校验。
- 打开客户端(如 iOS「家庭」),添加配件,扫描或手动输入 PIN,将桥或单个配件加入。
- 在 接入设备 页检查设备是否出现在预期区域,必要时使用 区域管理 整理分区。
更细说明见 品牌适配器:米家、HomeKit 出口与配件 与 常见问题。