webssh

WebSSH

مقدمة

تطبيق ويب بسيط يمكن استخدامه كعميل ssh للاتصال بخوادم ssh الخاصة بك. هو مكتوب في بايثون، على أساس تورنادو، باراميكو وxterm.js.

سمات

• دعم مصادقة كلمة مرور SSH، بما في ذلك كلمة المرور الفارغة.
• دعم مصادقة المفتاح العام SSH، بما في ذلك مفاتيح DSA RSA ECDSA Ed25519.
• المفاتيح المشفرة مدعومة.
• دعم المصادقة الثنائية (كلمة مرور لمرة واحدة تعتمد على الوقت).
• محطة ملء الشاشة مدعومة.
• نافذة المحطة يمكن تغيير حجمها.
• الكشف التلقائي عن الترميز الافتراضي لخادم ssh.
• المتصفحات الحديثة بما في ذلك Chrome وFirefox وSafari وEdge وOpera مدعومة.

معاينة

كيف يعمل

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

متطلبات

• بايثون 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-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 العادية من شبكة عامة أو حظرها، وتكون لإعادة التوجيه الأولوية على الحظر.
• حاول استخدام سياسة الرفض باعتبارها سياسة مفتاح المضيف المفقود إلى جانب المضيفين المعروفين الذين تم التحقق منهم، وهذا سيمنع هجمات الوسيط. الفكرة هي أنه يتحقق من ملف مفاتيح مضيف النظام ("~/.ssh/known_hosts") وملف مفاتيح مضيف التطبيق ("./known_hosts") بالترتيب، إذا لم يتم العثور على اسم مضيف خادم ssh أو لم يتم العثور على المفتاح متطابقة، سيتم إحباط الاتصال.