首页 > 文章 > 前端

Shelly设备自动化验证脚本详解

时间：2025-08-28 23:00:47 464浏览收藏

本文介绍了如何使用 Shelly Plus 1 PM 上的脚本，通过用户名和密码验证来控制另一个 Shelly 设备，并着重解决了`Shelly.call("http.get")`无法自动转换 URL 凭据为 HTTP 身份验证标头的问题。文章详细阐述了利用 `HTTP.Request` 手动构建 `Authorization: Basic` 标头的步骤，包括配置信息定义、URL 构建、Base64 编码生成认证信息，以及最终发送 HTTP 请求的过程。通过提供的完整示例代码，读者可以学习如何在 Shelly 设备上实现基于用户名密码的自动化控制，同时文章也强调了替换占位符、错误处理、安全性以及 URL 编码等关键注意事项，旨在帮助开发者更安全有效地利用 Shelly 脚本进行设备控制，满足复杂的身份验证需求。

使用脚本通过身份验证控制 Shelly 设备

本文档介绍了如何使用 Shelly Plus 1 PM 上的脚本，通过用户名和密码验证来控制另一个 Shelly 设备。由于 Shelly.call("http.get") 不会自动将 URL 中的凭据转换为 HTTP 身份验证标头，因此我们需要使用 HTTP.Request 并手动生成 Authorization: Basic 标头。本文提供了详细的代码示例，展示了如何实现这一目标，并解释了关键步骤和注意事项。

使用 HTTP.Request 进行身份验证

当需要通过用户名和密码验证来控制 Shelly 设备时，直接在 Shelly.call("http.get") 的 URL 中包含用户名和密码可能无法正常工作。这是因为 Shelly 的 http.get 方法不会自动将 URL 中的凭据转换为 HTTP Authorization: Basic 标头。为了解决这个问题，我们需要使用 HTTP.Request 方法，并手动构建包含身份验证信息的 HTTP 标头。

以下是如何使用 HTTP.Request 方法进行身份验证的步骤：

定义配置信息： 首先，我们需要定义包含目标 Shelly 设备的 IP 地址、用户名和密码的配置对象。

let CONFIG = {
  host: "your_shelly_ip", // 替换为目标 Shelly 设备的 IP 地址
  username: "your_username", // 替换为用户名
  password: "your_password", // 替换为密码
}

构建 URL： 接下来，构建要发送到目标 Shelly 设备的 URL。

let shelly_url = "http://" + CONFIG.host + "/relay/0?turn=on&timer=10"; // 示例：打开 relay 0 并设置 10 秒定时器

创建 Authorization 标头： 使用 btoa() 函数将用户名和密码编码为 Base64 字符串，并将其添加到 Authorization 标头中。

let user_pass = btoa(CONFIG.username + ":" + CONFIG.password);
let header = {
  method: "GET",
  url: shelly_url,
  headers: {},
  timeout: 20,
};
if (CONFIG.username) {
  header.headers.Authorization = "Basic " + user_pass;
}

使用 HTTP.Request 发送请求： 使用 Shelly.call("HTTP.Request", header, callback, null) 发送带有身份验证标头的 HTTP 请求。

Shelly.call("HTTP.Request", header, function (result, error_code, error_message) {
  if (error_code === 200) {
    print("Success: " + result);
  } else {
    print("Error code: " + error_code);
    print("Errormessage: " + error_message)
  }
}, null);

完整示例代码

以下是一个完整的示例代码，展示了如何使用 HTTP.Request 方法通过身份验证来控制 Shelly 设备：

let CONFIG = {
  host: "your_shelly_ip", // 替换为目标 Shelly 设备的 IP 地址
  username: "your_username", // 替换为用户名
  password: "your_password", // 替换为密码
}

function turnOnShelly() {
  let shelly_url = "http://" + CONFIG.host + "/relay/0?turn=on&timer=10";
  let user_pass = btoa(CONFIG.username + ":" + CONFIG.password);

  let header = {
    method: "GET",
    url: shelly_url,
    headers: {},
    timeout: 20,
  };

  if (CONFIG.username) {
    header.headers.Authorization = "Basic " + user_pass;
  }

  Shelly.call("HTTP.Request", header, function (result, error_code, error_message) {
    if (error_code === 200) {
      print("Success: " + result);
    } else {
      print("Error code: " + error_code);
      print("Errormessage: " + error_message)
    }
  }, null);
}

// 调用 turnOnShelly 函数来打开 Shelly 设备
turnOnShelly();

注意事项

替换占位符： 务必将 your_shelly_ip、your_username 和 your_password 替换为实际的值。
错误处理： 示例代码包含基本的错误处理。在生产环境中，建议添加更完善的错误处理机制。
安全性： 尽量避免在代码中硬编码用户名和密码。可以考虑使用环境变量或其他更安全的存储方式。
URL 编码： 如果 URL 中包含特殊字符，请确保对其进行正确编码。

总结

通过使用 HTTP.Request 方法并手动构建 Authorization: Basic 标头，我们可以成功地通过身份验证来控制 Shelly 设备。这种方法提供了更大的灵活性和控制权，可以满足各种复杂的身份验证需求。希望本文档能够帮助您更好地理解和应用 Shelly 脚本编程。

好了，本文到此结束，带大家了解了《Shelly设备自动化验证脚本详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！