Python Paramiko库SSHv2协议使用指南：连接、命令执行与文件传输

认真发呆

发布时间：2026-10-13 | 2人浏览过

原创

本文详细介绍Python第三方库Paramiko实现SSHv2协议的方法。涵盖SSHClient用于远程命令执行及SFTPClient用于文件上传下载的两种核心组件。通过用户名密码及私钥两种认证方式的代码示例，演示如何建立安全连接、执行Linux命令及跨服务器文件传输操作。

Paramiko库简介与安装

简介

SSH是一种网络协议，OpenSSH是其开源实现之一，而Paramiko则是Python中实现SSHv2协议的第三方库，其底层依赖cryptography库进行加密处理。

借助Paramiko库，开发者可以在Python脚本中直接调用SSH协议对远程服务器进行管理，从而替代传统的通过命令行执行ssh命令的操作方式。

由于Paramiko并非Python标准库，使用前需通过pip命令进行安装，具体指令为：pip install paramiko。

核心组件：SSHClient与SFTPClient

Paramiko库主要包含两个核心组件：SSHClient和SFTPClient。

SSHClient类用于封装SSH会话，功能类似于Linux系统中的ssh命令。它内部封装了传输层(Transport)、通道(Channel)以及通过open_sftp()方法建立SFTP客户端连接的逻辑，通常用于在远程服务器上执行命令。

SFTPClient类用于封装SFTP客户端，功能类似于Linux系统中的sftp命令，主要用于实现远程文件操作，包括文件的上传、下载以及修改文件权限等任务。

# Paramiko中的几个基础名词： 1、Channel：是一种类Socket对象，代表一种安全的SSH传输通道； 2、Transport：代表一种加密的会话，在建立时会同步创建一个加密的Tunnels（通道），该通道即为Channel； 3、Session：是客户端与服务器保持连接的对象，通过connect()/start_client()/start_server()方法启动会话。

SSHClient关键方法详解

SSHClient常用的方法介绍

connect()：用于实现与远程服务器的连接及身份认证，该方法中只有hostname参数是必须提供的。

常用参数

hostname 连接的目标主机地址 port=SSH_PORT 指定SSH服务端口 username=None 验证的用户名 password=None 验证的用户密码 pkey=None 私钥方式用于身份验证 key_filename=None 一个文件名或文件列表，指定私钥文件路径 timeout=None 可选的TCP连接超时时间 allow_agent=True, 是否允许连接到ssh代理，默认为True 允许 look_for_keys=True 是否在~/.ssh目录中搜索私钥文件，默认为True 允许 compress=False, 是否打开压缩功能

set_missing_host_key_policy()：用于设置当远程服务器的主机密钥未记录在本地known_hosts文件中时的处理策略。目前支持三种策略选项：

设置连接的远程主机没有本地主机密钥或HostKeys对象时的策略，目前支持三种：

AutoAddPolicy 自动添加主机名及主机密钥到本地HostKeys对象，不依赖load_system_host_key的配置。即新建立ssh连接时不需要再输入yes或no进行确认

WarningPolicy 用于记录一个未知的主机密钥的python警告。并接受，功能上和AutoAddPolicy类似，但是会提示是新连接 RejectPolicy 自动拒绝未知的主机名和密钥，依赖load_system_host_key的配置。此为默认选项

exec_command()：用于在远程服务器上执行Linux命令的方法。

open_sftp()：在当前SSH会话的基础上创建一个SFTP会话。该方法会返回一个SFTPClient对象，可用于后续的文件操作。

# 利用SSHClient对象的open_sftp()方法，可以直接返回一个基于当前连接的sftp对象，可以进行文件的上传等操作. sftp = client.open_sftp() sftp.put('test.txt','text.txt') SSHClient常用的方法举例

基于用户名密码的连接与命令执行

1.基于用户名和密码登入方式


import paramiko
class param():
 def param_iko(self):
  #实例化SSHClient
  client = paramiko.SSHClient()
  #自动添加策略，保存服务器的主机名和密钥信息，如果不添加，那么不再本地know_hosts文件中记录的主机将无法连接
  client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
  #连接SSH服务端，以用户名和密码进行认证
  client.connect(hostname='192.168.1.200', port=22, username='root', password='a123')
  #打开一个Channel并执行命令
  stdin, stdout, stderr = client.exec_command('df -h ')
  #打印执行结果
  print(stdout.read().decode('utf-8'))
  #关闭SSHClient
  client.close()
if __name__=='__main__':
  param().param_iko()

基于私钥认证的连接方式

通过公钥连接，前提是两台Linux可以互相连接

两台服务器需要ssh免秘钥登入


import paramiko
class param_my():
 def param_miyao(self):
  #配置私人密钥文件位置
  private = paramiko.RSAKey.from_private_key_file('/root/.ssh/id_rsa')
  #实例化SSHClient
  client = paramiko.SSHClient()
  #自动添加策略，保存服务器的主机名和密钥信息，如果不添加，那么不再本地know_hosts文件中记录的主机将无法连接
  client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
  #连接SSH服务端，以用户名和密码进行认证
  client.connect(hostname='192.168.1.250',port=22,username='root',pkey=private)
  #打开一个Channel并执行命令
  stdin, stdout, stderr = client.exec_command('df -h ')
  #打印执行结果
  print(stdout.read().decode('utf-8'))
  #关闭SSHClient
  client.close()
if __name__=='__main__':
  param_my().param_miyao()
[root@master test]# python3 a.py 
文件系统        容量 已用 可用 已用% 挂载点
/dev/mapper/rhel-root  27G  21G 6.8G  75% /
devtmpfs        977M   0 977M  0% /dev
tmpfs         993M   0 993M  0% /dev/shm
tmpfs         993M 9.1M 984M  1% /run
tmpfs         993M   0 993M  0% /sys/fs/cgroup
/dev/sr0        3.8G 3.8G   0 100% /mnt/cdrom
/dev/sda1       1014M 161M 854M  16% /boot
tmpfs         199M   0 199M  0% /run/user/0
tmpfs         199M  12K 199M  1% /run/user/42

SFTP文件上传与下载操作

跨服务器上传和下载文件


import os,sys
import paramiko
class get_putclass():
  def get_put(self):
   t = paramiko.Transport(('192.168.1.250',22))
   t.connect(username='root',password='a123')
   sftp = paramiko.SFTPClient.from_transport(t)   #前面部分是192.168.1.250 远程机器上的文件，后半部分是取到本地的路径和文件名
   sftp.get('/root/file/test.txt','/home/python/tmp/test/test.txt')   #前面部分是本机器上的文件，后半部分是远程机器上的文件路径和文件名
   sftp.put('/home/python/tmp/test/a.py','/root/file/a.py')
   t.close()
if __name__=='__main__':
  get_putclass().get_put()

通过秘钥来上传下载文件


import os,sys
import paramiko
class get_put_myao():
  def get_put_miyao(self):
   pravie_key_path = '/root/.ssh/id_rsa'
   key = paramiko.RSAKey.from_private_key_file(pravie_key_path)
   t = paramiko.Transport(('192.168.1.250',22))
   t.connect(username='root',pkey=key)
   sftp = paramiko.SFTPClient.from_transport(t)
   sftp.put('/home/python/tmp/test/b.py','/root/file/b.py') 
   sftp.get('/root/file/test.txt','/home/python/tmp/test/test.txt') 
   t.close()
if __name__=='__main__':
  get_put_myao().get_put_miyao()

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持本站。