概述

Shelly 设备提供本地网页界面，允许您通过电脑或移动设备上的标准网页浏览器控制和配置您的设备。通过该界面，您可以打开或关闭连接到设备的电器，设置定时任务，并配置在满足特定条件时执行的操作。

请注意，您无需互联网连接或Shelly Cloud即可使用本地网页界面——唯一的要求是您的浏览器必须与您的Shelly设备处于同一Wi-Fi网络。

访问网页界面

访问网页界面的方法：

1. 将您的设备连接到名称（SSID）符合以下格式的Wi-Fi网络："DeviceName-XXXXXXXXXX"，其中‘DeviceName’是您想要连接的设备名称，‘XXXXXXXXXX’代表由字母和数字组成的唯一设备ID。

2. 在建立与设备的接入点/ AP（在第1步中提到的Wi-Fi网络），访问网页界面的方法是输入所有Shelly设备通用的IP地址 192.168.33.1连接后，在浏览器中打开。

您现在已进入设备的网页界面。

将您的设备连接到Wi-Fi网络

网页界面中显示的一些设置仅在设备连接到互联网时可用。请按照以下步骤操作：

1. 在网页界面中，导航至设置>Wi-Fi。

2. 输入或选择您偏好的Wi-Fi网络，然后输入其密码。或者，您也可以选择连接到开放网络，只需勾选连接到开放Wi-Fi网络的复选框即可。此外，建议设置静态IP地址。

3. 请等待几秒钟，让您的设备尝试连接到您提供的Wi-Fi网络。如果您输入的密码不正确，或者Wi-Fi网络信号强度或稳定性不足，网页界面会显示一条消息，通知您无法建立连接。成功连接Wi-Fi后，包含新IP地址的链接会以文本形式显示在Wi-Fi设置上方。只需复制并粘贴该链接到您的浏览器即可。

您现在已进入联网设备的网页界面。下次需要访问网页UI时，只需连接到与设备相同的Wi-Fi网络，并输入在第3步获得的新IP地址。建议设置静态IP地址，以确保始终可以通过该地址访问。

了解布局

网页界面可分为四个主要部分——页眉、页脚、主菜单和主内容。

页眉

标题由两个部分组成——左侧是您的设备名称，右侧是几个图标，显示您设备的主要网络和连接功能。这些图标可以包括如Wi-Fi、Bluetooth、MQTT等功能，以及一个显示设备是否有新固件更新的图标。将鼠标悬停在图标上可以获得更多信息。每个设备的网页界面指南中都包含了图标含义的说明。请注意，各自的指南只会解释该设备支持的连接功能。

页脚

屏幕底部从左到右依次显示设备型号名称、设备ID、网页界面版本、设备固件版本，最后是当前时间。如果时间未同步，屏幕顶部会收到通知，某些计划和操作可能无法正常工作。某些旧版本的网页界面不包含所有这些组件。

主菜单

桌面版网页界面的主菜单位于左侧，而移动版则显示为一个汉堡菜单，图标为三条水平线叠加。菜单内容因设备而异，点击菜单项会跳转到不同页面。您也可以通过点击主页.

返回主页。

主内容

点击主菜单中的项目，您可以在网页界面中导航。屏幕上除页眉、页脚和主菜单外的所有内容均视为主内容。

*请注意，网页界面指南页面顶部显示的网页界面截图（如有截图）不一定是最新版本。因此，它们可能与最新版本略有不同，且不代表所有设备网页界面的外观。

以下是主菜单中每个设置的说明，包括点击不同设置后显示为主内容的内容。首页说明中还简要介绍了本设备专属的顶部图标。请注意，顶部栏在所有页面中都会显示，不仅仅是在首页。

主菜单

在网页界面中，您会在标题栏看到五个图标，包括AP、Wi-Fi、Bluetooth、云端和MQTT连接。不同状态颜色的含义如下：

主页AP 图标： 灰色：AP模式已禁用。

Wi-Fi蓝色：AP模式已启用。 灰色：Wi-Fi连接已禁用。 白色：Wi-Fi连接已启用，但尚未建立。 蓝色：设备已连接到Wi-Fi。

Bluetooth 图标： 图标： 灰色：连接已禁用。

蓝色：连接已启用。云端 灰色：已禁用与Shelly Cloud的连接。 白色：已启用与Shelly Cloud的连接，但尚未建立。 蓝色：设备已连接到Shelly Cloud。

MQTT 图标： 灰色：MQTT 已禁用。 蓝色：MQTT 已启用。

Firmware 更新 图标： 图标： 蓝色：设备有新的稳定固件版本。

灰色：Websocket未连接。

输出设置

名称

为输出命名/重命名。

输入/输出设置

• 选择输入模式：按钮

• - 每次按下按钮切换设备输出状态。开关

• - 开关位置对应设备输出状态。模拟

（并非所有设备均有此选项）- 使用模拟输入，设备根据输入百分比确定亮度百分比。:

• 设置输出类型切换开关（仅限开关） - 设备将作为翻转开关，具有一个开启状态和一个关闭

• 状态。如果输入为模拟模式，设备将跟随模拟输入状态。瞬时开关（仅限按钮） - 每次按下按钮切换设备输出状态。如果开关为开启，则切换为关闭

• ，反之亦然。边缘开关（仅限开关）

• - 每次切换开关位置都会切换设备输出状态。分离开关

- 输入与输出分离（分开），不会影响输出。基本上，您无法通过输入控制灯光。:

上电动作

• 此设置通常用于断电后恢复供电时的设备行为。开启

• - 设备上电后将开启。关闭

• - 设备上电后将关闭。恢复输出/继电器的最后已知状态

• - 设备上电后，输出状态将恢复为上次设备开启时的状态（断电前）。开关当前状态（仅限切换开关） - 跟随开关状态，开关切换至开启时设备开启，切换至.

关闭

时设备关闭。

当您使用第三方智能家居系统控制您的设备时，建议参考其文档或用户指南，以确定此字段需要输入什么内容。第三方系统的文档通常会说明建立与 Shelly 设备通信所需的参数、凭证或其他详细信息。

但是，如果您仅使用 Shelly 应用控制设备，可以忽略消耗类型此设置在将设备集成到第三方家庭自动化系统时相关。目的是指定外部系统与设备交互所需的信息或配置。

外部消耗类型字段。应用程序不需要额外配置，因为它内置了与设备通信和控制的机制。如果您出于任何原因希望从设备设置中移除外部消耗类型，只需将外部消耗类型按钮。这样做会有效禁用外部用电类型，并恢复设备的默认行为，或仅依赖 Shelly 应用进行控制和自动化。

LED指示模式

字段留空并点击保存设置您可以选择三种模式之一：功率消耗、开关状态或完全关闭模式下，LED状态灯将保持常亮，并消耗少量电力。在。如果选择模式下，LED状态灯会根据设备的开关状态亮起或熄灭。如果选择功率消耗模式，LED状态灯将完全关闭。

除了这些模式外，您还可以自定义LED灯在开启和关闭时的颜色，以及灯光的亮度。

LED灯的颜色会根据负载从绿色变为红色。它以0%到最大负载为范围，您可以保持默认设置，也可以在开关状态完全关闭保护).

• 将其调整为较低的数值。

• 在0%负载时，LED灯为绿色。

• 在100%负载（设定的过流值）时，LED灯为红色。

在50%负载时，LED灯为黄色。

• 设置（查找

• 过流

在0%到50%之间，颜色从绿色过渡到黄色。

在50%到100%之间，颜色从黄色过渡到红色。

分离开关

• 选择附加或分离开关。如果选择分离开关，设备输出不会受输入影响。启用分离开关时，设备只能在线控制。- 配置 Shelly 开关继电器，在功耗达到某一数值时关闭。允许的最大功率值等于最大电流乘以最大电压。

• 保护瓦特过载

• 安培过流 - 如果供电电流超过某一值，通道将被关闭。

电压过高

- 如果供电电压超过某一值，通道将被关闭。

重置计数器

将所有输入读数设为0。

动作

配置设备动作——创建新动作、编辑现有动作或删除动作。创建动作时需指定动作触发条件。您还可以设置动作持续时间及满足条件时触发的URL。

计划此功能需要设备连接互联网以同步时间。允许您创建、查看、编辑和删除计划。计划分为两种类型：基础.

和高级创建

• 基础

• 计划：

• 选择星期几。

  • 选择时间区间：时间、日出或日落。

  • 日落/日出：Shelly 设备可在日出/日落时自动开/关（或执行指定操作），也可在日出/日落前后指定时间自动执行。点击上下按钮或输入数字，以小时和分钟设置时间。

设置指定日期的时间：时间：点击上下按钮或输入数字，设置小时和分钟。创建

高级计划：高级计划功能使用

cron通过单个计划执行任务，而非多个基础计划。创建高级计划与基础计划不同，因其

执行时间菜单。您需选择一个或多个值、值范围或步长（通过点击选择、范围或

• 步长

• 按钮选择）用于：

• 秒（0-59）

• 分钟（0-59）

• 小时（0-23）

• 日期（1-31）

月份（1月-12月）

星期几（日-六）要创建每秒/分钟/小时/天/月/星期执行的计划，只需勾选相应部分（秒、分钟、小时、天、月或星期）下方的框。您还可以通过勾选日出/日落偏移框启用偏移，弹出小时和分钟菜单。保持小时和分钟不变并选择日出或日落，计划将在日出或日落时执行。修改小时和分钟值将创建偏移，输入负值表示计划在日出/日落前[设定小时和/或分钟]执行，输入正值表示在日出/日落后[设定小时和/或分钟]执行。小时和分钟不能一正一负。之后，在执行动作部分指定设备执行的动作。完成后点击

保存

保存新计划。

在计划菜单中，您可以查看所有计划。可选择以基础或高级时间查看。基础时间显示计划执行的时间和日期，高级时间在计划卡片中显示文本，提示点击查看更多信息。

两种视图均显示动作。若动作超过三个，显示为+n，n为未显示的动作数量。使用右侧切换按钮开启/关闭计划。

• 定时器允许自动管理电源。您可以使用：

• 自动开启：关闭后，继电器输出将在预设时间（秒）后自动开启。

自动关闭：

开启后，继电器输出将在预设时间（秒）后自动关闭。

• 设置网络设置

• Wi-Fi - 注册Shelly设备以连接最多2个不同的Wi-Fi网络。

  可以通过在文本框中输入或点击下拉箭头图标浏览所有可用网络来选择Wi-Fi网络。可选择开放网络，也可设置静态IP地址。

  启用Wi-Fi 1、Wi-Fi 2，或同时启用两者（通过每个旁边的切换按钮）。如果同时启用Wi-Fi 1和Wi-Fi 2，并且Shelly设备从其中一个网络断开连接，它会自动连接到另一个网络。只有在设置了网络名称（SSID）后，才能启用Wi-Fi。如果设备没有其他可用连接（AP、Bluetooth、以太网（如适用）或第二个Wi-Fi网络），尝试禁用Wi-Fi时会弹出提示，询问您是否要继续。

• Bluetooth - 通过切换开关来禁用/启用Bluetooth。设备的默认Bluetooth设置为启用。

接入点

- 配置设备AP，包括开关（通过切换按钮）和设置密码。设备接入点默认是开放网络。SSID唯一且不可更改。连接性

• RPC通信注意事项- 将您的 Shelly 连接到云端后，您可以远程控制设备，并接收设备的通知和更新。此设置默认启用云端。如果您禁用设备的云端支持，将无法在本地网络外连接到您的设备！

• MQTT - 配置 Shelly 设备通过 MQTT 执行操作。默认情况下，MQTT 是禁用的，但您可以通过切换开关来启用它。更改这些设置会导致设备重启。还有其他一些设置，例如 通过MQTT进行RPC状态通知：当RPC调用执行失败时，会出现横幅消息，通知设备未及时响应且连接丢失。连接恢复后，请求将重新发送。通过MQTT进行通用状态更新云端

• （允许通过RPC通知与设备通信）和 - 指定当 HTTP 通道在 servlet 仍在使用时关闭入站连接时，是否创建 I/O 异常。默认情况下，此设置处于禁用状态。要启用它，请点击旁边的切换开关（获取整体状态更新），可通过右侧开关启用/禁用。您还可以启用SSL并输入服务器、用户名和密码，但启用SSL会影响电池寿命，可能缩短一半。出站Websocket启用。在文本框中输入服务地址，并在*SSL连接下拉菜单中选择、ca.pem.

• 或user_ca.pem范围扩展器 该功能会创建一个热点，您可以将Wi-Fi设备连接到该热点。如果启用了范围扩展器的Shelly设备已连接到Wi-Fi路由器和互联网，则所有连接到它的设备也会连接到路由器和互联网。
  即使Shelly设备未连接到Wi-Fi路由器，所有连接到它的设备仍然可以与它以及彼此通信。下方显示的是已连接AP客户端的信息——包括数量、它们的IP配置、MAC地址，以及内部和外部IP地址。

• - 启用范围扩展器

  RPC通过UDP

  - 通过用户数据报协议（UDP）服务器使用远程过程调用（RPC）与设备通信并发送请求。适合远程控制和监控设备，无需专用服务器或连接。

使用此设置需输入UDP服务器的监听端口和目标地址。监听端口是设备监听传入请求的端口号，目标地址是请求发送的服务器IP地址。

• 输入所需信息后，可使用RPC over UDP协议向设备发送请求并接收响应。- 查看您的设备ID、所连接的Wi-Fi以及Wi-Fi RSSI设备设置

• 设备名称（信息）。重启 - 点击重启按钮后，会询问是否确认重启设备。点击确定重启设备，点击

• 取消则不重启。恢复出厂设置 - 点击重置按钮后，设备设置将恢复默认，所有更改将被撤销。弹窗中点击确定确认恢复出厂设置，点击

• 取消取消。位置和时区 - 时区和位置将自动检测，您也可手动从下拉菜单选择时区并输入经纬度。还有一个

如果设备时间未与当前时间同步，计划和操作可能无法按预期运行。若时间未同步，系统会显示提示信息。

• 自动检测位置按钮，若上次检测失败，可再次自动检测。

• Firmware 认证 - 启用认证后，访问设备网页界面需输入密码。启用后，禁用需点击切换按钮并在提示时输入认证密码。 - 此设置显示设备ID、固件版本、构建ID和网页构建ID。可通过固件ID或网页构建ID上方的

• 用户证书（TLS 配置）复制按钮复制内容。还可查看新版本、检查更新并轻松更新设备。支持上传自定义固件，但刷写自定义固件将永久失去设备保修。 - 通过拖放文件或点击指定按钮浏览文件，上传自定义证书颁发机构、客户端证书和客户端密钥。点击上传上传文件，点击

• 清除移除不想上传的文件。节能模式 - 通过降低CPU频率和调制解调器活动减少设备能耗。启用此设置，点击启用节能模式旁的切换按钮，然后点击

• 应用保存更改。调试.

- 包含Mqtt、Websocket和Udp调试。启用任一项，点击对应切换按钮。Udp调试需输入

本设备支持脚本功能。您可以利用该功能根据用户的具体需求自定义和增强设备功能。这些脚本可以考虑设备状态、与其他设备通信，或从天气预报等外部服务获取数据。脚本是一种用 JavaScript 子集编写的程序。

Udp地址脚本在网页界面中，进入

脚本菜单，可查看现有脚本，若无可创建新脚本或打开库浏览已有脚本。每个脚本旁显示状态（运行或停止）及启动时运行的切换按钮。脚本有错误时，最后保存的错误会显示在脚本名下。编辑脚本时，控制台显示在下方，错误信息也会弹出。代码区上方有保存、启动/停止和删除按钮。还可点击对应标签访问代码片段和

文档

。

组件创建组件组件设置允许用户创建

动态组件

• ，即设备中初始不存在的组件。虚拟组件是动态组件的一种，用于在脚本或运行间存储或传输数据，并在主页显示脚本功能。组件可分组，只有组及其内组件会显示在主页。未分组组件不会显示。每设备组件和组件组数量有限制。创建组件步骤：点击创建新建按钮，位于

• 用户定义组件旁。选择要创建的组件类型——布尔、数字、文本、枚举或按钮。创建后，每种组件类型都有名称、视图和自定义图标URL字段，需填写。

自定义图标URL

字段非必填，可用于自定义主页组件外观。可重命名或删除组件，也可为其创建动作，按钮位于组件旁。不同组件类型可能有特定附加字段，详见下文。布尔组件类型存储真/假值，用户可为真或假值分别输入两个标题及两个图标。默认值下拉菜单包含设备不同状态。视图选项有隐藏、切换和标签。切换视图显示切换按钮，点击切换组件值。标签

视图显示组件值标题。数字组件类型存储-999999999999999至999999999999999之间的数值。默认值应在此范围内。可更改单位和步长。视图选项有隐藏、输入框、滑块、进度条和标签。输入框视图显示输入字段，标签视图显示数值，进度条视图以视觉方式表示进度，滑块视图显示滑块界面供交互。

文本组件类型存储最多255字符的字符串。视图选项有隐藏、输入框、标签和图片。输入框视图显示输入字段，标签视图显示标题，图片视图需URL值，用于显示图片。枚举

组件类型存储一组命名常量。视图选项有隐藏、下拉菜单和标签。选择标签视图时，组件默认显示标题，但若指定图片，则优先显示图片。按钮组件类型提供模拟虚拟输入，允许用户通过点击与界面交互。它通过连接通道发送通知，可用于触发自动化和激活Webhook。具有两种视图选项——

按钮，在主页显示按钮组件，和隐藏。若组件设置为隐藏.

，则主页不显示。否则，组件组将显示在设备输入和/或输出下方，显示组内组件。创建组件组创建组步骤：

点击

用户定义组

• 旁的+，进入组创建菜单。输入组名。选择希望包含在组内的组件。

• 通过

• 旁的铅笔图标编辑组菜单，可通过上下箭头调整组顺序。

组件动作+动作菜单现按组件类型分类。您可为组件创建动作，动作将分为上述五类。

脚本编写

组件可包含在脚本中，根据条件编程改变值。指定脚本中的组件需使用其ID。组件ID从200开始，限制至299。可在

组件

菜单查看组件ID。BTHome组件旁的

BTHome组件

BTHome组件允许您创建与发出BTHome数据包的真实设备（如Shelly BLU设备）配对的虚拟/动态组件。要使用BTHome组件，必须首先建立成功的Bluetooth连接。如果Bluetooth观察器被禁用，系统会显示一条消息通知您，并提供一个按钮以启用它并重启您的设备。

连接建立后，若要添加BTHome（Bluetooth）设备，请点击+扫描按钮重新扫描。扫描到的设备会显示在按钮下方。设备需处于。设备将扫描可用的Bluetooth设备，但你也可以点击你选择的Bluetooth设备旁边的配对模式（长按设备按钮）才能被扫描到。另一种添加设备方式是使用MAC地址，点击按MAC地址添加设备并输入设备MAC地址。添加传感器，点击配置

自定义图标URL以自定义主页中BTHome组件外观。加密密钥用于数据包解密，可通过。在此界面，你可以为你的BTHome（Bluetooth）设备命名，添加加密密钥，并输入应用程序获取。Shelly BLU 调试 加密密钥字段下方列出支持的传感器，点击想添加的传感器旁的

符号+添加。添加后，传感器旁出现铅笔图标，点击可编辑名称、添加自定义图标URL，或点击垃圾桶图标删除传感器。

保存BTHome组件，点击保存设置。删除组件，点击文本字段上方的垃圾桶图标。

编辑BTHome组件，点击齿轮图标，进入设置界面，与添加组件时相同。

高级设置

点击此设置旁的箭头展开高级设置，详见下文。

KVS

KVS代表键值存储，是一种非关系型数据库，使用简单的键值方法存储数据。每个设备最多存储50个键值对。点击添加值按钮进入值创建界面，输入键（最多42字符）和值（最多253字符）。值文本框下方显示当前值类型。默认值类型为数字，输入文本时类型变为字符串。点击保存保存键。编辑现有值，点击该值。删除键值对，编辑时点击下方删除按钮。点击设置名称旁的问号可查看API文档，了解更多KVS适用于 Shelly 设备。

信息。

诊断

HTTP ping

在指定的文本字段中输入一个 URL，以便从您的设备向其发送 HTTP 请求。网页界面随后会告知您该请求是成功还是失败。

此设置允许下载调试日志。无故启用调试日志不推荐，会降低设备速度并加速闪存老化。启用后可下载之前和当前日志。离开此页面将重置日志记录器和日志数据。

设备客户端

• Bluetooth客户端 - 通过Bluetooth连接到你的设备的设备。

• 查看连接到设备的客户端，按类别排序。大多数设备有两种选项：AP客户端

- 连接到设备接入点的设备。