Home Assistant Git Pull 插件SSH密钥格式问题解析与解决方案

最新推荐文章于 2025-06-28 09:09:15 发布

原创最新推荐文章于 2025-06-28 09:09:15 发布 · 403 阅读

6 ·

CC 4.0 BY-SA版权

Home Assistant Git Pull 插件SSH密钥格式问题解析与解决方案

addons :heavy_plus_sign: Docker add-ons for Home Assistant 项目地址: https://gitcode.com/gh_mirrors/add/addons

问题背景

在使用Home Assistant的Git Pull插件时，许多用户遇到了SSH密钥格式导致的认证失败问题。该插件在配置界面自动生成的YAML格式会将SSH私钥以特定的折叠方式呈现，而这种格式会导致SSH客户端无法正确解析密钥文件。

问题现象

当用户通过GUI界面添加SSH私钥时，插件会自动生成如下格式的YAML配置：

deployment_key:
  - >-
    -----BEGIN OPENSSH PRIVATE KEY-----
    b3BlbnNzaC1rZXktdjEAAAAABG5vbmUAAAAEbm9uZQAAAAAAAAABAAAAMwAAAAtzc2gtZW
    QyNTUxOQAAACAjwLVL5pTg4dDLVKFLdg937uVedACrI66pEelMAeifkgAAAJhX6wwjV+sM
    IwAAAAtzc2gtZWQyNTUxOQAAACAjwLVL5pTg4dDLVKFLdg937uVedACrI66pEelMAeifkg
    <REDACTED>
    <REDACTED> ----END OPENSSH
    PRIVATE KEY-----

这种使用>-的YAML折叠格式不会在行尾添加换行符，而SSH私钥文件严格要求以换行符结束。当SSH客户端尝试加载这样的密钥时，会抛出"error in libcrypto"错误，导致Git操作失败。

技术分析

YAML折叠规则：>-是YAML中的折叠块标量指示符，它会将多行内容折叠成单行，并去掉末尾的换行符。
SSH密钥格式要求：OpenSSH私钥文件有严格的格式要求，必须包含完整的BEGIN/END标记，并且每个标记必须独占一行并以换行符结束。
插件行为：Git Pull插件的配置界面会自动格式化输入的SSH密钥，即使用户尝试手动添加换行符，保存后也会被自动移除。

解决方案

经过验证，以下YAML格式可以正确工作：

deployment_key:
  - "-----BEGIN OPENSSH PRIVATE KEY-----"
  - b3BlbnNzaC1rZXktdjEAAAAABG5vbmUAAAAEbm9uZQAAAAAAAAABAAAAMwAAAAtzc2gtZW
  - QyNTUxOQAAACAjwLVL5pTg4dDLVKFLdg937uVedACrI66pEelMAeifkgAAAJhX6wwjV+sM
  - IwAAAAtzc2gtZWQyNTUxOQAAACAjwLVL5pTg4dDLVKFLdg937uVedACrI66pEelMAeifkg
  - <REDACTED>
  - <REDACTED>
  - "-----END OPENSSH PRIVATE KEY-----"

这种格式的特点：