paramiko模块介绍

一、介绍

Paramiko 是 Python 中用于实现 SSH 远程登录 和 SFTP 文件传输 的核心模块，简单说就是 “用 Python 代码代替手动敲 SSH 命令”， 比如远程执行服务器命令、上传 / 下载文件 核心功能： 1. SSH 远程执行命令（比如 ls、mkdir、python run.py）； 2. SFTP 上传 / 下载文件（比 scp 命令更灵活）； 3. 支持密钥登录（比密码登录更安全）。

安装：pip install paramiko

二、功能介绍

2.1、ssh远程连接

# 导入 paramiko 模块
import paramiko# 1. 创建 SSH 客户端对象
ssh = paramiko.SSHClient()try:# 2. 首次连接服务器时，SSH 会提示 “是否信任该主机”，这行代码让 Python 自动信任，不用手动确认ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())# 3. 连接服务器（核心参数）ssh.connect(hostname='你的服务器IP',  # 比如 192.168.1.100port=22,                 # SSH 默认端口是 22，不用改username='服务器用户名',  # 比如 root、ubuntupassword='服务器密码'     # 你的服务器登录密码)# 4. 执行远程命令（比如查看服务器当前目录文件）# exec_command 返回 3 个文件对象：标准输入、标准输出、标准错误stdin, stdout, stderr = ssh.exec_command('ls -l')如果是多条命令：# 拼接多条命令：&& 表示前一条成功才执行后一条；; 表示不管前一条是否成功都执行cmd = 'cd /home/ubuntu && mkdir test_dir && ls -l'stdin, stdout, stderr = ssh.exec_command(cmd)# 5. 读取执行结果（stdout 是正确输出，stderr 是错误输出）# 解码：把字节转成字符串，指定编码（服务器一般是 utf-8）result = stdout.read().decode('utf-8')error = stderr.read().decode('utf-8')# 6. 打印结果if result:print("命令执行成功，结果：")print(result)if error:print("命令执行出错，错误信息：")print(error)except Exception as e:# 捕获所有异常（比如连接失败、密码错误）print(f"连接/执行命令失败：{e}")finally:# 7. 无论成功失败，最后关闭连接（避免占用资源）ssh.close()

2.2、SFTP 上传 / 下载文件

Paramiko 的 SFTP 功能可以实现 “本地 ↔ 远程服务器” 的文件传输，比 scp 命令更灵活（支持断点续传、批量传输）

# 1、上传文件，本地 -- 》服务器
import paramiko# 1. 先建立 SSH 连接（和之前一样）
transport = paramiko.Transport()
try:# 2. 认证登录transport.connect(hostname='ip', port=22, username='用户名', password='密码')# 3. 创建 SFTP 客户端对象sftp = paramiko.SFTPClient.from_transport(transport)# 4. 上传文件# 参数1：本地文件路径（比如 ./test.txt）# 参数2：服务器保存路径（比如 /home/ubuntu/test.txt）local_path = './test.txt'  # 本地当前目录的 test.txtremote_path = '/home/ubuntu/test.txt'  # 服务器保存路径sftp.put(local_path, remote_path)print(f"文件 {local_path} 上传到 {remote_path} 成功！")except Exception as e:print(f"上传失败：{e}")
finally:# 5. 关闭连接transport.close()# 2、下载文件，远程服务器 -- 》本地
import paramikotransport = paramiko.Transport()
try:transport.connect(hostname='ip', port=22, username='用户名', password='密码')# 下载文件：get(服务器文件路径, 本地保存路径)remote_path = '/home/ubuntu/test.txt'  # 服务器文件local_path = './download_test.txt'    # 本地保存的文件名sftp.get(remote_path, local_path)print(f"文件 {remote_path} 下载到 {local_path} 成功！")except Exception as e:print(f"下载失败：{e}")
finally:transport.close()

三、更安全：密钥登录（替代密码）

生产环境中不建议用密码登录（容易泄露），推荐用 SSH 密钥对登录

# 1、生成 SSH 密钥对（本地），就像Linux ssh远程连接 一样
ssh-keygen -t rsa# 2、把公钥上传到远程服务器
把 id_rsa.pub 里的内容复制到服务器的 ~/.ssh/authorized_keys 文件中# 3、Paramiko 用密钥登录（代码示例）
import paramiko1. 加载本地私钥
private_key = paramiko.RSAKey.from_private_key_file('/Users/你的用户名/.ssh/id_rsa')2. 建立连接
ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
try:ssh.connect(hostname='服务器IP',port=22,username='用户名',pkey=private_key  # 用私钥替代密码)# 执行命令（和之前一样）stdin, stdout, stderr = ssh.exec_command('uname -a')print(stdout.read().decode('utf-8'))
except Exception as e:print(f"登录失败：{e}")
finally:ssh.close()