Mercurial > prosody-modules
comparison mod_s2sout_override/README.md @ 5486:71243bedb2b0
mod_s2sout_override: New module for overriding s2s connections
This takes advantage of the new event added in Prosody rev d5f322dd424b
which enables a cleaner way to override the connection using a resolver.
| author | Kim Alvefur <zash@zash.se> |
|---|---|
| date | Wed, 24 May 2023 15:56:26 +0200 |
| parents | |
| children | 6cf2f32dbf40 |
comparison
equal
deleted
inserted
replaced
| 5485:67190744b1eb | 5486:71243bedb2b0 |
|---|---|
| 1 --- | |
| 2 summary: Override s2s connection targets | |
| 3 --- | |
| 4 | |
| 5 This module replaces [mod_s2soutinjection] and uses more modern and | |
| 6 reliable methods for overriding connection targets. | |
| 7 | |
| 8 # Configuration | |
| 9 | |
| 10 Enable the module as usual, then specify a map of XMPP remote hostnames | |
| 11 to URIs like `"tcp://host.example:port"`, to have Prosody connect there | |
| 12 instead of doing normal DNS SRV resolution. | |
| 13 | |
| 14 Currently only the `tcp://` scheme is supported. A future version could | |
| 15 support more methods including Direct TLS, alternate SRV lookup targets | |
| 16 or even UNIX sockets. | |
| 17 | |
| 18 ```lua | |
| 19 -- Global section | |
| 20 modules_enabled = { | |
| 21 -- other global modules | |
| 22 "s2sout_override"; | |
| 23 } | |
| 24 | |
| 25 s2sout_override = { | |
| 26 ["example.com"] = "tcp://other.host.example:5299"; | |
| 27 ["xmpp.example.net"] = "tcp://localhost:5999"; | |
| 28 } | |
| 29 ``` | |
| 30 | |
| 31 # Compatibility | |
| 32 | |
| 33 Prosody version status | |
| 34 --------------- ---------- | |
| 35 0.12.4 Will work | |
| 36 0.12.3 Will not work | |
| 37 0.11 Will not work |