ssh-chat

README

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

Documentation

Overview

TODO: Split this out into its own module, it's kinda neat.

Borrowed from go.crypto circa 2011