Cài đặt
Chọn tùy chọn phù hợp với máy chủ của bạn. Mọi cách đều cho bạn cùng một bảng điều khiển.
Hoạt động trong vài phút
Chọn máy của bạn và dán các lệnh. Chế độ Nâng cao cung cấp mọi cách khác để chạy bảng điều khiển, với các lệnh được viết lại cho thư mục và địa chỉ của riêng bạn.
- 1
Chạy trình cài đặt
Hoạt động trên mọi máy Linux có hệ điều hành 64-bit, từ VPS đến Raspberry Pi 4 hoặc 5. Trình cài đặt sẽ cài đặt Docker nếu thiếu, thiết lập bảng điều khiển trong /opt/msm và khởi động nó. Chạy lại sau để nâng cấp.
curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash - 2
Mở bảng điều khiển
Trình cài đặt sẽ hiển thị địa chỉ và mã PIN thiết lập dùng một lần. Mở địa chỉ trong trình duyệt, nhập mã PIN và tạo tài khoản quản trị viên của bạn.
http://your-server-ip:25564
- 1
Cài đặt Docker Desktop, Node.js, Git và pnpm
Mỗi công cụ một dòng trong PowerShell. Khởi động Docker Desktop sau khi cài đặt và để nó chạy.
winget install Docker.DockerDesktop winget install OpenJS.NodeJS.LTS winget install Git.Git winget install pnpm.pnpm - 2
Tải bảng điều khiển và khởi động nó
Mở một terminal mới để nó nhận diện các công cụ bạn vừa cài đặt.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install pnpm start - 3
Mở bảng điều khiển
Lần chạy đầu tiên sẽ hướng dẫn bạn kiểm tra hệ thống, chọn múi giờ và tạo tài khoản quản trị viên.
http://localhost:25564
- 1
Cài đặt Docker Desktop, Node.js, Git và pnpm
Sử dụng Homebrew. Khởi động Docker Desktop sau khi cài đặt và để nó chạy.
brew install --cask docker-desktop brew install node git pnpm - 2
Tải bảng điều khiển và khởi động nó
Bước cài đặt cũng sẽ biên dịch bảng điều khiển. Không cần biên dịch thủ công.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install pnpm start - 3
Mở bảng điều khiển
Lần chạy đầu tiên sẽ hướng dẫn bạn kiểm tra hệ thống, chọn múi giờ và tạo tài khoản quản trị viên.
http://localhost:25564
Điền vào hai trường và mọi lệnh bên dưới sẽ tự động cập nhật cho máy của bạn.
- 1
Tạo thư mục dữ liệu
Một thư mục chứa mọi thứ mà bảng điều khiển sở hữu.
mkdir -p {{dataDir}} - 2
Tải tệp compose và trỏ nó vào thư mục đó
DATA_DIR_HOST phải là đường dẫn tuyệt đối trên máy chủ, vì Docker sẽ gắn nó từ góc nhìn của máy chủ.
curl -fsSLO https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml echo "DATA_DIR_HOST={{dataDir}}" > .env - 3
Khởi động bảng điều khiển
Image hỗ trợ đa kiến trúc (amd64 và arm64) và cập nhật với mỗi bản phát hành.
docker compose up -d Sau đó mở bảng điều khiển
http://{{host}}:25564Lần chạy đầu tiên sẽ hướng dẫn bạn kiểm tra hệ thống, chọn múi giờ và tạo tài khoản quản trị viên.
- 1
Tạo thư mục dữ liệu trên máy chủ
Quy tắc thư mục tương tự: đường dẫn tuyệt đối, trên máy chạy Docker.
mkdir -p {{dataDir}} - 2
Thêm một stack từ tệp compose
Dán nội dung của tệp compose vào một stack mới. Tệp gốc ở đây:
https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml - 3
Đặt biến môi trường và triển khai
Thêm nó vào phần môi trường của stack, sau đó triển khai.
DATA_DIR_HOST={{dataDir}} Sau đó mở bảng điều khiển
http://{{host}}:25564Lần chạy đầu tiên sẽ hướng dẫn bạn kiểm tra hệ thống, chọn múi giờ và tạo tài khoản quản trị viên.
- 1
Kiểm tra yêu cầu
Node.js 24 trở lên, pnpm và Docker đang chạy (Docker Desktop trên Windows và macOS).
node --version # 24 or newer docker info # daemon reachable - 2
Clone và cài đặt
Bước cài đặt cũng sẽ biên dịch CSS của bảng điều khiển. Không có module gốc nào để biên dịch.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install - 3
Khởi động bảng điều khiển
Theo mặc định, nó chỉ lắng nghe trên localhost. Đặt PANEL_HOST=0.0.0.0 để truy cập nó từ các máy khác trên mạng của bạn.
pnpm start Sau đó mở bảng điều khiển
http://localhost:25564Lần chạy đầu tiên sẽ hướng dẫn bạn kiểm tra hệ thống, chọn múi giờ và tạo tài khoản quản trị viên.
- 1
Khởi động từ cài đặt mã nguồn
Chạy lệnh này từ thư mục đã clone. PM2 khởi chạy ứng dụng với phiên bản Node đã khởi động daemon của nó, vì vậy hãy ghim trình thông dịch.
pm2 start src/server.js --name minecraft-server-manager --interpreter "$(nvm which 24)" - 2
Lưu danh sách tiến trình và kích hoạt khởi động
pm2 startup sẽ hiển thị một lệnh để chạy với sudo; chạy lệnh đó một lần.
pm2 save pm2 startup - 3
Ưu tiên systemd?
Một unit chạy node src/server.js từ thư mục đã clone với WorkingDirectory được đặt sẽ hoạt động tương tự. Bảng điều khiển không cần thêm cờ nào.
Sau đó mở bảng điều khiển
http://{{host}}:25564Lần chạy đầu tiên sẽ hướng dẫn bạn kiểm tra hệ thống, chọn múi giờ và tạo tài khoản quản trị viên.
Tùy chọn 1: Docker
Tùy chọn cài đặt
Trình cài đặt Linux nhận các tùy chọn của nó sau bash -s --, vì vậy chúng cũng hoạt động qua pipe. Chạy lại với cùng các tùy chọn để nâng cấp; thư mục dữ liệu, các chỉnh sửa .env và compose của bạn sẽ được giữ nguyên.
--port 8080Phục vụ bảng điều khiển trên một cổng khác.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --port 8080--bind 127.0.0.1Chỉ lắng nghe trên 127.0.0.1, cho proxy ngược với TLS ở phía trước.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --bind 127.0.0.1--tag v0.14.1Ghim một bản phát hành thay vì theo dõi bản mới nhất.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --tag v0.14.1--dir /srv/msmCài đặt ở một nơi khác ngoài /opt/msm.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --dir /srv/msm--uninstall --yesGỡ cài đặt bảng điều khiển và giữ lại dữ liệu của nó. Qua pipe không có bàn phím để trả lời câu hỏi, vì vậy hãy thêm --yes; thêm --purge để xóa thư mục dữ liệu.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --uninstall --yes--helpMọi tùy chọn, cùng với giá trị mặc định của nó.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --help
Yêu cầu
- Docker Engine (Linux) hoặc Docker Desktop (Windows, macOS).
- Docker
- Linux
Windows- macOS
- Node.js 24 trở lên cho cài đặt từ mã nguồn. Hình ảnh Docker đã bao gồm sẵn.
- Node.js 24+
- Vài gigabyte dung lượng đĩa cho các hình ảnh máy chủ và thế giới.
Lưu ý cho Windows
- Docker Desktop phải đang chạy trước khi bạn bắt đầu hoặc tạo máy chủ.
- Chia sẻ ổ đĩa dự án của bạn với Docker Desktop (Cài đặt, Tài nguyên, Chia sẻ tệp) để các mount liên kết hoạt động.
- Hình ảnh Docker nhắm mục tiêu máy chủ Linux; trên Windows và macOS, hãy chạy bảng điều khiển từ mã nguồn.

Hãy đến chào hỏi
Báo cáo lỗi, đề xuất tính năng, nhận trợ giúp từ người thật và khoe máy chủ của bạn.
