Статья
Содержание статьи

Установка Django

Последнее обновление: 27 февраля 2025 г.

Django — это высокоуровневый веб-фреймворк на языке Python, предназначенный для быстрой и эффективной разработки веб-приложений. Он включает в себя множество встроенных компонентов, таких как система аутентификации, админ-панель и инструменты для работы с базами данных.

Основные области применения Django:

  • контент-менеджмент системы (CMS);
  • электронная коммерция;
  • социальные сети;
  • корпоративные приложения;
  • микросервисы и API.

Установка

Выполните создание сайта.

  • перейдите в основное меню;
  • выберите раздел Сайты;
  • нажмите кнопку Создать сайт.

Заполните все строки и нажмите кнопку Создать.

  • Доменное имя — доменное имя, которое будет использоваться пользователями сети Интернет для доступа к публикуемой информации;
  • Директория сайта  путь к директории сайта. Указывается относительно домашней директории владельца;
  • Обработчик — в строке Обработчик выберите Python;
  • Конструктор сайта/CMS — после выбора Обработчик → Python данная строка будет заблокирована;
  • Режим работы приложения — выберите подходящий режим работы для текущего пользователя.
  • Версия Python - выберите версию 3.11;
  • Базы данных - выберите Создать новую базу данных или Не привязывать базу данных.

Перейдите во вкладку Расширенные настройки.

Откройте вкладку Обработчик. Заполните поля как показано ниже.

  • Режим работы приложения — web-сервер Python;
  • Путь к серверу — для запуска сервера необходимо указать путь к файлу manage.py проекта. Путь к файлу имеет следующий формат, где project_name - имя проекта Django; 
  • Аргументы сервера — для запуска сервера используйте команду runserver <номер порта>. Этот параметр будет известен после создания сайта. Если в настройках сайта не было установлено значение для runserver <номер порта>, то при запуске проекта возникнет ошибка.
  • Cпособ подключения — порт;
  • Версия Python - 3.11 
  • После заполнения полей, нажмите кнопку Создать.

Выполните следующие действия.

  • перейдите в основное меню;
  • выберите вкладку Сайты;
  • выберите сайт;
  • нажмите на кнопку Редактировать

Выполните следующие действия.

  • откройте вкладку Обработчик (Python);
  • введите порт в строке Аргументы сервера;
  • нажмите кнопку Сохранить.
В данном примере для поля Аргументы сервера следует указать runserver 20000.    

Выполните удаление автоматически созданной директории.

  • перейдите в основное меню;
  • выберите вкладку Сайты;
  • выберите сайт;
  • нажмите кнопку Файлы сайта.

Удалите директорию project_name.

  • выберите директорию project_name;
  • нажмите вкладку Редактировать;
  • нажмите кнопку Удалить

Выполните следующие действия.

  • перейдите в основное меню;
  • выберите вкладку Сайты;
  • выберите сайт;
  • нажмите на вкладку Конфиг.файлы.

Введите django и нажмите кнопку Сохранить

Выполните следующие действия.

  • перейдите в основное меню;
  • выберите вкладку Сайты;
  • выберите сайт;
  • нажмите на кнопку •••;
  • выберите Shell-клиент.

Введите следующие команды.



source .venv/bin/activate
pip install --upgrade pip
pip install wheel
pip install mysqlclient 
django-admin startproject project_name
Обратите внимание!
При проблемах установки mysqlclient установите конкретную версию, например, pip install mysqlclient==2.1.0.

django-admin startproject project_name - project_name это имя проекта Django.

Выполните следующие действия.

  • перейдите в основное меню;
  • выберите вкладку Сайты;
  • выберите сайт;
  • выберите Файлы сайта.

Откроется Менеджер файлов.

  • перед выполнением операции удостоверьтесь, что находитесь в директории, содержащей текущий проект;
  • после завершения указанных выше шагов снова появится директорию с названием project_name.
  • откройте директорию project_name.

Выполните следующие действия.

  • 2 раза нажмите на файл settings.ру для его редактирования;
  • добавьте имя домена и псевдонимы в секции ALLOWED_HOSTS = []
  • домены должны находиться в кавычках. ALLOWED_HOSTS = ['имя сайта как в панели' , 'псевдоним'].

В секции DATABASES укажите данные для подключения к базе MySQL.



DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'ИМЯ_БД',
        'USER': 'ПОЛЬЗОВАТЕЛЬ_БД',
        'PASSWORD':'ПАРОЛЬ_ПОЛЬЗОВАТЕЛЯ_БД',
        'HOST':'localhost'
    }
}

Обратите внимание!
Если отсутствует база данных, создайте ее

В этом же файле выполните следующее изменение:

спуститесь ниже до секции STATIC_URL;
добавьте новую секцию STATIC_ROOT='static/'
нажмите кнопку Сохранить и закрыть.

Создайте каталог со статическими файлами.

  • перейдите в основное меню;
  • выберите вкладку Сайты;
  • нажмите на кнопку •••;
  • выберите Shell-клиент.

выполните команды указанные ниже.



source .venv/bin/activate

python project_name/manage.py collectstatic (Где project_name - Имя проекта Django).

Выполните миграцию проекта MySQL.

введите команду 



python project_name/manage.py migrate (Где project_name - имя проекта Django).

Выполните создание конфигурационного файла в корневом каталоге.

  • перейдите в основное меню;
  • выберите вкладку Сайты;
  • выберите сайт;
  • выберите Файлы сайта.
  • нажмите кнопку Создать.

Заполните строки как показано ниже.

  • Тип — файл;
  • Имя — введите passenger_wsgi.ру;
  • нажмите на кнопку Создать.

Выполните следующие действия.

  • перейдите в основное меню;
  • выберите вкладку Сайты;
  • выберите сайт;
  • выберите Файлы сайта;
  • нажмите 2 раза на файл passenger_wsgi.ру для его редактирования;

в файле passenger_wsgi.ру укажите содержимое указанное ниже;​​​​​



# -*- coding: utf-8 -*-
import os, sys
sys.path.insert(0, '/var/www/<имя пользователя панели>/data/www/<имя сайта>/project_name')
sys.path.insert(1, '/var/www/<имя пользователя панели>/data/www/<имя сайта>/.venv/lib/python<номер версии>/site-packages')
os.environ['DJANGO_SETTINGS_MODULE'] = 'project_name.settings'
from django.core.wsgi import get_wsgi_application
application = get_wsgi_application() 

1. В строке sys.path.insert(0, '/var/www/<имя пользователя панели>/data/www/<имя сайта>/project_name') - укажите путь к вашему проекту.
2. В строке sys.path.insert(1, '/var/www/<имя пользователя панели>/data/www/<имя сайта>/.venv/lib/python<номер версии>/site-packages') - укажите версию Python, которую вы выбрали при создании сайта.
3. В строке os.environ['DJANGO_SETTINGS_MODULE'] = 'project_name.settings' - измените project_name на название вашего проекта.

Выполните перезапуск Python.

  • перейдите в основное меню;
  • выберите вкладку Сайты;
  • выберите сайт;
  • нажмите на кнопку •••;
  • нажмите кнопку Перезапустить (Python).

В браузере откроется стартовая страница Django.