Flask na VPS: como publicar seu projeto com Nginx
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

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-runterminou 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.