Python Paramiko库：SSH远程连接与文件传输实战指南-Toy模板网

这篇具有很好参考价值的文章主要介绍了Python Paramiko库：SSH远程连接与文件传输实战指南。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

如何使用paramiko远程连接服务器,Python,python,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 SSHException

try:
    # 尝试建立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 SFTPError

try:
    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()