WSSH(1)

NAME
wsssh - WebSocket SSH wrapper for secure tunneling

SYNOPSIS
wsssh [--local-port PORT] [--debug] [--help] user@client.domain [SSH_OPTIONS...]

DESCRIPTION
wsssh is a wrapper around the standard SSH client that enables secure tunneling through WebSocket connections. It automatically parses hostnames to extract client IDs and server endpoints, establishes WebSocket tunnels, and launches SSH to connect through the tunnel.

OPTIONS

--local-port PORT
    Local port for tunnel establishment (default: auto-assign)

--debug
    Enable debug output for troubleshooting

--help
    Display help message and exit

HOSTNAME FORMAT
The hostname follows the format: client_id.wssshd_host[:port]

Examples:
    - remote.example.com → client: remote, server: example.com:22 - server.datacenter.com:9898 → client: server, server: datacenter.com:9898

EXAMPLES

Basic SSH connection:
    wsssh user@myclient.example.com -p 9898

SSH with custom options:
    wsssh -p 9898 -i ~/.ssh/key user@myclient.example.com ls -la

SSH with debug output:
    wsssh --debug user@remote.example.com -p 2222

ENVIRONMENT

WSSSH_DEBUG
    Set to 1 to enable debug output (alternative to --debug)

SECURITY
All tunnel communications are encrypted using SSL/TLS. The client verifies server certificates. For production deployments, use properly signed certificates.

EXIT STATUS
wsssh returns the exit status of the underlying SSH command.

SEE ALSO
ssh(1), wssshd(1), wssshc(1), wsscp(1)

AUTHOR
Written by Stefy Lanza <stefy@nexlab.net>

COPYRIGHT
Copyright © 2024 Stefy Lanza and SexHack.me. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.

BUGS
Report bugs to: https://github.com/stefy/wsssh/issues