FiveM: configurare un proxy inverso

Scopri come migliorare la sicurezza e l'affidabilità del tuo server di gioco FiveM con un proxy inverso: maggiore protezione DDoS e prestazioni migliori → Scopri di più

10 novembre 20266 min di lettura0 Visualizzazioni0 utile

Introduzione

Un server proxy inverso funge da intermediario tra gli utenti finali (i tuoi giocatori) e il tuo server di gioco FiveM. È particolarmente utile per i server che subiscono spesso attacchi DDoS, perché offre un ulteriore livello di sicurezza e maggiore affidabilità riducendo la visibilità dell'host principale e fornendo misure di protezione aggiuntive.

In questa guida ti mostriamo come configurare un proxy inverso per il tuo server di gioco FiveM. In questo scenario esistono due tipi di proxy inverso: il Connect Proxy, utilizzato per l'endpoint di connessione, e il Server Proxy, utilizzato per l'endpoint del server, dove avviene il puro proxying TCP/UDP. È possibile configurarli entrambi in modo indipendente.

Preparazione

Per configurare un proxy inverso, ti serve un server Linux (ad esempio un VPS) che ospiti il server proxy. In questo esempio utilizziamo Ubuntu come distribuzione Linux, ma i passaggi di installazione sono molto simili nella maggior parte delle distribuzioni Linux.

Suggerimento

Specifiche VPS consigliate Ti consigliamo vivamente di scegliere velocità di rete più elevate se vuoi configurare un Server Proxy, soprattutto se il tuo server ha molti giocatori. Il tuo VPS trasmetterà infatti il traffico TCP/UDP grezzo direttamente tra il client (il giocatore) e il server di gioco FiveM. Negli altri casi, è sufficiente un server con specifiche di base e aggiornamenti minimi. :)

Ti consigliamo inoltre di configurare il proxy con un dominio di tua proprietà. Crea un record A per il dominio che vuoi utilizzare (ad es. zapdocs.example.com) e indirizzalo all'indirizzo IP del tuo VPS Linux. Questo è l'indirizzo che i giocatori utilizzeranno per connettersi, ma, tecnicamente, puoi anche usare direttamente l'indirizzo IP del tuo server proxy.

Accesso al VPS

Quando il tuo VPS Linux è pronto, dovrai connetterti. Per scoprire come fare, consulta la nostra guida Primi passi con SSH.

Installare Nginx

Utilizzerai Nginx per ospitare il proxy inverso, perché è un server web open source molto efficiente e diffuso.

Dopo aver effettuato l'accesso al tuo VPS, installa Nginx con il seguente comando:

Code

sudo apt install nginx

Dopo l'installazione, devi configurare il firewall affinché il servizio sia raggiungibile da Internet. In questa guida utilizziamo il firewall UFW, poiché Nginx si registra come app e le impostazioni sono quindi facili da modificare. Per maggiori informazioni sul firewall UFW, consulta la nostra guida Consigli per la sicurezza Linux.

Info

Se utilizzi altri firewall (ad es. Iptables), assicurati di consentire a Nginx l'accesso necessario, in particolare sulle porte 80 e 443, utilizzate da Nginx.

Puoi visualizzare i profili Nginx con sudo ufw app list. In questo caso, seleziona Nginx Full, che consente l'accesso HTTP per i test e HTTPS per l'ambiente di produzione.

Code

sudo ufw allow 'Nginx Full'

Ora che Nginx è in esecuzione, prova ad aprire il sito nel browser per verificare che tutto funzioni. Se viene visualizzata la pagina di test, puoi proseguire con la guida.

Code

http://[deine_serverip]

Connect Proxy

Un Connect Proxy viene utilizzato per inoltrare le richieste all'endpoint di connessione del tuo server di gioco FiveM. Ciò significa che il server proxy riceve le richieste di connessione e le inoltra al server FiveM principale. Il vantaggio principale è che l'indirizzo IP effettivo del tuo host FiveM rimane nascosto nell'elenco dei server e quindi è meno visibile.

Configurazione di Nginx

Per prima cosa, crea una voce nella directory di Nginx per l'host scelto durante la configurazione del dominio. Anche in questo esempio utilizziamo zapdocs.example.com.

Crea il blocco server per il tuo dominio con il seguente comando, sostituendo [your_domain] con il tuo dominio:

Code

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

Copia il modello seguente nell'editor e modifica i valori in base alla tua configurazione.

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;
    }
}

Dopo aver modificato tutti i valori, salva il file ed esci da nano con CTRL + X, conferma con Y e premi ENTER.

Ora attiva il blocco server creando un link simbolico nella directory attiva:

Code

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

Per verificare che non ci siano errori di sintassi, puoi eseguire sudo nginx -t. Se l'operazione riesce, riavvia Nginx per applicare le modifiche:

Code

systemctl reload nginx.service

Ora verifica di riuscire a raggiungere il tuo dominio nel browser. Se tutto funziona, la pagina dovrebbe caricare il contenuto indicato come parametro targetServer. In caso di problemi, ti consigliamo di controllare i log con journalctl -f -u nginx.service per individuare eventuali errori.

Configurazione di FiveM

Dopo aver configurato il proxy, devi modificare alcuni valori nel file server.cfg del tuo server di gioco FiveM.

Aggiungi le righe seguenti e sostituisci i valori di conseguenza:

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"

Salva il file e riavvia il server. Al prossimo avvio, il tuo dominio dovrebbe risolvere all'indirizzo del server di gioco FiveM e potrà essere utilizzato per connettersi.

Puoi verificare che tutto funzioni provando ad aprire https://[your_domain]/info.json. Se il file viene caricato, il Connect Proxy funziona.

Server Proxy

Un Server Proxy viene utilizzato per inoltrare il traffico all'endpoint del server di gioco FiveM, ossia per il puro proxying e lo streaming TCP/UDP.

Configurazione di Nginx

A questo scopo utilizzerai il modulo stream di Nginx. Apri nginx.conf con nano:

Code

sudo nano /etc/nginx/nginx.conf

Aggiungi il blocco seguente nell'ambito principale e modifica i valori:

Code

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

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

Salva il file ed esci da nano con CTRL + X, conferma con Y e premi ENTER.

Verifica la sintassi con sudo nginx -t. Se è tutto a posto, ricarica Nginx per attivare la configurazione:

Code

systemctl reload nginx.service

Ora prova a connetterti al server di gioco tramite il dominio proxy. Se tutto funziona, dovresti riuscire a connetterti al server indicato come targetServer. In caso di problemi, controlla i log con journalctl -f -u nginx.service.

Configurazione di FiveM

Dopo aver avviato il proxy, devi modificare un'impostazione nel file server.cfg.

Suggerimento

Se hai già impostato il parametro set sv_endpoints durante la configurazione del Connect Proxy, puoi saltare questo passaggio.

Aggiungi la riga seguente e sostituisci il valore:

Code

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

Salva il file e riavvia il server. Al prossimo avvio, gli endpoint TCP/UDP grezzi verranno trasmessi tramite il proxy inverso.

Puoi verificarlo analizzando gli indirizzi IP dei giocatori: dovrebbero mostrare tutti l'indirizzo IP del tuo server proxy con porte assegnate casualmente.

Certificato SSL

Dopo aver avviato il proxy inverso FiveM, ti consigliamo vivamente di installare un certificato SSL per i tuoi domini, così da trasmettere i dati in modo sicuro tramite HTTPS.

Consulta la nostra guida Installazione di Certbot, che illustra l'intera procedura per richiedere e rinnovare automaticamente i certificati SSL per il tuo dominio o i tuoi domini.

Conclusione

Congratulazioni, hai configurato correttamente un proxy inverso per il tuo server di gioco FiveM. Ora puoi usufruire di maggiore sicurezza, affidabilità e prestazioni migliori. Se hai domande o riscontri problemi, il nostro team di supporto è a tua disposizione ogni giorno: non esitare a contattarci! 🙂

FAQ

Domande frequenti

Il Connect Proxy, per l'endpoint di connessione, e il Server Proxy, per l'endpoint del server e il puro proxying TCP/UDP. Puoi configurarli in modo indipendente.

È particolarmente utile per i server che subiscono spesso attacchi DDoS: riduce la visibilità dell'host principale e offre ulteriori misure di protezione.

Sono consigliate velocità di rete più elevate, soprattutto con molti giocatori, poiché il traffico TCP/UDP grezzo viene trasmesso direttamente tra client e server di gioco. Per esigenze meno elevate, sono sufficienti specifiche di base.

Feedback

Questo articolo ti è stato utile?

Il tuo feedback ci aiuta a definire le priorità e a migliorare i contenuti.

0 di 0 I feedback hanno giudicato utile questo articolo.

Assistenza personale

Le istruzioni non sono sufficienti?

Il supporto ZAP conosce il tuo prodotto: descrivi brevemente la tua richiesta e ti aiuteremo personalmente.

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; } }

# 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"

Quali 🍪 cookie desideri consentire?

FiveM: configurare un proxy inverso

Introduzione

Preparazione

Accesso al VPS

Installare Nginx

Connect Proxy

Configurazione di Nginx

Configurazione di FiveM

Server Proxy

Configurazione di Nginx

Configurazione di FiveM

Certificato SSL

Conclusione

Domande frequenti

FiveM

Preparazione

Accesso al VPS

Installare Nginx

Connect Proxy

Configurazione di Nginx

Configurazione di FiveM

Server Proxy

Configurazione di Nginx

Configurazione di FiveM

Certificato SSL

Conclusione

Server di gioco

Server e hosting

ZAPX

Risorse

ZAP-Hosting