JBounce IRC Bouncer
JBounce is an IRC-bouncer written in Java. It can be protected on usermask and password basis. IPv4 and IPv6 are supported by default, so it may well be used as a gateway to an IPv6 IRC-server from a client that has no IPv6-support.An IRC-bouncer is much like a proxy server for IRC. Instead of connecting directly to an IRC-server, clients can connect through the bouncer. The bouncer, in turn, connects to the IRC-server, and passes through all the messages between the client and the server.
Requirements
For using this program, you need:- a computer with Java (1.4.0 or newer) installed
- access to an IRC server from that computer
- any IRC-client
Version history
Version 1.0-pre1
The current pre-release and only public release as of yet. The program works, but some improvements would be more than nice.Ready:
- Basic bouncer functionality. Accepts connections, authenticates users, connects to IRC-server.
- Authenticates on usermask (nick, ircuser, hostname) and a password.
- Everything can be configured through a configuration file (XML).
- Works well on both IPv4 and IPv6.
- Decent logging should be added.
- Add protection against brute force attacks (temporary blacklist i.e.).
- Entire application needs code cleanup and structure check.
- Disconnects are handled OK, but not clean enough.
Download and installation
The files at the bottom of this page contain the bouncer's source code or the compiled files. Just download the binary if you don't need to modify the program. To compile the sources you need a standard J2SE 1.4 or better and the apache's ant.Right-click and choose save to download the file(s) you want. On *nix, extract the files with tar zxf jbou
nce-x.x-xxx.tar.gz. On windows, use any compatible tool for windows, like WinZIP or WinRAR to extract the
files.
To run the bouncer, follow these steps:
- Put the
jbounce.jarandbouncer.xmlin the same directory - Modify the
bouncer.xmlwith any text editor (like vi, notepad) to suit your configuration - Start the bouncer by typing
java -jar jbounce.jar. If you double-click thejbounce.jar-file on Windows the program should start, but you will not see any messages, and you'll have to kill the program off through ctrl alt del if you wish to quit the bouncer. - Use your favourite IRC-client to connect to the listening IP-address and port. Specify the user's password as a server-password, or login manually by typing
/QUOTE PASS passwordwhen connected.
- Add an asterisk and a (non-default) server to the password in your client-program. This server needs to be allowed for this user in the configuration file. An example password:
secret*irc.someothernet.com. - Are you a BitchX-user? Then
BitchX nickname hostname:port:passwordis the startup syntax. ;-)