Skip to content

hullarb/ssheasy

Repository files navigation

ssheasy

Source repositorty of the online ssh, sftp client ssheasy.com

Building, running locally

docker-compose up

This will compile the wasm ssh, sftp client, the proxy component that proxies tcp connections for the client running in the browser through websocket and sets up nginx server serving the web frontend. Additionaly prometheus and grafana is set up as well to monitor the connections proxied. An sshd is also started in a container for testing.

connect endpoint

Use /connect?host=HOST&port=PORT&user=USER&password=PASSWORD for initiating connection right away after opening the url.

Parameter Description Default Value
host SSH server hostname or IP address
port SSH server port 22
user SSH username
password SSH password
pk Private key (as string, for key auth)
webauthnKey WebAuthn key ID (for WebAuthn auth) -1
connect Whether to auto-connect ("true"/"false") "true"

Notes:

  • host is mandatory if connect is "true" (or not provided).
  • If connect is "false", the connection will not auto-initiate, but the provided connection data will be filled in the connection form.

Testing

For testing docker-compose sets up an sshd in a separate container. After starting up the stack with docker-compose up open http://localhost:8080 in your browser and use the host testssh with user root and password root.

Testing Webauthn

After building the project and creating a webauthn key copy the displayed public key to the ssh_conf/authorized_keys file and start the testopenssh service in the docker compose if you have not started it yet. User name is linuxserver.io hostname: testopenssh port: 2222.

Project structure

  • nginx: web server config, Dockerfile for building the wasm ssh/sftp client
  • proxy: golang proxy service for tunneling tcp connections through websocket
  • web: source of the ssh, sftp wasm client, and the httml for the frontend

Filemanager UI

The filemanager is based on forked version) of angular-filemanager. The fork replaces the backend api calls with calls to the wasm sftp client. The fork has to be built separately and copied to the web/html/node_modules directory.

About

ssh, sftp client running in the browser powered by golang and wasm

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages