From e1d39da3dba522da6c907c28f373776579480d7f Mon Sep 17 00:00:00 2001 From: Darknet Villain Date: Mon, 30 Jan 2017 09:11:09 -0500 Subject: [PATCH] Improved IRC tut --- docs/tutorials/irc.md | 85 ++++++++++++++++++++++++------------------- 1 file changed, 47 insertions(+), 38 deletions(-) diff --git a/docs/tutorials/irc.md b/docs/tutorials/irc.md index f627858..1e61360 100644 --- a/docs/tutorials/irc.md +++ b/docs/tutorials/irc.md @@ -1,65 +1,74 @@ Anonymous chat servers ====================== +## Connect to anonymous IRC server + +You can connect to IRC servers in I2P by using **Socks proxy**. By default, it listens at ``127.0.0.1:4447`` +(look at [configuration docs](../user-guide/configuration.md) for details). +Configure your IRC client to use this Socks proxy and connect to I2P servers just like to any other servers. + +*Alternatively*, you may want to create **client I2P tunnel** to specific server. +This way, i2pd will "bind" IRC server port on your computer and you will be able to connect to server without modifying any IRC client settings. + +To connect to IRC server at *irc.ilita.i2p:6667*, add this to ~/.i2pd/tunnels.conf: + + [IRC2] + type = client + address = 127.0.0.1 + port = 6669 + destination = walker.i2p + destinationport = 6667 + #keys = walker-keys.dat + +Restart i2pd, then connect to irc://127.0.0.1:6669 with your IRC client. + ## Running anonymous IRC server 1) Run your IRC server software and find out which host:port it uses (for example, 127.0.0.1:5555). - For small private IRC servers you can use [miniircd](https://github.com/jrosdahl/miniircd), for large public networks [UnreadIRCd](https://www.unrealircd.org/). + For small private IRC servers you can use [miniircd](https://github.com/jrosdahl/miniircd), for large public networks [UnreadIRCd](https://www.unrealircd.org/). 2) Configure i2pd to create IRC server tunnel. - Simplest case, if your server does not support WebIRC, add this to ~/.i2pd/tunnels.conf: + Simplest case, if your server does not support WebIRC, add this to ~/.i2pd/tunnels.conf: - [anon-chatserver] - type = irc - host = 127.0.0.1 - port = 5555 - keys = chatserver-key.dat + [anon-chatserver] + type = irc + host = 127.0.0.1 + port = 5555 + keys = chatserver-key.dat - And that is it. + And that is it. - Alternatively, if your IRC server supports WebIRC, for example, UnreadIRCd, put this into UnrealIRCd config: + Alternatively, if your IRC server supports WebIRC, for example, UnreadIRCd, put this into UnrealIRCd config: - webirc { - mask 127.0.0.1; - password your_password; - }; + webirc { + mask 127.0.0.1; + password your_password; + }; - Also change line: + Also change line: - modes-on-connect "+ixw"; + modes-on-connect "+ixw"; - to + to - modes-on-connect "+iw"; + modes-on-connect "+iw"; - And this in ~/.i2pd/tunnels.conf: + And this in ~/.i2pd/tunnels.conf: - [anon-chatserver] - type = irc - host = 127.0.0.1 - port = 5555 - keys = chatserver-key.dat - webircpassword = your_password + [anon-chatserver] + type = irc + host = 127.0.0.1 + port = 5555 + keys = chatserver-key.dat + webircpassword = your_password 3) Restart i2pd. 4) Find b32 destination of your anonymous IRC server. - Go to webconsole -> [I2P tunnels page](http://127.0.0.1:7070/?page=i2p_tunnels). Look for Sever tunnels and you will see address like \.b32.i2p next to anon-chatserver. + Go to webconsole -> [I2P tunnels page](http://127.0.0.1:7070/?page=i2p_tunnels). Look for Sever tunnels and you will see address like \.b32.i2p next to anon-chatserver. - Clients will use this address to connect to your server anonymously. + Clients will use this address to connect to your server anonymously. -## Connect to anonymous IRC server - -To connect to IRC server at *walker.i2p*, add this to ~/.i2pd/tunnels.conf: - - [IRC2] - type = client - address = 127.0.0.1 - port = 6669 - destination = walker.i2p - #keys = walker-keys.dat - -Restart i2pd, then connect to irc://127.0.0.1:6669 with your IRC client.