WSSHc(1)

NAME
wssshc - WebSocket SSH Client for registration

SYNOPSIS
wssshc [--server-ip IP] [--port PORT] [--id ID] [--password PASSWORD] [--interval SECONDS] [--debug] [--help]

DESCRIPTION
wssshc is a lightweight client for registering machines with a WebSocket SSH daemon (wssshd). It establishes a persistent WebSocket connection and maintains registration with the server, allowing SSH/SCP tunneling through the registered machine.

Configuration can be provided via command line options or an optional INI-formatted configuration file at ~/.config/wsssh/wssshc.conf with a [wssshc] section. Command line options take precedence over configuration file values.

OPTIONS

--server-ip IP
    IP address or hostname of the wssshd server

--port PORT
    Port number of the wssshd server (default: 9898)

--id ID
    Unique client identifier for registration

--password PASSWORD
    Registration password for authentication

--interval SECONDS
    Reconnection interval in seconds if connection is lost (default: 30)

--debug
    Enable debug output for troubleshooting

--help
    Display help message and exit

CONFIGURATION
Configuration can be specified in ~/.config/wsssh/wssshc.conf using INI format:

[wssshc]
password = yourpassword
domain = example.com
server-ip = 192.168.1.100
port = 9898
id = client01

Command line options override configuration file values. If neither configuration file nor command line provides a required value, the program will exit with an error.

EXAMPLES

Register a client machine:
    wssshc --server-ip 192.168.1.100 --port 9898 --id workstation01 --password mysecret

Register with debug output:
    wssshc --server-ip server.example.com --id laptop01 --password secret --debug

SECURITY
All communications are encrypted using SSL/TLS. The client uses self-signed certificates by default. For production use, ensure proper certificate validation.

SEE ALSO
wssshd(1), wsssh(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://git.nexlab.net/nexlab/wsssh/issues