FiveM: configurar um proxy reverso

Descubra como melhorar a segurança e a confiabilidade do seu servidor de jogos FiveM com um proxy reverso — para ter mais proteção contra DDoS e melhor desempenho → Saiba mais

10 de novembro de 20266 min de leitura0 visualizações0 útil

Introdução

Um servidor proxy reverso atua como intermediário entre os usuários finais (seus jogadores) e o servidor de jogos FiveM. Isso é especialmente útil para servidores que sofrem ataques DDoS frequentes, pois oferece uma camada adicional de segurança e mais confiabilidade ao reduzir a visibilidade do host principal e fornecer medidas extras de proteção.

Neste guia, mostraremos como configurar um proxy reverso para seu servidor de jogos FiveM. Há dois tipos de proxy reverso nesse cenário: o Connect Proxy, usado para o endpoint de conexão, e o Server Proxy, usado para o endpoint do servidor, onde ocorre o proxy TCP/UDP puro. Ambos podem ser configurados de forma independente.

Preparação

Para configurar um proxy reverso, você precisará de um servidor Linux (por exemplo, um VPS) para hospedar seu servidor proxy. Neste exemplo, usaremos o Ubuntu como distribuição Linux, mas as etapas de instalação são muito semelhantes na maioria das distribuições Linux.

Dica

Especificações recomendadas para o VPS Recomendamos que você escolha velocidades de rede mais altas se quiser configurar um Server Proxy, especialmente se o servidor tiver muitos jogadores. Isso porque seu VPS transmitirá TCP/UDP bruto diretamente entre o cliente (jogador) e o servidor de jogos FiveM. Caso contrário, um servidor com especificações básicas e atualizações mínimas será suficiente. :)

Também recomendamos configurar o proxy com um domínio que pertença a você. Para isso, crie um registro A para o domínio que deseja usar (por exemplo, zapdocs.example.com) e aponte-o para o endereço IP do seu VPS Linux. Esse será o endereço usado pelos jogadores para se conectar — tecnicamente, você também pode usar diretamente o endereço IP do servidor proxy, se preferir.

Acessar o VPS

Quando seu VPS Linux estiver pronto, você precisará se conectar a ele. Use nosso guia Primeiros passos com SSH para saber como fazer isso.

Instalar o Nginx

Você usará o Nginx para hospedar o proxy reverso, pois ele é um servidor web de código aberto popular e de alto desempenho.

Depois de acessar seu VPS, instale o Nginx com o seguinte comando:

Code

sudo apt install nginx

Após a instalação, ajuste o firewall para que o serviço possa ser acessado pela Internet. Neste guia, usaremos o firewall UFW, pois o Nginx é registrado como um aplicativo e, assim, é fácil ajustar as configurações. Confira mais informações sobre o firewall UFW em nosso guia Dicas de segurança para Linux.

Informações

Se você usar outros firewalls (por exemplo, Iptables), permita o acesso necessário ao Nginx, especialmente nas portas 80 e 443, usadas pelo Nginx.

Você pode exibir os perfis do Nginx com sudo ufw app list. Neste caso, selecione a opção Nginx Full, que permite acesso HTTP para testes e HTTPS para uso em produção.

Code

sudo ufw allow 'Nginx Full'

Agora que o Nginx está em execução, tente acessar o site pelo navegador para confirmar que tudo está funcionando. Se a página de teste for exibida, você poderá continuar com o guia.

Code

http://[deine_serverip]

Connect Proxy

O Connect Proxy é usado para fazer proxy do endpoint de conexão do seu servidor de jogos FiveM. Isso significa que seu servidor proxy recebe as solicitações de conexão e as encaminha para o servidor FiveM principal. A grande vantagem é que o endereço IP real do host FiveM fica oculto na lista de servidores e, portanto, menos visível.

Configuração do Nginx

Primeiro, crie uma entrada no diretório do Nginx para o host escolhido ao configurar o domínio. Neste exemplo, usaremos novamente zapdocs.example.com.

Crie o bloco de servidor para seu domínio com o comando a seguir, substituindo [your_domain] pelo seu próprio domínio:

Code

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

Agora, copie o modelo a seguir para o editor e ajuste os valores de acordo com sua configuração.

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

Depois de ajustar todos os valores, salve o arquivo e feche o nano com CTRL + X, confirme com Y e pressione ENTER.

Agora, ative o bloco de servidor criando um link simbólico para o diretório ativo:

Code

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

Para verificar se não há erros de sintaxe, execute sudo nginx -t. Se tudo estiver certo, reinicie o Nginx para aplicar as alterações:

Code

systemctl reload nginx.service

Agora, teste se consegue acessar seu domínio pelo navegador. Se tudo funcionar, a página deverá carregar o conteúdo especificado no parâmetro targetServer. Se tiver problemas, recomendamos verificar os logs com journalctl -f -u nginx.service para encontrar erros.

Configuração do FiveM

Depois de configurar o proxy, você precisará ajustar alguns valores no arquivo server.cfg do seu servidor de jogos FiveM.

Adicione as linhas a seguir e substitua os valores conforme necessário:

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"

Salve o arquivo e reinicie o servidor. Na próxima inicialização, seu domínio deverá apontar para o servidor de jogos FiveM e poderá ser usado para se conectar.

Você pode testar se tudo está funcionando tentando acessar https://[your_domain]/info.json. Se o arquivo carregar, seu Connect Proxy está funcionando.

Server Proxy

O Server Proxy é usado para fazer proxy do endpoint do servidor de jogos FiveM, ou seja, para o proxy e a transmissão de TCP/UDP puro.

Configuração do Nginx

Para isso, você usará o módulo stream do Nginx. Abra o arquivo nginx.conf com o nano:

Code

sudo nano /etc/nginx/nginx.conf

Agora, adicione o bloco a seguir no escopo raiz e ajuste os valores:

Code

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

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

Salve o arquivo e feche o nano com CTRL + X, confirme com Y e pressione ENTER.

Verifique a sintaxe com sudo nginx -t. Se tudo estiver certo, recarregue o Nginx para ativar a configuração:

Code

systemctl reload nginx.service

Agora, tente se conectar ao servidor de jogos usando o domínio do proxy. Se tudo funcionar, você deverá conseguir se conectar ao servidor especificado em targetServer. Se tiver problemas, verifique os logs com journalctl -f -u nginx.service.

Configuração do FiveM

Depois que o proxy estiver em execução, você precisará ajustar uma configuração no arquivo server.cfg.

Dica

Se você já definiu o parâmetro set sv_endpoints ao configurar o Connect Proxy, pode pular esta etapa.

Adicione a linha a seguir e substitua o valor:

Code

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

Salve o arquivo e reinicie o servidor. Na próxima inicialização, os endpoints TCP/UDP brutos serão transmitidos pelo proxy reverso.

Você pode verificar isso analisando os endereços IP dos jogadores — todos deverão mostrar o endereço IP do seu servidor proxy com portas atribuídas aleatoriamente.

Certificado SSL

Depois que o proxy reverso do FiveM estiver em execução, recomendamos fortemente instalar um certificado SSL para seus domínios, para que os dados sejam transmitidos com segurança via HTTPS.

Consulte nosso guia de Instalação do Certbot, que explica todo o processo para solicitar e renovar automaticamente certificados SSL para seu(s) domínio(s).

Conclusão

Parabéns! Você configurou com sucesso um proxy reverso para seu servidor de jogos FiveM e agora conta com mais segurança, confiabilidade e melhor desempenho. Nossa equipe de suporte está disponível todos os dias para ajudar com dúvidas ou problemas — entre em contato conosco! 🙂

FAQ

Perguntas frequentes

O Connect Proxy, para o endpoint de conexão, e o Server Proxy, para o endpoint do servidor e o proxy TCP/UDP puro. Ambos podem ser configurados de forma independente.

Para servidores que sofrem ataques DDoS frequentes: ele reduz a visibilidade do host principal e oferece medidas extras de proteção.

Velocidades de rede mais altas, especialmente para servidores com muitos jogadores, pois o TCP/UDP bruto é transmitido diretamente entre o cliente e o servidor de jogos. Para casos menos exigentes, especificações básicas são suficientes.

Feedback

Este artigo foi útil?

Sua opinião nos ajuda a definir prioridades e a melhorar os conteúdos.

0 de 0 As avaliações consideraram este artigo útil.

Ajuda personalizada

As instruções não são suficientes?

A nossa equipe de suporte da ZAP conhece seu produto — descreva brevemente seu problema e ajudaremos pessoalmente.

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"

Quais 🍪 cookies você aceita?

FiveM: configurar um proxy reverso

Introdução

Preparação

Acessar o VPS

Instalar o Nginx

Connect Proxy

Configuração do Nginx

Configuração do FiveM

Server Proxy

Configuração do Nginx

Configuração do FiveM

Certificado SSL

Conclusão

Perguntas frequentes

FiveM

Preparação

Acessar o VPS

Instalar o Nginx

Connect Proxy

Configuração do Nginx

Configuração do FiveM

Server Proxy

Configuração do Nginx

Configuração do FiveM

Certificado SSL

Conclusão

Servidor de jogos

Servidores e hospedagem

ZAPX

Recursos

ZAP-Hosting