本文介绍为何直接通过 exec.Command 调用系统 ssh 命令易出错，并推荐使用官方维护的 golang.org/x/crypto/ssh 包实现安全、可控、可编程的 SSH 连接，包含完整示例与关键注意事项。
直接调用系统 ssh 命令（如 exec.Command("ssh", "user@192.168.1.1")）看似便捷，但在 Go 中常引发不可靠行为——例如你遇到的 Could not resolve hostname ...: nodename nor servname provided 错误。该错误并非 DNS 问题，而是因 exec.Command 默认不继承 shell 的环境变量（如 HOME）、SSH 配置路径（~/.ssh/config）、known_hosts 机制及代理设置，导致 ssh 二进制在子进程中无法正确解析地址或读取密钥。
正确做法：使用原生 Go SSH 客户端库
推荐使用 golang.org/x/crypto/ssh —— 这是 Go 官方维护、生产就绪的纯 Go SSH 实现，支持密码、公钥、代理转发、会话复用等核心功能，且完全可控、无外部依赖。
✅ 示例：建立带公钥认证的 SSH 连接并执行命令
package main
import (
"golang.org/x/crypto/ssh"
"log"
"os"
)
func main() {
// 1. 解析地址（注意：不带 user@ 前缀）
addr := "192.168.1.1:22" // 显式指定端口更健壮
username := "your_user"
// 2. 加载私钥（示例为 PEM 格式）
key, err := os.ReadFile("/path/to/id_rsa")
if err != nil {
log.Fatal("Failed to read private key:", err)
}
signer, err := ssh.ParsePrivateKey(key)
if err != nil {
log.Fatal("Failed to parse private key:", err)
}
// 3. 构建客户端配置
config := &ssh.ClientConfig{
User: username,
Auth: []ssh.AuthMethod{
ssh.PublicKeys(signer),
},
HostKeyCallback: ssh.InsecureIgnoreHostKey(), // 生产环境请替换为 ssh.FixedHostKey(...) 或自定义验证
Timeout: 10,
}
// 4. 拨号连接
client, err := ssh.Dial("tcp", addr, config)
if err != nil {
log.Fatal("Failed to dial:", err)
}
defer client.Close()
// 5. 创建会话并执行命令
session, err := client.NewSession()
if err != nil {
log.Fatal("Failed to create session:", err)
}
defer session.Close()
out, err := session.Output("uptime")
if err != nil {
log.Fatal("Failed to run command:", err)
}
log.Printf("Uptime: %s", out)
}⚠️ 注意事项：
- 切勿在生产中使用 ssh.InsecureIgnoreHostKey()：它跳过主机密钥验证，存在中间人攻击风险。应使用 ssh.FixedHostKey(hostKey) 或实现 HostKeyCallback 验证已知指纹。
- 私钥保护：确保私钥文件权限为 0600，避免硬编码密钥到源码；推荐结合 os.UserHomeDir() 动态加载 ~/.ssh/id_rsa。
- 错误处理必须严谨：SSH 连接、认证、会话创建、命令执行各阶段均可能失败，需逐层检查 err。
- 资源释放：务必调用 session.Close() 和 client.Close()，防止 goroutine 泄漏。
使用原生 SSH 包不仅能彻底规避 shell 环境差异问题，还赋予你细粒度控制能力（如自定义心跳、超时、多路复用、SFTP 支持等），是自动化运维场景下的最佳实践。
