1.9 KiB

Raw Blame History

ssh-chat

Custom SSH server written in Go. Instead of a shell, you get a chat prompt.

Demo

Join the party:

$ ssh chat.shazow.net

(Apologies if the server is down.)

Quick Start

Usage:
  ssh-chat [OPTIONS]

Application Options:
  -v, --verbose   Show verbose logging.
  -b, --bind=     Host and port to listen on. (0.0.0.0:22)
  -i, --identity= Private key to identify server with. (~/.ssh/id_rsa)

Help Options:
  -h, --help      Show this help message

After doing go get github.com/shazow/ssh-chat on this repo, you should be able to run a command like:

$ ssh-chat --verbose --bind ":2022" --identity ~/.ssh/id_dsa

To bind on port 22, you'll need to make sure it's free (move any other ssh daemons to another port) and run ssh-chat as root (or with sudo).

ssh-chat on Docker

You can run ssh-chat using a Docker image without manually installing go-lang:

$ docker pull alvin/ssh-chat
$ docker run -d -p 0.0.0.0:(your host machine port):2022 --name ssh-chat alvin/ssh-chat

Or you can build your own image:

$ docker build -t (your-docker-username)/ssh-chat .

then run it:

$ docker run -d -p 0.0.0.0:(your host machine port):2022 --name ssh-chat (your-docker-username)/ssh-chat

Developing

If you're developing on this repo, there is a handy Makefile that should set things up with make run.

TODO:

Welcome message.
set term width properly
client map rather than list
backfill chat history
tab completion
/ban
/ban by ip
/help
/about
/list
/nick
pubkey fingerprint
truncate usernames
rename collision bug
op ops on join
piped stdout bug
saner sanitizing of inputs (version string, allow space/period)
Some tests.
More tests.
Even more tests.
Lots of refactoring
- Pull out the chat-related stuff into isolation from the ssh serving stuff

License

MIT

1.9 KiB Raw Blame History