用途:ez-ssh 用于通过 SSH 登录 Home Assistant(HA)主机,访问配置文件、日志并执行系统级命令。当用户要求以 SSH 方式连接 HA、检查主机级文件或运行系统命令时使用。
主要能力:可连接 HA 主机并读取其配置目录、日志与系统信息。资料列出的常见 HA 主机路径包括:/root/config/ 或 /config/(主配置目录,含 automations.yaml、scripts.yaml 等)、/root/config/custom_components/(HACS/自定义集成)、/root/config/.storage/(HA 内部存储,如实体与设备注册表)、/root/config/secrets.yaml(密钥,切勿暴露其值)、/mnt/data/supervisor/(Supervisor 数据,含插件配置与备份)、/mnt/data/supervisor/addons/local/(本地插件源码)。
使用方式:需要具备对 HA 主机的 SSH 访问权限,并设置环境变量(或 .env 文件):HA_SSH_HOST(HA 机器的 IP 或主机名)、HA_SSH_PORT(SSH 端口,默认 22)、HA_SSH_USER(SSH 用户,默认 root)。需提供可用的 SSH 密钥(如 ~/.ssh/id_ed25519 或 ~/.ssh/id_rsa)。快速连接命令:ssh -o StrictHostKeyChecking=no -p ${HA_SSH_PORT:-22} ${HA_SSH_USER:-root}@${HA_SSH_HOST}。在 ez-ha 插件内部,别名 ssh-ha 会自动执行该操作。
常用主机命令:ha core restart(重启 HA 核心)、ha core logs(跟踪 HA 核心日志)、ha host info(主机 OS 信息)、ha network info(网络配置)、ha addons list(列出已安装插件)、journalctl -f(跟踪系统日志)、docker ps(查看运行中的容器,HAOS 使用 Docker)。
限制与注意事项:编辑文件前应先读取;进行较大改动前先备份,如 cp file file.bak;编辑 YAML 配置后先校验再重启;不要暴露 secrets.yaml 中的值。资料未提供其他功能、收费或平台信息。