webssh

網路SSH

介紹

一個簡單的 Web 應用程序，用作 ssh 客戶端來連接到 ssh 伺服器。它是用Python編寫的，基於tornado、paramiko和xterm.js。

特徵

• 支援SSH密碼認證，包括空密碼。
• 支援 SSH 公鑰身份驗證，包括 DSA RSA ECDSA Ed25519 金鑰。
• 支援加密密鑰。
• 支援雙重認證（基於時間的一次性密碼）。
• 支援全螢幕終端機。
• 終端機視窗可調整大小。
• 自動偵測 ssh 伺服器的預設編碼。
• 支援 Chrome、Firefox、Safari、Edge、Opera 等現代瀏覽器。

預覽

它是如何運作的

 +---------+     http     +--------+    ssh    +-----------+
| browser | <==========> | webssh | <=======> | ssh server|
+---------+   websocket  +--------+    ssh    +-----------+

要求

• Python 3.8+

快速入門

1. 安裝此應用程序，運行命令pip install webssh
2. 啟動網路伺服器，運行命令wssh
3. 開啟瀏覽器，導航至127.0.0.1:8888
4. 輸入您的數據，提交表格。

伺服器選項

 # start a http server with specified listen address and listen port
wssh --address= ' 2.2.2.2 ' --port=8000

# start a https server, certfile and keyfile must be passed
wssh --certfile= ' /path/to/cert.crt ' --keyfile= ' /path/to/cert.key '

# missing host key policy
wssh --policy=reject

# logging level
wssh --logging=debug

# log to file
wssh --log-file-prefix=main.log

# more options
wssh --help

瀏覽器控制台

 // connect to your ssh server
wssh . connect ( hostname , port , username , password , privatekey , passphrase , totp ) ;

// pass an object to wssh.connect
var opts = {
  hostname : 'hostname' ,
  port : 'port' ,
  username : 'username' ,
  password : 'password' ,
  privatekey : 'the private key text' ,
  passphrase : 'passphrase' ,
  totp : 'totp'
} ;
wssh . connect ( opts ) ;

// without an argument, wssh will use the form data to connect
wssh . connect ( ) ;

// set a new encoding for client to use
wssh . set_encoding ( encoding ) ;

// reset encoding to use the default one
wssh . reset_encoding ( ) ;

// send a command to the server
wssh . send ( 'ls -l' ) ;

自訂字體

若要使用自訂字體，請將字體檔案放在目錄webssh/static/css/fonts/中並重新啟動伺服器。

URL 參數

支援透過 url（查詢或片段）傳遞參數，如下例所示：

傳遞表單資料（密碼必須採用base64編碼，不支援私鑰）

http://localhost:8888/ ? hostname=xx & username=yy & password=str_base64_encoded

傳遞終端背景顏色

http://localhost:8888/ # bgcolor=green

傳遞終端字體顏色

http://localhost:8888/ # fontcolor=red

傳遞使用者定義的標題

http://localhost:8888/ ? title=my-ssh-server

傳遞編碼

http://localhost:8888/ # encoding=gbk

傳遞字體大小

http://localhost:8888/ # fontsize=24

傳遞登入後立即執行的命令

http://localhost:8888/ ? command=pwd

傳遞終端類型

http://localhost:8888/ ? term=xterm-256color

使用 Docker

啟動應用程式

 docker-compose up

拆掉應用程式

 docker-compose down

測試

要求

 pip install pytest pytest-cov codecov flake8 mock

使用unittest運行所有測試

 python -m unittest discover tests

使用 pytest 運行所有測試

 python -m pytest tests

部署

在 Nginx 伺服器後面運行

wssh --address= ' 127.0.0.1 ' --port=8888 --policy=reject

 # Nginx config example
location / {
    proxy_pass http://127.0.0.1:8888;
    proxy_http_version 1.1 ;
    proxy_read_timeout 300 ;
    proxy_set_header Upgrade $http_upgrade ;
    proxy_set_header Connection "upgrade" ;
    proxy_set_header Host $http_host ;
    proxy_set_header X-Real-IP $remote_addr ;
    proxy_set_header X-Real-PORT $remote_port ;
}

作為獨立伺服器運行

wssh --port=8080 --sslport=4433 --certfile= ' cert.crt ' --keyfile= ' cert.key ' --xheaders=False --policy=reject

尖端

• 無論您選擇哪種部署選擇，都不要忘記啟用 SSL。
• 預設情況下，來自公共網路的純 http 請求將被重定向或阻止，並且重定向優先於被阻止。
• 嘗試使用拒絕策略作為遺失的主機金鑰策略以及經過驗證的known_hosts，這將防止中間人攻擊。這個想法是，如果未找到ssh 伺服器的主機名稱或金鑰不存在，它會按順序檢查系統主機金鑰檔案（“~/.ssh/known_hosts”）和應用程式主機金鑰檔案（“./known_hosts ”）匹配時，連接將被中止。