Bazy danych dla serwerów gier w Pterodactylu (database host)

Pluginy takie jak LuckPerms czy CoreProtect przechowują dane w bazie MySQL. Skonfigurujemy MariaDB jako database host Pterodactyla, aby użytkownicy mogli jednym kliknięciem w Panelu utworzyć bazę danych dla swojego serwera.

Jak to działa#

Gdy użytkownik kliknie New Database w zakładce Databases swojego serwera, Panel łączy się z database hostem i tworzy bazę s<ID serwera>_<nazwa> oraz użytkownika u<ID serwera>_<losowe znaki> z losowym hasłem. Serwer gier łączy się potem z tą bazą ze swojego kontenera.

Kluczowe słowo to kontener. Wewnątrz kontenera adres 127.0.0.1 oznacza sam kontener, nie VPS. Serwer gier nie znajdzie więc MariaDB pod 127.0.0.1. Na tym samym VPS kontenery mogą jednak dotrzeć do samego serwera pod 172.18.0.1 (interfejs pterodactyl0 tworzony przez Wings). Tego adresu użyjemy dla database hosta:

Sprawdź, czy interfejs istnieje (Wings musiał wystartować przynajmniej raz):

ip -4 addr show pterodactyl0

• ip -4 addr show pterodactyl0 – wypisuje adres IPv4 interfejsu pterodactyl0.

Wyjście zawiera linię inet 172.18.0.1/16. Jeśli polecenie mówi Device "pterodactyl0" does not exist, Wings jeszcze nie wystartował; najpierw dokończ jego instalację.

Konto dla Panelu#

Panel potrzebuje konta MariaDB, które może tworzyć bazy i użytkowników oraz nadawać im uprawnienia. Nie używaj konta pterodactyl z instalacji Panelu; ma uprawnienia tylko do bazy panel.

1. Wygeneruj silne hasło tylko z liter i cyfr (generator haseł).

2. Zaloguj się do MariaDB:

   mariadb

3. Utwórz konto. Zamiast <HASLO_DB_HOST> wstaw hasło z kroku 1:

   CREATE USER 'pterodactyluser'@'172.18.0.1' IDENTIFIED BY '<HASLO_DB_HOST>';
   GRANT ALL PRIVILEGES ON *.* TO 'pterodactyluser'@'172.18.0.1' WITH GRANT OPTION;
   exit

Nasłuchiwanie MariaDB w sieci#

Po instalacji MariaDB nasłuchuje tylko na 127.0.0.1 (ustawienie bind-address w /etc/mysql/mariadb.conf.d/50-server.cnf). Kontenery nie mogą jej tam dosięgnąć. Zmienisz to własnym plikiem, wczytywanym po domyślnym i go nadpisującym. Plik domyślny pozostaje nietknięty, nawet po aktualizacjach pakietu.

1. Utwórz plik:

   nano /etc/mysql/mariadb.conf.d/60-pterodactyl.cnf

2. Wklej zawartość, zapisz i zamknij edytor:

   [mysqld]
   bind-address = 0.0.0.0

3. Zrestartuj MariaDB i sprawdź, gdzie nasłuchuje:

   systemctl restart mariadb
   ss -tlnp | grep 3306

   • ss -tlnp – wypisuje nasłuchujące porty TCP i programy; grep 3306 wybiera linię MariaDB.

   Zobaczysz 0.0.0.0:3306 i nazwę procesu mariadbd.

Firewall#

MariaDB nasłuchuje teraz także na publicznym adresie IP VPS. Port 3306 musi pozostać zamknięty dla internetu. Użytkownicy baz serwerów gier mogą domyślnie łączyć się skądkolwiek (%), więc dałoby się zalogować nimi z zewnątrz.

Firewall w strefie klienta (poradnik):

• Tryb Blokuj wszystko poza dozwolonym: nie dodawaj żadnej reguły dla portu 3306. Jest zamknięty.
• Tryb Zezwól na wszystko: dodaj regułę Przychodzący · Drop · TCP · port 3306.

Połączenia z kontenerów do VPS pozostają wewnątrz serwera i firewall strefy klienta ich nie dotyczy.

UFW na VPS: jeśli jest włączony, blokuje także połączenia z kontenerów. Zezwól na port 3306 tylko z interfejsu Dockera:

ufw allow in on pterodactyl0 to any port 3306 proto tcp

• allow in on pterodactyl0 – zezwala na ruch przychodzący tylko z interfejsu pterodactyl0 (z kontenerów serwerów gier).
• to any port 3306 proto tcp – tylko na port TCP 3306.

Database host w Panelu#

1. W części administracyjnej Panelu kliknij Databases po lewej, a potem Create New.
2. Wypełnij formularz:

3. Kliknij Create. Panel od razu próbuje połączyć się z hostem. Jeśli się nie uda, pokazuje błąd i nie zapisuje hosta (zobacz Rozwiązywanie problemów).

Limit baz danych serwera#

Użytkownik może utworzyć tylko tyle baz, na ile pozwolisz. Domyślny limit to 0, a zakładka Databases mówi wtedy Databases cannot be created for this server.

1. W części administracyjnej otwórz Servers i kliknij serwer.
2. Przejdź do zakładki Build Configuration.
3. W Application Feature Limits ustaw Database Limit, na przykład 2.
4. Kliknij Update Build Configuration.

Tworzenie bazy danych z serwera#

Tę część wykonuje użytkownik serwera:

1. W Panelu otwórz serwer i jego zakładkę Databases.
2. Kliknij New Database.
3. Wypełnij Database Name, na przykład luckperms. Wynikowa nazwa to s<ID>_luckperms. Dozwolone są litery, cyfry, - i _, długość 3–⁠48 znaków.
4. Pole Connections From ustala, skąd użytkownik bazy może się łączyć. Bezpieczna wartość dla serwerów gier na tym węźle to 172.18.0.% (wszystkie kontenery). Puste pole oznacza %, czyli skądkolwiek.
5. Kliknij Create Database.
6. Kliknij ikonę oka obok nowej bazy. Pokazuje Endpoint (172.18.0.1:3306), Connections from, Username, Password i JDBC Connection String.

Wpisz te dane w konfiguracji pluginu. Większość pluginów chce adresu, nazwy bazy, użytkownika i hasła osobno. Na przykład LuckPerms w plugins/LuckPerms/config.yml:

storage-method: MariaDB
data:
  address: 172.18.0.1:3306
  database: s1_luckperms
  username: u1_AbCdEfGhIj
  password: '<HASLO_Z_PANELU>'

• storage-method – typ magazynu; MariaDB lub MySQL.
• address – Endpoint z Panelu (adres i port).
• database, username – dokładne wartości z Panelu (w tym przykładzie zmyślone).
• password – hasło z Panelu, w pojedynczych cudzysłowach ze względu na znaki specjalne.

Pluginy, które chcą jednego ciągu (JDBC URL), dostają wartość z pola JDBC Connection String w formie jdbc:mysql://user:password@172.18.0.1:3306/database. Więcej o bazach dla pluginów Minecrafta: MySQL dla pluginów.

Weryfikacja#

Z VPS sprawdź, czy użytkownik serwera może połączyć się przez adres używany przez kontenery:

mariadb -h 172.18.0.1 -u <DB_USER> -p <DB_NAME> -e "SELECT 1;"

• -h 172.18.0.1 – łączy się przez TCP z interfejsem Dockera.
• -u <DB_USER> – użytkownik z Panelu (na przykład u1_AbCdEfGhIj).
• -p – pyta o hasło.
• <DB_NAME> – baza z Panelu (na przykład s1_luckperms).
• -e "SELECT 1;" – wykonuje proste zapytanie i kończy.

Zobaczysz tabelę z liczbą 1. Jeśli w Connections From wpisano 172.18.0.%, ten test z VPS przechodzi, bo połączenie z 172.18.0.1 ma adres źródłowy 172.18.0.1.

Na koniec zrestartuj serwer gier i sprawdź w jego konsoli, czy plugin połączył się z bazą bez błędów.

Dla zaawansowanych: baza danych na innym serwerze#

Jeśli MariaDB działa na innym VPS niż Panel i Wings:

• Konto dla Panelu utwórz z adresem IP VPS z Panelem ('pterodactyluser'@'203.0.113.10').
• W polu Host wpisz adres IP serwera bazy danych. Zarówno Panel, jak i kontenery na węzłach muszą móc do niego dotrzeć.
• W firewallu serwera bazy danych zezwól na port 3306 tylko z adresów IP Panelu i węzłów (reguła z wypełnionym IP / zakres źródłowy).
• Connections From dla użytkowników baz serwerów ustaw na adres IP węzła.

Rozwiązywanie problemów#

Panel przy tworzeniu hosta zgłasza Access denied for user 'pterodactyluser'@'172.18.0.1'#

Hasło jest błędne albo użytkownik nie ma hosta 172.18.0.1. Sprawdź konta:

SELECT User, Host FROM mysql.user WHERE User = 'pterodactyluser';

Jeśli host jest inny, usuń konto (DROP USER 'pterodactyluser'@'<STARY_HOST>';) i utwórz je ponownie zgodnie z sekcją Konto dla Panelu.

Connection refused lub Can't connect to … server on '172.18.0.1'#

MariaDB nie nasłuchuje na tym adresie. Sprawdź ss -tlnp | grep 3306 (musi pokazać 0.0.0.0:3306) i plik 60-pterodactyl.cnf. Po każdej zmianie zrestartuj MariaDB.

Plugin zgłasza Communications link failure lub przekroczenie czasu połączenia#

Plugin nie mógł dotrzeć do bazy. Najczęściej w konfiguracji pluginu jest localhost lub 127.0.0.1 zamiast 172.18.0.1, albo UFW blokuje połączenie z kontenera (zobacz Firewall).

Plugin zgłasza Access denied for user 'u1_…'@'172.18.0.x'#

Connections From zawiera adres, z którego kontener się nie łączy. Usuń bazę i utwórz ją ponownie z 172.18.0.%, albo wygeneruj w Panelu nowe hasło do bazy, jeśli wpisano je błędnie.

Użytkownik nie widzi przycisku New Database#

Serwer ma Database Limit równy 0 albo limit jest wyczerpany. Zmień go zgodnie z sekcją Limit baz danych serwera.

Dalsza lektura#

• Pterodactyl: Setting up MySQL (otwiera się w nowym oknie)
• MariaDB: przewodnik po połączeniu zdalnym (otwiera się w nowym oknie)
• LuckPerms: Storage types (otwiera się w nowym oknie)