目錄

• 1. 概述
• 2. Paramiko的基本使用
  • 2.1 SSHClient關鍵引數介紹
  • 2.2 SSHClient常用示例
    • 2.2.1 通過使用者名稱和密碼方式登陸：
    • 2.2.2 通過使用者名稱和密碼方式登陸 ( transport方式 )
    • 2.2.3 通過使用者名稱和金鑰方式登陸
  • 2.3 SFTPClient關鍵引數介紹
  • 2.4 SFTPClient常用示例
• 3. 完整程式碼

1. 概述

本來是不想寫Paramiko的，因為我覺得之前的一篇關於Netmiko模組更適合網工，後來發現paramiko有包含SFTP功能，所以還是有必要來講講，畢竟我們在裝置上是要經常下載配置、上傳版本/升級版本用的，而且SFTP比FTP、TFTP更安全。

所以， 你也不用藉助其他工具來上傳、下載了，通通用 'Python' 來幫你搞定了。

SSH和SFTP都是使用一樣的埠號 22。如果對資料安全傳輸較重視，那麼SFTP替代FTP、TFTP是首選。

實驗環境說明：

• 一臺思科路由器，用於SSH登陸；
• 一臺華為交換機，用於SFTP上傳/下載；
• PyCharm Pro

2. Paramiko的基本使用

2.1 SSHClient關鍵引數介紹

connect()函式：

用途：用於連線遠端主機，其中'hostname'為必選引數。

常用引數
hostname    //遠端主機，填寫IP和域名都可以
port=SSH_PORT   //預設為22埠
username=None   //用於登陸遠端主機使用的使用者名稱
password=None   //用於登陸遠端主機使用的密碼
pkey=None   //使用私鑰用於身份認證，也叫'免密'登陸
key_filename=None   //使用私鑰檔名
timeout=None    //tcp連線超時時間
allow_agent=True    //預設允許連線到ssh代理
look_for_keys=True  //預設在~/.ssh中搜索私鑰檔案，預設為True 允許
compress=False  //預設沒有開啟壓縮
 

load_system_host_keys()函式:

用途：用於載入主機金鑰，金鑰儲存"known_hosts"檔案中。

filename=None   //預設會載入"~/.ssh/known_hosts"檔案

set_missing_host_key_policy()函式：

用途：用於檢查遠端主機在本地'host keys'是否有記錄並使用哪種策略。

#目前支援的三種策略： 
1.AutoAddPolicy     //自動新增主機名及主機金鑰到本地HostKeys物件，不依賴load_system_host_key的配置。即新建立ssh連線時不需要再輸入yes或no進行確認
2.WarningPolicy     //用於記錄一個未知的主機金鑰的python警告。並接受，功能上和AutoAddPolicy類似，但是會提示是新連線
3.RejectPolicy      //自動拒絕未知的主機名和金鑰，依賴load_system_host_key的配置。此為預設選項

exec_command()函式：

用途：用於在遠端主機執行的命令，並返回輸入、輸出、錯誤資訊。

command //執行的命令
stdin, stdout, stderr   //分別表示輸入、輸出、錯誤

2.2 SSHClient常用示例

2.2.1 通過使用者名稱和密碼方式登陸：

import paramiko

def ssh_client():
    # 建立一個例項化
    ssh = paramiko.SSHClient()
    # 載入系統HostKeys金鑰
    ssh.load_system_host_keys()
    # 自動新增策略，儲存遠端主機的主機名和金鑰資訊，如果不新增，那麼不在本地knows_hosts檔案中記錄的主機將無法連線，預設拒接
    ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
    #連線遠端主機
    ssh.connect('192.168.0.101',port=22, username='admin', password='Admin@123')
    #執行命令
    stdin, stdout,stderr = ssh.exec_command('show ip int br')
    print(stdout.read().decode('utf-8'))
    #關閉連線
    ssh.close()

if __name__ == '__main__':
    ssh_client()

執行程式碼返回結果如下：

2.2.2 通過使用者名稱和密碼方式登陸 ( transport方式 )

def ssh_client():
    # 建立一個例項化
    ssh = paramiko.SSHClient()
    #transport封裝
    t = paramiko.Transport('192.168.0.101', 22)
    t.connect(username='admin', password='Admin@123')
    ssh._transport = t

    # 載入系統HostKeys金鑰
    ssh.load_system_host_keys()
    # 自動新增策略，儲存遠端主機的主機名和金鑰資訊，如果不新增，那麼不在本地knows_hosts檔案中記錄的主機將無法連線，預設拒接
    ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
    #執行命令
    stdin, stdout,stderr = ssh.exec_command('show ip int br')
    print(stdout.read().decode('utf-8'))
    #關閉連線
    ssh.close()

if __name__ == '__main__':
    ssh_client()

執行程式碼返回結果如下：

​ 結果同上，輸出結果一樣。

2.2.3 通過使用者名稱和金鑰方式登陸

思科路由器公鑰配置：

username admin privilege 15 password Admin@123
ip domain name cisco.com
crypto key generate rsa modulus 1024
ip ssh version 2
ip ssh pubkey-chain
  username admin
   key-hash ssh-rsa 560DE41351E40FF6C237F9BBFF4238AC singvis@DESKTOP-IQ964AEendend
line vty 0 4
 exec-timeout 5 0
 logging synchronous
 login local
 transport input ssh
 privilege level 15

python程式碼：

import paramiko

def ssh_client():
    #私鑰的絕對路徑
    private = paramiko.RSAKey.from_private_key_file(r'C:\Users\singvis\Documents\Identity')

    # 建立一個例項化
    ssh = paramiko.SSHClient()
    # 載入系統HostKeys金鑰
    ssh.load_system_host_keys()
    # 自動新增策略，儲存遠端主機的主機名和金鑰資訊，如果不新增，那麼不在本地knows_hosts檔案中記錄的主機將無法連線，預設拒接
    ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
    #連線遠端主機,此處不需要密碼，為私鑰檔案
    ssh.connect('192.168.0.101',port=22, username='admin', pkey=private)
    #執行命令
    stdin, stdout,stderr = ssh.exec_command('show ip int br')
    print(stdout.read().decode('utf-8'))
    ssh.close()

if __name__ == '__main__':
    ssh_client()

通過SecurityCRT採用金鑰方式登陸192.168.0.101，不用輸入密碼，直接就登陸：

說明：金鑰的生成路徑：tools->creat public key ( 本次通過SecurityCRT )

2.3 SFTPClient關鍵引數介紹

SFTPCLient作為一個sftp的客戶端物件，根據ssh傳輸協議的sftp會話，實現遠端檔案操作，如上傳、下載、許可權、狀態。

from_transport(cls,t)   //建立一個已連通的SFTP客戶端通道
put(localpath, remotepath, callback=None, confirm=True) //將本地檔案上傳到遠端主機
get(remotepath, localpath, callback=None)   //從遠端主機下載檔案到本地
mkdir()     //建立目錄
remove()    //刪除目錄
rename()    //重新命名目錄
stat()      //檢視檔案狀態
listdir()   //列出目錄下的檔案

2.4 SFTPClient常用示例

以華為交換機為例子說明，交換機配置如下：

rsa local-key-pair create
#
stelnet server enable
sftp server enable
#
aaa
 local-user admin password simple Admin@123
 local-user admin privilege level 15
 local-user admin service-type terminal ssh
 #
ssh authentication-type default password
ssh user admin authentication-type password
ssh user admin service-type all
ssh user admin sftp-directory flash:/
#
user-interface vty 0 4
 authentication-mode aaa
 protocol inbound ssh

Python程式碼如下：

import paramiko

def sftp_put():
    #檔案路徑
    local_file =r'D:\test\123.txt'
    remote_file ='flash:/123.txt'

    t = paramiko.Transport('192.168.0.200', 22)
    t.connect(username='admin', password='Admin@123')

    sftp = paramiko.SFTPClient.from_transport(t)
    sftp.put(local_file,remote_file)
    t.close()

def sftp_get():
    local_path = r'D:\test\vrpcfg.zip'
    remote_path = 'flash:/vrpcfg.zip'

    t = paramiko.Transport('192.168.0.200', 22)
    t.connect(username='admin', password='Admin@123')
    #
    sftp = paramiko.SFTPClient.from_transport(t)
    sftp.get(remote_path, local_path)
    t.close()

if __name__ == '__main__':
    sftp_put()
    sftp_get()

執行程式碼返回結果如下：

3. 完整程式碼

#!/usr/bin/env python
#coding:utf-8
#歡迎關注微信公眾號：點滴技術
#這裡有靠譜的、有價值的、共成長的，專屬於網路攻城獅

import paramiko, time
from paramiko.ssh_exception import NoValidConnectionsError,AuthenticationException

def ssh_client(host, user, pwd, cmds, verbose=True):
    # 私鑰檔案的存放路徑
    # private = paramiko.RSAKey.from_private_key_file(r'C:\Users\singvis\Documents\Identity')
    # 建立一個例項化
    ssh = paramiko.SSHClient()
    # 載入系統SSH金鑰
    ssh.load_system_host_keys()
    # 自動新增策略，儲存伺服器的主機名和金鑰資訊，如果不新增，那麼不在本地knows_hosts檔案中記錄的主機將無法連線，預設拒接
    ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
    # 連線裝置
    try:
        ssh.connect(hostname=host,
                    username=user,
                    timeout=5,
                    compress=True,
                    password=pwd
                    #pkey=private,  #可以採用金鑰連線
                    )

        print("正在連線主機{}.....".format(host))
    except NoValidConnectionsError:
        print('連接出現了問題')
    except AuthenticationException:
        print('使用者名稱或密碼錯誤')
    except Exception as e:
        print('其他錯誤問題{}'.format(e))
    finally:
        #啟用互動式shell
        chan = ssh.invoke_shell()
        time.sleep(1)

        for cmd in cmds:
            chan.send(cmd.encode())
            #一定要有回車'Enter'這個動作
            chan.send(b'\n')
            time.sleep(2)
            r = chan.recv(40960).decode()
            if verbose:
                print(r)
        chan.close()
        ssh.close()

def sftp_get(ip, user, pwd, local_file,remote_file, port=22):
    try:
        t = paramiko.Transport(ip, port)
        t.connect(username=user, password=pwd)
        sftp = paramiko.SFTPClient.from_transport(t)
        sftp.get(remote_file, local_file)
        t.close()

    except Exception as e:
        print(e)


def sftp_put(ip, user, pwd, local_file, remote_file, port=22):
    try:
        t = paramiko.Transport(ip, port)
        t.connect(username=user, password=pwd)
        sftp = paramiko.SFTPClient.from_transport(t)
        sftp.put(local_file, remote_file)
        t.close()

    except Exception as e:
        print(e)


if __name__ == '__main__':
    '''
    不要執行的，請註釋掉，前面加'#'符號
    '''
    ip = '192.168.0.101'
    user= 'admin'
    pwd= 'Admin@123'
    # local_file = r'D:\test\123.txt'
    # remote_file = 'flash:/vrpcfg.zip'
    # sftp_get(ip='192.168.0.200', user=user, pwd=pwd, remote_file=remote_file, local_file=r'D:\test\vrpcfg.zip')
    # sftp_put(ip='192.168.0.200', user=user, pwd=pwd, local_file=local_file, remote_file='flash:/123.txt')

    cmds = ['terminal length 0', 'show version', 'show ip int br','show ip route']
    # cmds = ['disp ip int br','disp device','disp clock']
    ssh_client(ip, user, pwd, cmds)

參考資訊：

思科路由器和交換機SSH配置

---

如果喜歡的我的文章，歡迎關注我的公眾號：點滴技術，掃碼關注，不定期分享

相關推薦