2713bcba34
This adds support for listening on a Unix socket for administrative connections, that then use a simple protocol for communicating with the service (BouncerServ) as an administrator with a global context. The wire format used by the Unix socket is IRC, but without registration or overheads. Example session: >>> BOUNCERSERV <<< 461 * BOUNCERSERV :Not enough parameters >>> BOUNCERSERV :n s <<< :gensou FAIL BOUNCERSERV :this command must be run as a user >>> BOUNCERSERV :u s <<< :gensou PRIVMSG * :marisa: 2 networks <<< :gensou PRIVMSG * :alice: 1 networks <<< :gensou BOUNCERSERV OK |
||
---|---|---|
auth | ||
cmd | ||
config | ||
contrib | ||
database | ||
doc | ||
identd | ||
msgstore | ||
xirc | ||
.build.yml | ||
.editorconfig | ||
.gitignore | ||
certfp.go | ||
config.in | ||
conn.go | ||
downstream.go | ||
go.mod | ||
go.sum | ||
irc_test.go | ||
irc.go | ||
LICENSE | ||
Makefile | ||
net_go113.go | ||
net_go116.go | ||
rate.go | ||
README.md | ||
server_test.go | ||
server.go | ||
service_test.go | ||
service.go | ||
upstream.go | ||
user.go |
soju
soju is a user-friendly IRC bouncer. soju connects to upstream IRC servers on behalf of the user to provide extra functionality. soju supports many features such as multiple users, numerous IRCv3 extensions, chat history playback and detached channels. It is well-suited for both small and large deployments.
Usage
Building and installing
Dependencies:
- Go
- BSD or GNU make
- a C89 compiler (optional, for SQLite)
- scdoc (optional, for man pages)
For end users, a Makefile
is provided:
make
sudo make install
For development, you can use go run ./cmd/soju
as usual.
To link with the system libsqlite3, set GOFLAGS="-tags=libsqlite3"
. To disable
SQLite support, set GOFLAGS="-tags=nosqlite"
. To build with PAM authentication
support, set GOFLAGS="-tags=pam"
.
To use an alternative SQLite library that does not require CGO, set GOFLAGS="-tags=moderncsqlite"
.
Contributing
Send patches on the mailing list or on GitHub, report bugs on the issue tracker. Discuss in #soju on Libera Chat.
License
AGPLv3, see LICENSE.
Copyright (C) 2020 The soju Contributors