webssh

웹SSH

소개

SSH 서버에 연결하기 위해 SSH 클라이언트로 사용되는 간단한 웹 애플리케이션입니다. 이는 tornado, paramiko 및 xterm.js를 기반으로 Python으로 작성되었습니다.

특징

• 빈 비밀번호를 포함하여 SSH 비밀번호 인증이 지원됩니다.
• DSA RSA ECDSA Ed25519 키를 포함하여 SSH 공개 키 인증이 지원됩니다.
• 암호화된 키가 지원됩니다.
• 2단계 인증(시간 기반 일회용 비밀번호)이 지원됩니다.
• 전체 화면 터미널이 지원됩니다.
• 터미널 창 크기 조정 가능.
• 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 서버의 호스트 이름을 찾을 수 없거나 키가 없으면 시스템 호스트 키 파일("~/.ssh/known_hosts")과 응용 프로그램 호스트 키 파일("./known_hosts")을 순서대로 확인한다는 개념입니다. 일치하면 연결이 중단됩니다.