Как установить django без интернета

Обновлено: 08.07.2024

Django - это веб-фреймворк Python. См. Какую версию Python можно использовать с Django? для подробностей.

Python в Windows

Если вы только начинаете работать с Django и используете Windows, вы можете найти Как установить Django в Windows полезным.

О pip ¶

pip - это менеджер пакетов для Python, который по умолчанию включен в установщик Python. Он помогает устанавливать и удалять пакеты Python (например, Django!). В остальной части установки мы будем использовать pip для установки пакетов Python из командной строки.

Общие проблемы ¶

Если django-admin отображается только текст справки независимо от указанных параметров, вероятно, проблема с ассоциациями файлов в Windows. Проверьте, определено ли несколько переменных среды для запуска скриптов Python в PATH . Обычно это происходит, когда установлено несколько версий Python.

Если вы используете прокси-сервер для подключения к Интернету, при выполнении команды могут возникнуть проблемы . Задайте переменные среды конфигурации прокси-сервера в командной строке, например: py -m pip install Django

Цель этого документа - подготовить вас к работе с Django.

Установка Python ¶

Django - это веб-приложение для Python, поэтому в системе должен быть установлен Python. На момент написания этого руководства Python 3.8 - самая последняя версия.

После установки откройте командную строку и убедитесь, что версия Python соответствует той, которую вы установили, запустив:

Установка Apache и mod_wsgi ¶

Если вы просто хотите поэкспериментировать с Django, переходите к следующему разделу; Django включает легкий веб-сервер, который вы можете использовать для тестирования, поэтому нет необходимости настраивать Apache, пока вы не захотите развернуть Django в производственной среде.

Если вы хотите использовать Django на рабочем сайте, используйте Apache с mod_wsgi., mod_wsgi работает в двух режимах: встроенный режим и режим демона. Во встроенном режиме mod_wsgi сравним с mod_perl, он интегрирует Python в Apache и загружает код Python в память при запуске сервера. Код остается в памяти на протяжении всего жизненного цикла процесса Apache, обеспечивая значительное улучшение производительности по сравнению с другими конфигурациями. В режиме демона mod_wsgi делегирует управление запросами независимому процессу демона. Этот процесс может выполняться под другим именем пользователя, чем веб-сервер, что может повысить безопасность. С другой стороны, процесс можно перезапустить без перезапуска всего веб-сервера Apache, что может упростить обновление кода. Обратитесь к документации mod_wsgi, чтобы определить, какой режим лучше всего подходит для вас. Убедитесь, что Apache установлен и его модуль mod_wsgi включен. Django работает с любой версией Apache, которая поддерживает mod_wsgi.

См. Как использовать Django с mod_wsgi для получения дополнительной информации о том, как настроить mod_wsgi после его установки.

Если у вас нет возможности использовать mod_wsgi, не отчаивайтесь: Django поддерживает множество других сценариев развертывания. Один из них - uWSGI ; он отлично работает с nginx . Кроме того, Django следует спецификации WSGI ( PEP 3333 ), что позволяет ему работать на различных серверных платформах.

Настройка виртуальной среды ¶

Общепризнанной хорошей практикой является определение специальной среды для каждого создаваемого вами проекта Django. В экосистеме Python есть много вариантов управления средами и пакетами, некоторые из которых рекомендованы в документации Python . Сам Python содержит venv для управления средами, и именно его мы будем использовать в этом руководстве.

Чтобы создать виртуальную среду для вашего проекта, откройте новую командную строку и перейдите в папку, в которой вы хотите создать проект, затем введите следующее

Это создаст папку с именем «имя-проекта», если она еще не существует, и настроит виртуальную среду. Чтобы активировать среду, запустите

Виртуальная среда будет активирована, и вы увидите «(имя-проекта)» рядом с командной строкой, чтобы убедить вас. Каждый раз, когда вы запускаете новую командную строку, вам нужно будет снова активировать среду.

Начало работы с базой данных ¶

Если вы планируете использовать функции базы данных Django, вы должны предпринять шаги, чтобы сделать базу данных работоспособной. Django умеет управлять несколькими разными серверами баз данных; официально он поддерживает PostgreSQL , MariaDB , MySQL , Oracle и SQLite .

Если вы разрабатываете небольшой проект или что-то, что не планируете развертывать в производственной среде, SQLite обычно является лучшим вариантом, поскольку для него не требуется отдельный сервер. Однако SQLite имеет много отличий от других баз данных, и если вы работаете над более крупным проектом, рекомендуется разрабатывать с той же базой данных, которая будет использоваться в производстве.

Помимо официально поддерживаемых баз данных, существуют внешние по отношению к Django механизмы, которые позволяют использовать другие базы данных с Django.

В дополнение к ядру базы данных также необходимо проверить, установлены ли привязки Python для базы данных.

  • Если вы используете PostgreSQL, вам понадобится пакет psycopg2 . Более подробную информацию вы можете найти в Примечаниях к PostgreSQL .
  • Если вы используете MySQL или MariaDB, вам понадобится драйвер API базы данных, например mysqlclient . См. Примечания к MySQL для более подробной информации.
  • Если вы используете SQLite, рекомендуется прочитать примечания к SQLite Engine .
  • Если вы используете Oracle, вам понадобится копия cx_Oracle , но, пожалуйста, прочтите специальные примечания для Oracle Database Engine для получения подробной информации о поддерживаемых версиях Oracle и cx_Oracle .
  • Если вы используете неофициальный внешний движок, обратитесь к сопроводительной документации, чтобы узнать о возможных дополнительных ограничениях.

Если вы планируете использовать команду Django для автоматического создания таблиц базы данных для ваших моделей (после завершения установки Django и создания проекта), вам необходимо убедиться, что у Django есть разрешения на создание. и изменить таблицы в базе данных, которую вы используете; если вы думаете , что вы вручную создать таблицы, вы можете назначить права доступа к Джанго , , и . После создания пользователя базы данных с этими разрешениями встанет вопрос об указании деталей подключения в файле настроек вашего проекта, подробнее см . manage.py migrate SELECT INSERT UPDATE DELETE DATABASES

Если вы используете тестовую инфраструктуру Django для тестирования запросов к базе данных, Django потребуются необходимые разрешения для создания тестовой базы данных.

Запустите свою базу данных ¶

Если вы планируете использовать функции API базы данных Django, вам необходимо убедиться, что сервер базы данных работает. Django поддерживает множество различных серверов баз данных и официально поддерживается PostgreSQL , MariaDB , MySQL , Oracle и SQLite .

Если вы разрабатываете небольшой проект или что-то, что не планируете развертывать в производственной среде, SQLite, как правило, является лучшим вариантом, поскольку не требует запуска отдельного сервера. Однако SQLite имеет много отличий от других баз данных, поэтому, если вы работаете над чем-то существенным, рекомендуется разрабатывать ту же базу данных, которую вы планируете использовать в производственной среде.

В дополнение к официально поддерживаемым базам данных существуют сторонние серверы , позволяющие использовать другие базы данных с Django.

В дополнение к бэкэнду базы данных вам необходимо убедиться, что ваши привязки к базе данных Python установлены.

  • Если вы используете PostgreSQL, вам понадобится пакет psycopg2 . Дополнительные сведения см. В примечаниях PostgreSQL .
  • Если вы используете MySQL или MariaDB, вам понадобится драйвер API БД, например mysqlclient . См. Подробности в примечаниях к бэкэнду MySQL .
  • Если вы используете SQLite, возможно, вы захотите прочитать примечания к серверной части SQLite .
  • Если вы используете Oracle, вам понадобится копия cx_Oracle , но, пожалуйста, прочтите примечания кбэкэндуOracle для получения подробной информации о поддерживаемых версиях Oracle и cx_Oracle .
  • Если вы используете неофициальный серверный модуль стороннего производителя, ознакомьтесь с предоставленной документацией, чтобы узнать о дополнительных требованиях.

Если вы планируете использовать команду Django для автоматического создания таблиц базы данных для ваших моделей (после первой установки Django и создания проекта), вам необходимо убедиться, что Django имеет разрешение на создание и изменение таблиц в базе данных, которую вы используете; если вы планируете вручную создать таблицы, вы можете предоставить Django , , и разрешение. После создания пользователя базы данных с этими разрешениями вы укажете детали в файле настроек вашего проекта, подробности см. В разделе . manage.py migrate SELECT INSERT UPDATE DELETE DATABASES

Если вы используете платформу тестирования Django для тестирования запросов к базе данных, Django потребуется разрешение на создание тестовой базы данных.

Установка Django ¶

Django можно легко установить pip в вашей виртуальной среде.

В командной строке убедитесь, что виртуальная среда активна, и выполните следующую команду:

Это загрузит и установит последнюю версию Django.

В конце установки вы можете проверить, что все прошло успешно, запустив в командной строке. django-admin --version

См. « Начало работы с базой данных» для получения дополнительной информации об установке баз данных с помощью Django.

Установка Python ¶

Django - это веб-фреймворк Python. См. Какую версию Python можно использовать с Django? Больше подробностей.

Python в Windows

Если вы новичок в Django и используете Windows, эта документация может быть полезна: Как установить Django с Windows .

Установите Apache и mod_wsgi ¶

Если вы просто хотите поэкспериментировать с Django, переходите к следующему разделу; Django включает в себя легкий веб-сервер, который вы можете использовать для тестирования, поэтому вам не нужно настраивать Apache, пока вы не будете готовы развернуть Django в производственной среде.

Если вы хотите использовать Django на рабочем сайте, используйте Apache с mod_wsgi.. mod_wsgi работает в одном из двух режимов: встроенном режиме или режиме демона. Во встроенном режиме mod_wsgi похож на mod_perl - он встраивает Python в Apache и загружает код Python в память при запуске сервера. Код остается в памяти на протяжении всего времени существования процесса Apache, что приводит к значительному увеличению производительности по сравнению с другими серверными механизмами. В режиме демона mod_wsgi порождает независимый процесс-демон, который обрабатывает запросы. Процесс-демон может работать не от веб-сервера, а от имени другого пользователя, что может привести к повышению безопасности. Процесс демона можно перезапустить без перезапуска всего веб-сервера Apache, что, возможно, упростит обновление вашей кодовой базы. Обратитесь к документации mod_wsgi, чтобы определить, какой режим подходит для вашей установки. Убедитесь, что у вас установлен Apache с активированным модулем mod_wsgi.

См. Как использовать Django с mod_wsgi для получения информации о том, как настроить mod_wsgi после его установки.

Если по какой-то причине вы не можете использовать mod_wsgi, не бойтесь: Django поддерживает множество других вариантов развертывания. Один из них - uWSGI ; он очень хорошо работает с nginx . Кроме того, Django следует спецификации WSGI ( PEP 3333 ), что позволяет ему работать на различных серверных платформах.

Установите код Django ¶

Инструкции по установке немного отличаются в зависимости от того, устанавливаете ли вы пакет для конкретного дистрибутива, загружаете последний официальный выпуск или загружаете последнюю версию для разработки.

Установка официального выпуска с pip ¶

Это рекомендуемый способ установки Django.

Установите pip . Самый простой - использовать автономный установщик pip . Если ваш дистрибутив уже pip установлен, вам может потребоваться обновить его, если он устарел. Если он устарел, вы узнаете, потому что установка не будет работать.

Взгляните на venv . Этот инструмент предоставляет изолированные среды Python, которые более практичны, чем установка пакетов в масштабе всей системы. Он также позволяет устанавливать пакеты без прав администратора. В дополнительном руководстве рассказывается, как создать виртуальную среду.

После того, как вы создали и активировали виртуальную среду, введите команду:

Установка пакета для конкретного дистрибутива ¶

Ознакомьтесь с примечаниями к конкретному дистрибутиву, чтобы узнать, предоставляет ли ваша платформа / дистрибутив официальные пакеты / установщики Django. Пакеты, предоставляемые распространением, обычно позволяют автоматически устанавливать зависимости и поддерживаемые пути обновления; однако эти пакеты редко содержат последнюю версию Django.

Установка разрабатываемой версии ¶

Отслеживание разработки Django

Если вы решите использовать последнюю разрабатываемую версию Django, вам нужно обратить пристальное внимание на график разработки и следить за примечаниями к выпуску для предстоящего выпуска . Это поможет вам оставаться в курсе любых новых функций, которые вы, возможно, захотите использовать, а также любых изменений, которые вам нужно будет внести в свой код при обновлении вашей копии Django. (Для стабильных выпусков все необходимые изменения документируются в примечаниях к выпуску.)

Если вы хотите иметь возможность периодически обновлять свой код Django, добавляя последние исправления ошибок и улучшения, следуйте этим инструкциям:

Убедитесь, что у вас установлен Git и вы можете запускать его команды из оболочки. (Введите в командной строке, чтобы проверить это.) git help

Посмотрите основную ветку разработки Django, например:

Это создаст каталог django в вашем текущем каталоге.

Убедитесь, что интерпретатор Python может загружать код Django. Самый удобный способ сделать это - использовать виртуальную среду и pip . В дополнительном руководстве рассказывается, как создать виртуальную среду.

После настройки и активации виртуальной среды выполните следующую команду:

Это сделает код Django доступным для импорта, а также сделает django-admin доступной служебную команду. Другими словами, все готово!

Если вы хотите обновить свою копию исходного кода Django, запустите команду из каталога. Когда вы это сделаете, Git загрузит все изменения. git pull django

Я ищу для установки django-расширений и их зависимостей (особенно шести), не попав в интернет. У меня есть tarballs для django-extensions и six, поэтому я могу установить офлайн. Тем не менее, я вижу в своих журналах, что первая попытка пытается найти шесть на pypi, прежде чем проверять локально. Вместо этого я хочу заставить установщика никогда не проверять pypi.

Выход журнала (это до того, как я загрузил шесть архивов, поэтому, пожалуйста, проигнорируйте ошибку локальных пакетов)

Этот документ проведет вас через установку Python 3.8 и Django для Windows. Он также содержит инструкции по настройке виртуальной среды, упрощающей работу над проектами Python. Цель состоит в том, чтобы сделать его введением для пользователей, работающих над проектами Django, а не описать, как установить Django, чтобы вы могли разработать исправления для самого Django.

Действия, описанные в этом руководстве, были протестированы с Windows 10. Для других версий инструкции должны быть аналогичными. Вам должно быть удобно использовать командную строку Windows.

Установка Django кода ¶

Инструкции по установке немного отличаются в зависимости от того, устанавливаете ли вы пакет из своего дистрибутива, загружаете последнюю официальную версию или получаете последнюю версию в разработке.

Установка официальной версии с ¶

Это рекомендуемый способ установки Django.

Установите pip . Самый простой способ - использовать автономный установщик pip . Если в вашем дистрибутиве уже установлена ​​версия pip , возможно, потребуется обновить ее, если она слишком старая. В этом случае вы увидите это, потому что установка не будет работать.

Взгляните на venv . Этот инструмент предоставляет изолированные среды Python, которые намного удобнее, чем установка общесистемных пакетов. Он также позволяет устанавливать пакеты без прав администратора. Учебник вклад проведет вас через создание виртуальной среды.

После создания и активации виртуальной среды введите команду:

Установка пакета из дистрибутива ¶

Просмотрите примечания к дистрибутиву, чтобы убедиться, что ваша платформа / дистрибутив предлагает официальные пакеты или установщики Django. Пакеты, предоставляемые дистрибутивами, обычно позволяют использовать автоматическую установку поддерживаемых зависимостей и обновлений; однако эти пакеты редко соответствуют последним версиям Django.

Установка разрабатываемой версии ¶

Мониторинг разработки Django

Если вы решите использовать последнюю разрабатываемую версию Django, рекомендуется внимательно следить за процессом разработки, а также за примечаниями к выпуску следующей версии . Это поможет вам оставаться в курсе любых новых функций, которые вы можете использовать, или изменений, которые вам нужно будет внести в свой код при обновлении вашей копии Django (для стабильных выпусков любые необходимые изменения документируются в примечания к выпуску).

Если вы хотите иметь возможность время от времени обновлять свою версию Django, добавляя последние исправления и улучшения, следуйте этим инструкциям:

Убедитесь, что Git установлен и вы можете запускать его команды с терминала (введите в командной строке, чтобы проверить его). git help

Создайте рабочую копию основной ветки разработки Django следующим образом:

Каталог django будет создан в текущем каталоге.

Убедитесь, что интерпретатор Python может загружать код из Django. Самый удобный способ сделать это - использовать виртуальную среду и pip . Учебник вклад проведет вас через создание виртуальной среды.

После настройки и активации виртуальной среды выполните следующую команду:

Это сделает код Django импортируемым, а также предоставит служебную команду django-admin . Другими словами, все будет готово!

Если вы хотите обновить свою копию исходного кода Django, введите команду из каталога . Когда вы это сделаете, Git загрузит все изменения. git pull django

Читайте также: