Home Assistant 的 hassio.app_start 动作按需启动 Add-on 应用的完整指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读hassio.app_start是 Home Assistant 中用于**启动一个已安装应用app即 Add-on**的内置动作。它最常见的价值在于按需运行例如在晚间才启动下载客户端、用完即停让资源只在真正需要时被占用。读完本文你将掌握如何通过 UI 向导与 YAML 两种方式调用该动作理解app参数的取值方法并能在自动化与脚本中组合app_start/app_stop/app_restart实现完整的应用生命周期管理。本文以 hassio.app_start 动作文档 为核心骨架展开并参考了同目录下 hassio.app_stop、hassio.app_restart、hassio.app_stdin 等配套动作文档。动作概览hassio.app_start的作用是启动一个已安装的 Home Assistant 应用App。原文档给出的典型使用场景是只在需要时才启动某个应用例如在晚上启动下载客户端早上再将其停止。action: hassio.app_start data: app: core_sshdomainhassioaction 名称hassio.app_start参数app必填string 类型应用 slug需要说明的是原文档中app这一术语即指 Home Assistant 中的Add-on 应用官方文档语境下{% term app %}即应用/Add-on 的同义表述。在Settings Add-ons设置 加载项页面中可以查看、安装与管理这些应用。从用户界面UI使用此动作如果你更倾向于以可视化方式构建自动化和脚本Home Assistant 会一步步引导你完成此动作的设置——选择目标、微调选项、保存即可无需任何 YAML 知识此段文案来自 actions/ui_header.md 模板。按照原文档在自动化或脚本中启动应用的步骤如下进入设置 自动化与场景Settings Automations scenes。打开现有的自动化或脚本或选择创建自动化 创建新自动化Create automation Create new automation。如果是在创建新的自动化请在当...时When部分添加一个触发器。脚本不需要触发器——它们在被其他内容调用时才运行。在然后执行Then do部分选择添加动作Add action。搜索并选择启动应用Start app。选择要启动的应用App。点击保存Save。UI 中的选项选项描述必填App要启动的应用。是在 YAML 中使用此动作如果你直接在 YAML 中工作或者想确切了解 Home Assistant 在底层做了什么本节提供了技术参考列出 YAML 中使用的字段名、类型以及哪些字段是必填的此段文案来自 actions/yaml_header.md 模板。在 YAML 中此动作写作hassio.app_start。一个基本示例如下action: hassio.app_start data: app: core_ssh提示请使用应用的slug应用标识符你可以在设置 加载项Add-ons页面上找到它。YAML 中的选项字段描述必填类型app要启动的应用的 slug。是string注意事项Good to know原文档明确给出了两条关键限制在实际使用前务必确认仅管理员可以运行此动作Only administrators can run this action。此动作仅在 Home Assistant Operating SystemHAOS或 Supervised 安装方式下可用在Home Assistant Container或Home Assistant Core安装方式下不可用。这意味着如果你的部署方式是纯 Docker 容器或纯 CorePython 虚拟环境安装将无法通过该动作管理 Add-on 应用——这正是因为 Add-on 生态本身依赖 Supervisor 来管理容器生命周期。更多示例夜间启动下载应用原文档附带了一个完整的自动化场景——在互联网相对空闲的夜晚启动下载客户端触发器Trigger时间23:00动作Action启动应用点击展开查看完整 YAMLautomation: alias: Start downloads at night triggers: - trigger: time at: 23:00:00 actions: - action: hassio.app_start data: app: a0d7b954_transmission可以看到app字段使用的是 Transmission 下载客户端的sluga0d7b954_transmission而不是显示名称。第三方 Add-on 的 slug 通常带有仓库前缀如上例中的a0d7b954_这是由其托管仓库决定的官方 Add-on如core_ssh、core_mosquitto则通常以core_开头。相关动作完整的应用生命周期管理原文档在 front matter 中声明了三个相关动作related_actions它们与本动作配合使用可以组成完整的启动-停止-重启-交互闭环动作说明典型用途hassio.app_stop停止一个正在运行的应用与app_start配对让应用只在需要的时段运行例如早晨 07:00 停止下载客户端避免与白天上网争抢带宽hassio.app_restart重启一个正在运行的应用按计划定时重启或在应用失去响应时恢复它而无需重启整个 Home Assistanthassio.app_stdin向运行中的应用的标准输入stdin发送数据向支持 stdin 交互的应用发送命令或输入例如将app_start与app_stop组合即可实现晚上启动、早上停止的完整自动化automation: alias: Downloads on schedule triggers: - trigger: time at: 23:00:00 id: start - trigger: time at: 07:00:00 id: stop actions: - choose: - conditions: - condition: trigger id: start sequence: - action: hassio.app_start data: app: a0d7b954_transmission - conditions: - condition: trigger id: stop sequence: - action: hassio.app_stop data: app: a0d7b954_transmission还在纠结去社区求助官方文档为遇到困难的使用者提供了求助渠道加入 Discord 模板。小结hassio.app_start是 Home Assistant 自动化体系中管理 Add-on 应用生命周期的基础动作。本文完整覆盖了它的 UI 操作路径、YAML 调用语法、app参数的 slug 取值方式、管理员与安装方式限制并结合app_stop/app_restart给出了可复制的组合场景。将本文的示例复制到你的自动化中按需调整 slug 即可立即投入使用。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考