Base de Conhecimento

Django na VPS: como publicar seu projeto com Nginx

  • django, python, gunicorn, nginx, certbot, vps
  • Usuários acharam útil: 0

Aprenda a publicar um projeto Django na VPS: ambiente virtual, configurações de produção, Gunicorn com systemd, Nginx, arquivos estáticos e HTTPS com Certbot.

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

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

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

Django na VPS: este passo a passo mostra como publicar um projeto Django com Gunicorn, Nginx e HTTPS, da versão do Python ao teste final no navegador.

Se você está começando com servidores, o guia O que é servidor VPS explica o básico da máquina onde o projeto vai ficar. Aqui, os exemplos usam o domínio fictício www.exemplo.com.br, o usuário deploy e o projeto meuprojeto.

Versões do Django e do Python

A versão mais recente do Django é a 6.1.3. A série LTS atual é a 5.2, com suporte estendido até abril de 2028, e a próxima LTS, a 6.2, está prevista para abril de 2027. A 6.1, portanto, não é LTS: o suporte principal dela vai até abril de 2027 e o estendido até dezembro de 2027.

Sobre o Python, o Django 6.1 aceita as versões 3.12, 3.13, 3.14 e 3.15 (a 3.15 a partir do 6.1.3). O Django 5.2 aceita da 3.10 à 3.14. O site do Gunicorn informa que ele exige Python 3.12 ou mais novo. A versão do Python que o seu servidor traz varia com a distribuição, então confira antes de começar:

python3 --version

Ambiente virtual e instalação

O Django recomenda instalar com o pip dentro de um ambiente virtual. Um exemplo de comandos, com o usuário deploy; confira no seu servidor:

python3 -m venv /home/deploy/projeto/.venv

source /home/deploy/projeto/.venv/bin/activate

python -m pip install Django gunicorn

Instale o Python, o Nginx e o banco pelo gerenciador de pacotes da sua distribuição. Recomendamos rodar o projeto com um usuário comum, e não com o administrador do servidor.

Configurações antes de publicar

A documentação do Django tem uma lista de verificação de deploy. Os pontos principais:

  • SECRET_KEY: deve ser um valor grande e aleatório, mantido em segredo e fora do controle de versão;
  • DEBUG: a documentação manda manter desligado em produção, ou seja, DEBUG = False;
  • ALLOWED_HOSTS: com DEBUG = False, o Django não funciona sem um valor adequado nessa lista. O valor '*' aceita tudo, e aí a validação do cabeçalho Host fica por sua conta;
  • CSRF_TRUSTED_ORIGINS: lista de origens confiáveis para requisições inseguras, como o POST. Os exemplos da documentação trazem o esquema, como 'https://subdomain.example.com';
  • HTTPS: a documentação diz que um site que permite login de usuários deve exigir HTTPS no site inteiro.

Um exemplo de settings.py de produção, lendo a chave do ambiente. Adapte ao seu projeto; a linha SECURE_PROXY_SSL_HEADER só vale nas condições da seção seguinte:

import os

SECRET_KEY = os.environ["DJANGO_SECRET_KEY"]

DEBUG = False

ALLOWED_HOSTS = ["www.exemplo.com.br"]

CSRF_TRUSTED_ORIGINS = ["https://www.exemplo.com.br"]

STATIC_ROOT = "/var/www/exemplo/static/"

STATIC_URL = "static/"

SECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")

CSRF_COOKIE_SECURE = True

SESSION_COOKIE_SECURE = True

O comando check --deploy automatiza alguns dos checks da lista de deploy, não todos. Com a variável DJANGO_SECRET_KEY definida na sessão, rode django-admin check --deploy --settings=production_settings (troque pelo módulo de configurações do seu projeto, como meuprojeto.settings) e leia o resultado, mas não o trate como prova de que o site está seguro.

Atrás do proxy: SECURE_PROXY_SSL_HEADER

Como o Nginx fica na frente do Gunicorn, o Django só sabe que o pedido veio por HTTPS se você configurar SECURE_PROXY_SSL_HEADER. A documentação avisa que mudar essa opção pode comprometer a segurança do site e que ela só deve ser definida se você controla o proxy ou tem outra garantia de que ele define e remove o cabeçalho da forma certa. As condições que ela lista são:

  • o aplicativo Django está atrás de um proxy;
  • o proxy remove o cabeçalho X-Forwarded-Proto dos pedidos recebidos;
  • o proxy define o cabeçalho e o envia ao Django apenas para pedidos que chegaram originalmente por HTTPS.

O exemplo de Nginx do Gunicorn envia o cabeçalho com $scheme. Recomendamos conferir, no seu servidor, se o Nginx atende a terceira condição antes de manter essa linha ativa.

Banco de dados

O Django suporta oficialmente PostgreSQL, MariaDB, MySQL, Oracle e SQLite. Para um projeto pequeno ou que não vai para produção, a documentação diz que o SQLite é, em geral, a melhor opção, porque não exige um servidor separado. Para algo maior, ela recomenda desenvolver com o mesmo banco que será usado em produção. Sobre o SQLite, ela avisa que ele é leve e não suporta um alto nível de concorrência; nos erros desse tipo, ela sugere trocar de banco.

As versões mínimas, na documentação do 6.1, são PostgreSQL 15, MariaDB 10.11, MySQL 8.4 e SQLite 3.37.0.

Vai publicar o projeto em um servidor virtual? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Migrações e arquivos estáticos

Com o ambiente virtual ativo e a variável DJANGO_SECRET_KEY definida na sessão do terminal, crie as tabelas e reúna os arquivos estáticos em STATIC_ROOT. Crie antes a pasta de STATIC_ROOT, com permissão de escrita para o usuário deploy. Um exemplo de comandos, rodados na pasta do manage.py:

python manage.py migrate

python manage.py collectstatic --noinput

A opção --noinput dispensa as perguntas do collectstatic. A documentação avisa que o STATIC_ROOT não é lugar para guardar arquivos estáticos de forma permanente. Em produção, o Django manda copiar os arquivos para lá e configurar o servidor web para entregá-los na URL de STATIC_URL; o exemplo da documentação para isso é de Apache, e aqui o Nginx cumpre esse papel.

O runserver não serve para produção: a documentação diz isso em letras maiúsculas.

Gunicorn com systemd e socket

A documentação do Django mostra o Gunicorn iniciando com gunicorn myproject.wsgi a partir da pasta do manage.py, e esse comando abre um processo com uma thread em 127.0.0.1:8000. Em produção, o guia do Gunicorn usa o systemd com um socket. O arquivo do socket, no exemplo do guia (/etc/systemd/system/gunicorn.socket), é:

[Unit]

Description=gunicorn socket

[Socket]

ListenStream=/run/gunicorn.sock

SocketUser=www-data

SocketGroup=www-data

SocketMode=0660

[Install]

WantedBy=sockets.target

Um exemplo de /etc/systemd/system/gunicorn.service, adaptado do guia do Gunicorn para o ambiente virtual e para as variáveis de ambiente. Troque o usuário, as pastas e o nome do projeto pelos seus:

[Unit]

Description=gunicorn daemon

Requires=gunicorn.socket

After=network.target

[Service]

Type=notify

NotifyAccess=main

User=deploy

Group=www-data

WorkingDirectory=/home/deploy/projeto

EnvironmentFile=/etc/projeto/ambiente

ExecStart=/home/deploy/projeto/.venv/bin/gunicorn --workers 3 meuprojeto.wsgi

ExecReload=/bin/kill -s HUP $MAINPID

KillMode=mixed

TimeoutStopSec=5

PrivateTmp=true

[Install]

WantedBy=multi-user.target

O arquivo /etc/projeto/ambiente do exemplo guarda linhas como DJANGO_SECRET_KEY=valor-longo-e-aleatorio. Restrinja o acesso a ele. Para os workers, o site do Gunicorn dá a fórmula (2 x núcleos de CPU) + 1 e lembra que workers não são clientes: ele normalmente precisa de 4 a 12 para tráfego pesado. Trate a fórmula como ponto de partida e não como medida de capacidade. Para ativar o socket:

sudo systemctl enable --now gunicorn.socket

Nginx na frente do Gunicorn

Um exemplo de bloco server, para um arquivo de configuração do Nginx do seu sistema, que junta as orientações do Gunicorn e do Nginx. O socket é o mesmo /run/gunicorn.sock do systemd. Confira cada linha no seu servidor:

server {

listen 80;

server_name www.exemplo.com.br;

location /static/ {

root /var/www/exemplo;

}

location / {

proxy_set_header Host $host;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header X-Forwarded-Proto $scheme;

proxy_redirect off;

proxy_pass http://unix:/run/gunicorn.sock;

}

}

Detalhes que a documentação do Nginx explica: com location /static/ e root /var/www/exemplo, o Nginx entrega os arquivos de /var/www/exemplo/static/, que é o STATIC_ROOT do exemplo. Para o cabeçalho Host, o $http_host repassa o que o cliente enviou, e a documentação indica $host quando o cliente não envia. O limite padrão de upload é client_max_body_size 1m, e você precisa aumentá-lo se o projeto recebe arquivos maiores. Depois de editar, ative o Nginx e recarregue a configuração:

sudo systemctl enable nginx.service

sudo systemctl start nginx

sudo nginx -s reload

Django, Nginx e Gunicorn: uma combinação entre várias

A documentação do Django diz que há muitas opções de deploy, conforme a arquitetura e a necessidade, e que essa discussão está fora do que ela orienta. Na página de instalação, ela cita o Apache com mod_wsgi para sites em produção, e tem um guia próprio para o Gunicorn. O exemplo daqui usa Nginx com Gunicorn, e a documentação do Django não o indica como forma oficial.

HTTPS com Certbot

O site do Certbot pede que o seu site esteja acessível na internet pela porta 80. Com o Nginx e o snap, as instruções do site do Certbot são:

sudo snap install --classic certbot

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

sudo certbot --nginx

O último comando obtém o certificado e edita a configuração do Nginx. Para apenas obter o certificado, use sudo certbot certonly --nginx. Depois, teste a renovação:

sudo certbot renew --dry-run

Com o HTTPS ativo, mantenha em CSRF_TRUSTED_ORIGINS as origens com https:// e confira as opções CSRF_COOKIE_SECURE e SESSION_COOKIE_SECURE do exemplo de configuração.

Resumo da sequência

Um exemplo de ordem; confira cada passo no seu servidor:

  1. instalar Python, Nginx e o banco;
  2. criar o usuário e o ambiente virtual;
  3. instalar Django e Gunicorn;
  4. definir variáveis e settings.py;
  5. rodar migrate;
  6. rodar collectstatic;
  7. rodar check --deploy;
  8. criar o socket e o service do Gunicorn;
  9. criar o bloco do Nginx e recarregar;
  10. rodar o Certbot;
  11. conferir o site em HTTPS, o login e os estáticos.

Guias relacionados

Para temas próximos, veja o guia Bot em Python na VPS para manter um processo rodando e o de Laravel na VPS para uma aplicação PHP com Nginx. Para vários sites atrás de uma interface gráfica, há o Nginx Proxy Manager.

Que tal olhar as opções de servidor virtual? 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

Qual versão do Django usar?

A mais recente é a 6.1.3, mas a série LTS atual é a 5.2. A próxima LTS, a 6.2, está prevista para abril de 2027. Confira a página de download do Django antes de começar.

O Django recomenda Nginx com Gunicorn?

A documentação diz que há muitas opções de deploy e não elege uma. Ela cita o Apache com mod_wsgi na página de instalação e tem um guia próprio para o Gunicorn.

Posso usar SQLite em produção?

A documentação não proíbe nem elege um único banco para produção. Ela diz que o SQLite é leve e não suporta alta concorrência, e sugere trocar de banco quando aparecem erros por isso.

O check --deploy garante que o site está seguro?

Não. Segundo a documentação, ele automatiza alguns dos checks da lista de deploy, e o restante da lista continua com você.

Esta resposta lhe foi útil?

Artigos Relacionados