mirror of
https://github.com/parkervcp/eggs.git
synced 2024-11-27 08:52:54 +08:00
50 lines
2.8 KiB
Markdown
50 lines
2.8 KiB
Markdown
# Clusterio
|
|
|
|
*A Note on terminology. The developers of Clustorio are using the rather outdated Master/Slave terms for Primary/Secondary or Management/Processing nodes. We will use them in this guide and egg to avoid confusion, but would prefer a more modern set of terminology.*
|
|
|
|
## Introduction
|
|
|
|
Clusterio (https://github.com/clusterio/clusterio) is a clustered Factorio server manager that provides the tooling for implementing cross server interactions in Factorio.
|
|
It was previously best known for implementing cross server transfer and cloud storage of items via teleporter chests.
|
|
But this functionality has been pulled out of Clusterio into its own plugin for Clusterio named [Subspace Storage](https://github.com/clusterio/subspace_storage).
|
|
|
|
By itself Clusterio doesn't change the gameplay in any way, you could even use Clusterio to manage completely vanilla Factorio servers.
|
|
Plugins do the work of modding in the visible changes into the game, see the [Plugins section](#plugins) for ready-made plugins you can install into a Clusterio cluster.
|
|
|
|
## Features
|
|
|
|
- Clustered Factorio server management allowing you manage the running of Factorio servers across a fleet of physical servers from both a web interface and a command line interface.
|
|
|
|
- User list management for synchronizing in-game admins, whitelisted users, and bans to all the servers in the cluster.
|
|
|
|
- Integrated support for exporting statistics for the whole cluster to Prometheus via a single metrics endpoint.
|
|
|
|
- Extensive plugin support for adding your own cross server features to Factorio using Clusterio's communication backbone.
|
|
|
|
## Setup
|
|
|
|
Clusterio uses a Master/Slave system setup, with the Master server running the Web UI and controlling which Slaves run which Instances.
|
|
|
|
The Master server runs a web server that needs to be reachable for cluster management by the user, and by the other nodes to manage them.
|
|
|
|
The Slave server runs the factorio server, and will need any mods manually importing at this time, including the Factorio mods for the Clustorio Library(https://mods.factorio.com/mod/clusterio_lib) and Subspace Storage(https://mods.factorio.com/mod/subspace_storage).
|
|
|
|
Both only require a single port each.
|
|
|
|
Server Mode controls if the server is a master or slave, and each varaible is labeled as required for Master, Slave or All. Please ensure you fill in all required variables.
|
|
|
|
Set up the master server first, and from there you can generate the Master URL and Master Token required for the slave servers to connect.
|
|
|
|
Additional configuration options can be found in config-master.json and config-slave.json as relevant.
|
|
|
|
Changes to the Cluster will only be written out to the database on a graceful stop.
|
|
|
|
## Server Ports
|
|
|
|
Clusterio requires a single port
|
|
|
|
| Port | default |
|
|
|------------|------------|
|
|
| Master HTTP| 8081 |
|
|
| Slave Game | 34197 |
|