如何在Spring Boot+Apache SSHD中从字符串加载私钥？

架构老林

2026-8-20

从字符串加载Apache SSHD私钥（复用已有格式解析逻辑）

核心思路

Apache SSHD的KeyPairResourceLoader并非只能从文件路径加载密钥，它支持通用的Resource接口。我们可以把GitLab环境变量提供的私钥字符串转换成内存资源，直接复用框架已有的密钥格式解析能力，无需自行实现多格式兼容逻辑。

实现步骤

从环境变量获取私钥字符串
从GitLab环境变量中读取私钥，注意还原转义的换行符：

String privateKeyStr = System.getenv("SSH_PRIVATE_KEY");
// 修复环境变量中可能被转义的换行符
privateKeyStr = privateKeyStr.replace("\\n", "\n");

将字符串转为SSHD可识别的Resource
使用Apache SSHD自带的ByteArrayResource（无需依赖Spring），把字符串转为内存资源：

import org.apache.sshd.common.io.resource.ByteArrayResource;
import org.apache.sshd.common.io.resource.Resource;

Resource privateKeyResource = new ByteArrayResource(
    privateKeyStr.getBytes(StandardCharsets.UTF_8),
    "gitlab-provided-ssh-key" // 资源名称，仅用于标识
);

复用KeyPairResourceLoader加载密钥
调用loadKeyPairs的重载方法，传入内存资源即可自动解析主流密钥格式：

import org.apache.sshd.common.keyprovider.KeyPairResourceLoader;
import org.apache.sshd.common.util.security.SecurityUtils;
import org.apache.sshd.common.password.PasswordProvider;

KeyPairResourceLoader loader = SecurityUtils.getKeyPairResourceParser();
// 若私钥有密码，从环境变量读取并提供PasswordProvider；无密码则传null
PasswordProvider passwordProvider = () -> System.getenv("SSH_KEY_PASSWORD").toCharArray();
Collection<java.security.KeyPair> keys = loader.loadKeyPairs(null, privateKeyResource, passwordProvider);