wils@web ~ $ cat ~/ajuda/como-usar-o-gunicorn-20-1-0-para-servir-aplicacoes-python-em-producao.md

Servidores

Como usar o Gunicorn 20.1.0 para servir aplicações Python em produção

atualizado em 02/09/2026

O Gunicorn (Green Unicorn) é um servidor WSGI para aplicações Python, amplamente utilizado para servir aplicações web em produção. Nesta documentação, abordaremos como instalar e configurar o Gunicorn 20.1.0 para aplicações Python.

Pré-requisitos

  • Python 3.x instalado
  • pip para instalação de pacotes
  • Um ambiente virtual (opcional, mas recomendado)

1. Instalando o Gunicorn

Primeiro, instale o Gunicorn utilizando o pip. Se você estiver utilizando um ambiente virtual, ative-o antes de instalar.

pip install gunicorn==20.1.0

2. Estrutura do Projeto

Certifique-se de que sua aplicação Python esteja estruturada corretamente. Um exemplo simples de uma aplicação Flask:

from flask import Flask

app = Flask(__name__)

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

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

3. Executando o Gunicorn

Para servir sua aplicação, utilize o seguinte comando:

gunicorn --bind 0.0.0.0:8000 nome_do_seu_arquivo:app

Substitua nome_do_seu_arquivo pelo nome do arquivo Python que contém sua aplicação.

4. Configurações Adicionais

Você pode ajustar várias opções ao iniciar o Gunicorn:

  • --workers: Número de processos de trabalho (recomenda-se 2x o número de núcleos de CPU).
  • --timeout: Tempo limite para requisições (padrão é 30 segundos).
  • --log-level: Nível de log (ex: info, warning, error).

Exemplo de comando com opções:

gunicorn --bind 0.0.0.0:8000 --workers 4 --timeout 60 --log-level info nome_do_seu_arquivo:app

5. Executando em Segundo Plano

Para executar o Gunicorn como um serviço em segundo plano, você pode usar o nohup:

nohup gunicorn --bind 0.0.0.0:8000 nome_do_seu_arquivo:app &

Conclusão

O Gunicorn é uma excelente opção para servir aplicações Python em produção. Lembre-se de monitorar o desempenho e ajustar as configurações conforme necessário. Uma dica importante é usar um proxy reverso, como Nginx, para gerenciar as requisições e melhorar a segurança.

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.