Public/MCS-MCSManager
2
0
Fork 0
mirror of https://github.com/MCSManager/MCSManager.git synced 2025-11-27 23:10:24 +08:00
Code Issues Projects Releases Packages Wiki Activity
MCS-MCSManager/README_DE.md

13 KiB
Raw Permalink Blame History


Was ist das?

MCSManager Panel (abgekürzt: MCSM Panel) ist ein schnell bereitstellbares, verteilte Architektur unterstützendes, mehrbenutzerfähiges, einfaches und modernes Web-Verwaltungspanel für Minecraft- und Steam-Spielserver.

MCSManager hat in den Minecraft- und Steam-Gaming-Communities an Popularität gewonnen. Es hilft Ihnen dabei, mehrere physische Server zentral zu verwalten, ermöglicht es Ihnen, Spielserver auf jedem Host zu erstellen, und bietet ein sicheres und zuverlässiges Mehrbenutzer-Berechtigungssystem, das Ihnen einfach bei der Verwaltung mehrerer Server helfen kann. Es bietet bereits gesunde Software-Unterstützung für Administratoren, Betriebspersonal und einzelne Entwickler von Minecraft-, Terraria- und Steam-Spielservern.

Es eignet sich auch für alle kommerziellen Aktivitäten, wie z.B. IDC-Dienstanbieter für den Verkauf privater Server. Mehrere kleine und mittlere Unternehmen verwenden dieses Panel bereits als Management- und Verkaufssoftware, und es unterstützt mehrere Länder-Sprachen.

1 terminal 3 4

Funktionen

  1. Verwenden Sie den Anwendungsmarkt, um Minecraft- oder Steam-Spielserver mit einem Klick einfach bereitzustellen.
  2. Kompatibel mit den meisten Steam-Spielservern wie Palworld, Squad, Project Zomboid und Terraria usw.
  3. Web-Interface unterstützt Drag-and-Drop-Kartenlayout, um Ihr bevorzugtes Interface-Layout zu erstellen.
  4. Unterstützt alle Images auf Docker Hub, unterstützt Mehrbenutzer, unterstützt kommerzielle Instanz-Verkaufsdienste.
  5. Unterstützt verteilte Architektur, eine Web-Oberfläche kann mehrere Maschinen gleichzeitig verwalten.
  6. Einfache Technologie-Stack, Sie müssen nur TypeScript beherrschen, um die gesamte MCSManager-Entwicklung abzuschließen!
  7. Mehr...

Laufzeitumgebung

Das Kontrollpanel kann auf Windows- und Linux-Plattformen laufen, keine Datenbankinstallation erforderlich, Sie müssen nur die Node.js-Umgebung und mehrere Entpackungsbefehle installieren.

Sie müssen Node.js 16.20.2 oder höher verwenden, empfehlen wir die Verwendung der neuesten LTS-Version.


Offizielle Dokumentation

Englisch: https://docs.mcsmanager.com/

Chinesisch: https://docs.mcsmanager.com/zh_cn/


Installation

Windows

Für Windows-Systeme wird es als integrierte Version bereitgestellt, die sofort ausgeführt werden kann - herunterladen und sofort ausführen:

Archiv: https://download.mcsmanager.com/mcsmanager_windows_release.zip

Doppelklicken Sie auf start.bat, um sowohl das Web-Panel als auch den Daemon-Prozess zu starten.


Linux

Einzeiliger Befehl für schnelle Installation

sudo su -c "wget -qO- https://script.mcsmanager.com/setup.sh | bash"

Verwendung nach der Installation

systemctl start mcsm-{web,daemon} # Panel starten
systemctl stop mcsm-{web,daemon}  # Panel stoppen
  • Skript gilt nur für Ubuntu/Centos/Debian/Archlinux
  • Panel-Code und Laufzeitumgebung werden automatisch im /opt/mcsmanager/ Verzeichnis installiert.

Linux manuelle Installation

  • Wenn die Ein-Klick-Installation nicht funktioniert, können Sie diesen Schritt für die manuelle Installation versuchen.
# Zum Installationsverzeichnis wechseln. Wenn es nicht existiert, erstellen Sie es bitte mit 'mkdir /opt/' zuerst.
cd /opt/
# Laufzeitumgebung (Node.js) herunterladen. Wenn Sie bereits Node.js 16+ installiert haben, ignorieren Sie bitte diesen Schritt.
wget https://nodejs.org/dist/v20.11.0/node-v20.11.0-linux-x64.tar.xz
# Archiv entpacken
tar -xvf node-v20.11.0-linux-x64.tar.xz
# Programm zu System-Umgebungsvariablen hinzufügen.
ln -s /opt/node-v20.11.0-linux-x64/bin/node /usr/bin/node
ln -s /opt/node-v20.11.0-linux-x64/bin/npm /usr/bin/npm

# Installationsverzeichnis vorbereiten.
mkdir /opt/mcsmanager/
cd /opt/mcsmanager/

# MCSManager herunterladen.
wget https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_release.tar.gz
tar -zxf mcsmanager_linux_release.tar.gz

# Abhängigkeiten installieren.
chmod 775 install.sh
./install.sh

# Bitte öffnen Sie zwei Terminals oder screen.

# Zuerst node-Programm starten.
./start-daemon.sh

# Web-Service starten (im zweiten Terminal oder screen).
./start-web.sh

# Besuchen Sie http://<öffentliche IP>:23333/ um das Panel anzuzeigen.
# Im Allgemeinen wird die Web-Anwendung automatisch scannen und sich mit dem lokalen Daemon verbinden.

Diese Installationsmethode registriert das Panel nicht automatisch beim Systemdienst, daher müssen Sie screen-Software verwenden, um es zu verwalten. Wenn Sie möchten, dass der Systemdienst MCSManager übernimmt, lesen Sie bitte die Dokumentation.


Mac OS


# Zuerst Node.js installieren, wenn Sie es bereits installiert haben, können Sie diesen Schritt überspringen.
# Node.js empfiehlt die Installation der neuesten LTS-Version.
brew install node
node -v
npm -v

# Verwenden Sie curl zum Herunterladen von Dateien
curl -L https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_release.tar.gz -o mcsmanager_linux_release.tar.gz

# Dateien entpacken (gleicher Befehl wie ursprünglich)
tar -zxf mcsmanager_linux_release.tar.gz

cd mcsmanager

# Abhängigkeiten installieren.
chmod 775 install.sh
./install.sh

# Bitte öffnen Sie zwei Terminals oder screen.

# Zuerst node-Programm starten.
./start-daemon.sh

# Web-Service starten (im zweiten Terminal oder screen).
./start-web.sh

# Besuchen Sie http://localhost:23333/ um das Panel anzuzeigen.
# Im Allgemeinen wird die Web-Anwendung automatisch scannen und sich mit dem lokalen Daemon verbinden.

Installation über Docker

Installieren Sie das Panel mit docker-compose.yml, beachten Sie, dass Sie alle <CHANGE_ME_TO_INSTALL_PATH> zu Ihrem tatsächlichen Installationspfad ändern müssen.

services:
  web:
    image: githubyumao/mcsmanager-web:latest
    ports:
      - "23333:23333"
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - <CHANGE_ME_TO_INSTALL_PATH>/web/data:/opt/mcsmanager/web/data
      - <CHANGE_ME_TO_INSTALL_PATH>/web/logs:/opt/mcsmanager/web/logs

  daemon:
    image: githubyumao/mcsmanager-daemon:latest
    restart: unless-stopped
    ports:
      - "24444:24444"
    environment:
      - MCSM_DOCKER_WORKSPACE_PATH=<CHANGE_ME_TO_INSTALL_PATH>/daemon/data/InstanceData
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - <CHANGE_ME_TO_INSTALL_PATH>/daemon/data:/opt/mcsmanager/daemon/data
      - <CHANGE_ME_TO_INSTALL_PATH>/daemon/logs:/opt/mcsmanager/daemon/logs
      - /var/run/docker.sock:/var/run/docker.sock

Mit docker-compose aktivieren.

mkdir -p <CHANGE_ME_TO_INSTALL_PATH>
cd <CHANGE_ME_TO_INSTALL_PATH>
vim docker-compose.yml # Schreiben Sie den Inhalt der docker-compose.yml oben hier
docker compose pull && docker compose up -d

Hinweis: Nach der Docker-Installation kann die Web-Seite möglicherweise nicht mehr automatisch mit dem Daemon verbinden.

Zu diesem Zeitpunkt, wenn Sie das Panel betreten, sollten Sie einige Fehler sehen, weil die Web-Seite nicht erfolgreich mit der Daemon-Seite verbunden werden konnte, Sie müssen einen neuen Knoten erstellen, um sie zu verbinden.


Code-Beiträge

  • Muss vor Code-Beiträgen gelesen werden: https://github.com/MCSManager/MCSManager/issues/599

  • Code muss das bestehende Format beibehalten, übermäßige Code-Formatierung ist nicht erlaubt.

  • Alle Codes müssen den Internationalisierungsstandards entsprechen.


Entwicklung

Dieser Abschnitt ist für Entwickler. Wenn Sie Sekundärentwicklung an MCSManager durchführen oder Code-Beiträge einreichen möchten, lesen Sie bitte diese Inhalte sorgfältig:

Erforderlich

Wir verwenden Visual Studio Code zur Entwicklung von MCSManager. Sie müssen diese Plugins installieren:

  • i18n-Textanzeige-Unterstützung (I18n Ally)
  • Code-Formatierung (Prettier)
  • Vue - Official
  • ESLint

Abhängigkeitsdateien

Sie müssen zu den PTY und Zip-Tools Projekten gehen, um für Ihr System geeignete Binärdateien herunterzuladen und sie im daemon/lib Verzeichnis zu speichern (manuell erstellen, falls es nicht existiert), um den normalen Betrieb von Simulationsterminal und Dateientpackung zu gewährleisten.

Laden Sie drei Abhängigkeitsdateien herunter, wählen Sie entsprechend Ihrer Systemarchitektur aus, und überprüfen Sie die Releases, um Binärdateien zu finden, die zu Ihrem System und Ihrer Architektur passen.

Zum Beispiel:

cd /opt/mcsmanager/daemon
mkdir lib && cd lib

# Simulations-Terminal-Abhängigkeitsbibliothek
wget https://github.com/MCSManager/PTY/releases/download/latest/pty_linux_x64

# Bibliothek für Entpacken & Komprimieren von Dateien
wget https://github.com/MCSManager/Zip-Tools/releases/download/latest/file_zip_linux_x64

# 7z-Archiv-Unterstützung, optionaler Download
wget https://github.com/MCSManager/Zip-Tools/releases/download/latest/7z_linux_x64

Ausführung

git clone https://github.com/MCSManager/MCSManager.git

# MacOS
./install-dependents.sh
./npm-dev-macos.sh

# Windows
./install-dependents.bat
./npm-dev-windows.bat

Code-Internationalisierung

Da das Projekt mehrere Sprachen unterstützt, akzeptiert der Code nur Englisch für alle Strings und Kommentare, bitte kodieren Sie keine nicht-englischen Texte direkt im Code.

Zum Beispiel könnten Sie eine neue Zeichenkette schreiben, die mehrere Sprachen unterstützen muss.

import { $t } from "../i18n";

if (!checkName) {
  const errorMsg = "Check Name Failed!" // Tun Sie das nicht!
  const errorMsg = $t("TXT_CODE_MY_ERROR"); // Richtig!
}.

<script lang="ts" setup>
  import { t } from "@/lang/i18n";
  // ...
</script>

<template>
  <!-- ... -->
  <a-menu-item key="toNodesPage" @click="toNodesPage()">
    <FormOutlined />
    {{ t("TXT_CODE_NODE_INFO") }}
  </a-menu-item>
</template>

Bitte fügen Sie diese Zeile zur Sprachdatei hinzu, zum Beispiel: languages/en_US.json

Dabei ist en_US.json obligatorisch hinzuzufügen, es ist der Quelltext für alle Ländersprachen, andere Ländersprachen können von uns mit KI automatisch übersetzt werden.

{
  //...
  "TXT_CODE_MY_ERROR": "Check Name Failed!",
  "TXT_CODE_NODE_INFO": "Jump to Node Page"
}

Wenn Sie das I18n Ally Plugin installiert haben, sollte Ihr $t("TXT_CODE_MY_ERROR") den englischen Text anzeigen.

Wenn der Übersetzungstext Parameter tragen muss, könnte das etwas komplex werden, da Frontend und Backend verschiedene i18n-Bibliotheken verwenden, daher könnte das Format unterschiedlich sein. Sie müssen durch die Dateien schauen, um ähnliche Codes zu finden und zu verstehen.

Alle Übersetzungstextschlüssel können nicht dupliziert werden, bitte verwenden Sie einen längeren Namen!


Produktionsumgebungsversion erstellen

./build.bat # Windows
./build.sh  # MacOS

Nach dem Erstellen finden Sie den Produktionsumgebungscode im production-code Verzeichnis.


Browser-Kompatibilität

  • Unterstützt moderne Mainstream-Browser wie Chrome Firefox Safari Opera.
  • Hat die Unterstützung für IE-Browser aufgegeben.

Fehlerberichte

Willkommen zur Meldung aller gefundenen Probleme, wir werden sie schnell beheben.

Wenn Sie schwerwiegende Sicherheitslücken entdecken, die öffentlich nicht veröffentlicht werden können, senden Sie bitte eine E-Mail an: support@mcsmanager.com. Nach der Behebung von Sicherheitsproblemen wird der Name des Entdeckers im Code angehängt.


Lizenz

Der Quellcode folgt der Apache-2.0 Lizenz.

Copyright ©2025 MCSManager.