wils@web ~ $ cat ~/ajuda/guia-pratico-para-realizar-o-deploy-de-aplicacoes-flask-com-gunicorn-no-ubuntu-22-04.md

Desenvolvimento

Guia prático para realizar o deploy de aplicações Flask com Gunicorn no Ubuntu 22.04

atualizado em 05/08/2026

Este guia prático tem como objetivo auxiliar no processo de deploy de aplicações Flask utilizando o Gunicorn em um servidor Ubuntu 22.04.

Pré-requisitos

  • Ubuntu 22.04 instalado.
  • Acesso root ou sudo ao servidor.
  • Python 3 e pip instalados.
  • Aplicação Flask pronta para ser implantada.

Passo a Passo

1. Atualizar o servidor

sudo apt update && sudo apt upgrade -y

2. Instalar dependências

sudo apt install python3-pip python3-dev nginx

3. Criar um ambiente virtual

python3 -m venv venv
source venv/bin/activate

4. Instalar Flask e Gunicorn

pip install Flask gunicorn

5. Criar a aplicação Flask

Crie um arquivo chamado app.py com o seguinte conteúdo:

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello():
    return 'Hello, World!'

if __name__ == '__main__':
    app.run()

6. Testar a aplicação localmente

python app.py

Acesse http://localhost:5000 no navegador para verificar se a aplicação está funcionando.

7. Iniciar o Gunicorn

gunicorn --bind 0.0.0.0:8000 app:app

8. Configurar o Nginx

Crie um arquivo de configuração para o Nginx:

sudo nano /etc/nginx/sites-available/flaskapp

Adicione o seguinte conteúdo:

server {
    listen 80;
    server_name seu_dominio.com;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
sudo ln -s /etc/nginx/sites-available/flaskapp /etc/nginx/sites-enabled
sudo nginx -t
sudo systemctl restart nginx

Conclusão

Agora sua aplicação Flask está rodando com Gunicorn e Nginx. Para garantir a continuidade do serviço, considere utilizar um gerenciador de processos como o supervisor ou systemd.

Precisa de ajuda com isso no seu servidor? A gente resolve pra você.

falar no WhatsApp

// deu erro ou não funcionou?

Achou algo errado neste manual?

Conta pra gente o que deu errado ou qual erro apareceu — a gente corrige. Se quiser retorno, deixe seu contato.