如何在Ubuntu 18.04上安装Django Web Framework

Django是一个功能齐全的Python Web框架,用于开发动态网站和应用程序。使用Django,您可以快速创建Python Web应用程序,并依靠该框架来完成繁重的工作。 在本指南中,您将在Ubuntu 18.04服务器上启动并运行Django。安装完成后,您将启动一个新项目作为站点的基础。

介绍

Django是一个功能齐全的Python Web框架,用于开发动态网站和应用程序。 使用Django,您可以快速创建Python Web应用程序,并依靠该框架来完成繁重的工作。

在本指南中,您将在Ubuntu 18.04服务器上启动并运行Django。 安装完成后,您将启动一个新项目作为站点的基础。

不同的方法

安装Django有多种方法,具体取决于您的需求以及您希望如何配置开发环境。 它们具有不同的优点,一种方法可能比其他方法更适合您的具体情况。

一些不同的方法包括:

  • 从包中进行全局安装 :官方Ubuntu存储库包含可以与传统的apt包管理器一起安装的Django包。 这很简单,但不如其他一些方法灵活。 此外,存储库中包含的版本可能落后于项目中可用的官方版本。
  • 在虚拟环境中使用pip进行安装 :您可以使用venvvirtualenv等工具为项目创建自包含环境。 虚拟环境允许您在项目目录中安装Django,而不会影响较大的系统,以及其他每个项目的自定义和包。 这通常是使用Django最实用和最值得推荐的方法。
  • 使用git安装开发版本 :如果您希望安装最新的开发版本而不是稳定版本,您可以从Git仓库获取代码。 这是获取最新功能/修复所必需的,可以在您的虚拟环境中完成。 但是,开发版本不具有与更稳定版本相同的稳定性保证。

先决条件

在开始之前,您应该在Ubuntu 18.04服务器上拥有一个具有sudo权限的非root用户。 要进行此设置,请按照我们的Ubuntu 18.04初始服务器设置指南进行操作

从包中全局安装

如果您希望使用Ubuntu存储库安装Django,则该过程非常简单。

首先,使用apt更新本地包索引:

sudo apt update

接下来,检查已安装的Python版本。 默认情况下,18.04附带Python 3.6,您可以通过键入以下内容来验证:

python3 -V

你应该看到这样的输出:

Python 3.6.5

接下来,安装Django:

sudo apt install python3-django

您可以通过键入以下内容来测试安装是否成功:

django-admin --version
1.11.11

这意味着该软件已成功安装。 您可能还注意到Django版本不是最新的稳定版本。 要了解有关如何使用该软件的更多信息,请跳过以了解如何创建示例项目

在虚拟环境中使用pip进行安装

在您的系统上安装Django的最灵活方式是在虚拟环境中。 我们将向您展示如何在我们将使用venv模块创建的虚拟环境中安装Django,这是标准Python 3库的一部分。 此工具允许您创建虚拟Python环境并安装Python包,而不会影响系统的其余部分。 因此,无论是否与其他项目的要求发生冲突,您都可以基于每个项目选择Python包。

让我们从刷新本地包索引开始:

sudo apt update

检查已安装的Python版本:

python3 -V
Python 3.6.5

接下来,让我们从Ubuntu存储库安装pip

sudo apt install python3-pip

安装pip ,您可以使用它来安装venv包:

sudo apt install python3-venv

现在,无论何时启动新项目,都可以为其创建虚拟环境。 首先创建并移动到新的项目目录:

mkdir ~/newproject
cd ~/newproject

接下来,使用与您的Python版本兼容的python命令在项目目录中创建虚拟环境。 我们将调用我们的虚拟环境my_env ,但您应该将其命名为描述性的:

python3.6 -m venv my_env

这将安装独立版本的Python并将pip放入项目目录中的独立目录结构中。 将使用您选择的名称创建一个目录,该目录将保存将安装程序包的文件层次结构。

要将软件包安装到隔离环境中,必须通过键入以下命令将其激活:

source my_env/bin/activate

您的提示应该更改以反映您现在处于虚拟环境中。 它看起来像( my_env )username@hostname:~/newproject$

在新环境中,您可以使用pip来安装Django。 无论你的Python版本如何,当你在虚拟环境中时, pip应该被称为pip 另请注意,您在本地安装时不需要使用sudo

pip install django

您可以键入以下内容来验证安装:

django-admin --version
2.1

请注意,您的版本可能与此处显示的版本不同。

要离开虚拟环境,您需要从系统上的任何位置发出deactivate命令:

deactivate

您的提示应恢复为传统显示。 当您希望再次处理项目时,请通过返回项目目录并激活以下内容来重新激活虚拟环境:

cd ~/newproject
source my_env/bin/activate

开发版使用Git安装

如果您需要Django的开发版本,可以从其Git存储库下载并安装Django。 让我们从虚拟环境中做到这一点。

首先,让我们更新本地包索引:

sudo apt update

检查已安装的Python版本:

python3 -V
Python 3.6.5

接下来,从官方存储库安装pip

sudo apt install python3-pip

安装venv包以创建您的虚拟环境:

sudo apt install python3-venv

下一步是克隆Django存储库。 在发行版之间,此存储库将具有更多最新功能和错误修复,可能会牺牲稳定性。 您可以通过键入以下内容将存储库克隆到主目录中名为~/ django-dev的目录:

git clone git://github.com/django/django ~/django-dev

切换到此目录:

cd ~/django-dev

使用与已安装的Python版本兼容的python命令创建虚拟环境:

python3.6 -m venv my_env

激活它:

source my_env/bin/activate

接下来,您可以使用pip安装存储库。 -e选项将以“可编辑”模式安装,从版本控制安装时这是必需的:

pip install -e ~/django-dev

您可以通过键入以下内容来验证安装是否成功:

django-admin --version
2.2.dev20180802155335

同样,您看到的版本可能与此处显示的版本不匹配。

您现在在虚拟环境中拥有最新版本的Django。

创建示例项目

安装Django后,您就可以开始构建项目了。 我们将讨论如何使用虚拟环境在开发服务器上创建项目并对其进行测试。

首先,为项目创建一个目录并进行更改:

mkdir ~/django-test
cd ~/django-test

接下来,创建您的虚拟环境:

python3.6 -m venv my_env

激活环境:

source my_env/bin/activate

安装Django:

pip install django

要构建项目,可以使用django-adminstartproject命令。 我们将调用我们的项目djangoproject ,但您可以使用其他名称替换它。 startproject将在您当前的工作目录中创建一个目录,其中包括:

  • 一个管理脚本manage.py ,可用于管理各种特定于Django的任务。
  • 包含实际项目代码的目录(与项目同名)。

但是,为了避免有太多嵌套目录,让我们告诉Django将管理脚本和内部目录放在当前目录中(注意结束点):

django-admin startproject djangoproject .

要迁移数据库(此示例默认使用SQLite),我们将使用migrate命令与manage.py 迁移将您对Django 模型所做的任何更改应用于数据库模式。

要迁移数据库,请键入:

python manage.py migrate

您将看到如下输出:

Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying admin.0002_logentry_remove_auto_add... OK
  Applying admin.0003_logentry_add_action_flag_choices... OK
  Applying contenttypes.0002_remove_content_type_name... OK
  Applying auth.0002_alter_permission_name_max_length... OK
  Applying auth.0003_alter_user_email_max_length... OK
  Applying auth.0004_alter_user_username_opts... OK
  Applying auth.0005_alter_user_last_login_null... OK
  Applying auth.0006_require_contenttypes_0002... OK
  Applying auth.0007_alter_validators_add_error_messages... OK
  Applying auth.0008_alter_user_username_max_length... OK
  Applying auth.0009_alter_user_last_name_max_length... OK
  Applying sessions.0001_initial... OK

最后,让我们创建一个管理用户,以便您可以使用Djano管理界面 我们使用createsuperuser命令执行此createsuperuser

python manage.py createsuperuser

系统将提示您输入用户名,电子邮件地址和密码。

在Django设置中修改ALLOWED_HOSTS

要成功测试您的应用程序,您需要修改Django设置中的一个指令。

键入以下命令打开设置文件:

nano ~/django-test/djangoproject/settings.py

在里面,找到ALLOWED_HOSTS指令。 这定义了可用于连接Django实例的地址或域名的白名单。 具有不在此列表中的主机头的传入请求将引发异常。 Django要求您将其设置为防止某类安全漏洞。

在方括号中,列出与Django服务器关联的IP地址或域名。 每个项目都应该在引号中列出,单独的条目用逗号分隔。 如果您需要整个域和任何子域的请求,请在条目的开头添加一个句点:

〜/ django的测试/ djangoproject / settings.py
. . .
ALLOWED_HOSTS = ['your_server_ip_or_domain', 'your_second_ip_or_domain', . . .]

完成后,保存文件并退出编辑器。

测试开发服务器

一旦有了用户,就可以启动Django开发服务器,看看新的Django项目是什么样的。 您应该仅将其用于开发目的。 当您准备部署时,请务必仔细遵循Django的部署指南

在尝试开发服务器之前,请确保在防火墙中打开相应的端口。 如果您按照初始服务器设置指南并使用UFW,则可以通过键入以下命令打开端口8000

sudo ufw allow 8000

启动开发服务器:

python manage.py runserver your_server_ip:8000

访问服务器的IP地址,然后在Web浏览器中访问:8000

http://your_server_ip:8000

你应该看到这样的东西:

Django公共页面

要访问管理界面,请将/admin/添加到URL的末尾:

http://your_server_ip:8000/admin/

这将带您进入登录屏幕:

Django管理员登录

如果您输入刚刚创建的管理员用户名和密码,您将可以访问该站点的主管理员部分:

Django管理页面

有关使用Django管理界面的更多信息,请参阅“如何启用和连接Django管理界面”。

查看完默认站点后,可以通过在终端中键入CTRL-C来停止开发服务器。

您创建的Django项目为设计更完整的站点提供了结构基础。 查看Django文档,了解有关如何构建应用程序和自定义站点的更多信息。

结论

您现在应该在Ubuntu 18.04服务器上安装Django,提供创建功能强大的Web应用程序所需的主要工具。 您还应该知道如何启动新项目并启动开发人员服务器。 利用像Django这样的完整Web框架可以帮助您更快地开发,使您只能专注于应用程序的独特方面。

如果您想了解有关使用Django的更多信息,包括对模型视图等内容的深入讨论,请参阅我们的Django开发系列


分享按钮