（python）远程操作模块-Paramiko

前言

        Paramiko 是一个用于 Python 的模块，用于实现 SSH 客户端和服务器。使用 Paramiko，你可以在 Python 中进行 SSH 连接，并执行远程命令、传输文件等操作。

目录

安装

流程

范例

优点

缺点

需要注意的事项

---

安装

pip install paramiko

流程

范例

创建 SSH 客户端对象

提供主机名、用户名和密码（或私钥）等连接参数

client = paramiko.SSHClient()
client.set_missing_host_key_policy(paramiko.AutoAddPolicy())  # 允许连接未知主机
client.connect(hostname='remote_host', username='username', password='password')

密钥认证

private_key = paramiko.RSAKey.from_private_key_file('/path/to/private/key.pem')
client.connect(hostname='remote_host', username='username', pkey=private_key)

执行远程命令

stdin, stdout, stderr = client.exec_command('ls -l')
for line in stdout:
    print(line.strip())

传输文件 

sftp = client.open_sftp()
sftp.put('/local/path/file.txt', '/remote/path/file.txt')  # 上传文件
sftp.get('/remote/path/file.txt', '/local/path/file.txt')  # 下载文件

关闭连接

client.close()

优点

1. 易用性：Paramiko 提供了简洁的 API，易于理解和使用。通过 Paramiko，你可以很容易地建立 SSH 连接、执行命令和传输文件，而无需深入了解 SSH 协议的细节。

2. 功能丰富：Paramiko 提供了丰富的功能，包括 SSH 客户端和服务器的实现、SFTP（SSH 文件传输协议）的支持以及各种加密算法的实现。它可以满足大部分 SSH 相关的需求。

3. 跨平台性：Paramiko 可以在多个平台上运行，包括 Linux、Windows、macOS 等。这使得它成为一个跨平台的远程操作解决方案。

4. 活跃的社区支持：Paramiko 是一个开源项目，拥有活跃的社区支持。你可以在社区中找到各种教程、文档和问题解答，帮助你更好地使用 Paramiko。

缺点

1. 性能较低：与一些其他的基于 C 语言编写的 SSH 库相比，Paramiko的性能可能较低。这主要是因为它是用 Python 实现的，而 Python 在处理密集型计算和高并发任务时性能较差。

2. 依赖性：使用 Paramiko 需要依赖于 Python 的标准库以及一些第三方库，如 cryptography。这增加了项目的依赖性，并可能导致一些兼容性和版本管理的问题。

3. 文档相对不足：尽管 Paramiko 拥有一些文档和教程，但相对来说文档相对不足，可能需要一些时间来理解其 API 和使用方法。

需要注意的事项

当使用密钥认证时，如果认证失败，Paramiko 会返回相应的错误信息，通常包括以下几种可能的情况：

1. 私钥文件路径错误：如果指定的私钥文件路径错误或者无法读取私钥文件，Paramiko 会返回类似于 "No such file or directory" 或者 "Permission denied" 的错误信息。

2. 私钥文件格式错误：如果私钥文件的格式不正确，或者不符合 SSH 私钥的标准格式，Paramiko 会返回类似于 "Invalid key" 的错误信息。

3. 密钥不匹配：如果提供的私钥与远程主机上配置的公钥不匹配，Paramiko 会返回类似于 "Permission denied" 或 "Authentication failed" 的错误信息。

4. 密钥过期：如果使用的密钥已经过期或失效，Paramiko 可能会返回类似于 "Permission denied (publickey)" 的错误信息。

5. 密钥权限不足：如果私钥文件的权限设置不正确，例如私钥文件的权限过于宽松（例如权限设置为 777），则认证可能会失败并返回类似于 "Bad ownership or modes for file" 的错误信息。

在捕获到这些错误信息后，你可以根据具体情况进行适当的处理，例如检查私钥文件路径、格式和权限，或者确认公钥与私钥是否匹配。