Go语言：将RSA公钥编码为OpenSSH字符串格式并显示教程-Golang-PHP中文网

Go语言：将RSA公钥编码为OpenSSH字符串格式并显示教程

心靈之曲

发布： 2025-11-25 23:46:01

原创

814人浏览过

Go语言：将RSA公钥编码为OpenSSH字符串格式并显示教程

本文将指导如何在go语言中将`rsa.publickey`对象转换为openssh可读格式。通过利用`go.crypto/ssh`库进行公钥编码后，关键步骤是使用base64对生成的字节数组进行编码，从而解决直接转换为字符串时出现的乱码问题，最终实现将rsa公钥以标准的openssh格式在网页或其他界面中清晰展示。

在Go语言中处理加密密钥是常见的任务，其中一项需求是将rsa.PublicKey对象导出为OpenSSH格式的字符串，以便在authorized_keys文件或网页界面中显示。虽然golang.org/x/crypto/ssh库提供了强大的功能来处理SSH相关的加密操作，但初次尝试将公钥转换为字符串时，可能会遇到生成的字节数组无法直接转换为可读字符串的问题。本教程将详细阐述如何正确地完成这一转换。

理解go.crypto/ssh库的公钥编码

golang.org/x/crypto/ssh库提供了一系列用于处理SSH密钥的工具。要将Go原生的rsa.PublicKey转换为OpenSSH兼容的格式，通常会涉及以下两个核心函数：

ssh.NewPublicKey(pub interface{}) (PublicKey, error): 这个函数将一个标准的Go加密库（如*rsa.PublicKey、*ecdsa.PublicKey等）的公钥对象封装成ssh.PublicKey接口类型。这是后续操作的基础。
ssh.MarshalPublicKey(pub PublicKey) []byte: 这个函数接收一个ssh.PublicKey接口对象，并将其序列化为OpenSSH的“线缆格式”（wire format）字节数组。这种格式是二进制的，包含了密钥类型（如ssh-rsa）和密钥数据，但它并非直接可打印的文本格式。

当尝试直接将ssh.MarshalPublicKey返回的[]byte数组转换为string时，由于其中包含非ASCII字符和控制字符，会导致乱码或不可识别的字符，无法满足显示需求。

解决方案：Base64编码

OpenSSH格式的公钥字符串，例如在authorized_keys文件中看到的，其密钥数据部分是经过Base64编码的。因此，解决上述问题的关键在于对ssh.MarshalPublicKey返回的二进制字节数组进行Base64编码。

立即学习“go语言免费学习笔记（深入）”；

Soundful

Soundful Ai音乐生成器，只需一个按钮即可生成免版税曲目

240

查看详情

标准的OpenSSH公钥格式通常遵循以下结构： key-type BASE64_ENCODED_KEY [comment]

其中：

key-type：表示密钥类型，例如ssh-rsa、ecdsa-sha2-nistp256等。
BASE64_ENCODED_KEY：是ssh.MarshalPublicKey生成的二进制数据经过Base64编码后的字符串。
[comment]：是可选的注释，通常用于标识密钥所有者或用途。

实施步骤与示例代码

下面我们将通过一个完整的Go语言示例来演示如何将rsa.PublicKey转换为OpenSSH格式的字符串。

生成或获取rsa.PublicKey: 首先，你需要一个rsa.PublicKey对象。在本例中，我们将生成一个新的RSA密钥对进行演示。
转换为ssh.PublicKey: 使用ssh.NewPublicKey将rsa.PublicKey封装为ssh.PublicKey接口。
序列化为二进制格式: 调用ssh.MarshalPublicKey获取密钥的线缆格式字节数组。
Base64编码: 使用encoding/base64标准库对二进制数据进行编码。
构建最终字符串: 将密钥类型（通过ssh.PublicKey的Type()方法获取）和Base64编码后的密钥数据拼接起来，并添加一个换行符，以符合authorized_keys文件的常见格式。

package main

import (
    "crypto/rand"
    "crypto/rsa"
    "encoding/base64"
    "fmt"
    "log"

    "golang.org/x/crypto/ssh" // 确保导入正确的ssh库
)

// ConvertRSAPublicKeyToOpenSSHFormat 将 rsa.PublicKey 转换为 OpenSSH 格式的字符串
func ConvertRSAPublicKeyToOpenSSHFormat(rsaKey *rsa.PublicKey) (string, error) {
    // 1. 将 rsa.PublicKey 转换为 ssh.PublicKey 接口
    sshPubKey, err := ssh.NewPublicKey(rsaKey)
    if err != nil {
        return "", fmt.Errorf("无法创建 SSH 公钥对象: %w", err)
    }

    // 2. 将 ssh.PublicKey 序列化为线缆格式的字节数组
    // 这个字节数组包含了密钥类型（如 ssh-rsa）和密钥数据，但它是二进制的。
    marshalledBytes := ssh.MarshalPublicKey(sshPubKey)

    // 3. 对序列化后的字节数组进行 Base64 编码，使其可打印
    encodedKey := base64.StdEncoding.EncodeToString(marshalledBytes)

    // 4. 获取密钥类型（例如 "ssh-rsa"）
    keyType := sshPubKey.Type()

    // 5. 拼接成最终的 OpenSSH 格式字符串，并添加一个换行符
    // 格式为: key-type BASE64_ENCODED_KEY [comment]
    return fmt.Sprintf("%s %s\n", keyType, encodedKey), nil
}

func main() {
    // 演示：生成一个新的 RSA 密钥对
    // 实际应用中，你可能从文件或其他来源加载现有的公钥
    privateKey, err := rsa.GenerateKey(rand.Reader, 2048) // 生成2048位的RSA私钥
    if err != nil {
        log.Fatalf("生成 RSA 密钥失败: %v", err)
    }
    publicKey := &privateKey.PublicKey // 获取对应的公钥

    fmt.Println("--- 原始 RSA 公钥对象 ---")
    fmt.Printf("N: %x\n", publicKey.N)
    fmt.Printf("E: %d\n", publicKey.E)

    // 将 RSA 公钥转换为 OpenSSH 格式
    openSSHKey, err := ConvertRSAPublicKeyToOpenSSHFormat(publicKey)
    if err != nil {
        log.Fatalf("转换公钥到 OpenSSH 格式失败: %v", err)
    }

    fmt.Println("\n--- 转换后的 OpenSSH 格式公钥 ---")
    fmt.Print(openSSHKey) // 直接打印，它已经包含了换行符

    // 验证：展示未 Base64 编码的原始字节数组（通常不可直接显示）
    sshPubKey, _ := ssh.NewPublicKey(publicKey)
    rawMarshalledBytes := ssh.MarshalPublicKey(sshPubKey)
    fmt.Printf("\n--- 未 Base64 编码的原始字节数组（示例，通常不直接显示）---\n%v\n", rawMarshalledBytes)
}

登录后复制

运行上述代码，你将得到一个标准的OpenSSH格式公钥字符串，类似于：

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCs... [很长的Base64编码字符串] ...

登录后复制

注意事项

错误处理: 在实际应用中，务必对ssh.NewPublicKey和rsa.GenerateKey等可能返回错误的操作进行严格的错误检查，而不是简单地使用_忽略。
密钥长度: 示例中使用了2048位的RSA密钥，这是目前普遍推荐的最小安全长度。在生产环境中，可以根据安全需求选择更长的密钥（如4096位）。
库版本: 确保使用的是golang.org/x/crypto/ssh，而不是旧的code.google.com/p/go.crypto/ssh。Go模块化后，x系列库是推荐的。
注释: OpenSSH格式允许在公钥字符串末尾添加注释。如果需要，你可以在fmt.Sprintf中添加一个额外的参数来包含注释。例如：fmt.Sprintf("%s %s my-comment\n", keyType, encodedKey)。

总结

通过本教程，我们学习了如何在Go语言中将rsa.PublicKey对象成功转换为OpenSSH格式的字符串。核心在于理解ssh.MarshalPublicKey生成的是二进制的“线缆格式”数据，需要结合encoding/base64库进行Base64编码，才能生成人类可读且符合OpenSSH规范的文本表示。掌握这一技巧，可以帮助开发者更方便地在Go应用中集成SSH密钥管理功能。

以上就是Go语言：将RSA公钥编码为OpenSSH字符串格式并显示教程的详细内容，更多请关注php中文网其它相关文章！