Django實現WebSSH操作物理機或虛擬機器
我想用它替換掉xshell、crt之類的工具
WebSSH操作物理機或虛擬機器
Django實現WebSSH操作Kubernetes Pod文章釋出後,有小夥伴說咖啡哥,我們現在還沒有用上Kubernetes,但我想通過瀏覽器連線我們的物理機和虛擬機器該怎麼辦?
這就比較簡單了,既然我們已經實現了瀏覽器操作Kubernetes的Pod,那麼想想操作Pod和物理機虛擬機器有什麼區別呢?
整個資料流是一點沒變:使用者開啟瀏覽器--》瀏覽器傳送websocket請求給Django建立長連線--》Django與要操作的伺服器建立SSH通道,實時的將收到的使用者資料傳送給SSH後的主機,並將主機執行的結果資料返回給瀏覽器
唯一不一樣的地方就是Django與要操作的伺服器建立SSH通道的方式,在Kubernetes中是通過Kubernetes提供的API建立的Stream流,而操作物理機或者虛擬機器的時候我們可以使用Paramiko
模組來建立SSH長連線隧道,Paramiko
模組建立SSH長連線通道的方法如下:
# 例項化SSHClient ssh = paramiko.SSHClient() # 當遠端伺服器沒有本地主機的金鑰時自動新增到本地,這樣不用在建立連線的時候輸入yes或no進行確認 ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy()) # 連線SSH伺服器,這裡以賬號密碼的方式進行認證,也可以用key ssh.connect(hostname=host, port=port, username=username, password=password, timeout=8) # 開啟ssh通道,建立長連線 transport = ssh.get_transport() self.ssh_channel = transport.open_session() # 獲取ssh通道,並設定term和終端大小 self.ssh_channel.get_pty(term=term, width=cols, height=rows) # 啟用終端,這樣就可以正常登陸了 self.ssh_channel.invoke_shell()
連線建立,可以通過如下方法給SSH通道傳送資料
self.ssh_channel.send(data)
當然SSH返回的資料也可以通過如下方法持續的輸出給Websocket
while not self.ssh_channel.exit_status_ready(): # SSH返回的資料需要轉碼為utf-8,否則json序列化會失敗 data = self.ssh_channel.recv(1024).decode('utf-8','ignore') if len(data) != 0: message = {'flag': 'success', 'message': data} self.websocket.send(json.dumps(message)) else: break
有了這些資訊,結合Django實現WebSSH操作Kubernetes Pod的文章,實現WebSSH瀏覽器操作物理機或者虛擬機器就不算困難了,完整的Consumer程式碼如下:
import io
import json
import paramiko
from threading import Thread
from channels.generic.websocket import WebsocketConsumer
from cmdb.backends.sshargs import args
class SSHBridge(object):
def __init__(self, websocket):
self.websocket = websocket
def connect(self, host, port, username, authtype, password=None, pkey=None, term='xterm', cols=80, rows=24):
ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
try:
if authtype == 2:
pkey = paramiko.RSAKey.from_private_key(io.StringIO(pkey))
ssh.connect(username=username, hostname=host, port=port, pkey=pkey, timeout=8)
else:
ssh.connect(hostname=host, port=port, username=username, password=password, timeout=8)
except Exception as e:
message = json.dumps({'flag': 'error', 'message': str(e)})
self.websocket.send(message)
return False
# 開啟一個ssh通道並建立連線
transport = ssh.get_transport()
self.ssh_channel = transport.open_session()
self.ssh_channel.get_pty(term=term, width=cols, height=rows)
self.ssh_channel.invoke_shell()
# 連線建立一次,之後互動資料不會再進入該方法
for i in range(2):
recv = self.ssh_channel.recv(1024).decode('utf-8', 'ignore')
message = json.dumps({'flag': 'success', 'message': recv})
self.websocket.send(message)
def close(self):
try:
self.websocket.close()
self.ssh_channel.close()
except BaseException as e:
pass
def _ws_to_ssh(self, data):
try:
self.ssh_channel.send(data)
except OSError as e:
self.close()
def _ssh_to_ws(self):
try:
while not self.ssh_channel.exit_status_ready():
data = self.ssh_channel.recv(1024).decode('utf-8', 'ignore')
if len(data) != 0:
message = {'flag': 'success', 'message': data}
self.websocket.send(json.dumps(message))
else:
break
except Exception as e:
message = {'flag': 'error', 'message': str(e)}
self.websocket.send(json.dumps(message))
self.close()
def shell(self, data):
Thread(target=self._ws_to_ssh, args=(data,)).start()
Thread(target=self._ssh_to_ws).start()
class SSHConsumer(WebsocketConsumer):
def connect(self):
self.pk = self.scope['url_route']['kwargs'].get('id')
self.query = self.scope.get('query_string')
self.user = self.scope['user']
self.accept()
# ssh_connect_args為SSH連線需要的引數
ssh_connect_args = args(self.pk, self.user, self.query)
self.ssh = SSHBridge(websocket=self)
self.ssh.connect(**ssh_connect_args)
def disconnect(self, close_code):
self.ssh.close()
def receive(self, text_data=None):
text_data = json.loads(text_data)
self.ssh.shell(data=text_data.get('data', ''))
動態調整終端視窗大小
看了Kubernetes WebSSH終端視窗自適應Resize文章,小夥伴又說了,你這隻能在連線建立時確定終端視窗的大小,如果我中途調整了瀏覽器的大小,顯示就亂了,這該怎麼辦?
不要著急,接下來就讓我們看看怎麼讓終端視窗隨著瀏覽器大小的調整而改變,上邊的文章中已經說過,終端視窗的大小需要瀏覽器和後端返回的Terminal大小保持一致,單單調整頁面視窗大小或者後端返回的Terminal視窗大小都是不行的,那麼從這兩個方向來說明該如何動態調整視窗的大小
首先Paramiko
模組建立的SSH通道可以通過resize_pty
來動態改變返回Terminal視窗的大小,使用方法如下:
def resize_pty(self, cols, rows):
self.ssh_channel.resize_pty(width=cols, height=rows)
然後Django的Channels每次接收到前端發過來的資料時,判斷一下視窗是否有變化,如果有變化則呼叫上邊的方法動態改變Terminal輸出視窗的大小
我在實現時會給傳過來的資料加個flag,如果flag是resize,則呼叫resize_pty的方法動態調整視窗大小,否則就正常呼叫執行命令的方法,程式碼如下:
def receive(self, text_data=None):
text_data = json.loads(text_data)
if text_data.get('flag') == 'resize':
self.ssh.resize_pty(cols=text_data['cols'], rows=text_data['rows'])
else:
self.ssh.shell(data=text_data.get('data', ''))
後端都搞定了,那麼來看看前端如何處理吧
首先有一個terminal_size的方法根據瀏覽器視窗大小除以每個字元所佔用的大小計算出cols和rows的值,無論是xterm.js還是Paramiko都是根據這兩個值來調整視窗大小的
function terminal_size() {
return {
cols: Math.floor($('#terminal').width() / 9),
rows: Math.floor($(window).height() / 17),
}
}
然後通過$(window).resize()
來檢測瀏覽器視窗的變化,一旦發生變化,則傳送一個帶resize標記的資料給Django,同時傳遞的資料還有新的cols和rows
// terminal resize
$(window).resize(function () {
let cols = terminal_size().cols;
let rows = terminal_size().rows;
send_data = JSON.stringify({
'flag': 'resize',
'cols': cols,
'rows': rows
});
socket.send(send_data);
term.resize(cols, rows)
})
最後通過term.resize
來調整xterm渲染的視窗的大小
這樣一個完整的動態調整視窗大小的方案就完成了
演示與原始碼
我寫了個簡單的Demo來實現上邊的功能,Demo寫完發現還挺好用,我就擴充套件了一下添加了內網的物理機和虛擬機器,歷史原因,有些是賬號密碼認證,有些是金鑰認證,我都給相容了一下,最終實現的效果如上圖所示
專案裡邊要記錄主機的密碼,為了安全這個密碼是通過RSA加密存放在資料庫的,每次使用的時候進行解密,加解密的實現,可參考這篇文章 Django開發密碼管理表例項【附原始碼】
最後,如果你對這個簡單的小玩意感興趣,想要自己實現,卻遇到了一些問題,可以通過公眾號後臺加我微信獲取原始碼
相關文章推薦閱讀:
- Django實現WebSSH操作Kubernetes Pod
- Kubernetes WebSSH終端視窗自適應Resize