如何使用 Docker 群晖安装教程,从而运行智汀家庭云#
本文档描述如何在docker上运行智汀家庭云(以下简称SA),并使用浏览器体验SA。
- 环境准备#
linux主机
docker
docker-compose - 运行SA#
0
自行创建docker-compose文件运行#
选择一个目录存放SA所需文件,执行以下命令:
wget -O smartassistant.zip https://github.com/zhiting-te... && unzip smartassistant.zipcd zt-smartassistantdocker-compose up
Copy
备注:
您可以通过最新版本的发布地址:https://github.com/zhiting-te...,获取最新版本zip文件
- 测试运行情况#
服务启动后可以通过以下命令检查SA的状态:
curl http://localhost:9020/api/check
Copy
如果返回以下内容则说明服务已运行起来并且未被绑定
{"status":0,"reason":"成功","data":{"is_bind":false,"revision":""}}
Copy
- 使用智汀App进行体验#
SA体验演示#
点击添加智能设备发现SA
选中SA,点击添加
图. 点击添加设备
图. 正在添加设备
图. 设置是否允许找回用户凭证
图. 添加设备成功
点击支持品牌,界面中会列出SA内置的一些插件
查询支持品牌
点击其中的一个插件,点击添加对插件进行安装
图. 添加插件
图. 添加插件成功
插件添加成功后,返回到首页家居,点击右上角+按钮就可以添加插件支持的设备
选中其中的一个设备点击添加,添加完成后返回到首页的家居即可对设备进行操控
图. 添加设备
图. 添加设备成功
- 使用专业版进行体验#
5.1 账号和密码设置#
SA服务启动后,如果未绑定,需要发送以下请求对SA进行绑定:
curl -X POST -d '{"device": {"model": "smart_assistant"}}' http://localhost:37965/api/de...
Copy
绑定成功后返回以下内容:
{ "status": 0, "reason": "成功", "data": { "device_id": 1, "plugin_url": "", "user_info": { "user_id": 1, "role_infos": null, "account_name": "", "nickname": "wyqicai", "token": "MTYzNTMxOTE1M3xOd3dBTkVoRE5WRXpTME5CV0VrMFVFOVFWa0pJUjA1UFNVRklRMEUxUkZaWVFsRkNWVWhUVWxWRFEwNUVTek5QU0VwVlJVVlJSMEU9fNXschLMFQtEogQo2AlJu4wfSJfLrsk994FwSGUhp-_3", "phone": "", "is_set_password": false }, "area_info": { "id": "20763937284831135" } }}
Copy
SA绑定成功后设置用户名和密码:
curl -X PUT -d '{"account_name": "admin","password": "123456"}' --header 'smart-assistant-token:MTYzNTMxOTE1M3xOd3dBTkVoRE5WRXpTME5CV0VrMFVFOVFWa0pJUjA1UFNVRklRMEUxUkZaWVFsRkNWVWhUVWxWRFEwNUVTek5QU0VwVlJVVlJSMEU9fNXschLMFQtEogQo2AlJu4wfSJfLrsk994FwSGUhp-_3' http://localhost:37965/api/us...其中header参数smart-assistant-token值为绑定成功后的token, 请求url path(/api/users/:id)中的路径参数id为绑定成功后返回的用户id。
Copy
设置成功后返回:
{"status":0,"reason":"成功"}
Copy
当用户账号和密码设置成功后打开浏览器,访问 http://localhost:9020 即可体验SA了。
5.2 SA体验演示#
使用账号密码登录
登录成功后,切换到我的
点击支持品牌,界面中会列出SA内置的一些插件
点击其中的一个插件对插件进行安装
图. 添加插件
图. 成功添加插件
插件添加成功后,返回到首页家居,点击右上角+按钮就可以添加插件支持的设备
选中其中的一个设备点击添加,添加完成后返回到首页的家居即可对设备进行操控
图. 设备添加成功
图. 控制设备
- 进一步了解#
如果您手上有智汀家庭云支持的硬件设备,可以安装第三方插件,然后通过智汀APP接入您的设备。
智汀家庭云是一个开源项目,如果如果您熟悉 go 编程语言,想进一步了解我们的项目,可以访问开发环境搭建
智汀家庭云提供插件系统支持第三方设备接入,如果您的设备不在我们的支持列表,可以参考 开发您的第一个插件了解插件开发相关内容。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。