Paramiko是Python中实现SSH协议的库，用于自动化远程服务器管理。首先通过pip install paramiko安装；然后使用SSHClient创建连接，可基于用户名密码或私钥认证连接远程主机；执行命令用exec_command获取stdin、stdout、stderr三个通道，输出需decode转字符串；支持SFTP文件传输，通过open_sftp获得SFTP客户端进行上传下载及目录操作；为提升效率，可封装SSHConnection类复用连接；生产环境中应避免AutoAddPolicy，推荐手动验证主机密钥并做好异常处理。
使用Python的Paramiko库进行SSH操作是自动化服务器管理、远程执行命令和文件传输的常用方式。Paramiko是SSHv2协议的Python实现，支持客户端和服务端功能，这里主要介绍作为SSH客户端连接远程Linux服务器的基本用法。
安装Paramiko
在使用前需先安装Paramiko：
pip install paramiko连接SSH并执行命令
通过用户名和密码连接远程主机，并执行简单命令：
import paramiko创建SSH客户端
ssh = paramiko.SSHClient()
立即学习“Python免费学习笔记（深入）”；
自动添加目标主机密钥（不推荐用于生产环境）
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
连接远程服务器
ssh.connect('192.168.1.100', port=22, username='user', password='pass')
执行命令
stdin, stdout, stderr = ssh.exec_command('ls -l /tmp')
获取输出结果
print(stdout.read().decode()) print(stderr.read().decode()) # 错误信息
关闭连接
ssh.close()
说明：exec_command 返回三个通道对象，分别对应输入、正常输出和错误输出。stdout.read() 返回字节流，需 decode 转为字符串。
使用私钥登录（免密）
更安全的方式是使用SSH密钥对认证：
import paramikossh = paramiko.SSHClient() ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
使用私钥文件（如 id_rsa）
private_key = paramiko.RSAKey.from_private_key_file('/path/to/id_rsa')
ssh.connect('192.168.1.100', username='user', pkey=private_key)
stdin, stdout, stderr = ssh.exec_command('df -h') print(stdout.read().decode())
ssh.close()
支持 DSA、ECDSA、Ed25519 等多种密钥类型，例如 Ed25519Key.from_private_key_file。
SFTP 文件上传下载
Paramiko也支持SFTP文件操作：
import paramikossh = paramiko.SSHClient() ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy()) ssh.connect('192.168.1.100', username='user', password='pass')
创建SFTP会话
sftp = ssh.open_sftp()
下载文件
sftp.get('/remote/file.txt', '/local/file.txt')
上传文件
sftp.put('/local/file.txt', '/remote/file.txt')
列出远程目录
files = sftp.listdir('/remote/dir/') print(files)
sftp.close() ssh.close()
open_sftp() 返回一个SFTP客户端对象，可用于文件管理。
保持长连接与复用通道
频繁连接效率低，可复用SSH连接：
import paramikoclass SSHConnection: def init(self, host, port, user, password): self.host = host self.port = port self.user = user self.password = password self.ssh = None
def connect(self):
self.ssh = paramiko.SSHClient()
self.ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
self.ssh.connect(self.host, self.port, self.user, self.password)
def exec_cmd(self, command):
stdin, stdout, stderr = self.ssh.exec_command(command)
return stdout.read().decode(), stderr.read().decode()
def close(self):
if self.ssh:
self.ssh.close()使用示例
client = SSHConnection('192.168.1.100', 22, 'user', 'pass') client.connect() out, err = client.exec_cmd('uptime') print(out) client.close()
封装类便于在多个操作中复用连接，提升效率。
基本上就这些。连接时注意异常处理（如AuthenticationException、SSHException），生产环境避免使用 AutoAddPolicy，应验证主机密钥。Paramiko功能完整，适合写运维脚本或集成到项目中。
