Статья 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 updateapt install -y python3 python3-venv python3-pip git nginx postgresql certbot python3-certbot-nginxБаза данных
Заголовок раздела «База данных»sudo -u postgres psqlCREATE USER mysite WITH PASSWORD 'ДЛИННЫЙ_ПАРОЛЬ';CREATE DATABASE mysite OWNER mysite;\qPostgreSQL в Ubuntu по умолчанию слушает только 127.0.0.1. Не открывайте порт 5432 наружу. Подробнее: PostgreSQL на VPS.
Пользователь, код и venv
Заголовок раздела «Пользователь, код и venv»adduser --system --group --home /srv/mysite --shell /bin/bash mysitesudo -u mysite git clone https://github.com/ваш_аккаунт/ваш_проект.git /srv/mysite/appcd /srv/mysitesudo -u mysite python3 -m venv .venvsudo -u mysite .venv/bin/pip install -r app/requirements.txtВ requirements.txt должны быть:
djangogunicornpsycopg[binary]python-dotenvНиже считается, что проект называется config (файл config/settings.py), а manage.py лежит в /srv/mysite/app.
Настройки из .env
Заголовок раздела «Настройки из .env»Создайте /srv/mysite/app/.env:
DJANGO_SECRET_KEY=ДЛИННАЯ_СЛУЧАЙНАЯ_СТРОКАDJANGO_DEBUG=0DJANGO_ALLOWED_HOSTS=example.com,www.example.comDJANGO_CSRF_TRUSTED_ORIGINS=https://example.com,https://www.example.comDB_NAME=mysiteDB_USER=mysiteDB_PASSWORD=ДЛИННЫЙ_ПАРОЛЬDB_HOST=127.0.0.1DB_PORT=5432chmod 600 /srv/mysite/app/.envchown 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 = TrueCSRF_COOKIE_SECURE = TrueALLOWED_HOSTSперечисляет домены сайта. На запрос с другимHostDjango ответит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_dotenvload_dotenv()Миграции, статика, администратор
Заголовок раздела «Миграции, статика, администратор»cd /srv/mysite/appsudo -u mysite ../.venv/bin/python manage.py migratesudo -u mysite ../.venv/bin/python manage.py collectstatic --noinputsudo -u mysite ../.venv/bin/python manage.py createsuperusercollectstatic собирает CSS и JS всех приложений в STATIC_ROOT:
130 static files copied to '/srv/mysite/app/staticfiles'.Проверьте настройки командой manage.py check --deploy. Она покажет, что ещё стоит включить: HSTS, редирект на HTTPS, почтовый бэкенд для production.
Gunicorn под systemd
Заголовок раздела «Gunicorn под systemd»Создайте /etc/systemd/system/mysite.service:
[Unit]Description=Django mysite (gunicorn)After=network.target postgresql.service
[Service]User=mysiteGroup=www-dataWorkingDirectory=/srv/mysite/appEnvironmentFile=/srv/mysite/app/.envRuntimeDirectory=mysiteExecStart=/srv/mysite/.venv/bin/gunicorn config.wsgi:application --workers 3 --bind unix:/run/mysite/gunicorn.sock --access-logfile -ExecReload=/bin/kill -s HUP $MAINPIDRestart=alwaysRestartSec=5
[Install]WantedBy=multi-user.targetRuntimeDirectory создаёт /run/mysite при старте. Группа www-data нужна, чтобы Nginx мог подключиться к сокету.
systemctl daemon-reloadsystemctl enable --now mysitesystemctl status mysitels -l /run/mysite/● mysite.service - Django mysite (gunicorn) Active: active (running) since Wed 2026-11-18 15:11:48 UTC; 4s agosrwxrwxrwx 1 mysite www-data 0 Nov 18 15:11 gunicorn.sockNginx: статика, медиа и прокси
Заголовок раздела «Nginx: статика, медиа и прокси»Создайте /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/mysiteln -s /etc/nginx/sites-available/mysite /etc/nginx/sites-enabled/rm -f /etc/nginx/sites-enabled/defaultnginx -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 и ошибки Pythontail -f /var/log/nginx/error.log # ошибки NginxОбновление
Заголовок раздела «Обновление»cd /srv/mysite/appsudo -u mysite git pullsudo -u mysite ../.venv/bin/pip install -r requirements.txtsudo -u mysite ../.venv/bin/python manage.py migratesudo -u mysite ../.venv/bin/python manage.py collectstatic --noinputsystemctl reload mysitereload отправляет Gunicorn сигнал HUP: он плавно перезапускает воркеры без обрыва соединений.
sudo -u postgres pg_dump -Fc mysite > /root/mysite-$(date +%F).dumptar -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 |