MCS-MCSManager/README_FR.md at master

mirror of https://github.com/MCSManager/MCSManager.git synced 2025-11-27 23:10:24 +08:00

yumao233 f483071d3f docs: update README files to include instructions for downloading dependency files for terminal emulation and file compression features

2025-11-17 11:11:54 +08:00

14 KiB

Raw Permalink Blame History

English - 简体中文 - 繁體中文 - Deutsch - Português BR - 日本語 - Spanish - Thai - Français

Qu'est-ce que c'est ?

MCSManager Panel (abréviation : MCSM Panel) est un panneau d'administration web moderne, simple, multi-utilisateur, compatible avec l'architecture distribuée et à déploiement rapide pour les serveurs de jeux Minecraft et Steam.

MCSManager a gagné en popularité dans les communautés de jeux Minecraft et Steam. Il vous aide à gérer centralement plusieurs serveurs physiques, vous permet de créer des serveurs de jeux sur n'importe quel hôte, et fournit un système de permissions multi-utilisateur sécurisé et fiable qui peut facilement vous aider à gérer plusieurs serveurs. Il a fourni un support logiciel sain aux administrateurs, au personnel d'exploitation et aux développeurs individuels de serveurs de jeux Minecraft, Terraria et Steam.

Il convient également à toute activité commerciale, comme les fournisseurs de services IDC pour la vente de serveurs privés, etc. Plusieurs petites et moyennes entreprises utilisent déjà ce panneau comme logiciel de gestion et de vente, et il prend en charge les langues de plusieurs pays.

Fonctionnalités

Utilisez le marché d'applications pour déployer facilement des serveurs de jeux Minecraft ou Steam en un clic.
Compatible avec la plupart des serveurs de jeux Steam, comme Palworld, Squad, Project Zomboid et Terraria, etc.
L'interface web prend en charge la mise en page de cartes glisser-déposer pour créer votre mise en page d'interface préférée.
Prend en charge toutes les images sur Docker Hub, prend en charge multi-utilisateur, prend en charge les services de vente d'instances commerciales.
Prend en charge l'architecture distribuée, une interface web peut gérer plusieurs machines simultanément.
Pile technologique simple, vous n'avez besoin que de maîtriser TypeScript pour terminer tout le développement MCSManager !
Plus...

Environnement d'exécution

Le panneau de contrôle peut s'exécuter sur les plateformes Windows et Linux, aucune installation de base de données requise, vous n'avez besoin que d'installer l'environnement Node.js et plusieurs commandes de décompression.

Vous devez utiliser Node.js 16.20.2 ou supérieur, nous recommandons d'utiliser la dernière version LTS.

Documentation Officielle

Anglais : https://docs.mcsmanager.com/

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

Installation

Windows

Pour les systèmes Windows, il est fourni comme une version intégrée prête à l'emploi - téléchargez et exécutez immédiatement :

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

Double-cliquez sur start.bat pour lancer à la fois le panneau web et le processus daemon.

Linux

Commande d'une ligne pour installation rapide

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

Utilisation après installation

systemctl start mcsm-{web,daemon} # Démarrer le panneau
systemctl stop mcsm-{web,daemon}  # Arrêter le panneau

Le script ne s'applique qu'à Ubuntu/Centos/Debian/Archlinux
Le code du panneau et l'environnement d'exécution sont installés automatiquement dans le répertoire /opt/mcsmanager/.

Installation manuelle Linux

Si l'installation en un clic ne fonctionne pas, vous pouvez essayer cette étape pour l'installation manuelle.

# Passer au répertoire d'installation. S'il n'existe pas, veuillez le créer avec 'mkdir /opt/' d'abord.
cd /opt/
# Télécharger l'environnement d'exécution (Node.js). Si vous avez déjà Node.js 16+ installé, veuillez ignorer cette étape.
wget https://nodejs.org/dist/v20.11.0/node-v20.11.0-linux-x64.tar.xz
# Extraire l'archive
tar -xvf node-v20.11.0-linux-x64.tar.xz
# Ajouter le programme aux variables d'environnement système.
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

# Préparer le répertoire d'installation.
mkdir /opt/mcsmanager/
cd /opt/mcsmanager/

# Télécharger MCSManager.
wget https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_release.tar.gz
tar -zxf mcsmanager_linux_release.tar.gz

# Installer les dépendances.
chmod 775 install.sh
./install.sh

# Veuillez ouvrir deux terminaux ou screen.

# Démarrer d'abord le programme node.
./start-daemon.sh

# Démarrer le service web (dans le deuxième terminal ou screen).
./start-web.sh

# Visitez http://<IP publique>:23333/ pour voir le panneau.
# Généralement, l'application web scannera automatiquement et se connectera au démon local.

Cette méthode d'installation n'enregistre pas automatiquement le panneau aux services système, vous devez donc utiliser le logiciel screen pour le gérer. Si vous voulez que le service système prenne en charge MCSManager, veuillez consulter la documentation.

Mac OS


# D'abord installer Node.js, si vous l'avez déjà installé, vous pouvez ignorer cette étape.
# Node.js recommande d'installer la dernière version LTS.
brew install node
node -v
npm -v

# Utiliser curl pour télécharger les fichiers
curl -L https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_release.tar.gz -o mcsmanager_linux_release.tar.gz

# Extraire les fichiers (même commande que l'original)
tar -zxf mcsmanager_linux_release.tar.gz

cd mcsmanager

# Installer les dépendances.
chmod 775 install.sh
./install.sh

# Veuillez ouvrir deux terminaux ou screen.

# Démarrer d'abord le programme node.
./start-daemon.sh

# Démarrer le service web (dans le deuxième terminal ou screen).
./start-web.sh

# Visitez http://localhost:23333/ pour voir le panneau.
# Généralement, l'application web scannera automatiquement et se connectera au démon local.

Installation via Docker

Installez le panneau en utilisant docker-compose.yml, notez que vous devez modifier tous les <CHANGE_ME_TO_INSTALL_PATH> vers votre chemin d'installation réel.

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

Activer en utilisant docker-compose.

mkdir -p <CHANGE_ME_TO_INSTALL_PATH>
cd <CHANGE_ME_TO_INSTALL_PATH>
vim docker-compose.yml # Écrivez le contenu du docker-compose.yml ci-dessus ici
docker compose pull && docker compose up -d

Note : Après l'installation Docker, le côté Web peut ne plus se connecter automatiquement au Daemon.

À ce moment-là, si vous entrez dans le panneau, vous devriez voir quelques erreurs parce que le côté Web n'a pas réussi à se connecter avec succès au côté daemon, vous devez créer un nouveau nœud pour les connecter ensemble.

Contribution de code

Doit être lu avant de contribuer au code : https://github.com/MCSManager/MCSManager/issues/599
Le code doit maintenir le format existant, le formatage excessif du code n'est pas autorisé.
Tout le code doit respecter les normes d'internationalisation.

Développement

Cette section est pour les développeurs. Si vous voulez faire du développement secondaire sur MCSManager ou soumettre des contributions de code, veuillez lire attentivement ces contenus :

Requis

Nous utilisons Visual Studio Code pour développer MCSManager. Vous devez installer ces plugins :

Support d'affichage de texte i18n (I18n Ally)
Formatage de code (Prettier)
Vue - Official
ESLint

Fichiers de dépendances

Vous devez aller aux projets PTY et Zip-Tools pour télécharger les fichiers binaires appropriés pour votre système, les stocker dans le répertoire daemon/lib (créer manuellement s'il n'existe pas) pour assurer le fonctionnement normal du terminal de simulation et de la décompression de fichiers.

Téléchargez trois fichiers de dépendances, sélectionnez selon l'architecture de votre système, et consultez les releases pour trouver les binaires adaptés à votre système et architecture.

Par exemple :

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

# Bibliothèque de dépendances du terminal de simulation
wget https://github.com/MCSManager/PTY/releases/download/latest/pty_linux_x64

# Bibliothèque de dépendances pour extraire et compresser des fichiers
wget https://github.com/MCSManager/Zip-Tools/releases/download/latest/file_zip_linux_x64

# Support des archives 7z, téléchargement optionnel
wget https://github.com/MCSManager/Zip-Tools/releases/download/latest/7z_linux_x64

Exécution

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

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

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

Internationalisation du code

Comme le projet s'adapte à plusieurs langues, toutes les chaînes et commentaires dans le code n'acceptent que l'anglais, veuillez donc ne pas coder du texte non-anglais directement dans le code.

Par exemple, vous pourriez écrire une nouvelle chaîne qui doit s'adapter à plusieurs langues.

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

if (!checkName) {
  const errorMsg = "Check Name Failed!" // Ne faites pas ça !
  const errorMsg = $t("TXT_CODE_MY_ERROR"); // Correct !
}.

<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>

Veuillez ajouter cette ligne au fichier de langue, par exemple : languages/en_US.json

Parmi eux, en_US.json est obligatoire à ajouter, c'est le texte source pour toutes les langues de pays, les autres langues de pays peuvent être traduites automatiquement par nous en utilisant l'IA.

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

Si vous avez installé le plugin I18n Ally, votre $t("TXT_CODE_MY_ERROR") devrait afficher le texte anglais.

Si le texte de traduction doit porter des paramètres, cela pourrait être un peu complexe, car le frontend et le backend utilisent des bibliothèques i18n différentes, donc le format pourrait être différent. Vous devez regarder à travers les fichiers pour trouver du code similaire pour comprendre.

Toutes les clés de texte de traduction ne peuvent pas être dupliquées, veuillez donc essayer d'utiliser un nom plus long !

Construire la version d'environnement de production

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

Après la construction terminée, vous trouverez le code d'environnement de production dans le répertoire production-code.

Compatibilité du navigateur

Prend en charge les navigateurs modernes principaux comme Chrome Firefox Safari Opera.
A abandonné le support pour le navigateur IE.

Rapports de bugs

Bienvenue pour signaler tout problème trouvé, nous les corrigerons rapidement.

Si vous découvrez des vulnérabilités de sécurité graves qui sont gênantes à publier publiquement, veuillez envoyer un e-mail à : support@mcsmanager.com. Après que les problèmes de sécurité soient corrigés, le nom du découvreur sera attaché dans le code.

Licence

Le code source suit la licence Apache-2.0.

14 KiB Raw Permalink Blame History