Paramiko：Python 生态中最成熟的 SSH 协议库

提到 Python 的 SSH 库，Paramiko 是绕不开的那个名字。这个项目在 GitHub 上有近万 Star，发展了十几年，已经成为 Python 远程操作领域的基石。

它解决什么问题？

Paramiko 是 SSHv2 协议的纯 Python 实现，既支持客户端模式，也支持服务端模式。你可以用纯 Python 代码完成 SSH 连接、远程执行命令、文件传输这些操作，不需要依赖系统自带的 ssh 命令。

如果是普通用户，官方推荐直接使用基于 Paramiko 构建的 Fabric 库，日常远程操作更省事。只有当你需要底层 SSH 原语，或者想在 Python 里跑一个 SSH 服务端时，才需要直接跟 Paramiko 打交道。

核心能力

Paramiko 提供的能力分两层。

客户端功能：建立 SSH 连接、远程执行命令、SFTP 文件传输、端口转发。这些是日常用得最多的场景。

服务端功能：在 Python 中实现 SSH 服务端。这个场景少见但很有用，比如你需要一个可编程的 SSH 服务，或者想在测试中模拟 SSH 行为。

加密层面依赖 cryptography 库，后者使用 C 和 Rust 扩展，但官方提供了多种预编译版本，安装基本没有门槛。

为什么选它？

Python 社区里 SSH 相关的库不算多，Paramiko 能一直稳坐头把交椅，有几个原因。

一是成熟度。项目从 2003 年左右开始开发，经过十几年迭代，协议实现非常完整。遇到不确定的地方会参考 OpenSSH 的实现，有疑问优先跟 OpenSSH 保持一致。

二是生态地位。Fabric、Ansible 等知名工具底层都用了 Paramiko。这意味着它经过了大规模生产环境的检验，社区积累的问答和案例丰富。

三是纯 Python。部署时不用操心 C 扩展的兼容性问题，在各类操作系统和架构上都能跑。配合 cryptography 的预编译包，pip install 一步到位。

实际用起来怎么样？

日常场景下，Paramiko 表现稳定。SSH 连接、命令执行、SFTP 传输这些基本操作都有成熟的 API 封装。

不过直接用 Paramiko 写自动化脚本，代码量比用 Fabric 多一些。如果只是需要远程执行几条命令，Fabric 是更高效的选择。Paramiko 的优势在于灵活性和可定制性，想做底层控制的时候，它能给你完整的协议访问权限。

Python 做运维自动化的场景越来越多，Paramiko 作为底层基石，短期内很难被替代。它的设计理念很务实，不追求花哨的功能，把 SSH 协议实现做到位，剩下的交给上层库去发挥。

如果你在写 Python 运维工具或者需要程序化操作远程服务器，Paramiko 值得放进技术选型的候选列表。十几年的项目生命周期足够长，不会出现用着用着就没人维护的尴尬局面。

技术选型的候选列表。十几年的项目生命周期足够长，不会出现用着用着就没人维护的尴尬局面。