History

Brad Fitzpatrick e8551d6b40 all: use Go 1.21 slices, maps instead of x/exp/{slices,maps} Updates #8419 Signed-off-by: Brad Fitzpatrick <bradfitz@tailscale.com>		2023-08-17 08:42:35 -07:00
..
LICENSE	…
README.md	…
agent.go	refactor: move from io/ioutil to io and os packages	2022-09-15 21:45:53 -07:00
conn.go	…
context.go	ssh/tailssh: add support for sending multiple banners	2022-10-09 14:59:48 -07:00
context_test.go	all: remove old +build tags	2022-11-04 07:25:42 -07:00
doc.go	all: gofmt for Go 1.19	2022-08-02 10:08:05 -07:00
example_test.go	refactor: move from io/ioutil to io and os packages	2022-09-15 21:45:53 -07:00
options.go	refactor: move from io/ioutil to io and os packages	2022-09-15 21:45:53 -07:00
options_test.go	all: remove old +build tags	2022-11-04 07:25:42 -07:00
server.go	ssh/tailssh: add support for sending multiple banners	2022-10-09 14:59:48 -07:00
server_test.go	all: remove old +build tags	2022-11-04 07:25:42 -07:00
session.go	…
session_test.go	all: remove old +build tags	2022-11-04 07:25:42 -07:00
ssh.go	ssh/tailssh: do the full auth flow during ssh auth	2022-10-09 10:27:31 -07:00
ssh_test.go	…
tcpip.go	…
tcpip_test.go	all: use Go 1.21 slices, maps instead of x/exp/{slices,maps}	2023-08-17 08:42:35 -07:00
util.go	…
wrap.go	…

README.md

gliderlabs/ssh

The Glider Labs SSH server package is dope. —@bradfitz, Go team member

This Go package wraps the crypto/ssh package with a higher-level API for building SSH servers. The goal of the API was to make it as simple as using net/http, so the API is very similar:

 package main

 import (
     "tailscale.com/tempfork/gliderlabs/ssh"
     "io"
     "log"
 )

 func main() {
     ssh.Handle(func(s ssh.Session) {
         io.WriteString(s, "Hello world\n")
     })  

     log.Fatal(ssh.ListenAndServe(":2222", nil))
 }

This package was built by @progrium after working on nearly a dozen projects at Glider Labs using SSH and collaborating with @shazow (known for ssh-chat).

Examples

A bunch of great examples are in the _examples directory.

Usage

See GoDoc reference.

Contributing

Pull requests are welcome! However, since this project is very much about API design, please submit API changes as issues to discuss before submitting PRs.

Also, you can join our Slack to discuss as well.