How ankusht369/gossh works
gossh provides SSH-over-WebSocket transport: an SSH client connects to a local TCP port, the gossh client carries that stream over WSS to the gossh server, and the server bridges it to the existing sshd. The CLI also exposes server status and optional daemon mode. The relay service is an optional deployment layer documented in the README; source excerpts do not show its implementation. The shared tunnel session and logging are useful internal layers. Evidence is limited to the README and sampled source files.
Main entry points: main.go CLI modes · client.go Client WebSocket · server.go WebSocket handler · session.go Tunnel session
Components 13
CLI and process
- CLI modes
cmd/gossh/main.go - Daemon process
internal/daemon/daemon_unix.go
Client transport
- Local TCP listener
internal/client/client.go - Client WebSocket
internal/client/client.go
Server transport
- HTTP endpoints
internal/server/server.go - WebSocket handler
internal/server/server.go - Status response
internal/server/server.go
Shared runtime
- Tunnel session
internal/tunnel/session.go - Runtime logger
internal/log/log.go
Other components
- SSH user
- SSH client
- HTTPS relay
- SSH daemon
Connections 18
- SSH user → SSH client: starts
README.md - SSH client → Local TCP listener: connects to
README.md - CLI modes → Local TCP listener: starts client
cmd/gossh/main.go - Local TCP listener → Client WebSocket: opens per connection
internal/client/client.go - Client WebSocket → Tunnel session: creates session
internal/client/client.go - Client WebSocket → HTTPS relay: carries WSS
README.md - HTTPS relay → HTTP endpoints: forwards WebSocket
README.md - HTTP endpoints → WebSocket handler: routes /ws
internal/server/server.go - WebSocket handler → SSH daemon: dials SSH
internal/server/server.go - WebSocket handler → Tunnel session: creates session
internal/server/server.go - Tunnel session → SSH daemon: bridges TCP
- CLI modes → HTTP endpoints: starts server
cmd/gossh/main.go - CLI modes → Status response: requests status
cmd/gossh/main.go - HTTP endpoints → Status response: serves /status
internal/server/server.go - CLI modes → Daemon process: daemonizes
cmd/gossh/main.go - CLI modes → Runtime logger: initializes
cmd/gossh/main.go - Client WebSocket → Runtime logger: logs transport
internal/client/client.go - WebSocket handler → Runtime logger: logs transport
internal/server/server.go