https://github.com/mvrilo/ssh-chat
Chat over SSH.
https://github.com/mvrilo/ssh-chat
Last synced: 9 months ago
JSON representation
Chat over SSH.
- Host: GitHub
- URL: https://github.com/mvrilo/ssh-chat
- Owner: mvrilo
- License: mit
- Fork: true (shazow/ssh-chat)
- Created: 2014-12-16T03:16:42.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2014-12-17T23:32:06.000Z (over 11 years ago)
- Last Synced: 2025-03-26T19:02:15.199Z (over 1 year ago)
- Language: Go
- Homepage:
- Size: 249 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: history.go
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/shazow/ssh-chat)
# 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
```
The server's RSA key fingerprint is `e5:d5:d1:75:90:38:42:f6:c7:03:d7:d0:56:7d:6a:db`. If you see something different, you might be [MITM](https://en.wikipedia.org/wiki/Man-in-the-middle_attack)'d.
(Apologies if the server is down, try again shortly.)
## Quick Start
```
Usage:
ssh-chat [OPTIONS]
Application Options:
-v, --verbose Show verbose logging.
-i, --identity= Private key to identify server with. (~/.ssh/id_rsa)
--bind= Host and port to listen on. (0.0.0.0:22)
--admin= Fingerprint of pubkey to mark as admin.
--whitelist= Optional file of pubkey fingerprints that are allowed to connect
--motd= Message of the Day file (optional)
--pprof= enable http server for pprof
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).
## Deploying with 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
```
See notes in the header of our Dockerfile for details on building your own image.
## Developing
If you're developing on this repo, there is a handy Makefile that should set
things up with `make run`.
Additionally, `make debug` runs the server with an http `pprof` server. This allows you to open [http://localhost:6060/debug/pprof/]() and view profiling data. See [net/http/pprof](http://golang.org/pkg/net/http/pprof/) for more information about `pprof`.
## License
MIT