Ver código fonte

add i2pd b32 address directions

Fixes #1686
pull/2148/head
Shivaram Lingamneni 1 semana atrás
pai
commit
19b9867409
1 arquivos alterados com 11 adições e 0 exclusões
  1. 11
    0
      docs/MANUAL.md

+ 11
- 0
docs/MANUAL.md Ver arquivo

@@ -60,6 +60,7 @@ _Copyright © Daniel Oaks <daniel@danieloaks.net>, Shivaram Lingamneni <slingamn
60 60
     - [Migrating from Anope or Atheme](#migrating-from-anope-or-atheme)
61 61
     - [HOPM](#hopm)
62 62
     - [Tor](#tor)
63
+    - [I2P](#i2p)
63 64
     - [ZNC](#znc)
64 65
     - [External authentication systems](#external-authentication-systems)
65 66
     - [DNSBLs and other IP checking systems](#dnsbls-and-other-ip-checking-systems)
@@ -1142,6 +1143,16 @@ Instructions on how client software should connect to an .onion address are outs
1142 1143
 1. [Hexchat](https://hexchat.github.io/) is known to support .onion addresses, once it has been configured to use a local Tor daemon as a SOCKS proxy (Settings -> Preferences -> Network Setup -> Proxy Server).
1143 1144
 1. Pidgin should work with [torsocks](https://trac.torproject.org/projects/tor/wiki/doc/torsocks).
1144 1145
 
1146
+## I2P
1147
+
1148
+I2P is an anonymizing overlay network similar to Tor. The recommended configuration for I2P is to treat it similarly to Tor: have the i2pd reverse proxy its connections to an Ergo listener configured with `tor: true`. See the [i2pd configuration guide](https://i2pd.readthedocs.io/en/latest/tutorials/irc/#running-anonymous-irc-server) for more details; note that the instructions to separate I2P traffic from other localhost traffic are unnecessary for a `tor: true` listener.
1149
+
1150
+I2P can additionally expose an opaque client identifier (the user's "b32 address"). Exposing this identifier via Ergo is not recommended, but if you wish to do so, you can use the following procedure:
1151
+
1152
+1. Enable WEBIRC support in the i2pd configuration by adding the `webircpassword` key to the [i2pd server block](https://i2pd.readthedocs.io/en/latest/tutorials/irc/#running-anonymous-irc-server)
1153
+1. Remove `tor: true` from the relevant Ergo listener config
1154
+1. Enable WEBIRC support in Ergo (starting from the default/recommended configuration, find the existing webirc block, delete the `certfp` configuration, change `password` to use the output of `ergo genpasswd` on the password you configured i2pd to send, and set `accept-hostname: true`)
1155
+1. To prevent Ergo from overwriting the hostname as passed from i2pd, set the following options: `server.ip-cloaking.enabled: false` and `server.lookup-hostnames: false`. (There is currently no support for applying cloaks to regular IP traffic but displaying the b32 address for I2P traffic).
1145 1156
 
1146 1157
 ## ZNC
1147 1158
 

Carregando…
Cancelar
Salvar