labels:
- 'Stage-Alpha' summary: s2s to I2P hidden services ...
This plugin allows Prosody to connect to other servers that are running as a I2P hidden service. Running Prosody on a hidden service works without this module, this module is only necessary to allow Prosody to federate to hidden XMPP servers.
fork from mod_onions
This module depends on the bit32 Lua library.
To create a hidden service that can federate with other hidden XMPP servers, first add a hidden serivce to I2P. It should listen on port 5269 and optionally also on 5222 (if c2s connections to the hidden service should be allowed).
To add I2P hidden service, you can check the manual of you client like i2pd
Use the hostname that I2P gives with a virtualhost:
VirtualHost "somethingbase32.b32.i2p"
modules_enabled = { "i2p" };
And to use it for muc or other component,you should enable it like:
Component "conference.somethingbase32.b32.i2p" "muc"
modules_enabled={
"i2p";
}
| Name | Description | Type | Default value |
|---|---|---|---|
| i2p_socks5_host | the host to connect to for I2P's SOCKS5 proxy | string | "127.0.0.1" |
| i2p_socks5_port | the port to connect to for I2P's SOCKS5 proxy | integer | 4447 |
| i2p_only | forbid all connection attempts to non-I2P servers | boolean | false |
| i2p_s2s_all | pass all s2s connections through I2P | boolean | false |
| i2p_map | override the address for a host | table | {} |
By setting i2p_map, it is possible to override the address used to
connect to a given host with the address of a hidden service. The
configuration of i2p_map works as follows:
i2p_map = {
["something.org"] = "something.b32.i2p";
}
or, to also specify a port:
i2p_map = {
["something.org"] = { host = "something.b32.i2p", port = 5269 };
}
NOTICE:the map is not fully tested
And if you want to register a domain of .i2p, you need to make hostname like something.something.i2p. NOTICE that you will set the host on something.something.i2p instead of something.i2p.
| 0.8 | Doesn’t work |
|---|---|
| 0.9 | Works |
Not tested, but should be like mod_onions
i2p_s2s_alldoes not look up SRV records first. Therefore it will fail for many servers.- mod_i2p currently does not support connecting to
.i2pentries in SRV records.
- Running a hidden service on a server together with a normal server might expose the hidden service.
- A hidden service that wants to remain hidden should either disallow
s2s to non-hidden servers or pass all s2s traffic through I2P
(setting either
i2p_onlyori2p_s2s_all).