Przestrzenie nazw
Widoki
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.shz 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:
- Sprawdza maszynę i doinstalowuje
wget,unzip,curlipython3. - Pobiera pełną paczkę z metin2sp.pl i rozpakowuje folder serwera do
/opt/mt2009plus. - Czyta z GitHuba, jaka jest najnowsza wersja, pobiera paczkę aktualizacji, sprawdza jej sumę SHA-256 i nakłada ją na folder.
- Na końcu pokazuje adres serwera i komendy do haseł i paneli. Konta
adminitestdostają 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:
- Sprawdza maszynę (system, procesor, pamięć, dysk) i instaluje Dockera.
- Zakłada plik wymiany, jeśli brakuje pamięci.
- Buduje i uruchamia serwer. Pierwszy raz trwa to 15–40 minut. Budowa idzie w tle – zerwane połączenie SSH jej nie przerwie.
- Konta
adminitestdostają 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.ymlutwórzdocker-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–-vkasuje 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.