Python Paramiko库：SSH远程连接与文件传输实战指南

更多资料获取

📚 个人网站：ipengtao.com

在网络管理和系统运维中，SSH（Secure Shell）是一种广泛用于远程登录和文件传输的协议。Python中的Paramiko库为开发者提供了灵活、强大的SSH客户端和服务器功能。本文将深入探讨Paramiko库的使用，通过详细的示例代码，帮助读者理解如何在Python中进行SSH远程连接和文件传输。

安装Paramiko库

首先，确保已经安装了Paramiko库。可以使用以下命令进行安装：

pip install paramiko

SSH远程连接

使用Paramiko建立SSH远程连接的过程非常简单。

以下是一个基本的SSH连接示例：

import paramiko# 设置SSH连接参数
hostname = 'your_remote_host'
port = 22
username = 'your_username'
password = 'your_password'# 创建SSH客户端
client = paramiko.SSHClient()# 自动添加主机密钥
client.set_missing_host_key_policy(paramiko.AutoAddPolicy())# 连接远程主机
client.connect(hostname, port, username, password)# 执行远程命令
stdin, stdout, stderr = client.exec_command('ls -l')# 打印命令输出
print(stdout.read().decode())# 关闭SSH连接
client.close()

这个示例中，通过paramiko.SSHClient创建了一个SSH客户端，使用connect方法连接远程主机，然后通过exec_command方法执行了一个远程命令，并打印了命令的输出。

文件传输

Paramiko还提供了便捷的文件传输功能，可以轻松实现文件的上传和下载。

以下是一个文件上传的示例：

import paramiko# 设置SSH连接参数
hostname = 'your_remote_host'
port = 22
username = 'your_username'
password = 'your_password'# 创建SSH传输通道
transport = paramiko.Transport((hostname, port))
transport.connect(username=username, password=password)# 创建SFTP客户端
sftp = paramiko.SFTPClient.from_transport(transport)# 上传本地文件到远程主机
local_path = 'local_file.txt'
remote_path = 'remote_file.txt'
sftp.put(local_path, remote_path)# 关闭SFTP连接
sftp.close()# 关闭SSH传输通道
transport.close()

在这个示例中，通过paramiko.Transport创建了一个SSH传输通道，然后使用paramiko.SFTPClient从传输通道创建了一个SFTP客户端。通过put方法，我们将本地文件上传到远程主机。

进阶应用：使用SSH密钥进行连接

Paramiko还支持使用SSH密钥进行连接，提高了安全性。

以下是一个使用SSH密钥的连接示例：

import paramiko# 设置SSH连接参数
hostname = 'your_remote_host'
port = 22
username = 'your_username'
private_key_path = '/path/to/your/private/key'# 创建SSH客户端，加载私钥文件
private_key = paramiko.RSAKey(filename=private_key_path)
client = paramiko.SSHClient()# 自动添加主机密钥
client.set_missing_host_key_policy(paramiko.AutoAddPolicy())# 连接远程主机，使用SSH密钥进行身份验证
client.connect(hostname, port, username, pkey=private_key)# 执行远程命令
stdin, stdout, stderr = client.exec_command('ls -l')# 打印命令输出
print(stdout.read().decode())# 关闭SSH连接
client.close()

在这个示例中，使用paramiko.RSAKey加载了本地的私钥文件，并在连接时通过pkey参数指定了私钥。这样，就实现了使用SSH密钥进行连接的操作。

文件下载与目录同步

除了上传文件，Paramiko还支持从远程主机下载文件和同步目录。

以下是一个文件下载和目录同步的示例：

import paramiko# 设置SSH连接参数
hostname = 'your_remote_host'
port = 22
username = 'your_username'
password = 'your_password'# 创建SSH传输通道
transport = paramiko.Transport((hostname, port))
transport.connect(username=username, password=password)# 创建SFTP客户端
sftp = paramiko.SFTPClient.from_transport(transport)# 下载远程文件到本地
remote_file_path = 'remote_file.txt'
local_file_path = 'local_file.txt'
sftp.get(remote_file_path, local_file_path)# 同步远程目录到本地
remote_dir_path = 'remote_directory'
local_dir_path = 'local_directory'
sftp.get_r(remote_dir_path, local_dir_path)# 关闭SFTP连接
sftp.close()# 关闭SSH传输通道
transport.close()

在这个示例中，使用get方法将远程文件下载到本地，并使用get_r方法同步整个远程目录到本地。

多个命令的批量执行

Paramiko允许批量执行多个命令，这在一次SSH连接中执行多个任务时非常有用。

以下是一个批量执行多个命令的示例：

import paramiko# 设置SSH连接参数
hostname = 'your_remote_host'
port = 22
username = 'your_username'
password = 'your_password'# 创建SSH客户端
client = paramiko.SSHClient()
client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
client.connect(hostname, port, username, password)# 定义多个要执行的命令
commands = ['ls -l','echo "Hello, World!"','df -h'
]# 执行多个命令
for command in commands:stdin, stdout, stderr = client.exec_command(command)print(f"Command: {command}")print(stdout.read().decode())# 关闭SSH连接
client.close()

这个示例中，定义了一个包含多个命令的列表，然后通过循环执行每个命令，逐一打印执行结果。

异常处理机制

在实际应用中，异常处理是保障代码稳定性和可靠性的关键部分。当涉及到远程连接、文件传输等网络操作时，异常处理尤为重要。以下是一些常见的异常处理场景和相应的处理方式：

1. 网络连接异常

import paramiko
from paramiko import SSHExceptiontry:# 尝试建立SSH连接client = paramiko.SSHClient()client.set_missing_host_key_policy(paramiko.AutoAddPolicy())client.connect('remote_host', username='username', password='password')# 执行其他操作...except SSHException as e:print(f"SSH Connection Error: {e}")finally:# 确保连接关闭if client:client.close()

2. 文件不存在异常（SFTP）

import paramiko
from paramiko import SFTPErrortry:transport = paramiko.Transport(('remote_host', 22))transport.connect(username='username', password='password')# 创建SFTP客户端sftp = paramiko.SFTPClient.from_transport(transport)# 尝试下载远程文件sftp.get('remote_file.txt', 'local_file.txt')except FileNotFoundError as e:print(f"File Not Found Error: {e}")finally:# 关闭SFTP连接if sftp:sftp.close()# 关闭SSH传输通道if transport:transport.close()

提高安全性：使用SSH密钥进行连接

明文密码在传输过程中存在安全风险，因此建议使用SSH密钥进行连接，提高安全性。以下是一个使用SSH密钥的连接示例：

import paramiko# 设置SSH连接参数
hostname = 'your_remote_host'
port = 22
username = 'your_username'
private_key_path = '/path/to/your/private/key'# 创建SSH客户端，加载私钥文件
private_key = paramiko.RSAKey(filename=private_key_path)
client = paramiko.SSHClient()# 自动添加主机密钥
client.set_missing_host_key_policy(paramiko.AutoAddPolicy())try:# 连接远程主机，使用SSH密钥进行身份验证client.connect(hostname, port, username, pkey=private_key)# 执行其他操作...except paramiko.AuthenticationException as e:print(f"Authentication Error: {e}")finally:# 关闭SSH连接client.close()