wils@web ~ $ cat ~/ajuda/guia-para-implementar-gunicorn-como-servidor-wsgi-para-aplicacoes-flask-no-ubuntu-22-04.md

Desenvolvimento

Guia para implementar Gunicorn como servidor WSGI para aplicações Flask no Ubuntu 22.04

atualizado em 25/07/2026

Este guia fornece um passo a passo para implementar o Gunicorn como servidor WSGI para aplicações Flask no Ubuntu 22.04, garantindo uma configuração eficiente e segura.

Introdução

Gunicorn é um servidor WSGI Python que serve aplicações web de forma leve e rápida. Neste guia, vamos instalar e configurar o Gunicorn para trabalhar com uma aplicação Flask.

Pré-requisitos

  • Ubuntu 22.04 instalado.
  • Python 3 e pip instalados.
  • Uma aplicação Flask básica.

Passo a Passo

1. Atualizar o sistema

sudo apt update && sudo apt upgrade -y

2. Instalar o Gunicorn

pip install gunicorn

3. Criar uma 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()

4. Testar a aplicação localmente

python app.py

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

5. Executar o Gunicorn

gunicorn --bind 0.0.0.0:8000 app:app

A aplicação agora está disponível em http://localhost:8000.

6. Configurar o Gunicorn como um serviço

Crie um arquivo de serviço para o Gunicorn:

sudo nano /etc/systemd/system/gunicorn.service

Adicione o seguinte conteúdo:

[Unit]
Description=gunicorn daemon
After=network.target

[Service]
User=www-data
Group=www-data
WorkingDirectory=/caminho/para/seu/projeto
ExecStart=/usr/local/bin/gunicorn --access-logfile - --workers 3 --bind unix:/caminho/para/seu/projeto/app.sock app:app

[Install]
WantedBy=multi-user.target

7. Iniciar e habilitar o serviço

sudo systemctl start gunicorn
sudo systemctl enable gunicorn

Conclusão

Gunicorn é uma excelente escolha para servir aplicações Flask. Para uma melhor performance, considere usar um servidor reverso como Nginx na frente do Gunicorn.

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.