2025.3.4
首页 ▸ Integrations ▸

Vultr

Vultr integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 使您能够从 Home Assistant 访问和与您的 Vultr 订阅（虚拟私人服务器）进行交互。

当前支持以下设备类型在 Home Assistant 内部：

配置

从您的 Vultr 账户 获取您的 API 密钥。

Important

确保您允许 Home Assistant 的公共 IP 地址在访问控制标题下。

要将您的 Vultr 订阅与 Home Assistant 集成，将以下部分添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中。 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# 示例 configuration.yaml 条目
vultr:
  api_key: 你的_API_密钥

Configuration Variables

Looking for your configuration file?
api_key string Required

您的 Vultr API 密钥。

二进制传感器

vultr 二进制传感器平台使您能够监控您的 Vultr 订阅以查看其是否已开启。

配置

要使用此二进制传感器，您首先必须设置您的 Vultr 中心。

Note

以下示例假设一个订阅其 ID 为 123456 且标签为 Web Server

最小的 configuration.yaml （生成 binary_sensor.vultr_web_server）：

# 示例 configuration.yaml 条目
binary_sensor:
  - platform: vultr
    subscription: 123456

Configuration Variables

Looking for your configuration file?
subscription string Required

您想要监控的订阅，这可以在查看服务器时在 URL 中找到。

name string (Optional, default: Vultr {订阅标签})

您想要给这个二进制传感器的名称。

完整示例

完整的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] （生成 binary_sensor.totally_awesome_server）：

binary_sensor:
  - platform: vultr
    name: totally_awesome_server
    subscription: 12345

传感器

vultr 传感器平台将允许您查看当前的带宽使用情况和待付款项对您的 Vultr 订阅的影响。

要使用此传感器，您必须设置您的 Vultr 中心。

Note

以下示例假设一个订阅其 ID 为 123456 且标签为 Web Server

最小的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] （生成 sensor.vultr_web_server_current_bandwidth_used 和 sensor.vultr_web_server_pending_charges）：

sensor:
  - platform: vultr
    subscription: 123456

Configuration Variables

Looking for your configuration file?
subscription string Required

要监控的 Vultr 订阅，这可以在查看订阅时在 URL 中找到。

name string (Optional)

给这个传感器起的名称。

Default:

Vultr {Vultr 订阅标签} {监控条件名称}

monitored_conditions list (Optional, default: 所有条件)

您想要监控的每个订阅的项目列表。

current_bandwidth_gb

当前（发票周期）带宽使用情况，单位为千兆字节（GB）。

pending_charges

当前（发票周期）针对该订阅积累的费用。值为美元（US$）。

使用 {} 格式化条件名称的完整 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] （生成 sensor.server_current_bandwidth_gb 和 sensor.server_pending_charges）：

sensor:
  - platform: vultr
    name: Server {}
    subscription: 123456
    monitored_conditions:
      - current_bandwidth_gb
      - pending_charges

仅监控一个条件的自定义 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] （生成 sensor.web_server_bandwidth）：

sensor:
  - platform: vultr
    name: Web Server Bandwidth
    subscription: 123456
    monitored_conditions:
      - current_bandwidth_used

开关

vultr 开关平台允许您控制（启动/停止）您的 Vultr 订阅。

要控制您的 Vultr 订阅，您首先必须设置您的 Vultr 中心。

配置

最小的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] （生成 switch.vultr_web_server）：

# 示例 configuration.yaml 条目
switch:
  - platform: vultr
    subscription: 你的_订阅_ID

Configuration Variables

Looking for your configuration file?
subscription string Required

您想要控制的 droplets 列表。

name string (Optional, default: Vultr {订阅标签})

您想要给这个开关的名称。

额外示例

完整示例生成 switch.amazing_server，假设一个订阅其 ID 为 123456 且标签为 Web Server：

# 示例 configuration.yaml 条目
switch:
  - platform: vultr
    name: Amazing Server
    subscription: 123456

相关主题