概述

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、Cloud、Ethernet和MQTT连接。不同状态颜色的含义如下：

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

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

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

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

图标：以太网 图标： 灰色：以太网连接已禁用。 白色：以太网连接已启用，但未建立连接。

MQTT蓝色：设备已连接到以太网网络。 灰色：MQTT 已禁用。 蓝色：MQTT 已启用。

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

灰色：Websocket未连接。

在网页界面主页，您将看到设备的两个遮盖板、它们当前状态及名称下的电压，以及位置百分比（0%表示遮盖关闭，100%表示完全打开）。您还可以使用上下箭头和暂停按钮控制遮盖的移动。暂停按钮可在某个位置停止遮盖移动。另一种设置自定义位置的方法是使用每个遮盖下方的百分比滑块。您可以通过点击所选遮盖，调整滑块到精确值，然后点击 添加到收藏夹 按钮，轻松设置到某个百分比。这样会在主页遮盖滑块下方创建一个按钮，方便快速设置该百分比。若要从收藏夹中删除百分比值，只需在主页点击遮盖，在 收藏夹

下点击要删除值旁的垃圾桶图标。

通用设置

遮盖名称

通过设置更改主页显示的遮盖名称。

校准点击此设置中的 校准遮盖

按钮后，设备将开始校准，以便您控制其位置。校准过程中设备正在配置，请确保移除任何可能干扰此过程的障碍物。

反转方向勾选 启用方向反转

允许设备在接线错误时反转开/关逻辑。此操作不会改变网页界面显示，仅影响设备本身。

移动时间限制

设置设备开/关所需的时间限制（秒）。这样，您可以设置遮盖速度更快（较小限制）或更慢（较大限制）。

上电动作设置设备上电时执行的动作。您可以关闭此设置，或选择 恢复上次 以恢复设备上次执行的动作。此外，您还可以选择 匹配输入

，根据连接的开关或按钮状态操作设备。

空闲功率阈值

输入一个瓦特值，低于此值时电机视为停止。这节省电力，因为当设备未主动移动时，电机将停止工作。

输入设置

输入类型

输入模式

• 选择以下之一：按钮

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

- 开关位置对应设备输出状态。某些设备中此设置也称为“开关模式

”。

控制按钮模式

• 选择如何操作设备输入：单一 - 仅通过输入1控制设备。按钮按下时执行的动作依次为：开、停、关。双重 - 通过两个输入分别控制开和关。

• 分离 - 分离按钮模式意味着只能通过网页界面控制设备移动，设备上的按钮无效。

• 交换输入

反转输入逻辑——开输入变为关，关输入变为开。

安全与保护

障碍物检测

障碍物检测使设备在移动时避免碰撞。您可以通过以下设置自定义障碍物检测：

移动方向

• 仅开时 - 仅在遮盖打开时检测障碍物。

  • 仅关时 - 仅在遮盖关闭时检测障碍物。两者 - 设备移动任一方向时均检测障碍物。动作

  • 停止 - 遇到障碍物时设备停止移动。反转 - 遇到障碍物时设备改变移动方向。例如，开始关闭时检测到障碍物，设备将改为打开。安全开关

  • 安全开关功能可用作手动障碍物检测。仅当按钮模式设置为

• 单一

  • 时可用。第二输入变为指定的

  • 安全开关

。

您可以通过以下设置自定义安全开关功能：移动方向仅开时 - 仅在遮盖打开时通过第二输入启用安全开关。仅关时 - 仅在遮盖关闭时通过第二输入启用安全开关。.

两者 - 设备移动任一方向时通过第二输入启用安全开关。

• 动作

  • 停止 - 点击指定安全开关（第二输入）时设备停止移动。反转 - 点击指定安全开关（第二输入）时设备反转移动方向。例如，开始关闭时按下安全开关，设备将改为打开。保护

  • 过功率（瓦特）过电流（安培） - 当供电电流超过设定值时，通道将关闭。

  • 过电压（伏特）

• - 当供电电压超过设定值时，通道将关闭。

  • 欠电压（伏特）

  • - 当电压低于设定值时关闭设备。

过/欠电压自动恢复

• - 如果设备在过/欠电压保护时已开启，保护解除后设备状态将自动恢复。 - 配置 Shelly 开关继电器，在功耗达到某一数值时自动关闭。允许的最大功率值等于最大电流乘以最大电压。

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

• 计划此功能需设备连接互联网以同步时间。允许您创建、查看、编辑和删除计划。

• 计划分为两种类型：基础

• 和高级

创建

基础

计划：

选择星期几。

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

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

• cron

• 通过单个计划执行任务，而非多个基础计划。

• 创建高级计划与基础计划不同，因其包含

  • 执行时间

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

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

、范围或

步长按钮选择）用于：秒（0-59）

分（0-59）时（0-23）日（1-31）月（1月-12月）星期（周日-周六）若要创建每秒/分/时/日/月/星期执行的计划，只需勾选所需部分（秒、分、时、日、月或星期）下方的框。您还可通过勾选日出/日落偏移选项启用偏移，勾选后会出现小时和分钟设置。保持小时和分钟不变并选择日出或日落，计划将在日出或日落时执行。修改小时和分钟值将创建偏移，输入负值表示计划在日出/日落前[设定小时和/或分钟]执行，输入正值表示在日出/日落后[设定小时和/或分钟]执行。小时和分钟不能一正一负。之后，在

• 执行动作

• 部分指定设备执行的动作。完成后点击

• 保存

• 保存新计划。

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

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

脚本

在网页UI中，进入脚本菜单，您将看到现有脚本，若无脚本，可创建新脚本或打开库浏览已有脚本。每个脚本旁显示其状态（运行或停止）及启动时运行的切换开关。若脚本有错误，最后保存的错误会显示在脚本名下。编辑脚本时，控制台位于下方，显示任何弹出的错误。代码区上方有保存

、

启动/停止

和

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

删除选项。您还可点击对应标签访问代码片段

和文档。设置网络设置接入点 - 配置设备的AP，包括开关（通过切换开关）和设置密码。设备的接入点默认是开放网络。SSID唯一且不可更改。以太网连接RPC通信注意事项：当RPC调用执行失败时，会出现横幅消息，通知您设备未及时响应且连接丢失。连接恢复后，请求将重新发送。

云端

（允许通过RPC通知与设备通信）和

• （获取整体状态更新），可通过右侧开关启用/禁用。您还可启用SSL并输入服务器、用户名和密码，但启用SSL会影响电池寿命，可能缩短一半。出站Websocket

• 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设置为启用。

• 启用 - 您可以使用以太网而非Wi-Fi连接设备。与Wi-Fi设置类似，您可以为设备设置静态IP地址（推荐），以便每次都能通过相同的IP地址访问设备。如果启用静态IP，系统会提示您填写IP地址、DNS服务器、网关和子网掩码。

。在文本框中输入服务地址，并在

SSL连接下拉菜单中选择

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

• MQTT - 配置 Shelly 设备通过 MQTT 执行操作。默认情况下，MQTT 是禁用的，但您可以通过切换开关来启用它。更改这些设置会导致设备重启。还有其他一些设置，例如 通过MQTT进行RPC状态通知ca.pem通过MQTT进行通用状态更新或

• user_ca.pem - 指定当 HTTP 通道在 servlet 仍在使用时关闭入站连接时，是否创建 I/O 异常。默认情况下，此设置为禁用。要启用它，请点击旁边的切换开关。。信号扩展器 - 开启信号扩展器*RPC通过UDP - 通过用户数据报协议（UDP）服务器使用远程过程调用（RPC）与设备通信并发送请求。此功能便于远程控制和监控设备，无需专用服务器或连接。使用此设置需输入UDP服务器的监听端口和目标地址。监听端口是设备监听传入请求的端口号，目标地址是请求发送的服务器IP地址。输入所需信息后，您可使用RPC通过UDP协议向设备发送请求并接收响应。.

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

• 重启 - 点击

  重启

  按钮后，系统会询问是否确认重启设备。点击

确定

• 重启设备，点击- 查看您设备的ID、所连接的Wi-Fi以及Wi-Fi RSSI取消

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

• 取消操作。位置和时区 - 设备会自动检测时区和位置，您也可手动从下拉菜单选择时区并输入经纬度。还有一个自动检测位置按钮，若上次检测失败，可再次自动检测位置。认证 - 启用认证后，访问设备网页UI需输入密码。启用后，禁用需点击切换开关并在提示时输入认证密码。 - 在此设置中，您可查看设备ID、固件版本、构建ID和网页构建ID。点击固件ID或网页构建ID上方的

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

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

• 上传文件，点击清除

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

• 用户证书（TLS 配置）启用节能模式旁的切换开关，然后点击应用保存更改。调试

• - 包含Mqtt、Websocket和Udp调试。启用任一项，点击对应切换开关。启用Udp调试时，还需输入Udp地址显示模式 - 控制设备显示屏亮度。可根据喜好调节显示亮度，也有助于节能，减少不必要的亮度。高级设置点击此设置旁的箭头可展开高级设置，具体说明如下。

• KVSKVS代表.

• 键值存储，是一种非关系型数据库，通过简单的键值方式存储数据。单个设备最多可存储50个键值对。点击

添加值

按钮进入值创建界面，提示输入键（最多42字符）和值（最多253字符）。值文本框下方显示当前值类型。默认值类型为

数字

，输入文本时类型变为字符串。点击保存按钮保存键。编辑现有值，点击该值即可。删除键值对，编辑时点击下方的删除按钮。点击设置名称旁的问号可查看API文档，了解更多关于KVS的信息。诊断在此设置中，您可下载调试日志。无故启用调试日志不推荐，因为会降低设备速度并加速闪存老化。启用后，您还可下载之前和当前日志。离开此页面将重置日志记录器和日志数据。 按钮。要编辑现有值，只需点击它。要删除键值对，请点击 删除 当你编辑密钥时，出现在其下方的按钮。点击设置名称旁边的问号将带你进入API文档，文档中会为你提供更多相关信息。 KVS适用于 Shelly 设备。

诊断

在此设置中，您可以下载调试日志。没有特殊原因，不建议启用调试日志，因为这会导致设备变慢，并加速闪存老化。如果您决定启用，您还可以下载之前和当前的日志。请注意，离开此页面将重置日志记录器和日志数据。

HTTP ping

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