Перейти к содержимому

Статья 56 из 141

Гайды

Как развернуть Django на VPS: Gunicorn, PostgreSQL, Nginx, статика и HTTPS

manage.py runserver предназначен только для разработки. На сервере Django работает так: Gunicorn запускает приложение и слушает unix-сокет, systemd следит за процессом, Nginx отдаёт статику и медиа сам, а остальные запросы передаёт Gunicorn. Данные хранятся в PostgreSQL.

Инструкция проверена на Ubuntu 24.04 с Python 3.12, Django 6.1, Gunicorn 27, psycopg 3.3 и PostgreSQL 16 (ноябрь 2026).

Ресурс Минимум Комментарий
vCPU 1
RAM 1–2 ГБ Gunicorn с тремя воркерами занял около 120 МБ, плюс PostgreSQL
Диск 10 ГБ больше, если пользователи загружают файлы
Домен example.com A-запись на IP сервера (DNS)
Окно терминала
apt update
apt install -y python3 python3-venv python3-pip git nginx postgresql certbot python3-certbot-nginx
Окно терминала
sudo -u postgres psql
CREATE USER mysite WITH PASSWORD 'ДЛИННЫЙ_ПАРОЛЬ';
CREATE DATABASE mysite OWNER mysite;
\q

PostgreSQL в Ubuntu по умолчанию слушает только 127.0.0.1. Не открывайте порт 5432 наружу. Подробнее: PostgreSQL на VPS.

Окно терминала
adduser --system --group --home /srv/mysite --shell /bin/bash mysite
sudo -u mysite git clone https://github.com/ваш_аккаунт/ваш_проект.git /srv/mysite/app
cd /srv/mysite
sudo -u mysite python3 -m venv .venv
sudo -u mysite .venv/bin/pip install -r app/requirements.txt

В requirements.txt должны быть:

django
gunicorn
psycopg[binary]
python-dotenv

Ниже считается, что проект называется config (файл config/settings.py), а manage.py лежит в /srv/mysite/app.

Создайте /srv/mysite/app/.env:

DJANGO_SECRET_KEY=ДЛИННАЯ_СЛУЧАЙНАЯ_СТРОКА
DJANGO_DEBUG=0
DJANGO_ALLOWED_HOSTS=example.com,www.example.com
DJANGO_CSRF_TRUSTED_ORIGINS=https://example.com,https://www.example.com
DB_NAME=mysite
DB_USER=mysite
DB_PASSWORD=ДЛИННЫЙ_ПАРОЛЬ
DB_HOST=127.0.0.1
DB_PORT=5432
Окно терминала
chmod 600 /srv/mysite/app/.env
chown mysite:mysite /srv/mysite/app/.env

Секретный ключ можно сгенерировать так: python3 -c "import secrets; print(secrets.token_urlsafe(50))".

В конце config/settings.py прочитайте переменные:

import os
SECRET_KEY = os.environ["DJANGO_SECRET_KEY"]
DEBUG = os.environ.get("DJANGO_DEBUG", "0") == "1"
ALLOWED_HOSTS = os.environ.get("DJANGO_ALLOWED_HOSTS", "").split(",")
CSRF_TRUSTED_ORIGINS = os.environ.get("DJANGO_CSRF_TRUSTED_ORIGINS", "").split(",")
DATABASES = {
"default": {
"ENGINE": "django.db.backends.postgresql",
"NAME": os.environ["DB_NAME"],
"USER": os.environ["DB_USER"],
"PASSWORD": os.environ["DB_PASSWORD"],
"HOST": os.environ.get("DB_HOST", "127.0.0.1"),
"PORT": os.environ.get("DB_PORT", "5432"),
}
}
STATIC_URL = "static/"
STATIC_ROOT = BASE_DIR / "staticfiles"
MEDIA_URL = "media/"
MEDIA_ROOT = BASE_DIR / "media"
SECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")
SESSION_COOKIE_SECURE = True
CSRF_COOKIE_SECURE = True
  • ALLOWED_HOSTS перечисляет домены сайта. На запрос с другим Host Django ответит 400 Bad Request.
  • CSRF_TRUSTED_ORIGINS указывается со схемой https://. Без него вход в админку за прокси может закончиться ошибкой 403 CSRF verification failed. Мы проверили это на тестовом сервере.
  • SECURE_PROXY_SSL_HEADER говорит Django, что запрос пришёл по HTTPS, если Nginx передал X-Forwarded-Proto: https.

Чтобы manage.py тоже видел .env, добавьте в его начало после import sys:

from dotenv import load_dotenv
load_dotenv()
Окно терминала
cd /srv/mysite/app
sudo -u mysite ../.venv/bin/python manage.py migrate
sudo -u mysite ../.venv/bin/python manage.py collectstatic --noinput
sudo -u mysite ../.venv/bin/python manage.py createsuperuser

collectstatic собирает CSS и JS всех приложений в STATIC_ROOT:

130 static files copied to '/srv/mysite/app/staticfiles'.

Проверьте настройки командой manage.py check --deploy. Она покажет, что ещё стоит включить: HSTS, редирект на HTTPS, почтовый бэкенд для production.

Создайте /etc/systemd/system/mysite.service:

[Unit]
Description=Django mysite (gunicorn)
After=network.target postgresql.service
[Service]
User=mysite
Group=www-data
WorkingDirectory=/srv/mysite/app
EnvironmentFile=/srv/mysite/app/.env
RuntimeDirectory=mysite
ExecStart=/srv/mysite/.venv/bin/gunicorn config.wsgi:application --workers 3 --bind unix:/run/mysite/gunicorn.sock --access-logfile -
ExecReload=/bin/kill -s HUP $MAINPID
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target

RuntimeDirectory создаёт /run/mysite при старте. Группа www-data нужна, чтобы Nginx мог подключиться к сокету.

Окно терминала
systemctl daemon-reload
systemctl enable --now mysite
systemctl status mysite
ls -l /run/mysite/
● mysite.service - Django mysite (gunicorn)
Active: active (running) since Wed 2026-11-18 15:11:48 UTC; 4s ago
srwxrwxrwx 1 mysite www-data 0 Nov 18 15:11 gunicorn.sock

Создайте /etc/nginx/sites-available/mysite:

server {
listen 80;
server_name example.com www.example.com;
client_max_body_size 20M;
location /static/ {
alias /srv/mysite/app/staticfiles/;
expires 30d;
}
location /media/ {
alias /srv/mysite/app/media/;
}
location / {
proxy_pass http://unix:/run/mysite/gunicorn.sock;
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;
}
}

Nginx работает от www-data, поэтому ему нужно право проходить в домашний каталог приложения:

Окно терминала
chmod 755 /srv/mysite
ln -s /etc/nginx/sites-available/mysite /etc/nginx/sites-enabled/
rm -f /etc/nginx/sites-enabled/default
nginx -t && systemctl reload nginx

Проверка:

Окно терминала
curl -I -H "Host: example.com" http://127.0.0.1/admin/login/
curl -I -H "Host: example.com" http://127.0.0.1/static/admin/css/base.css

Обе команды на тестовом сервере вернули HTTP/1.1 200 OK. Запрос с чужим доменом в Host получил 400 Bad Request, как и должно быть.

Файлы, которые загружают пользователи, Django кладёт в MEDIA_ROOT. Nginx отдаёт их напрямую, Gunicorn в этом не участвует.

Окно терминала
certbot --nginx -d example.com -d www.example.com

После выпуска сертификата откройте https://example.com/admin/ и войдите под созданным администратором. Подробнее: Let’s Encrypt и Certbot.

Окно терминала
journalctl -u mysite -f # Gunicorn и ошибки Python
tail -f /var/log/nginx/error.log # ошибки Nginx
Окно терминала
cd /srv/mysite/app
sudo -u mysite git pull
sudo -u mysite ../.venv/bin/pip install -r requirements.txt
sudo -u mysite ../.venv/bin/python manage.py migrate
sudo -u mysite ../.venv/bin/python manage.py collectstatic --noinput
systemctl reload mysite

reload отправляет Gunicorn сигнал HUP: он плавно перезапускает воркеры без обрыва соединений.

Окно терминала
sudo -u postgres pg_dump -Fc mysite > /root/mysite-$(date +%F).dump
tar -czf /root/mysite-media-$(date +%F).tar.gz -C /srv/mysite/app media .env

Храните копии за пределами сервера: бэкапы. Статику сохранять не нужно, её пересоздаёт collectstatic.

Симптом Причина и решение
400 Bad Request на все страницы домена нет в DJANGO_ALLOWED_HOSTS, после правки .env выполните systemctl restart mysite
403 CSRF verification failed при входе домен со схемой https:// не указан в CSRF_TRUSTED_ORIGINS
Админка без стилей не выполнен collectstatic или неверный путь в alias (нужен / в конце)
502 Bad Gateway Gunicorn не запущен или Nginx не может открыть сокет: journalctl -u mysite -n 50, права на /run/mysite
403 Forbidden на /static/ у www-data нет прав на каталог: chmod 755 /srv/mysite
KeyError: 'DJANGO_SECRET_KEY' systemd не прочитал .env: проверьте путь в EnvironmentFile
connection refused к базе PostgreSQL не запущен или неверные DB_HOST/DB_PORT