Python Paramiko远程服务器终端操作与文件分发详解

阿麦

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

原创

本文详细解析如何使用Python的Paramiko库进行远程服务器终端操作。内容涵盖通过SFTPClient将本地文件推送到Salt服务端，利用salt-cp命令分发文件至目标服务器，以及通过SSHClient执行Git命令以获取提交记录。文中提供了完整的代码示例，包括连接配置、文件读写及远程命令交互，适用于运维自动化与远程管理场景。

本文深入解析了利用Python Paramiko库进行远程服务器终端操作的完整流程。通过详细的示例代码，展示了如何建立连接、传输文件及执行远程命令，为相关学习与工作实践提供了具有参考价值的技术指南。

本地文件写入操作

首先，演示如何将内容写入本地文件。

SFTP文件上传至Salt服务端

接着，介绍如何使用Paramiko的SFTPClient模块，将指定文件上传至Salt服务端。

利用salt-cp分发文件至目标服务器

随后，讲解如何利用Paramiko SSHClient调用salt-cp命令，将文件分发到目标服务器。

具体实现本地文件写入的代码如下，该过程涉及指定文件路径与写入模式。


with open(filePath, ‘w‘) as f:   # filePath文件本地路径，w write模式
　　f.write(content)  
return filePath

以下是将文件推送到Salt服务端的Python实现代码，展示了SFTP连接的建立与文件传输过程。


import paramiko
# 1 连接客户端
transport = paramiko.Transport((ssh_url, ssh_port))
transport.connect(username=ssh_user, password=ssh_pwd)
# 2 定义与客户端交互  将刚刚定义的transport当参数传递给他
sftp = paramiko.SFTPClient.from_transport(transport)
# sftp.put(r‘/Users/mnt/{}‘.format(script_name), ‘/mnt/{}‘.format(script_name))
sftp.put(本地路径+ ‘{}‘.format(文件名), 目标路径+‘{}‘.format(文件名))
# 5 关闭连接
transport.close()

以下是通过SSHClient执行salt-cp命令以分发文件的代码示例，包含连接配置与命令执行逻辑。


# 实例化一个ssh
ssh = paramiko.SSHClient()
# 设置主机不在khost_key中也能连接
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
# 创建连接
ssh.connect(hostname=ssh_url, port=ssh_port, username=ssh_user, password=ssh_pwd)
# 执行命令, 　　　　salt-cp -L salt_minion_hostname local_url/filename target_url
stdin, stdout, stderror = ssh.exec_command(‘salt-cp -L localhost.localdomain /mnt/‘ + script_name + ‘ /mnt‘)
# 打印输出
print(stdout.read())
# 关闭连接
ssh.close()

远程执行Git命令获取提交记录

最后，演示如何通过Paramiko模块控制远程服务器终端，执行Git相关命令以获取版本信息。


import paramiko
#
def parmiko_con():
  # 实例化一个ssh
  ssh = paramiko.SSHClient()
  # 设置主机不在khost_key中也能连接
  ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
  # 创建连接
  ssh.connect(hostname=ssh_url, port=ssh_port, username=ssh_user, password=ssh_pwd)
  # 执行命令
  # cmd = ‘cd /mnt/test_pro/opsmanage/ && git shortlog -2‘　　　　# 查看最近两次的提交版本，在cmd里执行没有问题，但在函数里运行响应不出来，git log命令需要按q退出
  # cmd = ‘cd /mnt/test_pro/opsmanage/ && git rev-list master‘　　　# master分支提交记录倒叙排列
  cmd = ‘cd /mnt/test_pro/opsmanage/ && git log --since=1.weeks‘　　# 查看近一周的提交，多条数据只有一个列表，需要进行处理，需要请移步：https://www.cnblogs.com/lutt/p/12037454.html
  # cmd = ‘cd /mnt/test_pro/opsmanage/ && git rev-list --all -n 2‘  # 历史版本reverse只去两条记录(只显示commit id)
  # cmd = ‘cd /mnt/OpsManage/ && git branch -a‘　　　　# 查看当前所有分支, git branch 查看当前分支
  # cmd = ‘cd /mnt/test_pro/opsmanage/ && git tag -l‘ # 查看当前所有tag
  stdin, stdout, stderror = ssh.exec_command(cmd)
  # 打印输出
  list2 = []
  ret = stdout.read().decode(‘utf-8‘)
  list2 = ret.split(‘\n‘)
  print(list2)

  # 关闭连接
  ssh.close()

if __name__ == ‘__main__‘:
  parmiko_con()
  print(‘ok‘)

以上内容涵盖了基于Paramiko进行远程操作的核心步骤，希望能为读者的学习和工作提供有益帮助。