首页 > 文章 > python教程

PythonParamikoSSH连接入门教程

时间：2025-10-12 19:29:27 146浏览收藏

想要用Python自动化管理远程服务器？本文为你提供一份详细的Python Paramiko SSH连接教程。Paramiko是Python中强大的SSH协议库，让你轻松实现远程服务器的自动化管理。本教程将从Paramiko的安装开始，讲解如何使用用户名密码或SSH密钥连接远程Linux服务器，并演示如何执行命令、获取输出结果。此外，你还将学会使用SFTP进行文件上传和下载，以及如何通过封装SSHConnection类来复用连接，提高效率。最后，强调生产环境中密钥验证和异常处理的重要性，助你安全高效地使用Paramiko进行SSH操作。

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()

使用示例

client = SSHConnection('192.168.1.100', 22, 'user', 'pass') client.connect() out, err = client.exec_cmd('uptime') print(out) client.close()

封装类便于在多个操作中复用连接，提升效率。

基本上就这些。连接时注意异常处理（如AuthenticationException、SSHException），生产环境避免使用 AutoAddPolicy，应验证主机密钥。Paramiko功能完整，适合写运维脚本或集成到项目中。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PythonParamikoSSH连接入门教程》文章吧，也可关注golang学习网公众号了解相关技术文章。