Base de Conhecimento

Flask na VPS: como publicar seu projeto com Nginx

  • flask, vps, gunicorn, nginx, python, systemd
  • Usuários acharam útil: 0

Publique um projeto Flask numa VPS: ambiente virtual, Gunicorn, serviço no systemd, Nginx na frente, ProxyFix, HTTPS com Certbot e cookies seguros.

Por Redação Eleven Host · @robson.direitodigital · 6 de novembro de 2026 · 10 min de leitura

Arte da Eleven Host: janela de terminal com o título: Flask na VPS: como publicar seu projeto com Nginx

Capa da Redação Eleven Host para o guia: Flask na VPS: como publicar seu projeto com Nginx Arte: Eleven Host

Flask na VPS é o caminho para publicar o seu projeto num servidor próprio: você roda a aplicação com o Gunicorn dentro de um ambiente virtual, coloca o Nginx na frente, ativa o HTTPS com o Certbot e deixa o serviço sob o systemd.

Atualizado em 06/11/2026. Na data deste guia, a versão mais recente do Flask é a 3.1.3, de fevereiro de 2026, e a do Gunicorn é a 26.2.0, de 24/08/2026. Trate as versões como um retrato do dia. O Flask 3.1.3 traz uma correção de segurança na sessão, então vale instalar a versão atual.

Antes de começar: o servidor é seu

Numa VPS, a administração do servidor é responsabilidade sua. Se ainda não sabe como ele funciona, comece pelo guia de servidor VPS, que explica o que é e como escolher o plano. Os comandos deste guia são para Linux, com exemplos da família Debian e Ubuntu, e você deve conferir cada um no seu servidor.

Quanto ao Python, o Flask aceita a versão 3.9 ou mais nova, mas o Gunicorn atual pede a 3.10. Como os dois trabalham juntos, o piso real é o Python 3.10.

O servidor de desenvolvimento do Flask serve só para desenvolver na sua própria máquina. A documentação do Flask diz que ele não foi feito para ser seguro, estável nem eficiente.

Por que não usar o servidor de desenvolvimento

Para a documentação do Flask, produção significa apenas tudo o que não é desenvolvimento, e isso vale tanto para milhões de usuários quanto para uma pessoa só. Por isso ela manda usar um servidor WSGI dedicado ou uma plataforma de hospedagem. O depurador embutido merece um aviso à parte: ele permite executar código Python arbitrário pelo navegador, e o PIN que o protege não deve ser a sua defesa.

A documentação lista vários servidores WSGI, como Gunicorn, Waitress, mod_wsgi e uWSGI, e diz que a lista não esgota as opções. O Gunicorn é um dos servidores da lista da doc; aqui usamos ele. Ele não roda no Windows, a não ser pelo WSL, e não deve ser executado como root, porque o código da sua aplicação rodaria como root.

Passo 1: ambiente virtual e dependências

Use um ambiente virtual para cuidar das dependências do projeto, tanto no desenvolvimento quanto em produção. Um exemplo de comandos, com o usuário comum do servidor, dentro da pasta do projeto:

sudo apt install python3-venv

python3 --version

python3 -m venv .venv

. .venv/bin/activate

pip install -r requirements.txt

pip install gunicorn

O pip install -r requirements.txt vale para um projeto simples com esse arquivo. Se o seu projeto é empacotado, a documentação do Flask usa pip install .. Um ambiente virtual não se copia de um lugar para outro: para mudar de servidor, crie de novo. E dá para chamar os programas dele pelo caminho completo, sem ativar, o que será útil no serviço do systemd.

Um servidor virtual entra nos planos do projeto? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Passo 2: teste o Gunicorn

A sintaxe é modulo:variavel, que equivale a importar a variável do módulo. Um exemplo de comando, para conferir no seu servidor, com o módulo hello e a variável app:

gunicorn -w 3 -b 127.0.0.1:8000 hello:app

Passe o -b 127.0.0.1:8000 de forma explícita. O padrão do Gunicorn é o endereço 127.0.0.1, mas, se existir a variável de ambiente PORT, ele passa a ouvir em 0.0.0.0. Com esse endereço, o Gunicorn atenderia a internet e seria possível contornar o Nginx, algo que a documentação do Flask manda evitar quando há proxy reverso. Com 127.0.0.1, só o Nginx, na mesma máquina, consegue falar com ele.

Sobre o número de workers, as docs divergem: a do Flask fala em começar com o dobro do número de núcleos de CPU, a página de design do Gunicorn sugere (2 x núcleos) + 1 e a de configurações cita de 2 a 4 vezes o número de núcleos. Pela fórmula do design, 1 núcleo dá 3 workers e 2 núcleos dão 5. Usamos 3 como ponto de partida, a ajustar sob carga: workers demais gastam recursos e podem reduzir o desempenho.

Com o worker padrão (sync), o proxy precisa segurar clientes lentos; sem isso, o Gunicorn fica vulnerável a ataques de negação de serviço. Para conexões longas, como streaming e WebSocket, desligue o buffer do proxy e use um worker assíncrono, como o gevent.

Passo 3: SECRET_KEY e modo debug

A chave secreta precisa ser longa e aleatória, e não deve aparecer em perguntas públicas nem em commits. Com o ambiente virtual ativo, a documentação do Flask gera uma assim:

python -c 'import secrets; print(secrets.token_hex())'

Não use a chave pública de exemplo de tutoriais: com ela, um atacante consegue alterar o cookie de sessão. Para ler a chave de uma variável de ambiente, coloque no seu código esta linha, sem recuo:

app.config.from_prefixed_env()

Essa função lê tudo o que começa com FLASK_, e FLASK_SECRET_KEY vira app.config["SECRET_KEY"]. Um exemplo: guardar o valor num arquivo como /etc/meuapp.env, com chmod 600, e fora do repositório.

O modo debug também fica desligado em produção, e ele já vem desligado por padrão. Procure no código por app.run(debug=True) e remova. Se usar a variável FLASK_DEBUG, confira que ela não está ativa.

Passo 4: o serviço no systemd

Um exemplo de serviço, adaptado do modelo da documentação do Gunicorn para um ambiente virtual e para o endereço 127.0.0.1. Troque o usuário, o grupo e os caminhos pelos seus e confira tudo no seu servidor. Um usuário próprio, sem privilégios, evita rodar a aplicação como root:

sudo adduser --system --group meuapp

Arquivo /etc/systemd/system/meuapp.service:

[Unit]

Description=meuapp (gunicorn)

After=network.target

[Service]

Type=notify

NotifyAccess=main

User=meuapp

Group=meuapp

WorkingDirectory=/srv/meuapp

EnvironmentFile=/etc/meuapp.env

ExecStart=/srv/meuapp/.venv/bin/gunicorn -w 3 -b 127.0.0.1:8000 hello:app

ExecReload=/bin/kill -s HUP $MAINPID

KillMode=mixed

TimeoutStopSec=5

PrivateTmp=true

Restart=on-failure

[Install]

WantedBy=multi-user.target

Crie antes o arquivo /etc/meuapp.env do passo 3, porque, com essa linha, o serviço não sobe sem ele. Para ativar:

sudo systemctl daemon-reload

sudo systemctl enable --now meuapp

systemctl status meuapp

Se o seu projeto é um robô e não um site, o artigo Bot em Python na VPS trata de manter um programa Python em execução no servidor.

Passo 5: o Nginx na frente

Aponte o domínio para o IP da VPS. Para domínios registrados conosco, o DNS gerenciado é grátis na rede da Cloudflare, com painel na área do cliente. A documentação do Gunicorn recomenda com ênfase rodar o Gunicorn atrás de um servidor proxy, e a do Flask mostra um bloco para o Nginx. Para instalar o Nginx num servidor Debian ou Ubuntu, um exemplo é sudo apt install nginx.

Um exemplo de bloco, adaptado do modelo do Flask, para um arquivo em /etc/nginx/sites-available/meuapp, com o domínio real no lugar do _ da documentação. Confira no seu servidor:

server {

listen 80;

server_name meuapp.exemplo.com.br;

location / {

proxy_pass http://127.0.0.1:8000/;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header X-Forwarded-Proto $scheme;

proxy_set_header X-Forwarded-Host $host;

proxy_set_header X-Forwarded-Prefix /;

}

}

Depois, ligue o site, teste a sintaxe e recarregue:

sudo ln -s /etc/nginx/sites-available/meuapp /etc/nginx/sites-enabled/

sudo nginx -t

sudo systemctl reload nginx

Passo 6: o ProxyFix, só com proxy na frente

Esse bloco do Nginx avisa a aplicação sobre o endereço original por cabeçalhos X-Forwarded. Para o Flask confiar neles, use o ProxyFix, em duas linhas sem recuo:

from werkzeug.middleware.proxy_fix import ProxyFix

app.wsgi_app = ProxyFix(app.wsgi_app, x_for=1, x_proto=1, x_host=1, x_prefix=1)

A documentação do Flask avisa que o middleware só deve ser usado se a aplicação estiver de fato atrás de um proxy, configurado com o número de proxies encadeados. Cabeçalhos podem ser forjados, e errar essa configuração pode virar um problema de segurança. O =1 vale para um proxy, o Nginx. Se houver outro proxy ou uma CDN na frente, o número muda. O bloco do Nginx e o ProxyFix andam juntos, porque o bloco acima não repassa o cabeçalho Host e o Flask conta com o X-Forwarded-Host e o x_host=1.

O Gunicorn tem um filtro próprio, o forwarded_allow_ips, que por padrão aceita só 127.0.0.1 e ::1. Só precisa mudar se o Nginx estiver em outra máquina. Para ver outro tipo de projeto Python publicado do mesmo jeito, veja o Django na VPS e a API com FastAPI na VPS.

Passo 7: HTTPS com o Certbot

Antes de pedir o certificado, o site precisa estar no ar e disponível para o resto da internet na porta 80. As instruções do Certbot para Nginx em Linux usam o snap; se houver Certbot instalado por apt, dnf ou yum, remova-o antes. Os comandos da página dele:

sudo snap install --classic certbot

sudo ln -s /snap/bin/certbot /usr/local/bin/certbot

sudo certbot --nginx

sudo certbot renew --dry-run

O certbot --nginx obtém o certificado e ajusta a configuração. Para só obter o certificado, sem mexer na configuração, use certbot certonly --nginx. Os pacotes instalam uma tarefa agendada ou um timer do systemd que renova os certificados automaticamente, e o renew --dry-run é o teste dessa renovação.

Passo 8: cookies seguros e hosts permitidos

Depois que o HTTPS estiver funcionando, ajuste os cookies de sessão. A opção SESSION_COOKIE_SECURE só faz sentido servindo por HTTPS:

app.config.update(SESSION_COOKIE_SECURE=True, SESSION_COOKIE_HTTPONLY=True, SESSION_COOKIE_SAMESITE='Lax')

A documentação do Flask também manda definir TRUSTED_HOSTS ao publicar, para restringir os valores aceitos no cabeçalho Host.

Conferência final

  • o serviço está ativo: systemctl status meuapp;
  • o app.run(debug=True) não ficou no código;
  • a SECRET_KEY está fora do repositório e do código;
  • a porta 8000 não responde pelo endereço público do servidor, só por 127.0.0.1;
  • o certbot renew --dry-run terminou sem erro.

Para quem vai escolher um servidor

A loja mostra as opções de VPS e o que cada plano inclui.

Vale ver o que a loja oferece em VPS? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer os planos

Perguntas frequentes

Posso usar o flask run em produção?

Não. A documentação do Flask diz que o servidor de desenvolvimento serve só para desenvolver localmente e não deve ir para produção. O mesmo vale para o depurador.

O Gunicorn é o único servidor possível?

Não. A documentação do Flask lista outros, como Waitress e uWSGI, e sugere avaliar as opções para a sua aplicação. Neste guia usamos o Gunicorn.

Qual versão do Python devo usar?

O Flask aceita a 3.9 ou mais nova, mas o Gunicorn 26.2.0, na data deste guia, pede a 3.10. Use a 3.10 ou mais nova.

Preciso do ProxyFix?

Só se a aplicação estiver atrás de um proxy, como o Nginx deste guia, e com o número de proxies certo.

Esta resposta lhe foi útil?

Artigos Relacionados