ircd.chat/ircd
11
1
Fork 0
Code Issues Pull Requests 1 Releases Wiki Activity

readme

Browse Source
This commit is contained in:
Jeremy Latt 2014-03-18 15:29:31 -07:00
parent e5bba28daa
commit a4f4e4df9c
1 changed files with 20 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
README.md
View File

@ -1,8 +1,7 @@
# Ergonomadic
Ergonomadic is an IRC daemon written from scratch in Go. Pull requests and
issues are welcome. Discuss it here or on Freenode in
[#ergonomadic](irc://chat.freenode.net/#ergonomadic).
issues are welcome. Discuss it here or on Freenode in [#ergonomadic][irc].
## Some Features
@ -11,7 +10,7 @@ issues are welcome. Discuss it here or on Freenode in
- 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
- haproxy [PROXY protocol][proxy-proto] header for hostname setting
- passwords stored in bcrypt format
- channels that persist between restarts (+P)
@ -25,14 +24,17 @@ I wanted to learn Go.
## 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.
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][stunnel] version 4.56 with
haproxy's [PROXY protocol][proxy-proto]. This will allow the server to get the
client's original addresses for hostname lookups.
## What about federation?
IRC federation solves a problem that was more likely to occur on the internet of
1991 than today. We are exploring alternatives to federation that avoid nickname
and channel sync issues created during netsplits.
## Installation
@ -44,9 +46,8 @@ ergonomadic initdb -conf ergonomadic.conf
## Configuration
See the example `ergonomadic.conf`. Passwords are base64-encoded
bcrypted byte strings. You can generate them with the `genpasswd`
subcommand.
See the example `ergonomadic.conf`. Passwords are base64-encoded bcrypted byte
strings. You can generate them with the `genpasswd` subcommand.
```sh
ergonomadic genpasswd 'hunter2!'
@ -65,3 +66,8 @@ ergonomadic run -conf ergonomadic.conf
- [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)
[proxy-proto]: http://haproxy.1wt.eu/download/1.5/doc/proxy-protocol.txt
[irc]: irc://chat.freenode.net/#ergonomadic
[stunnel]: https://www.stunnel.org/index.html