当前位置：首页 > 文章列表 > 文章 > python教程 > PythonParamikoSSH连接入门教程

PythonParamikoSSH连接入门教程

2025-11-15 16:56:32 0浏览收藏

想要自动化管理远程Linux服务器？Python Paramiko SSH连接教程来了！本文详细介绍了如何使用Python的Paramiko库进行SSH连接，实现远程命令执行和文件传输。从Paramiko的安装（`pip install paramiko`）到使用用户名密码或私钥进行身份验证，再到利用`exec_command`执行命令并获取输出，以及通过SFTP进行文件上传下载，都有清晰的代码示例。更进一步，本文还提供了封装SSH连接类的方案，提升效率。掌握Paramiko，轻松搞定服务器自动化运维，快来学习吧！记得在生产环境中做好异常处理和主机密钥验证哦。

Paramiko是Python中实现SSH协议的库，用于自动化远程服务器管理。首先通过pip install paramiko安装；然后使用SSHClient创建连接，可基于用户名密码或私钥认证连接远程主机；执行命令用exec_command获取stdin、stdout、stderr三个通道，输出需decode转字符串；支持SFTP文件传输，通过open_sftp获得SFTP客户端进行上传下载及目录操作；为提升效率，可封装SSHConnection类复用连接；生产环境中应避免AutoAddPolicy，推荐手动验证主机密钥并做好异常处理。

python Paramiko的SSH用法

使用Python的Paramiko库进行SSH操作是自动化服务器管理、远程执行命令和文件传输的常用方式。Paramiko是SSHv2协议的Python实现，支持客户端和服务端功能，这里主要介绍作为SSH客户端连接远程Linux服务器的基本用法。

安装Paramiko

在使用前需先安装Paramiko：

pip install paramiko

连接SSH并执行命令

通过用户名和密码连接远程主机，并执行简单命令：

import paramiko

创建SSH客户端

ssh = paramiko.SSHClient()

自动添加目标主机密钥（不推荐用于生产环境）

ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())

连接远程服务器

ssh.connect('192.168.1.100', port=22, username='user', password='pass')

执行命令

stdin, stdout, stderr = ssh.exec_command('ls -l /tmp')

获取输出结果

print(stdout.read().decode()) print(stderr.read().decode()) # 错误信息

关闭连接

ssh.close()

说明：exec_command 返回三个通道对象，分别对应输入、正常输出和错误输出。stdout.read() 返回字节流，需 decode 转为字符串。

使用私钥登录（免密）

更安全的方式是使用SSH密钥对认证：

import paramiko

ssh = paramiko.SSHClient() ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())

使用私钥文件（如 id_rsa）

private_key = paramiko.RSAKey.from_private_key_file('/path/to/id_rsa')

ssh.connect('192.168.1.100', username='user', pkey=private_key)

stdin, stdout, stderr = ssh.exec_command('df -h') print(stdout.read().decode())

ssh.close()

支持 DSA、ECDSA、Ed25519 等多种密钥类型，例如 Ed25519Key.from_private_key_file。

SFTP 文件上传下载

Paramiko也支持SFTP文件操作：

import paramiko

ssh = paramiko.SSHClient() ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy()) ssh.connect('192.168.1.100', username='user', password='pass')

创建SFTP会话

sftp = ssh.open_sftp()

下载文件

sftp.get('/remote/file.txt', '/local/file.txt')

上传文件

sftp.put('/local/file.txt', '/remote/file.txt')

列出远程目录

files = sftp.listdir('/remote/dir/') print(files)

sftp.close() ssh.close()

open_sftp() 返回一个SFTP客户端对象，可用于文件管理。

保持长连接与复用通道

频繁连接效率低，可复用SSH连接：

import paramiko

class SSHConnection: def init(self, host, port, user, password): self.host = host self.port = port self.user = user self.password = password self.ssh = None

def connect(self):
    self.ssh = paramiko.SSHClient()
    self.ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
    self.ssh.connect(self.host, self.port, self.user, self.password)

def exec_cmd(self, command):
    stdin, stdout, stderr = self.ssh.exec_command(command)
    return stdout.read().decode(), stderr.read().decode()

def close(self):
    if self.ssh:
        self.ssh.close()