Python Paramiko模块实现远程命令执行与文件传输详解

云舒

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

原创

本文详细介绍如何使用Python的paramiko模块进行远程服务器控制与文件传输。内容涵盖模块安装、通过SSH执行远程Shell命令（包括sudo交互处理）、利用多线程批量执行命令，以及基于SFTP协议实现本地与远程服务器间的文件上传与下载操作，提供完整代码示例供参考。

本文介绍如何利用Python的paramiko模块实现远程服务器控制及文件传输功能，并提供具体示例供参考。

1 安装

sudo pip install paramiko

2 使用SSH实现远程控制

#LINUX下执行shell
ssh username@ip #输入密码后就可以对远程机器进行操作
ssh username@ip command #输入密码后远程机器就执行command

在SSH会话运行过程中，若需退出连接，可通过终止（kill）对应的ssh进程来实现。

3 使用paramiko实现SSH连接

import paramiko
hostname = '10.1.111.111'
username = 'root'
password = '111111'
port = 22 #整数不是字符串
paramiko.util.log_to_file('paramiko.log')
ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy()) #允许连接不在know_hosts文件中的主机
ssh.connect(hostname=hostname,port=port,username=username,password=password)
stdin, stdout, stderr = ssh.exec_command("ls") #远程执行shell命令
print(stdout.readlines()) #输出回显结果
ssh.close()

exec_command命令支持使用分号（;）分隔以按顺序执行多个命令；该命令可传入多个参数。需要注意的是，exec_command仅针对单个会话有效，命令执行完毕后，会话将返回至登录时的默认目录。示例如下：

a='~/Videos'
b='aaa'
ssh.exec_command('cd %s;mkdir %s'%(a,b)) #aaa在a目录下
ssh.exec_command('mkdir aaa') #aaa在缺省目录下

当远程执行命令涉及交互式输入时，可通过调用 stdin.write(“”) 方法来完成交互操作。

注意以下关键点：

（1）在执行sudo命令时必须添加-S参数，这表示程序将从标准输入（stdin）接收密码；

（2）调用 stdin.write(‘password\n') 时，字符串末尾必须包含换行符（\n）作为命令结束标志，否则服务器将一直处于等待状态；

（3）必须调用 flush() 方法以刷新写入缓冲区（flush() any buffer you're writing to）。

stdin, stdout, stderr = ssh.exec_command('sudo -S ls')
stdin.write('password\n')
stdin.flush()

可以通过多进程或多线程技术来批量执行远程命令：

import paramiko
import threading

def ssh_cmd(ip,port,username,passwd,cmd):
  ssh = paramiko.SSHClient()
  ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
  ssh.connect(ip,port,username,passwd)
  for m in cmd:
    stdin, stdout, stderr = ssh.exec_command(m)
    print(stdout.readlines()) 
  ssh.close()

if __name__=='__main__':
  cmd = ['ls','ifconfig']   
  a=threading.Thread(target=ssh_cmd,args=(ip,port,username,passwd,cmd))
  a.start() 
  a.join()

4 远程传输文件

使用scp命令从本地服务器复制文件到远程服务器。

scp local_file remote_username@remote_ip:remote_file

若指定了用户名，命令执行后将提示输入用户密码；若不指定用户名，则需同时输入用户名和密码。反之，从远程服务器复制文件到本地服务器的操作如下：

scp remote_username@remote_ip:remote_file local_file

5 使用paramiko实现远程文件传输

新建一个SFTPClient对象，该对象可复用之前建立的SSH连接。因此，在使用sftp传输文件时，无需再次进行用户身份认证。具体实现文件

上传的代码如下：

sftp = paramiko.SFTPClient.from_transport(ssh.get_transport())
#sftp = ssh.open_sftp() #两者选其一即可
sftp.put('bbb.c','aaa.c') #文件上传并重命名
sftp.close()

或者采用以下代码实现文件的上传和下载：

import paramiko
t=paramiko.Transport((hostname,port))
t.connect(username=username,password=password)
sftp = paramiko.SFTPClient.from_transport(t) 
sftp.put('bbb.c','aaa.c') #文件上传并重命名
sftp.get('m.py', 'mm.py')#文件下载并重命名
t.close()

官方文档

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