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

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çalhoHostfica 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-Protodos 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:
- instalar Python, Nginx e o banco;
- criar o usuário e o ambiente virtual;
- instalar Django e Gunicorn;
- definir variáveis e
settings.py; - rodar
migrate; - rodar
collectstatic; - rodar
check --deploy; - criar o socket e o service do Gunicorn;
- criar o bloco do Nginx e recarregar;
- rodar o Certbot;
- 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ê.