webssh

WebSSH

Perkenalan

Aplikasi web sederhana untuk digunakan sebagai klien ssh untuk terhubung ke server ssh Anda. Itu ditulis dengan Python, berdasarkan tornado, paramiko dan xterm.js.

Fitur

• Otentikasi kata sandi SSH didukung, termasuk kata sandi kosong.
• Otentikasi kunci publik SSH didukung, termasuk kunci DSA RSA ECDSA Ed25519.
• Kunci terenkripsi didukung.
• Otentikasi Dua Faktor (kata sandi satu kali berbasis waktu) didukung.
• Terminal layar penuh didukung.
• Jendela terminal dapat diubah ukurannya.
• Deteksi otomatis pengkodean default server ssh.
• Browser modern termasuk Chrome, Firefox, Safari, Edge, Opera didukung.

Pratinjau

Bagaimana cara kerjanya

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

Persyaratan

• Python 3.8+

Mulai cepat

1. Instal aplikasi ini, jalankan perintah pip install webssh
2. Mulai server web, jalankan perintah wssh
3. Buka browser Anda, navigasikan ke 127.0.0.1:8888
4. Masukkan data Anda, kirimkan formulir.

Opsi server

 # 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

Konsol peramban

 // 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' ) ;

Font Khusus

Untuk menggunakan font khusus, letakkan file font Anda di direktori webssh/static/css/fonts/ dan restart server.

Argumen URL

Mendukung penyampaian argumen berdasarkan url (kueri atau fragmen) seperti contoh berikut:

Melewati data formulir (kata sandi harus dikodekan dalam base64, kunci pribadi tidak didukung)

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

Melewati warna latar belakang terminal

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

Melewati warna font terminal

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

Melewati judul yang ditentukan pengguna

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

Melewati pengkodean

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

Melewati ukuran font

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

Melewati perintah yang dieksekusi tepat setelah login

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

Melewati tipe terminal

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

Gunakan Docker

Mulai aplikasi

 docker-compose up

Hancurkan aplikasinya

 docker-compose down

Tes

Persyaratan

 pip install pytest pytest-cov codecov flake8 mock

Gunakan unittest untuk menjalankan semua tes

 python -m unittest discover tests

Gunakan pytest untuk menjalankan semua tes

 python -m pytest tests

Penyebaran

Berjalan di belakang server 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 ;
}

Berjalan sebagai server mandiri

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

Kiat

• Untuk pilihan penerapan apa pun yang Anda pilih, jangan lupa untuk mengaktifkan SSL.
• Secara default, permintaan http biasa dari jaringan publik akan dialihkan atau diblokir dan pengalihan akan lebih diutamakan daripada pemblokiran.
• Cobalah untuk menggunakan kebijakan penolakan sebagai kebijakan kunci host yang hilang bersama dengan host_yang diketahui terverifikasi Anda, ini akan mencegah serangan man-in-the-middle. Idenya adalah memeriksa file kunci host sistem("~/.ssh/known_hosts") dan file kunci host aplikasi("./known_hosts") secara berurutan, jika nama host server ssh tidak ditemukan atau kuncinya tidak cocok, koneksi akan dibatalkan.