Backrest项目SFTP连接Hetzner存储箱的SSH密钥配置指南

在使用Backrest项目与Hetzner存储箱建立SFTP连接时，可能会遇到SSH认证问题。本文将详细介绍如何正确配置SSH密钥以实现稳定连接。

问题现象分析

当用户尝试通过Backrest UI连接Hetzner存储箱时，虽然命令行工具可以正常连接，但UI界面却返回"Permission denied"错误。这种差异通常表明UI环境下的SSH认证配置存在问题，特别是密钥认证环节。

解决方案详解

1. Docker环境准备

首先需要为Docker容器配置SSH目录绑定挂载：

• 将宿主机目录映射到容器内的/root/.ssh路径
• 确保容器内SSH目录权限正确(root用户拥有)

2. 建立初始SSH连接

通过Docker控制台连接到Hetzner存储箱：

• 确认Hetzner控制面板已启用SSH访问
• 首次连接会自动生成known_hosts文件，记录服务器指纹

3. SSH密钥生成与配置

使用PuTTYGen工具生成密钥对：

• 选择RSA或Ed25519算法
• 生成后将私钥导出为OpenSSH兼容格式
• 将私钥文件(如HetznerPriv)放入容器SSH目录

4. SSH客户端配置

在容器内创建/root/.ssh/config文件，内容示例：

Host hetzner-box
    HostName 存储箱域名.your-storagebox.de
    User 用户名
    IdentityFile ~/.ssh/HetznerPriv

关键配置说明：

• Host: 自定义连接别名
• HostName: 存储箱完整域名
• User: Hetzner提供的用户名
• IdentityFile: 私钥文件路径

5. 权限设置

执行以下命令确保安全权限：

chmod 600 /root/.ssh/HetznerPriv
chmod 600 /root/.ssh/config
chmod 600 /root/.ssh/known_hosts

权限说明：

• 600权限确保只有所有者可读写
• 防止其他用户访问敏感密钥文件

Backrest连接配置

完成上述步骤后，在Backrest UI中使用以下格式连接：

sftp:hetzner-box:目标目录

进阶建议

1. 密钥管理：

• 考虑使用密码保护私钥
• 定期轮换密钥对增强安全性

2. 连接测试：

• 先用命令行测试连接：sftp -v hetzner-box
• 查看详细日志定位问题

3. 容器持久化：

• 将SSH配置纳入Docker镜像或使用持久化卷
• 避免容器重建后配置丢失

通过以上步骤，可以解决Backrest与Hetzner存储箱间的SSH认证问题，实现稳定可靠的SFTP连接。