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_ES.md

13 KiB
Raw Permalink Blame History


¿Qué es esto?

MCSManager Panel (abreviado: MCSM Panel) es un panel de administración web moderno, simple, multi-usuario, compatible con arquitectura distribuida y de despliegue rápido para servidores de juegos Minecraft y Steam.

MCSManager ha ganado popularidad dentro de las comunidades de juegos Minecraft y Steam. Te ayuda a gestionar centralmente múltiples servidores físicos, permitiéndote crear servidores de juegos en cualquier host, y proporciona un sistema de permisos multi-usuario seguro y confiable que puede ayudarte fácilmente a gestionar múltiples servidores. Ha estado proporcionando soporte de software saludable para administradores, personal de operaciones y desarrolladores individuales de servidores de juegos Minecraft, Terraria y Steam.

También es adecuado para cualquier actividad comercial, como proveedores de servicios IDC para venta de servidores privados, etc. Varias pequeñas y medianas empresas ya están usando este panel como software de gestión y ventas, y soporta idiomas de múltiples países.

1 terminal 3 4

Características

  1. Usa el mercado de aplicaciones para desplegar fácilmente servidores de juegos Minecraft o Steam con un clic.
  2. Compatible con la mayoría de servidores de juegos Steam, como Palworld, Squad, Project Zomboid y Terraria, etc.
  3. La interfaz web soporta diseño de tarjetas de arrastrar y soltar para crear tu diseño de interfaz preferido.
  4. Soporta todas las imágenes en Docker Hub, soporta multi-usuario, soporta servicios de venta de instancias comerciales.
  5. Soporta arquitectura distribuida, una interfaz web puede gestionar múltiples máquinas simultáneamente.
  6. Pila tecnológica simple, ¡solo necesitas dominar TypeScript para completar todo el desarrollo de MCSManager!
  7. Más...

Entorno de Ejecución

El panel de control puede ejecutarse en plataformas Windows y Linux, no requiere instalación de base de datos, solo necesitas instalar el entorno Node.js y varios comandos de descompresión.

Debes usar Node.js 16.20.2 o superior, recomendamos usar la última versión LTS.


Documentación Oficial

Inglés: https://docs.mcsmanager.com/

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


Instalación

Windows

Para sistemas Windows, viene como una versión integrada lista para ejecutar - descarga y ejecuta inmediatamente:

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

Haz doble clic en start.bat para iniciar tanto el panel web como el proceso daemon.


Linux

Comando de una línea para instalación rápida

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

Uso después de la instalación

systemctl start mcsm-{web,daemon} # Iniciar panel
systemctl stop mcsm-{web,daemon}  # Detener panel
  • El script solo se aplica a Ubuntu/Centos/Debian/Archlinux
  • El código del panel y el entorno de ejecución se instalan automáticamente en el directorio /opt/mcsmanager/.

Instalación manual de Linux

  • Si la instalación de un clic no funciona, puedes probar este paso para la instalación manual.
# Cambiar al directorio de instalación. Si no existe, por favor créalo con 'mkdir /opt/' primero.
cd /opt/
# Descargar entorno de ejecución (Node.js). Si ya tienes Node.js 16+ instalado, por favor ignora este paso.
wget https://nodejs.org/dist/v20.11.0/node-v20.11.0-linux-x64.tar.xz
# Extraer archivo
tar -xvf node-v20.11.0-linux-x64.tar.xz
# Agregar programa a variables de entorno del sistema.
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

# Preparar directorio de instalación.
mkdir /opt/mcsmanager/
cd /opt/mcsmanager/

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

# Instalar dependencias.
chmod 775 install.sh
./install.sh

# Por favor abre dos terminales o screen.

# Iniciar programa node primero.
./start-daemon.sh

# Iniciar servicio web (en segundo terminal o screen).
./start-web.sh

# Visita http://<IP pública>:23333/ para ver el panel.
# Generalmente, la aplicación web escaneará automáticamente y se conectará al daemon local.

Este método de instalación no registra automáticamente el panel en los servicios del sistema, por lo que debes usar software screen para gestionarlo. Si quieres que el servicio del sistema tome control de MCSManager, por favor consulta la documentación.


Mac OS


# Primero instalar Node.js, si ya lo tienes instalado, puedes saltar este paso.
# Node.js recomienda instalar la última versión LTS.
brew install node
node -v
npm -v

# Usar curl para descargar archivos
curl -L https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_release.tar.gz -o mcsmanager_linux_release.tar.gz

# Extraer archivos (mismo comando que el original)
tar -zxf mcsmanager_linux_release.tar.gz

cd mcsmanager

# Instalar dependencias.
chmod 775 install.sh
./install.sh

# Por favor abre dos terminales o screen.

# Iniciar programa node primero.
./start-daemon.sh

# Iniciar servicio web (en segundo terminal o screen).
./start-web.sh

# Visita http://localhost:23333/ para ver el panel.
# Generalmente, la aplicación web escaneará automáticamente y se conectará al daemon local.

Instalación vía Docker

Instala el panel usando docker-compose.yml, nota que necesitas cambiar todos los <CHANGE_ME_TO_INSTALL_PATH> a tu ruta de instalación real.

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

Habilitar usando docker-compose.

mkdir -p <CHANGE_ME_TO_INSTALL_PATH>
cd <CHANGE_ME_TO_INSTALL_PATH>
vim docker-compose.yml # Escribe el contenido del docker-compose.yml arriba aquí
docker compose pull && docker compose up -d

Nota: Después de la instalación de Docker, el lado Web puede no conectarse automáticamente al Daemon.

En ese momento, si entras al panel, deberías ver algunos errores porque el lado Web no pudo conectarse exitosamente al lado daemon, necesitas crear un nuevo nodo para conectarlos.


Contribuir Código

  • Debe leerse antes de contribuir código: https://github.com/MCSManager/MCSManager/issues/599

  • El código necesita mantener el formato existente, no se permite formato excesivo de código.

  • Todo el código debe cumplir con los estándares de internacionalización.


Desarrollo

Esta sección es para desarrolladores. Si quieres hacer desarrollo secundario en MCSManager o enviar contribuciones de código, por favor lee cuidadosamente estos contenidos:

Requerido

Usamos Visual Studio Code para desarrollar MCSManager. Debes instalar estos plugins:

  • Soporte de visualización de texto i18n (I18n Ally)
  • Formato de código (Prettier)
  • Vue - Official
  • ESLint

Archivos de Dependencias

Necesitas ir a los proyectos PTY y Zip-Tools para descargar archivos binarios adecuados para tu sistema, almacenarlos en el directorio daemon/lib (crear manualmente si no existe) para asegurar el funcionamiento normal de terminal de simulación y descompresión de archivos.

Descarga tres archivos de dependencia, selecciona según la arquitectura de tu sistema, y consulta Releases para encontrar binarios adecuados para tu sistema y arquitectura.

Por ejemplo:

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

# Biblioteca de dependencias del terminal emulado
wget https://github.com/MCSManager/PTY/releases/download/latest/pty_linux_x64

# Biblioteca de dependencias para extraer y comprimir archivos
wget https://github.com/MCSManager/Zip-Tools/releases/download/latest/file_zip_linux_x64

# Soporte para archivos 7z, descarga opcional
wget https://github.com/MCSManager/Zip-Tools/releases/download/latest/7z_linux_x64

Ejecución

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

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

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

Internacionalización de Código

Dado que el proyecto se adapta a múltiples idiomas, todos los strings y comentarios en el código solo aceptan inglés, por lo que por favor no codifiques texto no inglés directamente en el código.

Por ejemplo, podrías escribir una nueva cadena que necesita adaptarse a múltiples idiomas.

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

if (!checkName) {
  const errorMsg = "Check Name Failed!" // ¡No hagas esto!
  const errorMsg = $t("TXT_CODE_MY_ERROR"); // ¡Correcto!
}.

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

Por favor agrega esta línea al archivo de idioma, por ejemplo: languages/en_US.json

Entre ellos, en_US.json es obligatorio agregar, es el texto fuente para todos los idiomas de países, otros idiomas de países pueden ser traducidos automáticamente por nosotros usando IA.

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

Si has instalado el plugin I18n Ally, tu $t("TXT_CODE_MY_ERROR") debería mostrar el texto en inglés.

Si el texto de traducción necesita llevar parámetros, esto podría ser un poco complejo, porque el frontend y backend usan diferentes bibliotecas i18n, por lo que el formato podría ser diferente. Necesitas revisar los archivos para encontrar código similar para entender.

¡Todas las claves de texto de traducción no pueden duplicarse, por lo que por favor intenta usar un nombre más largo!


Construir Versión de Entorno de Producción

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

Después de que la construcción esté completa, encontrarás el código del entorno de producción en el directorio production-code.


Compatibilidad del Navegador

  • Soporta navegadores modernos principales como Chrome Firefox Safari Opera.
  • Ha abandonado el soporte para el navegador IE.

Reportes de Errores

Bienvenido a reportar cualquier problema encontrado, los corregiremos rápidamente.

Si descubres vulnerabilidades de seguridad graves que son inconvenientes de publicar públicamente, por favor envía un correo electrónico a: support@mcsmanager.com. Después de que los problemas de seguridad sean corregidos, el nombre del descubridor será adjuntado en el código.


Licencia

El código fuente sigue la licencia Apache-2.0.

Copyright ©2025 MCSManager.