Přejít na obsah

FiveM: Nastavení reverzní proxy

Zjisti, jak zvýšit zabezpečení a spolehlivost svého herního serveru FiveM pomocí reverzní proxy – získáš lepší ochranu před DDoS útoky i vyšší výkon → Zjisti víc

17. listopadu 20265 Min. doba čtení25 Zobrazení0 užitečné

Úvod

Reverzní proxy server je server, který funguje jako prostředník mezi koncovými uživateli (tvými hráči) a tvým herním serverem FiveM. Hodí se zejména pro servery, které často čelí DDoS útokům, protože nabízí další vrstvu zabezpečení a vyšší spolehlivost: omezuje viditelnost hlavního hostitele a poskytuje dodatečná ochranná opatření.

V tomto návodu ti ukážeme, jak nastavit reverzní proxy pro tvůj herní server FiveM. V tomto scénáři existují dva typy reverzních proxy: Connect proxy, která se používá pro koncový bod připojení, a Server proxy, která se používá pro koncový bod serveru, kde probíhá pouze proxyování TCP/UDP. Obě můžeš nastavit nezávisle na sobě.

Příprava

K nastavení reverzní proxy potřebuješ Linux server (například VPS server), na kterém bude proxy server hostovaný. V tomto příkladu používáme distribuci Ubuntu, ale postup instalace je u většiny distribucí Linuxu velmi podobný.

Tip

Doporučené specifikace VPS serveru Pokud chceš nastavit Server proxy, důrazně doporučujeme zvolit vyšší rychlost sítě, zejména pokud má tvůj server mnoho hráčů. Tvůj VPS server totiž bude přenášet nezpracovaný provoz TCP/UDP přímo mezi klientem (hráčem) a herním serverem FiveM. V ostatních případech zcela postačí server se základními specifikacemi a minimálními upgrady. :)

Doporučujeme také nastavit proxy pomocí domény, kterou vlastníš. Vytvoř pro doménu, kterou chceš použít (například zapdocs.example.com), záznam A a nasměruj ho na IP adresu svého Linux VPS. Tuto adresu budou hráči používat k připojení – technicky můžeš použít také přímo IP adresu svého proxy serveru.

Přístup k VPS serveru

Jakmile bude tvůj Linux VPS server připravený, musíš se k němu připojit. Jak na to, se dozvíš v našem návodu Začínáme s SSH.

Instalace Nginx

K hostování reverzní proxy použiješ Nginx, protože jde o velmi výkonný a oblíbený webový server s otevřeným zdrojovým kódem.

Po přihlášení k VPS serveru nainstaluj Nginx následujícím příkazem:

Code
sudo apt install nginx

Po instalaci musíš upravit firewall, aby byla služba dostupná z internetu. V tomto návodu používáme firewall UFW, protože se Nginx zaregistruje jako aplikace a jeho nastavení tak lze snadno upravit. Další informace o firewallu UFW najdeš v našem návodu Tipy pro zabezpečení Linuxu.

Informace

Pokud používáš jiný firewall (například Iptables), nezapomeň Nginxu povolit potřebný přístup, zejména na portech 80 a 443, na kterých Nginx běží.

Seznam profilů Nginx zobrazíš příkazem sudo ufw app list. V tomto případě vyber možnost Nginx Full, která umožňuje přístup přes HTTP pro testování a přes HTTPS pro produkční provoz.

Code
sudo ufw allow 'Nginx Full'

Teď, když Nginx běží, zkus stránku otevřít v prohlížeči a ověř, že vše funguje. Pokud se zobrazí testovací stránka, můžeš pokračovat podle návodu.

Code
http://[deine_serverip]

Connect proxy

Connect proxy slouží k proxyování koncového bodu připojení tvého herního serveru FiveM. Proxy server tak přijímá požadavky na připojení a předává je tvému hlavnímu hernímu serveru FiveM. Velkou výhodou je, že se skutečná IP adresa tvého hostitele FiveM skryje v seznamu serverů, a je tak méně viditelná.

Nastavení Nginx

Nejprve v adresáři Nginx vytvoř záznam pro hostitele, kterého jsi zvolil při nastavení domény. V tomto příkladu znovu použijeme zapdocs.example.com.

Pomocí následujícího příkazu vytvoř blok serveru pro svou doménu a nahraď [your_domain] svou vlastní doménou:

Code
sudo nano /etc/nginx/sites-available/[your-domain]

Zkopíruj do editoru následující šablonu a uprav hodnoty podle své konfigurace.

Code
upstream backend {
    # FiveM Server IP-Adresse
    server [your_fivem_serverip]:30120;
}

proxy_cache_path /srv/cache levels=1:2 keys_zone=assets:48m max_size=20g inactive=2h;

server {
    listen 80;
    listen [::]:80;

    server_name [your_domain]; # Zum Beispiel: zapdocs.example.com

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $remote_addr;
        # Erforderlich, um Auth-Header korrekt weiterzuleiten
        proxy_pass_request_headers on;
        # Verhindert, dass Verbindungen sofort geschlossen werden
        proxy_http_version 1.1;
        proxy_pass http://backend;
    }

    # Zusätzlicher Block für einen Caching Proxy
    location /files/ {
        proxy_pass http://backend$request_uri;
        add_header X-Cache-Status $upstream_cache_status;
        proxy_cache_lock on;
        proxy_cache assets;
        proxy_cache_valid 1y;
        proxy_cache_key $request_uri$is_args$args;
        proxy_cache_revalidate on;
        proxy_cache_min_uses 1;
    }
}

Po úpravě všech hodnot soubor ulož a ukonči nano pomocí CTRL + X, potvrď stisknutím Y a stiskni ENTER.

Teď aktivuj blok serveru vytvořením symbolického odkazu do aktivního adresáře:

Code
sudo ln -s /etc/nginx/sites-available/[your_filename] /etc/nginx/sites-enabled/[your_filename]

Ověř, že v konfiguraci nejsou syntaktické chyby, spuštěním příkazu sudo nginx -t. Pokud vše proběhne úspěšně, restartuj Nginx, aby se změny projevily:

Code
systemctl reload nginx.service

Teď vyzkoušej, jestli se ke své doméně dostaneš v prohlížeči. Pokud vše funguje, stránka by měla načíst obsah určený parametrem targetServer. Pokud narazíš na problémy, doporučujeme zkontrolovat logy příkazem journalctl -f -u nginx.service a vyhledat chyby.

Konfigurace FiveM

Po nastavení proxy musíš upravit několik hodnot v souboru server.cfg svého herního serveru FiveM.

Vlož následující řádky a nahraď příslušné hodnoty:

Code
# Verhindert, dass die Serverliste deinen Server mit der echten IP bewirbt
set sv_forceIndirectListing true

# Lässt die Serverliste deine Domain anfragen statt der Standard-IP (z.B. zapdocs.example.com)
set sv_listingHostOverride "[your_domain]"

# Liste von IPv4-Netzen in CIDR-Notation, die 'X-Real-IP' erlauben und den Rate Limiter umgehen
set sv_proxyIPRanges "[your_proxy_serverip]/32"

# Der eigentliche Endpunkt, auf dem dein Server läuft, oder ein oder mehrere Server Proxy Endpunkte
set sv_endpoints "[your_fivem_serverip]:30120"

Soubor ulož a restartuj server. Po dalším spuštění by se tvoje doména měla přeložit na tvůj herní server FiveM a mělo by být možné ji použít k připojení.

Funkčnost můžeš ověřit tak, že otevřeš adresu https://[your_domain]/info.json. Pokud se soubor načte, Connect proxy funguje.

Server proxy

Server proxy slouží k proxyování koncového bodu serveru tvého herního serveru FiveM, tedy k samotnému proxyování a přenosu provozu TCP/UDP.

Nastavení Nginx

Použiješ k tomu modul stream v Nginx. Otevři soubor nginx.conf pomocí nano:

Code
sudo nano /etc/nginx/nginx.conf

Vlož do kořenového kontextu následující blok a uprav hodnoty:

Code
stream {
    upstream backend {
        server [your_fivem_serverip]:30120;
    }
    
    server {
		listen 30120;
		proxy_pass backend;
	}

	server {
		listen 30120 udp reuseport;
		proxy_pass backend;
	}
}

Soubor ulož a ukonči nano pomocí CTRL + X, potvrď stisknutím Y a stiskni ENTER.

Zkontroluj syntaxi příkazem sudo nginx -t. Pokud je vše v pořádku, znovu načti Nginx, aby se konfigurace aktivovala:

Code
systemctl reload nginx.service

Teď se zkus připojit ke svému hernímu serveru přes doménu proxy. Pokud vše funguje, měl by ses připojit k serveru, který jsi nastavil jako targetServer. Pokud narazíš na problémy, zkontroluj logy příkazem journalctl -f -u nginx.service.

Konfigurace FiveM

Po spuštění proxy musíš upravit jedno nastavení v souboru server.cfg.

Tip

Pokud už jsi při nastavování Connect proxy nastavil parametr set sv_endpoints, můžeš tento krok přeskočit.

Vlož následující řádek a nahraď hodnotu:

Code
# Der eigentliche Endpunkt, auf dem dein Server läuft, oder ein oder mehrere Server Proxy Endpunkte
set sv_endpoints "[your_fivem_serverip]:30120"

Soubor ulož a restartuj server. Po dalším spuštění se nezpracované koncové body TCP/UDP budou přenášet přes reverzní proxy.

Ověřit to můžeš analýzou IP adres hráčů – měly by se u všech zobrazovat IP adresa tvého proxy serveru s náhodně přiřazenými porty.

Certifikát SSL

Po spuštění reverzní proxy FiveM důrazně doporučujeme nainstalovat pro své domény certifikát SSL, aby se data bezpečně přenášela přes HTTPS.

Podívej se na náš návod Instalace Certbotu, který vysvětluje celý postup žádosti o certifikáty SSL pro tvé domény a jejich automatického obnovování.

Závěr

Gratulujeme, úspěšně jsi nastavil reverzní proxy pro svůj herní server FiveM a můžeš teď využívat vyšší zabezpečení, spolehlivost i lepší výkon. Pokud máš otázky nebo narazíš na problémy, náš tým podpory je ti každý den k dispozici – neváhej nás kontaktovat! 🙂

FAQ

Často kladené dotazy

Connect proxy (pro koncový bod připojení) a Server proxy (pro koncový bod serveru, kde probíhá pouze proxyování TCP/UDP). Obě lze nastavit nezávisle.
Hodí se serverům, které často čelí DDoS útokům. Omezuje viditelnost hlavního hostitele a poskytuje dodatečnou ochranu.
Doporučují se vyšší rychlosti sítě, zejména při větším počtu hráčů, protože se nezpracovaný provoz TCP/UDP přenáší přímo mezi klientem a herním serverem. Pro méně náročné případy postačí základní specifikace.

Zpětná vazba

Pomohl ti tento článek?

Tvoje zpětná vazba nám pomáhá lépe určovat priority a upravovat obsah.

0 od 0 Uživatelé označili tento článek za užitečný.

Osobní pomoc

Návod nestačí?

Naše podpora ZAP zná tvůj produkt — stručně popiš, co potřebuješ, a osobně ti pomůžeme.

Zappy zná tento návod a odpoví ti přímo v chatu.