2021-09-05 07:31:47 -07:00
|
|
|
# mt-multiserver-proxy
|
|
|
|
mt-multiserver-proxy is a reverse proxy designed for linking
|
|
|
|
multiple Minetest servers together. It is the successor to multiserver.
|
2021-09-10 05:51:20 -07:00
|
|
|
# mt
|
|
|
|
This project was made possible by [anon55555's mt module](https://github.com/anon55555/mt).
|
2021-08-28 04:20:57 -07:00
|
|
|
## Installation
|
2021-09-02 11:25:15 -07:00
|
|
|
Go 1.17 or higher is required. Run
|
2021-08-28 04:20:57 -07:00
|
|
|
|
2021-09-10 04:43:03 -07:00
|
|
|
`go install github.com/HimbeerserverDE/mt-multiserver-proxy/cmd/mt-multiserver/proxy@latest`
|
2021-08-28 04:20:57 -07:00
|
|
|
|
2021-09-05 07:31:47 -07:00
|
|
|
to download and compile the project. A mt-multiserver-proxy executable
|
2021-09-10 04:43:03 -07:00
|
|
|
will be created in your $GOBIN directory. The same command is also
|
|
|
|
used to upgrade to the latest version. You will need to recompile
|
|
|
|
all plugins after upgrading.
|
2021-08-28 04:20:57 -07:00
|
|
|
## Usage
|
2021-08-28 06:06:18 -07:00
|
|
|
### Starting
|
2021-09-05 07:31:47 -07:00
|
|
|
Run `$GOBIN/mt-multiserver-proxy`. The configuration file and other required
|
2021-08-28 04:20:57 -07:00
|
|
|
files are created automatically in the directory the executable
|
|
|
|
(or symlink to said executable) is in, so make sure to move the
|
|
|
|
executable to the desired location or use a symlink.
|
2021-08-28 06:06:18 -07:00
|
|
|
### Stopping
|
2021-09-05 07:31:47 -07:00
|
|
|
mt-multiserver-proxy reacts to SIGINT, SIGTERM and SIGHUP. It stops listening
|
2021-08-28 06:06:18 -07:00
|
|
|
for new connections, kicks all clients, disconnects from all servers
|
2021-09-05 07:31:47 -07:00
|
|
|
and exits. If some clients aren't responding, mt-multiserver-proxy waits until
|
2021-08-28 06:06:18 -07:00
|
|
|
they have timed out.
|
2021-08-28 04:20:57 -07:00
|
|
|
## Configuration
|
|
|
|
The configuration file name and format are described in [doc/config.md](doc/config.md)
|
|
|
|
**All internal servers need to allow empty passwords and must not be reachable from the internet!**
|
2021-09-10 04:43:03 -07:00
|
|
|
## Chat commands
|
2021-09-10 05:51:20 -07:00
|
|
|
The default chat commands can be installed as a [plugin](https://github.com/HimbeerserverDE/mt-multiserver-chatcommands).
|