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ě.
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ý.
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.
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.
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:
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.
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.
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.
http://[deine_serverip]
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á.
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:
sudo nano /etc/nginx/sites-available/[your-domain]
Zkopíruj do editoru následující šablonu a uprav hodnoty podle své konfigurace.
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:
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:
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.
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:
# 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 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.
Použiješ k tomu modul stream v Nginx. Otevři soubor nginx.conf pomocí nano:
sudo nano /etc/nginx/nginx.conf
Vlož do kořenového kontextu následující blok a uprav hodnoty:
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:
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.
Po spuštění proxy musíš upravit jedno nastavení v souboru server.cfg.
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:
# 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.
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í.