8,2 KiB
JTS3ServerMod-dockerized
Was ist es? Und kann ich es essen?
Erstens: Nein, Sie können es nicht essen. Sie können es aber als dockerisierte Variante des JTS3ServerMod verwenden.
JTS3ServerMod ist ein ziemlich perfekter Bot für Ihren TeamSpeak-Server – geschrieben in Java. Da einige Leute ein Docker-Image brauchen/wollen und der ursprüngliche Autor Stefan1200 keins zur Verfügung stellt, bin ich hier, um Ihnen zu helfen.
Unterstützte Architekturen
- linux/amd64
- linux/arm/v7
- linux/arm/v6
- linux/arm64/v8
Ausführen des Images
Sie können das Image wie jeden anderen Container ausführen, es stellt automatisch das erforderliche Voloume mit den Konfigurationsdateien bereit. Weitere Informationen zur Konfiguration des JTS3ServerMod finden Sie in den offiziellen Dokumentationen, entweder durch Einbinden des documents-Volumes oder durch den Besuch der Online-Dokumentation.
Mögliches Volume-Mapping
| Volume | Pfad im Container | Beschreibung |
|---|---|---|
| config | /JTS3ServerMod/config |
Konfigurationsdateien |
| documents | /JTS3ServerMod/documents |
Dokumentationsdateien des Bots + Original changelog.txt und readme.txt (+deutsche Variante) |
| plugins | /JTS3ServerMod/plugins |
In diesem Verzeichnis können zusätzliche Plugins hochgeladen werden - bitte folgen Sie der Dokumentation des JTS3ServerMod |
Beispiele
Ein Container mit benannten Volumes und festgelegten Namen
docker run --name jts3servermod-dockerized -v jts3_config:/JTS3ServerMod/config -v jts3_documents:/JTS3ServerMod/documents -v jts3_plugins:/JTS3ServerMod/plugins nickslowinski/jts3servermod-dockerized:dev
Ein Container mit gemounteten Volumes und festgelegten Namen
docker run --name jts3servermod-dockerized -v /ein/pfad/auf/dem/host/jts3_config:/JTS3ServerMod/config -v /ein/pfad/auf/dem/host/jts3_documents:/JTS3ServerMod/documents -v /ein/pfad/auf/dem/host/jts3_plugins:/JTS3ServerMod/plugins nickslowinski/jts3servermod-dockerized:dev
Häufige Probleme
Der Container stoppt sofort nach dem Start
Falls der Log-Auszug in etwa so aussieht wie der nachfolgende, dann bedeutet dies nicht, dass das Image defekt ist! Ihr müsst den Bot konfigurieren und erneut starten, solange Ihr keine Fehler in der Konfiguration begangen habt, startet der Bot erfolgreich.
JTS3ServerMod 6.5.7 (31.01.2020) Instance Manager started...
Operating System : Linux (version: 5.14.10-200.fc34.x86_64 / arch: amd64)
Used Java Version: 1.8.0_282 (path: /usr/lib/jvm/java-1.8-openjdk/jre)
Current directory: /JTS3ServerMod
Writing InstanceManager log file to: /JTS3ServerMod/JTS3ServerMod_InstanceManager.log
Loading InstanceManager config file from: /JTS3ServerMod/config/JTS3ServerMod_InstanceManager.cfg
bot1: Writing bot log file to: /JTS3ServerMod/JTS3ServerMod_server1.log
bot1: Virtual bot instance "bot1" starts now (build 6508)
bot1:
bot1: **********************************************************************************
bot1: It seems you never touched the config, check file config/server1/JTS3ServerMod_server.cfg
bot1: **********************************************************************************
bot1:
bot1: Unable to connect to Teamspeak 3 server at ts3.server.net!
bot1: java.net.UnknownHostException: ts3.server.net
bot1: Virtual bot instance "bot1" stopped
Stopping all bots, please wait...
Fehler beim Laden der JTS3ServerMod InstanceManager Konfigurationsdatei
Beispiel Log-Auszug:
JTS3ServerMod 6.5.7 (31.01.2020) Instance Manager started...
Operating System : Linux (version: 5.10.17-v8+ / arch: aarch64)
Used Java Version: 1.8.0_282 (path: /usr/lib/jvm/java-1.8-openjdk/jre)
Current directory: /JTS3ServerMod
Writing InstanceManager log file to: /JTS3ServerMod/JTS3ServerMod_InstanceManager.log
JTS3ServerMod InstanceManager configuration file does not exists, check file path:
/JTS3ServerMod/config/JTS3ServerMod_InstanceManager.cfg
Error while loading the JTS3ServerMod InstanceManager config file, read error messages above to know more. Quitting now...
Dieser Fehler konnte bisher immer nachweislich auf veraltete Softwareversionen zurückgeführt werden. Um diesen Fehler zu beheben, muss nur das System, unter anderem auch Docker und dessen Abhängigkeiten, aktualisiert werden. Sollte der Fehler nach erfolgreicher Aktualisierung und einem anschließenden Systemneustart immer noch auftreten, so eröffnet bitte ein Ticket.
Hilfe bekommen
Bitte verwenden Sie den Issue Tracker, um nach Ihrem Problem zu suchen (und verwenden Sie unterschiedliche Schlagwörter). Wenn Sie sichergestellt haben, dass Ihr Problem eindeutig ist, erstellen Sie ein Ticket und geben Sie hilfreiche Informationen wie Protokolle, was Sie getan haben, nützliche Teile deiner Konfiguration usw. an.
Wenn Sie eine Sicherheitslücke gefunden haben, kontaktieren Sie mich bitte privat per E-Mail unter nick@nick-slowinski.de (und verschlüsseln Sie die Nachricht mit mein PGP-Schlüssel wenn möglich). Sicherheitslücken werden priorisiert und nach der Veröffentlichung eines Fixes öffentlich bekannt gegeben.
Beitragen
Beiträge zu diesem Projekt sind herzlich willkommen. Wenn Sie einen Weg gefunden haben, dieses Projekt zu verbessern, öffnen Sie bitte ein Ticket und beschreiben Sie, was Sie erreichen möchten (damit Sie keine Zeit verschwenden, wenn Ihr Vorschlag außerhalb des Projektrahmens liegt).
Ein vollständiger Leitfaden für Mitwirkende wird zu einem späteren Zeitpunkt veröffentlicht.
Autoren
Lizenz
Dieses Projekt ist unter der GNU General Public License lizenziert. Den vollständigen englischen Lizenztext finden Sie in der LIZENZ-Datei.
Häufig gestellte Fragen
Planen Sie, Images für andere Architekturen zu veröffentlichen?
Vorerst nicht, aber wenn jemand eine andere Architektur anfordert (über den Issue Tracker), werde ich prüfen, was ich tun kann.
Warum verwenden Sie openjdk8 und nicht 11?
Ich möchte das Image so klein wie möglich halten, daher wurde OpenJDK 8 über 11 gewählt. Solange OpenJDK 8 unterstützt wird und für dieses Projekt ausreichend ist, wird es verwendet.
Wird die JTS3ServerMod Hosting Edition unterstützt?
Nicht im Moment. Ich kann ein Image dafür erstellen (Stefan1200 stellt die Downloads dafür bereit), aber es gibt keine Möglichkeit, es zu testen, da ich keinen Lizenzschlüssel dafür habe.