MCS-MCSManager/README_JP.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

15 KiB

Raw Permalink Blame History

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

これは何ですか？

MCSManager Panel（略称：MCSM Panel）は、Minecraft と Steam ゲームサーバー用の高速デプロイ、分散アーキテクチャ対応、マルチユーザー、シンプルでモダンな Web 管理パネルです。

MCSManager は Minecraft と Steam ゲーミングコミュニティ内で人気を博しています。複数の物理サーバーを一元管理し、任意のホストでゲームサーバーを作成できるよう支援し、複数のサーバーを簡単に管理できる安全で信頼性の高いマルチユーザー権限システムを提供します。Minecraft、Terraria、Steam ゲームサーバーの管理者、運用担当者、個人開発者に健全なソフトウェアサポートを提供し続けています。

また、IDC サービスプロバイダーのプライベートサーバー販売などの商業活動にも適しています。いくつかの中小企業がすでにこのパネルを管理・販売ソフトウェアとして使用しており、複数国の言語をサポートしています。

機能

アプリケーションマーケットを使用して、Minecraft または Steam ゲームサーバーをワンクリックで簡単にデプロイできます。
Palworld、Squad、Project Zomboid、Terraria など、ほとんどの Steam ゲームサーバーと互換性があります。
Web インターフェースはドラッグアンドドロップカードレイアウトをサポートし、お好みのインターフェースレイアウトを作成できます。
Docker Hub のすべてのイメージをサポートし、マルチユーザー、商業インスタンス販売サービスをサポートします。
分散アーキテクチャをサポートし、1 つの Web インターフェースで複数のマシンを同時に管理できます。
シンプルな技術スタック、TypeScript に精通するだけで MCSManager 全体の開発を完了できます！
その他...

実行環境

コントロールパネルは Windows と Linux プラットフォームで実行でき、データベースのインストールは不要で、Node.js 環境といくつかの解凍用コマンドをインストールするだけで済みます。

Node.js 16.20.2 以上を使用する必要があり、最新の LTS バージョンの使用を推奨します。

公式ドキュメント

英語：https://docs.mcsmanager.com/

中国語：https://docs.mcsmanager.com/zh_cn/

インストール

Windows

Windows システムの場合、すぐに実行できる統合バージョンとして提供されます - ダウンロードしてすぐに実行してください：

アーカイブ：https://download.mcsmanager.com/mcsmanager_windows_release.zip

start.bat をダブルクリックして、Web パネルと daemon プロセスの両方を起動します。

Linux

ワンラインコマンドクイックインストール

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

インストール後の使用方法

systemctl start mcsm-{web,daemon} # パネルを開始
systemctl stop mcsm-{web,daemon}  # パネルを停止

スクリプトは Ubuntu/Centos/Debian/Archlinux にのみ適用されます
パネルコードと実行環境は /opt/mcsmanager/ ディレクトリに自動インストールされます

Linux 手動インストール

ワンクリックインストールが機能しない場合は、この手順で手動インストールを試すことができます。

# インストールディレクトリに切り替え。存在しない場合は、まず 'mkdir /opt/' で作成してください。
cd /opt/
# 実行環境（Node.js）をダウンロード。すでに Node.js 16+ がインストールされている場合は、この手順をスキップしてください。
wget https://nodejs.org/dist/v20.11.0/node-v20.11.0-linux-x64.tar.xz
# アーカイブを解凍
tar -xvf node-v20.11.0-linux-x64.tar.xz
# プログラムをシステム環境変数に追加。
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

# インストールディレクトリを準備。
mkdir /opt/mcsmanager/
cd /opt/mcsmanager/

# MCSManager をダウンロード。
wget https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_release.tar.gz
tar -zxf mcsmanager_linux_release.tar.gz

# 依存関係をインストール。
chmod 775 install.sh
./install.sh

# 2つのターミナルまたは screen を開いてください。

# まず node プログラムを開始。
./start-daemon.sh

# Web サービスを開始（2番目のターミナルまたは screen で）。
./start-web.sh

# http://<パブリック IP>:23333/ にアクセスしてパネルを表示。
# 通常、Web アプリケーションは自動的にスキャンしてローカルデーモンに接続します。

このインストール方法では、パネルがシステムサービスに自動登録されないため、screen ソフトウェアを使用して管理する必要があります。システムサービスに MCSManager を管理させたい場合は、ドキュメントを参照してください。

Mac OS


# まず Node.js をインストール。すでにインストールされている場合は、この手順をスキップできます。
# Node.js は最新の LTS バージョンのインストールを推奨します。
brew install node
node -v
npm -v

# curl を使用してファイルをダウンロード
curl -L https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_release.tar.gz -o mcsmanager_linux_release.tar.gz

# ファイルを解凍（元のコマンドと同じ）
tar -zxf mcsmanager_linux_release.tar.gz

cd mcsmanager

# 依存関係をインストール。
chmod 775 install.sh
./install.sh

# 2つのターミナルまたは screen を開いてください。

# まず node プログラムを開始。
./start-daemon.sh

# Web サービスを開始（2番目のターミナルまたは screen で）。
./start-web.sh

# http://localhost:23333/ にアクセスしてパネルを表示。
# 通常、Web アプリケーションは自動的にスキャンしてローカルデーモンに接続します。

Docker 経由でのインストール

docker-compose.yml を使用してパネルをインストールしてください、<CHANGE_ME_TO_INSTALL_PATH> すべてを実際のインストールパスに変更する必要があることに注意してください。

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

docker-compose を使用して有効化。

mkdir -p <CHANGE_ME_TO_INSTALL_PATH>
cd <CHANGE_ME_TO_INSTALL_PATH>
vim docker-compose.yml # 上記の docker-compose.yml の内容をここに記述
docker compose pull && docker compose up -d

注意：Docker インストール後、Web 側は Daemon に自動的に接続できなくなる可能性があります。

この時点でパネルに入ると、一部のエラーが表示されるはずです。これは Web 側が daemon 側に正常に接続できなかったためです、それらを接続するために新しいノードを作成する必要があります。

コードの貢献

コードを貢献する前に必ずお読みください：https://github.com/MCSManager/MCSManager/issues/599
コードは既存の形式を維持する必要があり、過度のコードフォーマットは許可されません。
すべてのコードは国際化標準に準拠する必要があります。

開発

**このセクションは開発者向けです。**MCSManager で二次開発を行ったり、コード貢献を提出したりする場合は、これらの内容を注意深くお読みください：

必要要件

MCSManager の開発には Visual Studio Code を使用しています。以下のプラグインを必ずインストールしてください：

i18n テキスト表示サポート（I18n Ally）
コードフォーマット（Prettier）
Vue - Official
ESLint

依存ファイル

daemon/lib ディレクトリ（存在しない場合は手動で作成）に、お使いのシステムに適したバイナリファイルを保存するために、PTY と Zip-Tools プロジェクトにアクセスしてダウンロードする必要があります。これにより シミュレーション端末 と ファイル解凍 の正常な動作が保証されます。

3つの依存ファイルをダウンロードし、システムアーキテクチャに応じて選択し、Releases を確認してシステムとアーキテクチャに適したバイナリファイルを見つけてください。

例:

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

# シミュレーション端末依存ライブラリ
wget https://github.com/MCSManager/PTY/releases/download/latest/pty_linux_x64

# 解凍 & 圧縮ファイル依存ライブラリ
wget https://github.com/MCSManager/Zip-Tools/releases/download/latest/file_zip_linux_x64

# 7z アーカイブサポート、オプションのダウンロード
wget https://github.com/MCSManager/Zip-Tools/releases/download/latest/7z_linux_x64

実行

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

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

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

コードの国際化

プロジェクトは複数言語に対応しているため、コード内のすべての 文字列 と コメント は英語のみを受け付けます。コード内で非英語テキストを直接ハードコードしないでください。

例えば、複数言語に対応する必要がある新しい文字列を書く場合があります。

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

if (!checkName) {
  const errorMsg = "Check Name Failed!" // これはしないでください！
  const errorMsg = $t("TXT_CODE_MY_ERROR"); // 正しい方法！
}.

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

この行を言語ファイルに追加してください。例：languages/en_US.json

その中で、en_US.json は必須で追加する必要があり、これはすべての国言語のソーステキストです。他の国言語は AI を使用して自動翻訳できます。

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

I18n Ally プラグインをインストールしている場合、$t("TXT_CODE_MY_ERROR") は英語テキストを表示するはずです。

翻訳テキストにパラメータを含める必要がある場合は、少し複雑になる可能性があります。フロントエンドとバックエンドで異なる i18n ライブラリを使用しているため、形式が異なる場合があります。類似のコードを見つけるためにファイルを調べる必要があります。

すべての翻訳テキストキーは重複できませんので、より長い名前を使用してください！

本番環境バージョンのビルド

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

ビルドが完了すると、production-code ディレクトリに本番環境コードが見つかります。

ブラウザ互換性

Chrome Firefox Safari Opera などのモダンな主流ブラウザをサポートします。
IE ブラウザのサポートを放棄しました。

バグレポート

発見された問題の報告を歓迎します。迅速に修正いたします。

公開するのに不便な重大なセキュリティ脆弱性を発見した場合は、support@mcsmanager.com にメールをお送りください。セキュリティ問題が修正された後、発見者の名前がコードに添付されます。

ライセンス

ソースコードは Apache-2.0 ライセンスに従います。

15 KiB Raw Permalink Blame History Unescape Escape