FiveM Przewodnik po server.cfg: Bezpieczna konfiguracja startowa

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sets sv_projectName "My Server"
sets sv_projectDesc "A clear one-sentence description"
sv_hostname "My Server"
set onesync on
sv_maxclients 48
sv_licenseKey "replace_with_portal_key"
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap

The server.cfg plik jest sercem każdego serwera FiveM. Określa, jak działa Twój serwer: sloty, sieć, wersja gry, OneSync, logowanie i widoczność na liście serwerów. Ten przewodnik jest dla właściciele serwerów i deweloperzy którzy chcą bezpiecznych domyślnych ustawień, utwardzania produkcji i najlepszych praktyk dotyczących wydajności. Zawsze wykonuj kopie zapasowe i używaj kontroli wersji. Jeśli jesteś nowy, zacznij od naszego Jak utworzyć serwer FiveM. Aby uzyskać głębsze optymalizacje, zobacz nasz Centrum wydajności.

TL;DR: Gotowa do produkcji linia bazowa (z adnotacjami)

Czysty server.cfg jest podstawą stabilności. Poniżej znajdują się dwa przykłady: minimalny konfiguracja deweloperska i a utwardzona konfiguracja produkcyjna.

Minimalna konfiguracja deweloperska

# server.cfg (development)
# Basic config for local testing

# Network
endpoint_add_tcp "0.0.0.0:30120" # TCP port binding
endpoint_add_udp "0.0.0.0:30120" # UDP port binding

# Server info
sv_hostname "My Dev Server"
sv_maxclients 8

# OneSync
set onesync on

# Resources (basic example)
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure baseevents

# Permissions (default ACL)
exec permissions.cfg

Utwardzona konfiguracja produkcyjna

# server.cfg (production)

# Network
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Security
sv_endpointPrivacy true # Hides player IP addresses from public server reports; it does not hide the server origin
sv_scriptHook 0 # Disable client mods
# Leave rcon_password unset unless legacy RCon is explicitly required

# Slots
sv_maxclients 64 # Adjust to host capacity

# Game build (use latest recommended)
# Optional: pin a documented game build only when your resources require it

# Project info
sv_hostname "FIVEMX Roleplay | Serious RP"
sets sv_projectName "FIVEMX RP Server"
sets sv_projectDesc "Realistic RP with QBCore & custom scripts"
sets tags "roleplay, seriousrp, qbcore"
sets locale "en-US"
load_server_icon mylogo.png
sets banner_detail "https://cdn.example.com/banner.png"
sets banner_connecting "https://cdn.example.com/loading.png"

# OneSync
set onesync on

# Resources (use resource list)
exec resources.cfg

# Logging & ACL
set sv_logLevel 2
exec permissions.cfg

# txAdmin integration
# Load framework/database configuration from a separately permissioned config; do not publish real credentials

Wskazówka: Zawsze waliduj swoją konfigurację po edycjach za pomocą txAdmin kontroli stanu i logów konsoli. Zobacz logi txAdmin.

Informacje o serwerze i lista

Następujące zmienne kontrolują sposób wyświetlania Twojego serwera w przeglądarka serwerów i API:

Zobacz Oficjalna dokumentacja poleceń i zmiennych serwera Cfx.re dla aktualnej składni i zachowania.

Sieć i sloty

FiveM serwery używają Punkty końcowe TCP/UDP. Domyślnie port 30120 jest używany.

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_maxclients 64

• Uruchom wiele serwerów na jednej maszynie z przesunięcia portów: np. 30121, 30122.
• Dopasuj reguły zapory sieciowej, aby otworzyć porty TCP/UDP.
• sv_maxclients bezpośrednio wpływa na użycie procesora i pamięci RAM — nie ustawiaj wyższej wartości niż ta, którą może obsłużyć Twój sprzęt. Zobacz dostawców hostingu serwerów

Ostrzeżenie: Nie udostępniaj portów MySQL ani RCON w Internecie.

Kompilacja gry i artefakty

Wersja artefaktu FXServer i wersja gry GTA V to oddzielne wybory. Aktualizuj artefakty ścieżką zalecaną przez Cfx.re; ustaw sv_enforceGameBuild tylko wtedy, gdy zasoby serwera wymagają udokumentowanej wersji zawartości GTA, i zweryfikuj wartość w odniesieniu do aktualnej dokumentacji poleceń Cfx.re.

# Optional startup-only setting; choose a value from the current Cfx.re reference
# sv_enforceGameBuild 

• [Oficjalna dokumentacja convars][1] wymienia prawidłowe numery kompilacji.
• Ustaw kompilację w server.cfg Lub w txAdmin → Ustawienia → FXServer → Dodatkowe argumenty:

+set sv_enforceGameBuild 2944

• Pobierz najnowszą wersję artefakty z [runtime.fivem.net][4] (Windows) lub strony budowania Linux.
• Nigdy nie mieszaj kompilacji klienta i serwera.

Konfiguracja OneSync

OneSync umożliwia synchronizacja encji po stronie serwera: więcej graczy, dokładniejsze stany, lepsze strumieniowanie. Zawsze używaj OneSync włączony dla nowoczesnych frameworków (QBCore, ESX).

Wskazówka: Skala sv_maxclients z sprzętem. Użyj Poradnik Resmon do mierzenia wpływu zasobów.

Kolejność uruchamiania zasobów i zależności

Zasoby ładują się w kolejności zdefiniowanej przez ensure. Zawsze najpierw uruchamiaj zależności.

# resources.cfg (split file)
ensure oxmysql
ensure qb-core
ensure qb-adminmenu
ensure qb-inventory
ensure qb-policejob
ensure my-custom-scripts

W server.cfg:

exec resources.cfg

• Zachowaj frameworki i konektory bazy danych na początku.
• Grupuj powiązane zasoby.
• Unikaj ensure * w produkcji; powoduje niedeterministyczną kolejność.

Zabezpieczenia i utwardzanie przed nadużyciami

Bezpieczny server.cfg zapobiega wyciekom i nadużyciom.

Lista kontrolna:

• sv_endpointPrivacy true
• sv_scriptHook 0 (blokuj modyfikacje klienta)
• Silny lub niepełnosprawny rcon_password
• Używać add_principal I add_ace dla ACL
• Trzymaj sekrety z dala od publicznych repozytoriów i plików zasobów klienta/współdzielonych; ogranicz dostęp do konfiguracji dostępnej tylko dla serwera, która je zawiera.
• Regularnie aktualizuj artefakty
• Monitor logi txAdmin
• Używać Poradnik Resmon aby wyłapać ciężkie skrypty

Przykład ACL:

add_ace group.admin command allow
add_principal identifier.steam:110000112345678 group.admin

CDN i strumieniowanie zasobów (kiedy używać)

Dla dużych MLOs, niestandardowych samochodów i tekstur, użyj CDN, aby zmniejszyć czasy dołączenia.

• Hostuj pliki na CDN, takim jak Cloudflare R2 (ustaw [nagłówki CORS][6]).
• Dla wysokiej wydajności, BunnyCDN obsługuje [żądania zakresu][7] (wymagane dla .rpf streaming).
• Dodaj wersjonowane adresy URL, aby uniknąć konfliktów pamięci podręcznej.

Zobacz nasze Optymalizuj czasy ładowania przewodnik.

Mity i przestarzałe flagi

Wiele konfiguracji online nadal pokazuje Source Engine cvars jak:

sv_maxrate 0
sv_minrate 30000
sv_maxupdaterate 60

Nie używać. Nie są one obsługiwane w FiveM i nie mają żadnego wpływu. Zobacz [oficjalne convars][1].

Przestarzałe/starsze zmienne konfiguracyjne:

• sv_master1 → niepotrzebne.
• sv_useDirectListing → zastąpione przez sv_endpointPrivacy.

Walidacja i rozwiązywanie problemów

Sprawdzenie kluczy po edycji server.cfg:

Pakiety serwerowe

Poznaj kompletne produkty serwerowe do uruchamiania i przebudowy.

Pakiety serwerowePodstawa serwera ESX (od RibSosay)$53.99

Pakiety serwerowePełny serwer QBus / QBCore v4.1$43.99

Pakiety serweroweSzablon serwera ESX Pro$136.99

Zasoby wewnętrzne i kolejne kroki

• Jak utworzyć serwer FiveM
• /fivem-serwery

Często zadawane pytania

1. Co to jest server.cfg w FiveM?
To główny plik konfiguracyjny, który definiuje nazwę serwera, sloty, zasoby, sieć, bezpieczeństwo i widoczność.

2. Gdzie powinienem umieścić server.cfg?
W głównym folderze serwera (obok server.exe Lub FXServer ). txAdmin ładuje go automatycznie.

3. Jaka jest różnica między set, sets, oraz setr?

• set: zmienna tylko dla serwera.
• sets: pojawia się na liście serwerów (informacje publiczne).
• setr: zsynchronizowane z klientami.

4. Mój serwer nie pojawia się na liście. Dlaczego?
Sprawdzać sv_hostname, sets tags, sets locale, oraz sv_endpointPrivacy. Upewnij się również, że porty są otwarte.

5. Jak zwiększyć liczbę slotów dla graczy?
Zmień sv_maxclients. Skaluj stopniowo i monitoruj za pomocą Poradnik Resmon. Upewnij się, że Twój sprzęt i sieć mogą sobie z tym poradzić.

6. Co to jest sv_enforceGameBuild?
Convar, który wymusza na klientach używanie określonej wersji gry GTA V. Zapobiega awariom spowodowanym niezgodnością wersji. Zobacz [Dokumentacja Convars][1].

7. Czy powinienem używać numerów kompilacji czy aliasów?
Obie opcje działają. Numeryczne (2944) jest jawne; alias (mp2024_02) jest łatwiejszy do śledzenia. Oba są obsługiwane.

8. Gdzie ustawiam sv_enforceGameBuild w txAdmin?
W txAdmin → Ustawienia → FXServer → Dodatkowe argumenty. Przykład: +set sv_enforceGameBuild 2944.

9. Czym jest OneSync?
System umożliwiający obsługę większej liczby graczy, dokładne strumieniowanie encji i kontrolę serwera. Wymagany dla nowoczesnych frameworków. Zobacz [OneSync dokumentację][3].

10. Infinity vs Legacy OneSync?
Legacy = do 64 slotów. Infinity = obsługuje 128+, zaawansowana synchronizacja encji. Zawsze używaj onesync on (domyślnie nieskończoność).

11. Jak zorganizować zasoby?
Używać exec resources.cfg. Najpierw uruchom konektory bazy danych, następnie frameworki, potem prace/skrypty. Unikaj ensure *.

12. Moje banery nie wyświetlają się na liście serwerów.
Upewnij się, że adresy URL są w protokole HTTPS, publiczne i wskazują na prawidłowe rozmiary obrazów. Użyj sieci CDN dla niezawodności.

13. Do czego służą logi txAdmin?
Pokazują błędy, awarie, problemy z zasobami. Zobacz logi txAdmin.

14. Jak sprawdzić problemy z wydajnością?
Używać resmon 1 w konsoli. Zobacz nasze Poradnik Resmon szczegóły.

15. Czy flagi szybkości silnika Source są potrzebne?
Nie. sv_maxrate, sv_minrate, sv_maxupdaterate nic nie rób w FiveM. Zamiast tego użyj [dokumentacji Convars][1].

Podziękowania:

• [Convars – Cfx.re Dokumentacja][1]
• [Polecenia serwera – Cfx.re Dokumentacja][2]
• [Dokumentacja OneSync – Cfx.re][3]
• [Artefakty (kompilacje Windows) – runtime.fivem.net

Dla pól specyficznych dla listy i aktualnego sv_master1 zachowania, kontynuuj z FiveM przewodnik konfiguracji listy serwerów.

Aktualne oficjalne referencje server.cfg

• Cfx.re przykład konfiguracji FXServer vanilla
• Cfx.re komendy serwerowe i convars
• Konfiguracja Cfx.re txAdmin