PL/Server Manual: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(replaced IRC with Discord)
 
(6 intermediate revisions by the same user not shown)
Line 8: Line 8:


=== Linux ===
=== Linux ===
Serwer pod Linuksem można zainstalować na dwa sposoby:  
Serwer pod Linuksem można zainstalować na kilka sposobów:
* [http://wiki.github.com/multitheftauto/multitheftauto/building-on-gnulinux Kompilując kod źródłowy ]
* [[Installing and Running MTASA Server on GNU Linux | Instalując i uruchamiając MTA na systemie linux]]
* [http://linux.mtasa.com Uruchamiając gotowe binarki (wcześniej skompilowane pliki) ]
* [http://linux.mtasa.com Uruchamiając gotowe binarki (wcześniej skompilowane pliki) ]
* [[Building MTASA Server on GNU Linux | Kompilując własny kod źródłowy serwera]]


=== Linux (x64/x86) ===
Dodatkowe informacje możemy znaleźć [[PL/Linux_64 | tutaj]]
Dokładniejszy opis dedykowany instalacji serwera na systemach 64 lub 86 bitowych (które nie są wspierane przez zespół MTA) można znaleźć w moim [[PL/Linux_64 | dokładniejszym opisie ]]
 
Możesz doświadczyć różnych błędów i częstych problemów. Jeśli tak się dzieje to sprawdź
* [[Building MTASA Server on GNU Linux#Troubleshooting]]
 
=== FreeBSD ===
Możesz uruchomić MTA:SA na FreeBSD za pomocą emulatora Linuxa.
* Włącz [https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/linuxemu-lbc-install.html Kompatybilność plików binarnych linuxa]
* Zainstaluj lub skompiluj następująće pakiet: hs-terminfo, linux_base-f10, linux-f10-sqlite3
* Zaintaluj [https://linux.mtasa.com/ Skompilowane binarki dla linuxa]


=== Windows ===
=== Windows ===
Line 22: Line 31:
* Klikamy na zainstaluj...
* Klikamy na zainstaluj...
* ...i gotowe!
* ...i gotowe!
Aby dowiedzieć się czym jest lista kontroli dostępu w pliku acl.ml, sprawdź [[PL/Access_Control_List|ACL]]<br/><br/>


== Konfiguracja serwera ==
== Konfiguracja serwera ==
Line 27: Line 38:


=== Ogólna konfiguracja ===
=== Ogólna konfiguracja ===
Podstawowa konfiguracja serwera znajduje się w pliku "mods/deathmatch/'''mtaserver.conf'''".
Podstawowa konfiguracja serwera znajduje się w pliku "mods/deathmatch/[[PL/mtaserver.conf|mtaserver.conf]]".
Plik ten można edytować za pomocą dowolnego edytora tekstu (jeśli nie mamy zainstalowanego żadnego "specjalistycznego" edytora - na Windowsie można użyć windowsowego ''notatnik''-a, zaś na Linuksie ''nano'' lub ''vi'').
Plik ten można edytować za pomocą dowolnego edytora tekstu (jeśli nie mamy zainstalowanego żadnego "specjalistycznego" edytora - na Windowsie można użyć windowsowego ''notatnik''-a, zaś na Linuksie ''nano'' lub ''vi'').
W pliku tym przy prawie każdej zmiennej znajduje się opis w języku angielskim, co jest dużym ułatwieniem.


=== Przekierowanie portów ===
=== Przekierowanie portów ===
W pliku '''mtaserver.conf''' znajdują się takie dwie linijki:
W pliku [[PL/mtaserver.conf|mtaserver.conf]] znajdują się takie dwie linijki:
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<serverport>22003</serverport>  
<serverport>22003</serverport>  
Line 39: Line 48:
</syntaxhighlight>
</syntaxhighlight>


Odpowiadają one za to na jakim porcie (portach) będzie nasłuchiwał nasz serwer.  
Porty są potrzebne do prawidłowej konfiguracji serwera. Wyjaśnimy później, jak je ustawić, ale najpierw, jeśli chcesz, aby Twój serwer pojawiał się w przeglądarce serwerów, potrzebujemy innego portu, a jest to port ASE.
Jak już wcześniej była o tym mowa - panel-www domyślnie nasłuchuje na porcie 22005 (tutaj to ustawienie możemy zmienić).
Podobnie serwer domyślnie nasłuchuje na porcie 22003 (co również może ulec zmianie - w/g naszego "widzimisię").


(krótki przykład włączania i wyłączania ASE):
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<ase>1</ase> <!-- 0 = wyłączony, 1 = włączony -->
<ase>1</ase> <!-- 0 = wyłączony, 1 = włączony -->
</syntaxhighlight>
</syntaxhighlight>
Teraz przekierujemy porty w Twoim routerze, co nie jest potrzebne, jeśli masz już otwarte wszystkie porty lub jeśli nie masz routera z zaporą sieciową. Jeśli tak, pomiń tę część.
Jeśli nie wiesz, jak działa przekierowanie portów w Twoim routerze, wejdź na [https://portforward.com/ stronę Port Forward], znajdź tam model swojego routera i postępuj zgodnie z zawartymi tam instrukcjami.
Prawie w każdym routerze można ustawić typ portu: UDP lub TCP. Poniższa lista wyjaśni, jaki typ portu jest potrzebny do czego:
Główny port serwera: UDP
Port HTTP: TCP
Port ASE: UDP (jest to potrzebne, jeśli chcesz, aby Twój serwer pojawił się na liście serwerów)
Port ASE jest również łatwy do uzyskania - Port ASE = port głównego serwera + 123
Jeśli więc masz port głównego serwera ustawiony na 22003, port ASE będzie miał numer 22126.
'''Jeśli masz jakieś problemy''' (i przeszukałeś podaną wcześniej stronę [https://portforward.com/ portforward.com] to zapoznaj się z tym wątkiem
<br/>
[https://forum.mtasa.com/topic/115141-guide-port-forwarding-in-order-to-run-a-mta-server/ '''Przekierowanie portów dla serwerów MTA''']
''W najnowszej wersji serwera możesz sprawdzić status portu za pomocą komendy serwera [[PL/Server_Commands#openports|openports]].''


=== Kontrola klienta ===
=== Kontrola klienta ===


MTA San Andreas ma skonfigurowanego AntyCheata. Aby antycheat działał na wszystkich, należy ustawić minimalną wersje klienta.
Serwer MTA można skonfigurować na kilka sposobów. Możemy na przykład wyłączyć jakieś komponenty systemu AntyCheat, lub zezwolić na zmodyfikowane pliki gry. Wszystkie te ustawienia znajdują się w pliku '''mods/deathmatch/[[PL/mtaserver.conf|mtaserver.conf]]'''. Możesz także zapoznać się z [[PL/Anti-cheat guide | konfiguracją antycheat]].


Jeżeli chcesz ustawić minimalną wersje klienta, wyszukaj taką linijkę:
Jeżeli chcesz ustawić minimalną wersje klienta, wyszukaj taką linijkę:
Line 55: Line 82:
<minclientversion></minclientversion>
<minclientversion></minclientversion>
</syntaxhighlight>
</syntaxhighlight>
Minimalna wersja z antycheatem: 1.1.1-9.02320
Przykładowa wersja wygląda tak: 1.1.1-9.02320


=== Konta administratorskie ===
=== Konta administratorskie ===
Line 62: Line 89:
Aby dodać konto administratora, postępuj według tych kroków:<br>
Aby dodać konto administratora, postępuj według tych kroków:<br>
<ol>
<ol>
<li>Uruchom serwer i dodaj nowe konto za pomocą '''[[Server_Commands#addaccount|addaccount name password]]''' w konsoli serwera, o tak:
<li>Uruchom serwer i dodaj nowe konto za pomocą '''[[PL/Server_Commands#addaccount|addaccount login haslo]]''' w konsoli serwera, o tak:
<div style="margin: 10px 10px 10px 10px;">
<div style="margin: 10px 10px 10px 10px;">
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
Line 69: Line 96:
</div>
</div>
<div style="margin: 10px 10px 10px 20px;">
<div style="margin: 10px 10px 10px 20px;">
''Notka: Jeżeli nie masz konsoli serwera, i zasób 'admin' nie jest uruchomiony, to możesz użyć komendy register, której użyjesz tak:\
''Uwaga: Jeżeli nie masz konsoli serwera, i zasób 'admin' nie jest uruchomiony, to możesz użyć komendy register, której użyjesz tak:\
'''/register SEBA18293 12344321'''''
'''/register SEBA18293 12344321'''''
</div>
</div>
<li>Serwer wyświetli wiadomość, a ty zarejestrujesz konto.
<li>Serwer wyświetli wiadomość, że konto zostało zarejestrowane
<li>Następnie wyłącz serwer za pomocą '''shutdown''' w konsoli serwera.
<li>Następnie wyłącz serwer za pomocą '''shutdown''' w konsoli serwera.
<li>Serwer zostanie zatrzymany.</li>
<li>Serwer zostanie zatrzymany.</li>
Line 91: Line 118:
</div>
</div>


Gratulacje, dodałeś konto administratora.
Gratulacje, dodałeś konto administratora. W ten sposób możesz dodać dowolną liczbę administratorów lub użytkowników. Przyjrzyj się na przykład niektórym innym grupom i listom ACL. Dostęp do listy ACL można także uzyskać poprzez odpowiednie funkcje, sprawdź [[PL/ACL|ACL]].
 
Zaleca się zajrzeć do interfejsu internetowego, poniżej wyjaśnimy, jak to zrobić.
 
Uwaga: Istnieją również sposoby dodawania kont i edytowania uprawnień serwera podczas jego działania. "[[PL/Server_Commands#addaccount|addaccount <login> <haslo>]]" to wewnętrzne polecenie służące do dodawania kont, ale w celu dodania tych kont do określonych grup/list ACL konieczne będzie użycie interfejsu internetowego!
 
Można także zmodyfikować plik acl.xml podczas działania serwera i użyć komendy "[[PL/Server_Commands#reloadacl|reloadacl]]"
</li>
</li>
</ol>
</ol>


=== Korzystanie z interfejsu WWW (panelu www) ===
=== Korzystanie z interfejsu WWW (panelu www) ===
Poprzez panel-www możemy zarządzać jak już wcześniej wspomniano konkretnymi elementami serwera (tzw. "zasobami" - z ang. resource).
Interfejs WWW daje nam możliwość zdalnego zarządzania serwerem. Możemy za jego pomocą dodawać użytkowników, zarządzać grupami ACL oraz [[PL/Zasoby|zasobami]] na serwerze.
Możemy je uruchamiać, zatrzymywać, restartować.  
Cały interfejs jest dostarczany wraz z serwerem przy pomocy kilku [[PL/Zasoby|zasobów]].


Interfejs WWW może zostać wyłączony poprzez ustawienie zmiennej:
Zasoby odpowiedzialne za interfejs www są uruchamiane wraz z serwerem w domyślnej konfiguracji. Panel WWW jest dostępny na wbudowanym serwerze HTTP, domyślnie na porcie 22005. Aby sprawdzić czy serwer ten jest aktywny należy wykonać poniższe kroki:
<syntaxhighlight lang="lua">
<ol>
<li>Zatrzymaj serwer</li>
<li>Otwórz plik [[PL/mtaserver.conf|mtaserver.conf]] znajdujący się '''mods/deathmatch'''</li>
<li>Upewnij się czy serwer HTTP jest włączony:
<syntaxhighlight lang="xml">
<httpserver>1</httpserver>
<httpserver>1</httpserver>
</syntaxhighlight>
</syntaxhighlight>
na 0.
</li>
<li>Ustaw port HTTP według własnych potrzeb (domyślnie 22005):
<syntaxhighlight lang="xml">
<httpport>22005</httpport>
</syntaxhighlight>
</li>
<li>Zapisz zmiany i zamknij plik</li>
<li>Uruchom serwer</li>
<li>Do poprawnego działania interfejsu WWW muszą być uruchomione następujące zasoby:
# resourcebrowser
# resourcemanager
# webadmin
# webmap


Za poprawne działanie interfejsu WWW odpowiadają następujące zasoby:
Dlatego jeśli dokonałeś jakichkolwiek zmian w autostarcie zasobów, upewnij się, że powyższe są uruchomione. Jeśli nic nie ruszałeś to domyślnie są uruchomione wraz ze startem serwera.
* resourcebrowser
</li>
* resourcemanager
<li>Otwórz przeglądarkę internetową (Internet Explorer 6 oraz 7 '''nie jest wspierany''') i przejdź do serwera HTTP wprowadzając adres URL '''http://ip_serwera:port/'''.</li>
* webadmin
<li>Po przejściu serwer poprosi o zalogowanie się - Logujemy się tam danymi administratora konta [[PL/Access_Control_List|ACL]], które opisaliśmy w poprzedniej sekcji wyżej.</li>
* webmap
</ol>


Są one ustawione jako uruchamiane domyślnie w standardowej konfiguracji serwera.
Od tej pory mamy dostęp do zarządzania serwerem przez interfejs WWW.


=== Konfiguracja zewnętrznego serwera WWW (np. do serwowania plików statycznych tj. obrazki, modele itd.) ===
Wbudowany serwer HTTP jest także używany do pobierania plików uruchomionych zasobów na serwerze do każdego gracza z osobna. Przykładowo jeśli masz na serwerze jakiś zasób, który zawiera graficzny interfejs lub jakieś modele do podmiany to pliki takie jak obrazki, modele, kolizje, tekstury itd muszą zostać przesłane z serwera do każdego gracza na serwerze. To zadanie właśnie wykonuje domyślnie wbudowany serwer HTTP lub ustalony przez nas serwer zewnętrzny (zazwyczaj jest szybszy), z tym, że taki zewnętrzny serwer musimy skonfigurować zupełnie osobno.


Mając na uwadze wydajność i spójność serwera możesz skonfigurować zewnętrzny serwer HTTP do pobierania plików na serwerze przez graczy. Zewnętrzny serwer WWW musi być publicznie dostępny, tak aby każdy gracz na serwerze (klient) mógł się połączyć z tym serwerem w celu pobrania potrzebnych plików klienta. Taki zabieg może przyśpieszyć proces pobierania oraz odciążyć serwer.


=== Konfiguracja zewnętrznego serwera WWW (np. do serwowania plików statycznych tj. obrazki, cssy itd.) ===
Aby umożliwić pobieranie plików z zewnętrznego serwera WWW należy skonfigurować pole [[PL/mtaserver.conf#httpdownloadurl|httpdownloadurl]]:
Jeżeli twój serwer korzysta z edytowanych modeli aut, obrazków w grze (lub na wbudowanym serwerze www) możesz ustawić w ustawieniach serwera, aby zewnętrzny serwer WWW serwował pliki za nie odpowiedzialne.
Domyślnie pliki serwowane są z serwera MTA (powyższa operacja może służyć przyśpieszeniu procesu pobierania - lub po prostu odciążeniu serwera).


Aby umożliwić pobieranie potrzebnych plików z zewnętrznego serwera, należy ustawić zmienną '''httpdownload''' i '''httpdownloadurl''' w konfiguracji serwera:
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="lua"><httpdownload>1</httpdownload>
<httpdownloadurl>http://www.mojserwer.pl/skad/chce/sciagac/pliki</httpdownloadurl>
<httpdownloadurl>http://www.mojserwer.pl/skad/chce/sciagac/pliki</httpdownloadurl>
</syntaxhighlight>
</syntaxhighlight>


W tym momencie po uruchomieniu serwera w katalogu '''/mods/deathmatch/resourcecache/http-client-files''' będą znajdować się archiwa .zip zawierające pliki które należy wrzucić na wcześniej ustawiony zewnętrzny serwer www.
Po uruchomieniu serwera MTA w katalogu '''mods/deathmatch/resource-cache/http-client-files''' będą znajdować się pliki klienta gotowe do wrzucenia na zewnętrzny serwer WWW. Jeśli serwer WWW znajduje się na tej samej maszynie co serwera MTA to wystarczy połączyć odpowiedni katalog serwera WWW z katalogiem '''http-client-files'''. Jeśli natomiast serwer WWW i serwer MTA znajdują się na różnych maszynach to należy zapewnić dostęp serwerowi WWW do katalogu '''http-client-files''' za pomocą ścieżki sieciowej lub utworzyć zdalną kopię przy pomocy oprogramowania do synchronizacji.


Domyślnie zostaną wygenerowane pliki dla wszystkich zasobów. Jeżeli chcielibyśmy aby domyślne (takie jak webadmin itd.) dalej korzystały z wbudowanego serwowania plików w MTA, możemy ustawić w konfiguracji serwera, aby wygenerowane zostały tylko pliki dla '''rozpakowanych''' (w katalogu ''resources'') zasobów.
'''Uwagi'''
<syntaxhighlight lang="lua"><httpautoclientfiles>1</httpautoclientfiles></syntaxhighlight>
* Należy unikać znaków specjalnych (np. ~,!) w adresie URL zewnętrznego serwera
* Nie należy stawiać ukośnika (/) na końcu adresu URL, czyli zamiast '''http://www.mojserwer.pl/katalog/''' podajemy '''http://www.mojserwer.pl/katalog''' bez tego ukośnika na końcu.
* Serwer WWW musi używać formatu danych "''ContentType: application/octet-stream''" dla plików Lua. Większość serwerów ma to już domyślnie ustawione, ale w razie potrzeby można to zrobić ręcznie dodając do pliku .htaccess taką linijkę:
<div style="padding: 10px">
<syntaxhighlight lang="xml">AddType application/octet-stream .lua
</syntaxhighlight></div>


'''Uwaga:  
Instrukcja jak zainstalować i skonfigurować Nginx jako zewnętrzny serwer WWW dla MTA znajduje się tutaj: [[PL/Installing_and_Configuring_Nginx_as_an_External_Web_Server|Instalcaja i konfiguracja Nginx jako zewnętrzny serwer WWW]]
* Zaleca się nie używać w adresie zewnętrznego serwera www specjalnych znaków (takich jak !, ~).
* Na końcu adresu zewnętrznego serwera nie należy stawiać "slesza" (/).'''


== Uruchamianie serwera ==
== Uruchamianie serwera ==
Line 138: Line 189:
Na Linuksie uruchom komende '''./mta-server'''.
Na Linuksie uruchom komende '''./mta-server'''.


== Instalacja/Aktualizacja zasobów ("modów") na serwerze ==
Pamiętaj, aby zapewnić dostęp w zaporze sieciowej i przekierować porty, jeśli jest to potrzebne.
Zasoby serwera (tzw. "mody") mogą być wgrane na dwa sposoby:
 
== Instalacja/Aktualizacja zasobów na serwerze ==
Zasoby serwera mogą być wgrane na dwa sposoby:
* Archiwum ZIP (zawierające pliki zasobu)
* Archiwum ZIP (zawierające pliki zasobu)
* Katalog zawierający pliki zasobu
* Katalog zawierający pliki zasobu
Line 145: Line 198:
Aby wgrać nowy zasób należy:
Aby wgrać nowy zasób należy:
# Przenieść lub skopiować go do '''mods/deathmatch/resources/'''.
# Przenieść lub skopiować go do '''mods/deathmatch/resources/'''.
# W oknie konsoli serwera wpisać komendę '''refresh'''.
# W oknie konsoli serwera wpisać komendę [[PL/mtaserver.conf#refresh|refresh]].


== Usuwanie zasobów ("modów") ==
== Usuwanie zasobów ==
Usuwanie zasobów jest bardzo proste. Sprowadza się do:
Usuwanie zasobów jest bardzo proste. Sprowadza się do:


# Usunięcia archiwum ZIP danego zasobu, lub jego katalogu.
# Usunięcia archiwum ZIP danego zasobu, lub jego katalogu.
# Wpisania w oknie konsoli komendy '''refresh'''.
# Wpisania w oknie konsoli komendy [[PL/mtaserver.conf#refresh|refresh]].


== Administrowanie serwerem ==
== Administrowanie serwerem ==
Line 161: Line 214:
<syntaxhighlight lang="lua">restart [nazwa zasobu]</syntaxhighlight>
<syntaxhighlight lang="lua">restart [nazwa zasobu]</syntaxhighlight>


Administracja jest również możliwa poprzez panel www (wcześniej opisany) lub poprzez grę.  
Polecenia te (oraz inne) są dostępne z poziomu konsoli serwera oraz konsoli w grze pod klawiszem ~ lub F8. Jeśli używamy konsoli w grze to, aby móc używać tych komend musimy mieć do tego uprawnienia i musimy być zalogowani na konto [[PL/Access_Control_List|ACL]].
Po zalogowaniu się na konto administratora:
 
<syntaxhighlight lang="lua">/login [nazwa konta] [haslo]</syntaxhighlight>
Ponadto także możemy skorzystać z panelu administratora w graficznej formie, który jest dostępny domyślnie pod klawiszem '''P'''. Pozwala on na karanie graczy, zarządzanie zasobami, serwerem i wiele więcej.
i wciskając klawisz F8. W owym panel oferuje nam kick-owanie i banowanie graczy (czyli takie podstawowe czynności).
 
Zarządzanie serwerem jest także możliwe przez panel WWW opisany w sekcjach wyżej.


== Uruchamianie map / Tryb gry ==
== Uruchamianie map / Tryb gry ==
Więcej informacji [[map_manager|znajdziesz tutaj]][[Image:usen.gif|Artykuł w języku angielskim]].
Więcej informacji [[map_manager|znajdziesz tutaj]][[Image:usen.gif|Artykuł w języku angielskim]].


== Uwagi ==
== Utrzymywanie serwera ==
Aby zapewnić stabilność działania serwera nie należy pozostawiać go bez opieki po uruchomieniu. Oto kilka wskazówek na temat prowadzenia i utrzymywania serwera:
 
* Warto co jakiś czas monitorować zużycie pamięci przez proces poprzez menadżer zadań lub [[performancebrowser]] / '''ipb'''. Jeśli serwer MTA zużywa powyżej 1,2 GB to w każdej chwili może wystąpić błąd ''Out of memory (OOM)'', który mówi o braku pamięci. W takim przypadku powinieneś:
** Zrestartować serwer
** Rozpocząć poszukiwania nieoptymalnych skryptów. Przeczytasz niżej jak można je znaleźć.
* Dbaj, aby zużycie procesora przez serwer nie osiągało wysokich wartości, ponieważ zazwyczaj powoduje to lagi lub nawet awarię serwera.
* Używaj [[setElementData]] i [[getElementData]] z rozsądkiem. Są to funkcje, które w przypadku synchronizacji wykonują ją '''ciągle'''. Gdy to możliwe ogranicz ilość synchronizowanych danych i używaj [[addElementDataSubscriber]]. Możesz także rozważyć stworzenie własnego systemu wymiany i przechowywania danych, który zastąpi ten wbudowany.
* Jak w każdej grze tutaj także znajdują się cheaterzy (choć jest ich mniej dzięki silnemu systemowi antycheat), którzy tylko szukają możliwości aby uprzykrzyć Ci życie i zaszkodzić. Jeśli więc wprowadzasz jakieś nowe, niestandardowe zasoby na serwer to zapoznaj się z [[Script security|bezpieczeństwem skryptów]].
* Zaleca się co jakiś czas restartowanie serwera - Jak w przypadku procesów i aplikacji nie wszystkie wywołania mogą zostać "uwolnione". Przykładowo po uruchomienia serwera zużycie pamięci jest na poziomie około 50 mb. Jeśli w międzyczasie wejdą jacyś gracze, a po czasie wyjdą z serwera to zużycie pamięci '''wzrośnie''', nawet jeśli na serwerze będzie 0 graczy. Jest to znane jako [[https://www.google.com/search?q=software+aging|"starzenie" się oprogramowania]]. Jest to wynik ciągłego działania serwera i pewnych działań w kodzie - Serwer, który nie jest ponownie uruchomiony będzie zużywał coraz więcej pamięci, aż dojdzie do wspomnianego wyżej braku pamięci lub innej awarii. Oczywiście taki proces "degradacji" serwera trwa bardzo długi okres czasu i zależy od liczby graczy, obciążenia i wielu innych czynników. Jeśli tworzysz duży serwer, dla setek graczy to dobrą praktyką jest restartowanie go np. raz w tygodniu w godzinach nocnych.
 
== Optymalizacja serwera ==
Jeśli masz zasoby, które działają w sposób nie optymalny to w bardzo łatwy sposób może to doprowadzić do lagów, przeciążenia, braku pamięci i awarii serwera. Aby zapobiegać takim sytuacjom należy monitorować co jakiś czas zużycie zasobów serwera przez konkretne skrypty i procesy.
 
Do takiego monitorowania przeznaczone są zasoby [[performancebrowser]] oraz '''ipb'''.
* Performancebrowser umożliwia monitorowanie stabilności serwera za pomocą interfejsu WWW w przeglądarce. W pasek adresu w przeglądarce wprowadzamy adres URL: '''ip_serwera:port/performancebrowser/''', port który podajemy to port HTTP. Domyślnie jest to po prostu port serwera + 1. Gdy wszystko się uda zostaniemy poproszeni o zalogowanie się do konta ACL z uprawnieniami.
* IPB jest dokładnie tym samym, tyle tylko, że jest to interfejs graficzny w grze. Aby go używać musimy posiadać uprawnienia ACL.
 
W zakładce '''Lua memory''' możemy zobaczyć zużycie pamięci serwera przez poszczególne zasoby. Natomiast w zakładce '''Lua timing''' możemy zobaczyć zużycie procesora przez poszczególne zasoby.
 
Możemy także sprawdzić zużycie pamięci i procesora po stronie klienta i u konkretnych graczy. W tym celu zaznaczamy pole '''Incl. clients''' i wybieramy kogoś z listy '''Target'''.
 
Im niższe zużycie pamięci i procesora przez zasób tym lepiej. Jeśli zasób zużywa przykładowo 300% procesora klienta to taki gracz z pewnością doświadczy utrudnień w postaci lagów, zacinania się gry a nawet awarii. Dlatego należy zawsze pilnować i optymalizować lub eliminować takie zasoby, które zużywają duże ilości zasobów serwera.
 
== Przydatne informacje ==


# Zasoby można odświeżać również w grze, jeżeli w nadamy odpowiednie uprawnienia w pliku ''acl.xml''.
# Zasoby można odświeżać również w grze za pomocą komendy '''refresh''' na czacie lub w konsoli F8. Używanie tej komendy wymaga odpowiednich uprawnień [[PL/Access_Control_List|ACL]]. Komenda może wywołać chwilowy lag, jeśli jest wiele zasobów na serwerze
# W instrukcji zostały podane względne ścieżki (tzn. np. /deathmatch/resources odnosi się do katalogu w katalogu serwera).
# W instrukcji zostały podane względne ścieżki (tzn. np. /deathmatch/resources odnosi się do katalogu w katalogu serwera). Dla serwera lokalnego domyślnie jest to '''C:\Program Files\MTA San Andreas\server'''
# Można wybrać inny plik konfiguracyjny z którego będzie korzystać MTA, podając parametr ''--config [nazwa pliku konfiguracyjnego]''
# Można wybrać inny plik konfiguracyjny z którego będzie korzystać MTA, podając parametr ''--config [nazwa pliku konfiguracyjnego]'' np. ''mtaserver.exe --config nowyplik.cfg''
# Nie należy martwić się błędem dotyczącym pliku ''settings.xml''.
# Nie należy martwić się błędami i ostrzeżeniami dotyczącymi pliku ''settings.xml''. Jest to normalne przy świeżym i czystym serwerze


== Potrzebujesz pomocy ?==
====Potrzebujesz pomocy?====
Potrzebujesz pomocy? Napisz na [http://forum.mtasa.com/ forum] lub napisz na [https://discord.com/invite/mtasa Discord].
Potrzebujesz pomocy? Napisz na [http://forum.mtasa.com/ forum] lub napisz na [https://discord.com/invite/mtasa Discord]. Skorzystaj z odpowiedniego kanału pomocy #help-support dla serwera lub któryś ze #scripting-helo dla pomocy w skryptach/zasobach.


[[de:Server Anleitung]]
[[en:Server Manual]]
[[en:Server Manual]]
[[es:Manual del Servidor]]
[[fr:Manuel Serveur]]
[[hu:Server Manual]]
[[it:Manuale del Server]]
[[nl:Server Manual]]
[[pl:Server Manual]]
[[pt-br:Manual do Servidor]]
[[ru:Server Manual]]

Latest revision as of 14:39, 5 April 2024

Pierwsze kroki

Uruchomienie swojego własnego serwera MTA:SA jest o wiele łatwiejsze niż mogłoby się wydawać. Jeżeli chciałbyś postawić serwer by pograć ze znajomymi lub po prostu z ludźmi z sieci - zachęcam do lektury.

Instalacja serwera

Poniżej opisane są sposoby instalacji serwera w zależności od posiadanego systemu operacyjnego.

Linux

Serwer pod Linuksem można zainstalować na kilka sposobów:

Dodatkowe informacje możemy znaleźć tutaj

Możesz doświadczyć różnych błędów i częstych problemów. Jeśli tak się dzieje to sprawdź

FreeBSD

Możesz uruchomić MTA:SA na FreeBSD za pomocą emulatora Linuxa.

Windows

Instalacja serwera na Windowsie jest prosta "jak budowa cepa".

  • Najpierw pobieramy instalator ze strony głównej
  • Po ściągnięciu uruchamiamy ów instalator
  • Wybieramy folder gdzie chcemy zainstalować MTA (serwer jest w jednej paczce z klientem)
  • Klikamy na zainstaluj...
  • ...i gotowe!

Aby dowiedzieć się czym jest lista kontroli dostępu w pliku acl.ml, sprawdź ACL

Konfiguracja serwera

Serwer Multi Theft Auto jest wstępnie konfigurowany z okna konsoli, z poziomu gry i z przeglądarki internetowej.

Ogólna konfiguracja

Podstawowa konfiguracja serwera znajduje się w pliku "mods/deathmatch/mtaserver.conf". Plik ten można edytować za pomocą dowolnego edytora tekstu (jeśli nie mamy zainstalowanego żadnego "specjalistycznego" edytora - na Windowsie można użyć windowsowego notatnik-a, zaś na Linuksie nano lub vi).

Przekierowanie portów

W pliku mtaserver.conf znajdują się takie dwie linijki:

<serverport>22003</serverport> 
<httpport>22005</httpport>

Porty są potrzebne do prawidłowej konfiguracji serwera. Wyjaśnimy później, jak je ustawić, ale najpierw, jeśli chcesz, aby Twój serwer pojawiał się w przeglądarce serwerów, potrzebujemy innego portu, a jest to port ASE.

(krótki przykład włączania i wyłączania ASE):

<ase>1</ase> <!-- 0 = wyłączony, 1 = włączony -->

Teraz przekierujemy porty w Twoim routerze, co nie jest potrzebne, jeśli masz już otwarte wszystkie porty lub jeśli nie masz routera z zaporą sieciową. Jeśli tak, pomiń tę część.

Jeśli nie wiesz, jak działa przekierowanie portów w Twoim routerze, wejdź na stronę Port Forward, znajdź tam model swojego routera i postępuj zgodnie z zawartymi tam instrukcjami.

Prawie w każdym routerze można ustawić typ portu: UDP lub TCP. Poniższa lista wyjaśni, jaki typ portu jest potrzebny do czego:

Główny port serwera: UDP Port HTTP: TCP Port ASE: UDP (jest to potrzebne, jeśli chcesz, aby Twój serwer pojawił się na liście serwerów)

Port ASE jest również łatwy do uzyskania - Port ASE = port głównego serwera + 123 Jeśli więc masz port głównego serwera ustawiony na 22003, port ASE będzie miał numer 22126.

Jeśli masz jakieś problemy (i przeszukałeś podaną wcześniej stronę portforward.com to zapoznaj się z tym wątkiem
Przekierowanie portów dla serwerów MTA

W najnowszej wersji serwera możesz sprawdzić status portu za pomocą komendy serwera openports.

Kontrola klienta

Serwer MTA można skonfigurować na kilka sposobów. Możemy na przykład wyłączyć jakieś komponenty systemu AntyCheat, lub zezwolić na zmodyfikowane pliki gry. Wszystkie te ustawienia znajdują się w pliku mods/deathmatch/mtaserver.conf. Możesz także zapoznać się z konfiguracją antycheat.

Jeżeli chcesz ustawić minimalną wersje klienta, wyszukaj taką linijkę:

<minclientversion></minclientversion>

Przykładowa wersja wygląda tak: 1.1.1-9.02320

Konta administratorskie

Zaleca się, aby serwer posiadał przynajmniej jedno konto administratora - tak, aby właściciel serwera miał w każdej chwili możliwość włączenia/wyłączenia serwera (lub danej jego części poprzez panel-www, konsole, grę).

Aby dodać konto administratora, postępuj według tych kroków:

  1. Uruchom serwer i dodaj nowe konto za pomocą addaccount login haslo w konsoli serwera, o tak:
    addaccount SEBA18293 12344321
    

    Uwaga: Jeżeli nie masz konsoli serwera, i zasób 'admin' nie jest uruchomiony, to możesz użyć komendy register, której użyjesz tak:\ /register SEBA18293 12344321

  2. Serwer wyświetli wiadomość, że konto zostało zarejestrowane
  3. Następnie wyłącz serwer za pomocą shutdown w konsoli serwera.
  4. Serwer zostanie zatrzymany.
  5. Otwórz plik 'mods/deathmatch/acl.xml' za pomocą edytora tekstu.
  6. Dodaj konto do grupy Admin
    <acl>
      ...
      <group name="Admin">
        <acl name="Admin"/>
        ...
        <object name="user.SEBA18293" />
      </group>
      ...
    </acl>
    

    Gratulacje, dodałeś konto administratora. W ten sposób możesz dodać dowolną liczbę administratorów lub użytkowników. Przyjrzyj się na przykład niektórym innym grupom i listom ACL. Dostęp do listy ACL można także uzyskać poprzez odpowiednie funkcje, sprawdź ACL.

    Zaleca się zajrzeć do interfejsu internetowego, poniżej wyjaśnimy, jak to zrobić.

    Uwaga: Istnieją również sposoby dodawania kont i edytowania uprawnień serwera podczas jego działania. "addaccount <login> <haslo>" to wewnętrzne polecenie służące do dodawania kont, ale w celu dodania tych kont do określonych grup/list ACL konieczne będzie użycie interfejsu internetowego!

    Można także zmodyfikować plik acl.xml podczas działania serwera i użyć komendy "reloadacl"

Korzystanie z interfejsu WWW (panelu www)

Interfejs WWW daje nam możliwość zdalnego zarządzania serwerem. Możemy za jego pomocą dodawać użytkowników, zarządzać grupami ACL oraz zasobami na serwerze. Cały interfejs jest dostarczany wraz z serwerem przy pomocy kilku zasobów.

Zasoby odpowiedzialne za interfejs www są uruchamiane wraz z serwerem w domyślnej konfiguracji. Panel WWW jest dostępny na wbudowanym serwerze HTTP, domyślnie na porcie 22005. Aby sprawdzić czy serwer ten jest aktywny należy wykonać poniższe kroki:

  1. Zatrzymaj serwer
  2. Otwórz plik mtaserver.conf znajdujący się mods/deathmatch
  3. Upewnij się czy serwer HTTP jest włączony:
    <httpserver>1</httpserver>
    
  4. Ustaw port HTTP według własnych potrzeb (domyślnie 22005):
    <httpport>22005</httpport>
    
  5. Zapisz zmiany i zamknij plik
  6. Uruchom serwer
  7. Do poprawnego działania interfejsu WWW muszą być uruchomione następujące zasoby:
    1. resourcebrowser
    2. resourcemanager
    3. webadmin
    4. webmap
    Dlatego jeśli dokonałeś jakichkolwiek zmian w autostarcie zasobów, upewnij się, że powyższe są uruchomione. Jeśli nic nie ruszałeś to domyślnie są uruchomione wraz ze startem serwera.
  8. Otwórz przeglądarkę internetową (Internet Explorer 6 oraz 7 nie jest wspierany) i przejdź do serwera HTTP wprowadzając adres URL http://ip_serwera:port/.
  9. Po przejściu serwer poprosi o zalogowanie się - Logujemy się tam danymi administratora konta ACL, które opisaliśmy w poprzedniej sekcji wyżej.

Od tej pory mamy dostęp do zarządzania serwerem przez interfejs WWW.

Konfiguracja zewnętrznego serwera WWW (np. do serwowania plików statycznych tj. obrazki, modele itd.)

Wbudowany serwer HTTP jest także używany do pobierania plików uruchomionych zasobów na serwerze do każdego gracza z osobna. Przykładowo jeśli masz na serwerze jakiś zasób, który zawiera graficzny interfejs lub jakieś modele do podmiany to pliki takie jak obrazki, modele, kolizje, tekstury itd muszą zostać przesłane z serwera do każdego gracza na serwerze. To zadanie właśnie wykonuje domyślnie wbudowany serwer HTTP lub ustalony przez nas serwer zewnętrzny (zazwyczaj jest szybszy), z tym, że taki zewnętrzny serwer musimy skonfigurować zupełnie osobno.

Mając na uwadze wydajność i spójność serwera możesz skonfigurować zewnętrzny serwer HTTP do pobierania plików na serwerze przez graczy. Zewnętrzny serwer WWW musi być publicznie dostępny, tak aby każdy gracz na serwerze (klient) mógł się połączyć z tym serwerem w celu pobrania potrzebnych plików klienta. Taki zabieg może przyśpieszyć proces pobierania oraz odciążyć serwer.

Aby umożliwić pobieranie plików z zewnętrznego serwera WWW należy skonfigurować pole httpdownloadurl:

<httpdownloadurl>http://www.mojserwer.pl/skad/chce/sciagac/pliki</httpdownloadurl>

Po uruchomieniu serwera MTA w katalogu mods/deathmatch/resource-cache/http-client-files będą znajdować się pliki klienta gotowe do wrzucenia na zewnętrzny serwer WWW. Jeśli serwer WWW znajduje się na tej samej maszynie co serwera MTA to wystarczy połączyć odpowiedni katalog serwera WWW z katalogiem http-client-files. Jeśli natomiast serwer WWW i serwer MTA znajdują się na różnych maszynach to należy zapewnić dostęp serwerowi WWW do katalogu http-client-files za pomocą ścieżki sieciowej lub utworzyć zdalną kopię przy pomocy oprogramowania do synchronizacji.

Uwagi

  • Należy unikać znaków specjalnych (np. ~,!) w adresie URL zewnętrznego serwera
  • Nie należy stawiać ukośnika (/) na końcu adresu URL, czyli zamiast http://www.mojserwer.pl/katalog/ podajemy http://www.mojserwer.pl/katalog bez tego ukośnika na końcu.
  • Serwer WWW musi używać formatu danych "ContentType: application/octet-stream" dla plików Lua. Większość serwerów ma to już domyślnie ustawione, ale w razie potrzeby można to zrobić ręcznie dodając do pliku .htaccess taką linijkę:
AddType application/octet-stream .lua

Instrukcja jak zainstalować i skonfigurować Nginx jako zewnętrzny serwer WWW dla MTA znajduje się tutaj: Instalcaja i konfiguracja Nginx jako zewnętrzny serwer WWW

Uruchamianie serwera

Aby uruchomić serwer kliknij dwukrotnie na plik MTA-Server.exe. Na Linuksie uruchom komende ./mta-server.

Pamiętaj, aby zapewnić dostęp w zaporze sieciowej i przekierować porty, jeśli jest to potrzebne.

Instalacja/Aktualizacja zasobów na serwerze

Zasoby serwera mogą być wgrane na dwa sposoby:

  • Archiwum ZIP (zawierające pliki zasobu)
  • Katalog zawierający pliki zasobu

Aby wgrać nowy zasób należy:

  1. Przenieść lub skopiować go do mods/deathmatch/resources/.
  2. W oknie konsoli serwera wpisać komendę refresh.

Usuwanie zasobów

Usuwanie zasobów jest bardzo proste. Sprowadza się do:

  1. Usunięcia archiwum ZIP danego zasobu, lub jego katalogu.
  2. Wpisania w oknie konsoli komendy refresh.

Administrowanie serwerem

Aby uruchomić dany zasób wystarczy użyć polecenia (oczywiście bez nawiasu):

start [nazwa zasobu]

Następnie gdybyśmy chcieli go zatrzymać:

stop [nazwa zasobu]

Jeśli zrestartować:

restart [nazwa zasobu]

Polecenia te (oraz inne) są dostępne z poziomu konsoli serwera oraz konsoli w grze pod klawiszem ~ lub F8. Jeśli używamy konsoli w grze to, aby móc używać tych komend musimy mieć do tego uprawnienia i musimy być zalogowani na konto ACL.

Ponadto także możemy skorzystać z panelu administratora w graficznej formie, który jest dostępny domyślnie pod klawiszem P. Pozwala on na karanie graczy, zarządzanie zasobami, serwerem i wiele więcej.

Zarządzanie serwerem jest także możliwe przez panel WWW opisany w sekcjach wyżej.

Uruchamianie map / Tryb gry

Więcej informacji znajdziesz tutajArtykuł w języku angielskim.

Utrzymywanie serwera

Aby zapewnić stabilność działania serwera nie należy pozostawiać go bez opieki po uruchomieniu. Oto kilka wskazówek na temat prowadzenia i utrzymywania serwera:

  • Warto co jakiś czas monitorować zużycie pamięci przez proces poprzez menadżer zadań lub performancebrowser / ipb. Jeśli serwer MTA zużywa powyżej 1,2 GB to w każdej chwili może wystąpić błąd Out of memory (OOM), który mówi o braku pamięci. W takim przypadku powinieneś:
    • Zrestartować serwer
    • Rozpocząć poszukiwania nieoptymalnych skryptów. Przeczytasz niżej jak można je znaleźć.
  • Dbaj, aby zużycie procesora przez serwer nie osiągało wysokich wartości, ponieważ zazwyczaj powoduje to lagi lub nawet awarię serwera.
  • Używaj setElementData i getElementData z rozsądkiem. Są to funkcje, które w przypadku synchronizacji wykonują ją ciągle. Gdy to możliwe ogranicz ilość synchronizowanych danych i używaj addElementDataSubscriber. Możesz także rozważyć stworzenie własnego systemu wymiany i przechowywania danych, który zastąpi ten wbudowany.
  • Jak w każdej grze tutaj także znajdują się cheaterzy (choć jest ich mniej dzięki silnemu systemowi antycheat), którzy tylko szukają możliwości aby uprzykrzyć Ci życie i zaszkodzić. Jeśli więc wprowadzasz jakieś nowe, niestandardowe zasoby na serwer to zapoznaj się z bezpieczeństwem skryptów.
  • Zaleca się co jakiś czas restartowanie serwera - Jak w przypadku procesów i aplikacji nie wszystkie wywołania mogą zostać "uwolnione". Przykładowo po uruchomienia serwera zużycie pamięci jest na poziomie około 50 mb. Jeśli w międzyczasie wejdą jacyś gracze, a po czasie wyjdą z serwera to zużycie pamięci wzrośnie, nawet jeśli na serwerze będzie 0 graczy. Jest to znane jako ["starzenie" się oprogramowania]. Jest to wynik ciągłego działania serwera i pewnych działań w kodzie - Serwer, który nie jest ponownie uruchomiony będzie zużywał coraz więcej pamięci, aż dojdzie do wspomnianego wyżej braku pamięci lub innej awarii. Oczywiście taki proces "degradacji" serwera trwa bardzo długi okres czasu i zależy od liczby graczy, obciążenia i wielu innych czynników. Jeśli tworzysz duży serwer, dla setek graczy to dobrą praktyką jest restartowanie go np. raz w tygodniu w godzinach nocnych.

Optymalizacja serwera

Jeśli masz zasoby, które działają w sposób nie optymalny to w bardzo łatwy sposób może to doprowadzić do lagów, przeciążenia, braku pamięci i awarii serwera. Aby zapobiegać takim sytuacjom należy monitorować co jakiś czas zużycie zasobów serwera przez konkretne skrypty i procesy.

Do takiego monitorowania przeznaczone są zasoby performancebrowser oraz ipb.

  • Performancebrowser umożliwia monitorowanie stabilności serwera za pomocą interfejsu WWW w przeglądarce. W pasek adresu w przeglądarce wprowadzamy adres URL: ip_serwera:port/performancebrowser/, port który podajemy to port HTTP. Domyślnie jest to po prostu port serwera + 1. Gdy wszystko się uda zostaniemy poproszeni o zalogowanie się do konta ACL z uprawnieniami.
  • IPB jest dokładnie tym samym, tyle tylko, że jest to interfejs graficzny w grze. Aby go używać musimy posiadać uprawnienia ACL.

W zakładce Lua memory możemy zobaczyć zużycie pamięci serwera przez poszczególne zasoby. Natomiast w zakładce Lua timing możemy zobaczyć zużycie procesora przez poszczególne zasoby.

Możemy także sprawdzić zużycie pamięci i procesora po stronie klienta i u konkretnych graczy. W tym celu zaznaczamy pole Incl. clients i wybieramy kogoś z listy Target.

Im niższe zużycie pamięci i procesora przez zasób tym lepiej. Jeśli zasób zużywa przykładowo 300% procesora klienta to taki gracz z pewnością doświadczy utrudnień w postaci lagów, zacinania się gry a nawet awarii. Dlatego należy zawsze pilnować i optymalizować lub eliminować takie zasoby, które zużywają duże ilości zasobów serwera.

Przydatne informacje

  1. Zasoby można odświeżać również w grze za pomocą komendy refresh na czacie lub w konsoli F8. Używanie tej komendy wymaga odpowiednich uprawnień ACL. Komenda może wywołać chwilowy lag, jeśli jest wiele zasobów na serwerze
  2. W instrukcji zostały podane względne ścieżki (tzn. np. /deathmatch/resources odnosi się do katalogu w katalogu serwera). Dla serwera lokalnego domyślnie jest to C:\Program Files\MTA San Andreas\server
  3. Można wybrać inny plik konfiguracyjny z którego będzie korzystać MTA, podając parametr --config [nazwa pliku konfiguracyjnego] np. mtaserver.exe --config nowyplik.cfg
  4. Nie należy martwić się błędami i ostrzeżeniami dotyczącymi pliku settings.xml. Jest to normalne przy świeżym i czystym serwerze

Potrzebujesz pomocy?

Potrzebujesz pomocy? Napisz na forum lub napisz na Discord. Skorzystaj z odpowiedniego kanału pomocy #help-support dla serwera lub któryś ze #scripting-helo dla pomocy w skryptach/zasobach.