公眾號：《Python編程時光》，作者：明哥
在使用 Python 寫一些腳本的時候母债，在某些情況下尝抖，我們需要頻繁登陸遠(yuǎn)程服務(wù)去執(zhí)行一次命令衙熔，并返回一些結(jié)果青责。
在 shell 環(huán)境中脖隶，我們是這樣子做的产阱。
$ sshpass -p ${passwd} ssh -p ${port} -l ${user} -o StrictHostKeyChecking=no xx.xx.xx.xx "ls -l"
然后你會發(fā)現(xiàn)义屏，你的輸出有很多你并不需要庄敛，但是又不去不掉的一些信息（也許有方法，請留言交流）科汗，類似這樣
host: xx.xx.xx.xx, port: xx
Warning: Permanently added '[xx.xx.xx.xx]:xx' (RSA) to the list of known hosts.
Login failure: [Errno 1] This server is not registered to rmp platform, please confirm whether cdn server.
total 4
-rw-r--r-- 1 root root 239 Mar 30 2018 admin-openrc
對于直接使用 shell 命令藻烤，來執(zhí)行命令的，可以直接使用管道，或者將標(biāo)準(zhǔn)輸出重定向到文件的方法取得執(zhí)行命令返回的結(jié)果
1. 使用 subprocess
若是使用 Python 來做這件事怖亭，通常我們會第一時間涎显，想到使用 os.popen，os.system兴猩，commands期吓，subprocess 等一些命令執(zhí)行庫來間接獲取 。
但是據(jù)我所知倾芝，這些庫獲取的 output 不僅只有標(biāo)準(zhǔn)輸出讨勤，還包含標(biāo)準(zhǔn)錯誤（也就是上面那些多余的信息）
所以每次都要對 output 進(jìn)行的數(shù)據(jù)清洗脊岳，然后整理格式化帚桩，才能得到我們想要的數(shù)據(jù)。
用 subprocess 舉個例子，就像這樣子
import subprocess
ssh_cmd = "sshpass -p ${passwd} ssh -p 22 -l root -o StrictHostKeyChecking=no xx.xx.xx.xx 'ls -l'"
status, output = subprocess.getstatusoutput(ssh_cmd)
# 數(shù)據(jù)清理，格式化的就不展示了
<code...>
通過以上的文字 + 代碼的展示 ，可以感覺到 ssh 登陸的幾大痛點(diǎn)
- 痛點(diǎn)一：需要額外安裝 sshpass（如果不免密的話）
- 痛點(diǎn)二：干擾信息太多，數(shù)據(jù)清理秋泄、格式化相當(dāng)麻煩
- 痛點(diǎn)三：代碼實(shí)現(xiàn)不夠優(yōu)雅（有點(diǎn)土）姥敛，可讀性太差
- 痛點(diǎn)四：ssh 連接不能復(fù)用了赌，一次連接僅能執(zhí)行一次
- 痛點(diǎn)五：代碼無法全平臺之剧，僅能在 Linux 和 OSX 上使用
為了解決這幾個問題，我搜索了全網(wǎng)關(guān)于 Python ssh 的文章，沒有看到有完整介紹這方面的技巧的。
為此竹椒，我就翻閱了一個很火的 Github 項(xiàng)目： awesome-python-cn （https://github.com/BingmingWong/awesome-python-cn）翘贮。
期望在這里，找到有一些關(guān)于 遠(yuǎn)程連接 的一些好用的庫。
還真的被我找到了兩個
- sh.ssh
- Paramiko
2. 使用 sh.ssh
首先來介紹第一個浸剩，sh.ssh
sh 是一個可以讓你通過函數(shù)的調(diào)用來完成 Linxu/OSX 系統(tǒng)命令的一個庫重罪，非常好用惨篱，關(guān)于它有機(jī)會也寫篇介紹。
$ python3 -m pip install sh
今天只介紹它其中的一個函數(shù)：ssh
通常兩臺機(jī)器互訪常遂，為了方便，可設(shè)置免密登陸笆搓，這樣就不需要輸入密碼。
這段代碼可以實(shí)現(xiàn)免密登陸骇扇，并執(zhí)行我們的命令 ls -l
from sh import ssh
output=ssh("root@xx.xx.xx.xx", "-p 22", "ls -l")
print(output)
但有可能 ，我們并不想設(shè)置互信免密婿脸，為了使這段代碼更通用鸿脓，我假定我們沒有設(shè)置免密蛔溃，只能使用密碼進(jìn)行登陸麸塞。
問題就來了，要輸入密碼蜕径，必須得使用交互式的方法來輸入呀，在 Python 中要如何實(shí)現(xiàn)呢扒接？
原來 ssh 方法接收一個 _out 參數(shù)蒂教，這個參數(shù)可以為一個字符串脆荷，表示文件路徑，也可以是一個文件對象（或者類文件對象）观堂，還可以是一個回調(diào)函數(shù)，意思是當(dāng)有標(biāo)準(zhǔn)輸出時，就會調(diào)用將輸出內(nèi)容傳給這個函數(shù)礁叔。
這就好辦了呀。
我只要識別到有 password: 字樣冶伞，就往標(biāo)準(zhǔn)輸入寫入我的密碼就好了呀新症。
完整代碼如下：
import sys
from sh import ssh
aggregated = ""
def ssh_interact(char, stdin):
global aggregated
sys.stdout.write(char.encode())
sys.stdout.flush()
aggregated += char
if aggregated.endswith("password: "):
stdin.put("you_password\n")
output=ssh("root@xx.xx.xx.xx", "-p 22", "ls -l",_tty_in=True, _out_bufsize=0, _out=ssh_interact)
print(output)
這是官方文檔（http://amoffat.github.io/sh/tutorials/interacting_with_processes.html?highlight=ssh）給的一些信息，寫的一個demo响禽。
嘗試運(yùn)行后徒爹，發(fā)現(xiàn)程序會一直在運(yùn)行中，永遠(yuǎn)不會返回芋类，不會退出隆嗅，回調(diào)函數(shù)也永遠(yuǎn)不會進(jìn)入。
通過調(diào)試查看源代碼侯繁，仍然查不到問題所在胖喳，于是去 Github 上搜了下，原來在 2017 年就已經(jīng)存在這個問題了贮竟，到現(xiàn)在 2020 年了還沒有修復(fù)丽焊，看來使用 sh.ssh 的人并不多较剃，于是我又“追問”了下，期望能得到回復(fù)技健。
以上這個問題重付，只有在需要輸入密碼才會出現(xiàn)，如果設(shè)置了機(jī)器互信是沒有問題的凫乖。
為了感受 sh.ssh 的使用效果确垫，我設(shè)置了機(jī)器互信免密，然后使用如下這段代碼帽芽。
from sh import ssh
my_server=ssh.bake("root@xx.xx.xx.xx", "-p 22")
# 相當(dāng)于執(zhí)行登陸一次執(zhí)行一次命令删掀，執(zhí)行完就退出登陸
print(my_server.ls())
# 可在 sleep 期間，手動登陸服務(wù)器导街，使用 top 披泪，查看當(dāng)前有多少終端在連接
time.sleep(5)
# 再次執(zhí)行這條命令時，登陸終端數(shù)將 +1搬瑰，執(zhí)行完后款票，又將 -1
print(my_server.ifconfig())
驚奇地發(fā)現(xiàn)使用 bake 這種方式，my_server.ls() 和 my_server.ifconfig() 這種看似是通過同一個ssh連接泽论，執(zhí)行兩次命令艾少，可實(shí)際上，你可以在遠(yuǎn)程機(jī)器上翼悴，執(zhí)行 top 命令看到已連接的終端的變化缚够，會先 +1 再 -1，說明兩次命令的執(zhí)行是通過兩次連接實(shí)現(xiàn)的鹦赎。
如此看來谍椅，使用 sh.ssh 可以解決痛點(diǎn)一（如果上述問題能得到解決）、痛點(diǎn)二古话、痛點(diǎn)三雏吭。
但是它仍然無法復(fù)用 ssh 連接，還是不太方便陪踩，不是我理想中的最佳方案杖们。
最重要的一點(diǎn)是， sh 這個模塊膊毁，僅支持 Linxu/OSX 胀莹，在 Windows 你得使用它的兄弟庫 - pbs ，然后我又去 pypi 看了一眼 pbs婚温，已經(jīng) “年久失修”描焰，沒人維護(hù)了。
至此，我離 “卒”荆秦，就差最后一根稻草了篱竭。
3. 使用 paramiko
帶著最后一絲希望，我嘗試使用了 paramiko 這個庫步绸，終于在 paramiko 這里掺逼，找回了本應(yīng)屬于 Python 的那種優(yōu)雅。
你可以通過如下命令去安裝它
$ python3 -m pip install paramiko
然后接下來瓤介，就介紹幾種常用的 ssh 登陸的方法
方法1：基于用戶名和密碼的 sshclient 方式登錄
然后你可以參考如下這段代碼吕喘，在 Linux/OSX 系統(tǒng)下進(jìn)行遠(yuǎn)程連接
import paramiko
ssh = paramiko.SSHClient()
# 允許連接不在know_hosts文件中的主機(jī)
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
# 建立連接
ssh.connect("xx.xx.xx.xx", username="root", port=22, password="you_password")
# 使用這個連接執(zhí)行命令
ssh_stdin, ssh_stdout, ssh_stderr = ssh.exec_command("ls -l")
# 獲取輸出
print(ssh_stdout.read())
# 關(guān)閉連接
ssh.close()
方法2：基于用戶名和密碼的 transport 方式登錄
方法1 是傳統(tǒng)的連接服務(wù)器、執(zhí)行命令刑桑、關(guān)閉的一個操作氯质，多個操作需要連接多次，無法復(fù)用連接[痛點(diǎn)四]祠斧。
有時候需要登錄上服務(wù)器執(zhí)行多個操作闻察，比如執(zhí)行命令、上傳/下載文件琢锋，方法1 則無法實(shí)現(xiàn)辕漂，那就可以使用 transport 的方法。
import paramiko
# 建立連接
trans = paramiko.Transport(("xx.xx.xx.xx", 22))
trans.connect(username="root", password="you_passwd")
# 將sshclient的對象的transport指定為以上的trans
ssh = paramiko.SSHClient()
ssh._transport = trans
# 剩下的就和上面一樣了
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
ssh_stdin, ssh_stdout, ssh_stderr = ssh.exec_command("ls -l")
print(ssh_stdout.read())
# 關(guān)閉連接
trans.close()
方法3：基于公鑰密鑰的 SSHClient 方式登錄
import paramiko
# 指定本地的RSA私鑰文件
# 如果建立密鑰對時設(shè)置的有密碼吴超，password為設(shè)定的密碼钉嘹，如無不用指定password參數(shù)
pkey = paramiko.RSAKey.from_private_key_file('/home/you_username/.ssh/id_rsa', password='12345')
# 建立連接
ssh = paramiko.SSHClient()
ssh.connect(hostname='xx.xx.xx.xx',
port=22,
username='you_username',
pkey=pkey)
# 執(zhí)行命令
stdin, stdout, stderr = ssh.exec_command('ls -l')
# 結(jié)果放到stdout中，如果有錯誤將放到stderr中
print(stdout.read())
# 關(guān)閉連接
ssh.close()
方法4：基于密鑰的 Transport 方式登錄
import paramiko
# 指定本地的RSA私鑰文件
# 如果建立密鑰對時設(shè)置的有密碼烛芬，password為設(shè)定的密碼隧期，如無不用指定password參數(shù)
pkey = paramiko.RSAKey.from_private_key_file('/home/you_username/.ssh/id_rsa', password='12345')
# 建立連接
trans = paramiko.Transport(('xx.xx.xx.xx', 22))
trans.connect(username='you_username', pkey=pkey)
# 將sshclient的對象的transport指定為以上的trans
ssh = paramiko.SSHClient()
ssh._transport = trans
# 執(zhí)行命令，和傳統(tǒng)方法一樣
stdin, stdout, stderr = ssh.exec_command('df -hl')
print(stdout.read().decode())
# 關(guān)閉連接
trans.close()
以上四種方法赘娄，可以幫助你實(shí)現(xiàn)遠(yuǎn)程登陸服務(wù)器執(zhí)行命令，如果需要復(fù)用連接：一次連接執(zhí)行多次命令宏蛉，可以使用 方法二 和 方法四
用完后遣臼，記得關(guān)閉連接。
實(shí)現(xiàn) sftp 文件傳輸
同時拾并，paramiko 做為 ssh 的完美解決方案揍堰，它非常專業(yè)，利用它還可以實(shí)現(xiàn) sftp 文件傳輸嗅义。
import paramiko
# 實(shí)例化一個trans對象# 實(shí)例化一個transport對象
trans = paramiko.Transport(('xx.xx.xx.xx', 22))
# 建立連接
trans.connect(username='you_username', password='you_passwd')
# 實(shí)例化一個 sftp對象,指定連接的通道
sftp = paramiko.SFTPClient.from_transport(trans)
# 發(fā)送文件
sftp.put(localpath='/tmp/11.txt', remotepath='/tmp/22.txt')
# 下載文件
sftp.get(remotepath='/tmp/22.txt', localpath='/tmp/33.txt')
trans.close()
到這里屏歹，Paramiko 已經(jīng)完勝了，但是仍然有一個痛點(diǎn)我們沒有提及之碗，就是多平臺蝙眶，說的就是 Windows，這里就有一件好事，一件壞事了幽纷，式塌。
好事就是：paramiko 支持 windows
壞事就是：你需要做很多復(fù)雜的準(zhǔn)備，你可 google 解決友浸，但是我建議你直接放棄峰尝，坑太深了。
4. 寫在最后
經(jīng)過了一番對比收恢，和一些實(shí)例的展示武学，可以看出 Paramiko 是一個專業(yè)、讓人省心的 ssh 利器伦意，個人認(rèn)為 Paramiko 模塊是運(yùn)維人員必學(xué)模塊之一劳淆，如果你恰好需要在 Python 代碼中實(shí)現(xiàn) ssh 到遠(yuǎn)程服務(wù)器去獲取一些信息，那么我把 Paramiko 推薦給你默赂。
最后沛鸵，希望這篇文章，能給你帶來幫助缆八。
5. 參考鏈接
本篇文章由一文多發(fā)平臺ArtiPub自動發(fā)布
