2012-04-17 21:24:26 -07:00
|
|
|
# Ergonomadic
|
2012-04-17 21:23:12 -07:00
|
|
|
|
2014-02-27 11:07:21 -08:00
|
|
|
Ergonomadic is an IRC daemon written from scratch in Go. Pull requests
|
|
|
|
|
and issues are welcome.
|
2012-04-17 21:23:12 -07:00
|
|
|
|
2014-02-24 09:41:09 -08:00
|
|
|
## Some Features
|
|
|
|
|
|
|
|
|
|
- follows the RFC where possible
|
2014-03-01 14:45:23 -08:00
|
|
|
- gcfg gitconfig-style configuration
|
|
|
|
|
- server password (PASS command)
|
|
|
|
|
- channels with most standard modes
|
|
|
|
|
- IRC operators (OPER command)
|
|
|
|
|
- haproxy [PROXY protocol](http://haproxy.1wt.eu/download/1.5/doc/proxy-protocol.txt) header for hostname setting
|
2014-02-24 09:41:09 -08:00
|
|
|
- passwords stored in bcrypt format
|
2014-02-25 16:48:12 -08:00
|
|
|
- channels that persist between restarts (+P)
|
2014-02-24 09:41:09 -08:00
|
|
|
|
2013-05-24 21:39:53 -07:00
|
|
|
## Why?
|
2012-04-17 21:58:26 -07:00
|
|
|
|
|
|
|
|
I wanted to learn Go.
|
|
|
|
|
|
2013-05-24 21:39:53 -07:00
|
|
|
## What's with the name?
|
2012-04-17 21:58:26 -07:00
|
|
|
|
|
|
|
|
"Ergonomadic" is an anagram of "Go IRC Daemon".
|
2012-12-09 12:51:50 -08:00
|
|
|
|
2014-03-01 14:45:23 -08:00
|
|
|
## What about SSL/TLS support?
|
|
|
|
|
|
|
|
|
|
Go has a not-yet-verified-as-safe TLS 1.2 implementation. Sadly, many
|
|
|
|
|
popular IRC clients will negotiate nothing newer than SSLv2. If you
|
|
|
|
|
want to use SSL to protect traffic, I recommend using
|
|
|
|
|
[stunnel](https://www.stunnel.org/index.html) version 4.56 with
|
|
|
|
|
haproxy's
|
|
|
|
|
[PROXY protocol](http://haproxy.1wt.eu/download/1.5/doc/proxy-protocol.txt). This
|
|
|
|
|
will allow the server to get the client's original addresses for
|
|
|
|
|
hostname lookups.
|
|
|
|
|
|
2014-02-26 22:25:10 -08:00
|
|
|
## Installation
|
2014-02-09 15:15:02 -08:00
|
|
|
|
|
|
|
|
```sh
|
2014-02-24 09:41:09 -08:00
|
|
|
go get
|
2014-02-09 15:15:02 -08:00
|
|
|
go install
|
2014-03-05 23:40:49 +01:00
|
|
|
ergonomadic -conf ergonomadic.conf -initdb
|
2014-02-26 22:25:10 -08:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Configuration
|
|
|
|
|
|
2014-03-01 14:45:23 -08:00
|
|
|
See the example `ergonomadic.conf`. Passwords are base64-encoded
|
|
|
|
|
bcrypted byte strings. You can generate them with the `genpasswd`
|
|
|
|
|
subcommand.
|
2014-02-26 22:25:10 -08:00
|
|
|
|
|
|
|
|
```sh
|
2014-03-01 14:45:23 -08:00
|
|
|
ergonomadic -genpasswd 'hunter2!'
|
2014-02-26 22:25:10 -08:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Running the Server
|
|
|
|
|
|
|
|
|
|
```sh
|
2014-03-05 23:40:49 +01:00
|
|
|
ergonomadic -conf ergonomadic.conf
|
2013-05-24 21:39:53 -07:00
|
|
|
```
|
2014-02-27 11:07:21 -08:00
|
|
|
|
|
|
|
|
## Helpful Documentation
|
|
|
|
|
|
|
|
|
|
- [RFC 1459: Internet Relay Chat Protocol](http://tools.ietf.org/html/rfc1459)
|
|
|
|
|
- [RFC 2811: IRC Channel Management](http://tools.ietf.org/html/rfc2811)
|
|
|
|
|
- [RFC 2812: IRC Client Protocol](http://tools.ietf.org/html/rfc2812)
|
|
|
|
|
- [RFC 2813: IRC Server Protocol](http://tools.ietf.org/html/rfc2813)
|
|
|
|
|
- [IRC/2 Numeric List](https://www.alien.net.au/irc/irc2numerics.html)
|
