Instalacja na Linuksie / VPS

Wolisz instrukcję krok po kroku? Otwórz interaktywny poradnik instalacji, aktualizacji i ustawień. Wybierzesz komputer lub VPS i otrzymasz instrukcje dla swojej instalacji.

Na Linuksie nie ma okienkowego launchera – wszystko robisz w terminalu. Drogi instalacji:

  • instalator jednym plikiem instaluj-vps.sh – tylko MT2009 PLUS 2.x, najprościej na świeżym VPS (niżej),
  • z launchera na Windows (przycisk SERWER NA VPS) – 2.x i Yohara,
  • instalator vps-install.sh z folderu paczki – 2.x i Yohara,
  • krok po kroku (niżej, gdy chcesz mieć wszystko pod kontrolą).

Instalacja jest w obu wersjach taka sama; różnią się aktualizacje: 2.x aktualizuje się sama z GitHuba, a Yohara dostaje łatki (Aktualizacje).

Czego potrzebujesz

  • VPS albo mini PC z Debianem albo Ubuntu, procesor x86_64 (ARM się nie nada – serwer gry to kod 32-bitowy x86), dostęp jako root albo przez sudo.
  • 8 GB RAM (4 GB działa z mniejszą liczbą botów – instalator założy plik wymiany) i 60–80 GB dysku.
  • Pełną paczkę serwera z Discorda – przy instalatorze jednym plikiem (2.x) pobiera ją sam.

MT2009 PLUS 2.x: instalator jednym plikiem

Instalacja – zaloguj się na VPS jako root i wpisz dwie komendy:

wget -O instaluj-vps.sh https://metin2sp.pl/wiki/pobierz/instaluj-vps.sh
sh instaluj-vps.sh

Jeśli system nie ma wget, najpierw: apt-get update && apt-get install -y wget ca-certificates.

Skrypt sam pobierze pełną paczkę serwera: MT2009-PLUS-Serwer-2.12.0.zip (ok. 140 MB) i od razu zaktualizuje ją do najnowszej wersji 2.x. Tę samą paczkę możesz też pobrać ręcznie – działa na Windowsie (launcher) i na Linuksie.

Co robi, po kolei:

  1. Sprawdza maszynę i doinstalowuje wget, unzip, curl i python3.
  2. Pobiera pełną paczkę z metin2sp.pl i rozpakowuje folder serwera do /opt/mt2009plus.
  3. Czyta z GitHuba, jaka jest najnowsza wersja, pobiera paczkę aktualizacji, sprawdza jej sumę SHA-256 i nakłada ją na folder.
  4. Na końcu pokazuje adres serwera i komendy do haseł i paneli. Konta admin i test dostają losowe hasła.

Opcje:

Opcja Co robi
--paczka URL inny bezpośredni link do pełnej paczki (.zip albo .tar.gz) zamiast tej z metin2sp.pl
--folder KATALOG gdzie ma stać serwer (domyślnie /opt/mt2009plus)
--address ADRES publiczny adres serwera (domyślnie odczytany adres IPv4 VPS)
--bots N liczba botów (domyślnie dobrana do pamięci)
--bez-aktualizacji zostaw wersję z pełnej paczki
--force instaluj mimo małej pamięci albo dysku
--tylko-pliki tylko kroki 1–3 – pliki gotowe w folderze, bez Dockera

Z launchera na Windows

W launcherze (2.x albo Yohary) kliknij SERWER NA VPS: 1. POŁĄCZ (KLUCZ SSH), potem 2. ZAINSTALUJ NA VPS. Launcher wgrywa folder serwera przez SSH i uruchamia na VPS te same komendy co niżej. W tym samym oknie są STAN VPS, LOGI VPS i OTWÓRZ PANEL (TUNEL SSH), a w 2.x także AKTUALIZUJ VPS.

Instalator vps-install.sh

Wgraj cały folder serwera (ten z plikiem VERSION i folderem linux-port/; w paczce 2.x to folder Serwer) na VPS, np. scp albo WinSCP, zaloguj się przez SSH i z tego folderu uruchom:

sudo sh linux-port/tools/vps-install.sh install

Co robi:

  1. Sprawdza maszynę (system, procesor, pamięć, dysk) i instaluje Dockera.
  2. Zakłada plik wymiany, jeśli brakuje pamięci.
  3. Buduje i uruchamia serwer. Pierwszy raz trwa to 15–40 minut. Budowa idzie w tle – zerwane połączenie SSH jej nie przerwie.
  4. Konta admin i test dostają losowe hasła (zapisane w /root/metin2-accounts.txt).

Opcje: --address ADRES (publiczny adres serwera), --bots N (liczba botów), --force (mimo małej pamięci albo dysku); tylko w Yoharze także --profile NAZWA (gotowa konfiguracja świata: mt2009, clean_easy, clean_hard, sapphire, emerald), --language KOD (domyślny język serwera).

Po instalacji – z folderu serwera:

sudo sh linux-port/tools/vps-install.sh status              # czy budowa jeszcze trwa, czy serwer działa
sudo sh linux-port/tools/vps-install.sh passwords           # hasła kont admin i test
sudo sh linux-port/tools/vps-install.sh add-account LOGIN   # konto dla znajomego
sudo sh linux-port/tools/vps-install.sh logs                # ostatnie logi
sudo sh linux-port/tools/vps-install.sh update              # tylko 2.x: aktualizacja do nowej wersji z GitHuba

W paczce Yohary jest też własny instaluj-vps.sh, który sam pobiera paczkę i odpala ten instalator. Działa tylko z bezpośrednim linkiem do pełnej paczki Yohary (--paczka URL, --folder KATALOG, --jezyk KOD) i nie robi aktualizacji. Plik do pobrania z wiki (wyżej) instaluje 2.x.

Panele są dla bezpieczeństwa widoczne tylko na samym VPS. Otwierasz je przez tunel SSH – na swoim komputerze:

ssh -L 7788:127.0.0.1:7788 -L 7790:127.0.0.1:7790 root@ADRES_VPS

i w przeglądarce http://127.0.0.1:7788 (panel klasyczny) oraz http://127.0.0.1:7790 (panel zaawansowany), dopóki okno SSH jest otwarte. ItemShop (port 7791) jest dostępny dla graczy pod adresem serwera.

W kliencie gry dodaj serwer z adresem VPS, np. plikiem Ustaw_serwer_VPS.bat. W 2.x możesz też dodać serwer w MT2009-Patcherze (ikona serwera VPS u góry po prawej). Porty gry to TCP 11000 i 13000–13003 (13003 to osobny rdzeń map: w 2.x Zaklęty Las i mapy 90 poziomu, w Yoharze mapy Yohary) – jeśli dostawca VPS ma własną zaporę, otwórz je tam.

Krok po kroku

Poradnik od czystego Debiana 13 do działającego serwera. Na Ubuntu wygląda to tak samo (w repozytorium Dockera zamień debian na ubuntu).

1. Czego potrzebujesz

  • Maszyny z Debianem 13 (VPS albo mini PC, z pulpitem albo bez) i kontem z sudo.
  • Procesora x86 (Intel/AMD) – serwer gry nie działa na ARM.
  • Co najmniej 4 GB RAM i 60–80 GB dysku (więcej pamięci przy tysiącach botów albo drugim kanale).
  • Internetu – Docker pobiera obrazy bazowe przy budowie.
  • Pełnej paczki serwera z Discorda. Z paczki 2.x potrzebny jest tylko folder Serwer.

Nie używaj instalatorów installer/install.sh ani aktualizatorów z innych projektów. Nakładają pliki innej wersji silnika i psują działający serwer.

2. System i Docker

Aktualizacja systemu i narzędzia:

sudo apt-get update
sudo apt-get upgrade -y
sudo apt-get install -y ca-certificates curl gnupg unzip

Docker z repozytorium Dockera (w repozytorium Debiana bywa starsza wersja bez Compose v2):

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker

Sprawdź, czy działa:

sudo docker run hello-world
sudo docker compose version

Pierwsza komenda wypisuje powitanie Dockera, druga numer wersji Compose (v2.x). W poradniku wszystkie komendy Dockera mają sudo. Jeśli dodasz się do grupy docker (sudo usermod -aG docker $USER, potem ponowne logowanie), używaj już wszędzie samego docker i nie mieszaj go z sudo docker.

3. Paczka serwera na maszynie

Plik zip wgrywasz na serwer z własnego komputera, np. scp:

scp MT2009-PLUS.zip UZYTKOWNIK@ADRES_SERWERA:~/

albo programem WinSCP / FileZilla. Jeśli masz bezpośredni link, możesz pobrać od razu na serwerze: wget -O MT2009-PLUS.zip "LINK".

Rozpakuj folder serwera do /opt/metin2/stack (nazwę folderu w zipie sprawdź komendą unzip -l; w paczce 2.x to <folder paczki>/Serwer):

sudo mkdir -p /opt/metin2/_new
cd /opt/metin2/_new
sudo unzip -q ~/MT2009-PLUS.zip
sudo mv "/opt/metin2/_new/<folder serwera>" /opt/metin2/stack
sudo rm -rf /opt/metin2/_new
cat /opt/metin2/stack/VERSION

W /opt/metin2/stack mają być m.in. VERSION, linux-port/, launcher/ i tools/.

4. Plik .env

Cała konfiguracja jest w jednym pliku:

cd /opt/metin2/stack/linux-port/docker
sudo cp .env.example .env
sudo nano .env

Wystarczy sekcja „1. REQUIRED” na górze:

Ustawienie Co wpisać
M2_PUBLIC_ADDRESS publiczny adres IP maszyny albo domena (curl -4 ifconfig.me). Bez tego klient zawiśnie na „łączenie z serwerem”
M2_DB_ROOT_PASSWORD, M2_DB_PASSWORD dwa różne, długie hasła, np. z openssl rand -hex 24 (bez spacji i cudzysłowów)
M2_DB_PUBLISH_PORT zostaw 3306, chyba że port jest zajęty
M2_PANEL_PASSWORD możesz zostawić puste – panel wylosuje hasło przy pierwszym starcie
M2_DEFAULT_LANGUAGE tylko Yohara: domyślny język serwera, np. pl
PLAYERBOT_AUTOSPAWN_COUNT ile botów startuje z grą; na pierwszy start daj mniej, np. 50 – potem zmienisz w panelu

M2_COMPOSE_PROJECT_NAME i M2_CONTAINER_PREFIX zostaw puste. Trzeba je ustawić dopiero przy drugiej, osobnej kopii serwera na tej samej maszynie.

5. Pierwsze uruchomienie

cd /opt/metin2/stack/linux-port/docker
sudo docker compose up -d --build

Pierwszy build kompiluje serwer od zera: od kilkunastu do kilkudziesięciu minut. Konsola może długo milczeć – to normalne.

6. Czy wszystko działa

sudo docker compose ps

Usługi mają status Up / healthy. Kontener *-playerbot-migrate kończy się raz (Exited (0)) – tak ma być.

Hasło panelu, jeśli zostawiłeś je puste:

sudo docker compose logs panel | grep -A4 PASSWORD

Panele: http://ADRES_SERWERA:7788 (klasyczny, mapa botów) i http://ADRES_SERWERA:7790 (panel zaawansowany), ItemShop: http://ADRES_SERWERA:7791. W grze: konto admin / admin z czterema postaciami GM – zmień to hasło, zanim serwer zobaczą inni.

Coś nie wstało? Najpierw logi:

sudo docker compose logs game --tail 80
sudo docker compose logs panel --tail 40

Porty gry: TCP 11000 i 13000–13003 (z drugim kanałem 13000–13012) – otwórz je w zaporze i u dostawcy VPS.

7. Baza danych z komputera (opcjonalnie)

Baza słucha tylko na 127.0.0.1 serwera.

  • Tunel SSH (bezpieczniej) – w Navicat / HeidiSQL ustaw połączenie przez SSH do tej maszyny, a w nim 127.0.0.1:3306.
  • Otwarty port (wygodniej, mniej bezpiecznie) – obok docker-compose.yml utwórz docker-compose.override.yml:
services:
  mariadb:
    ports: !override
      - "0.0.0.0:3306:3306"

i uruchom sudo docker compose up -d. Logujesz się jako root (hasło M2_DB_ROOT_PASSWORD) albo metin2 (hasło M2_DB_PASSWORD). Wtedy bazę chroni tylko siła hasła – rób to świadomie.

8. Aktualizacja

MT2009 PLUS 2.x – z GitHuba:

cd /opt/metin2/stack
sudo sh linux-port/tools/update.sh check   # tylko pokazuje wersje
sudo sh linux-port/tools/update.sh run     # instaluje najnowszą

9. Przydatne komendy

sudo docker compose ps            # stan
sudo docker compose down          # zatrzymanie (baza zostaje)
sudo docker compose up -d         # start
sudo docker compose logs -f game  # logi gry

Czego nie robić:

  • docker compose down -v – -v kasuje bazę danych.
  • Instalatorów i aktualizatorów z innych projektów.
  • Ręcznych zmian w game/src/ bez przebudowy – zobacz Baza danych i pliki serwera.

Jeśli po aktualizacji albo wgraniu łatki coś nie wstaje: nic nie zostało skasowane, poprzednie obrazy są na dysku. Sprawdź logi, popraw i uruchom sudo docker compose up -d --build jeszcze raz.

Zobacz też