如何在 Debian 8 上安装 Django 网络框架

介绍

Django 是一款全功能的 Python 网页框架,用于开发动态网站和应用程序. 使用 Django,您可以快速创建 Python 网页应用程序,并依靠框架来完成大量的重型提升。

在本指南中,我们将向您展示如何在 Debian 8 服务器上安装和运行 Django。

前提条件

在你开始之前,你应该有一个非 root 用户,在你的 Debian 8 服务器上拥有sudo权限. 要设置此功能,请遵循我们的 Debian 8 初始服务器设置指南。

当您准备好继续时,请阅读下方来决定哪种安装方法最适合您的情况。

可用的安装方法

有许多不同的方式,你可以安装Django取决于你的需求和你想要如何配置你的开发环境. 这些有不同的优点,一种方法可能比其他人更适合你的特定情况。

以下几种不同的方法:

• ** [从软件包全球安装] (# 从软件包全球安装) ** : Debian官方寄存器内有Django软件包,可以很容易地安装在传统的 " apt " 软件包管理器上。 这非常简单,但不像其他方法那样灵活。 此外,储存库中的版本可能落后于项目提供的正式版本。
• ** [通过 pip 全球安装] (# global-install- through- pip) ** : pip'工具是Python软件包的软件包管理器。 如果您安装了 pip ` , 您可以轻松地在系统级别上安装 Django, 供任何用户使用 。 这应始终包含最新的稳定释放。 即使如此,全球设施本身也不太灵活。
• ** [在Virtualenv中安装管道] (#virtualenv-install- through-pip) ** : Python `virtualenv'软件包允许您为各种项目创建自成一体的环境。 使用这一技术,可以在项目目录中安装Django而不影响系统级软件包. 这使得您可以方便地提供每个项目的定制和包. 与全球无障碍安装相比,虚拟环境增加了一些轻微的精神和工艺间接费用,但提供了最大的灵活性。
• ** [开发版本通过 git 安装] (# development-version-install-over- git) ** : 如果您想要安装最新的开发版本而不是稳定的发布,您必须从git repo中获取代码。 这可能是获得最新特征/固定设备所必需的,并且可以在全球或当地进行。 然而,发展版本没有同样的稳定性保障。 (英语)

考虑到上述警告和品质,请从下面的指示中选择最适合您的安装方法。之后,请务必查看 创建样本项目的部分,以了解如何开始。

全球安装从包裹

如果你想使用 Debian 存储库来安装 Django,这个过程非常简单。

首先,更新您的本地包索引以apt:

1sudo apt-get update

接下来,选择您想与 Django 一起使用的 Python 版本。

1sudo apt-get install python-django

如果您想与 Django 一起使用 Python 3 ,请输入:

1sudo apt-get install python3-django

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

1django-admin --version

1[secondary_label Output]
21.7.11

这意味着软件已成功安装,您还可能会注意到Django版本不是最新的稳定版本。 要了解如何使用该软件,请跳过前去学习 如何创建样本项目。

全球安装通过PIP

如果您想在全球范围内安装最新版本的Django,更好的选择是使用Python包管理器的pip。首先,我们需要安装pip包管理器。

1sudo apt-get update

现在,您可以安装相应的软件包并完成安装,您需要的软件包和命令取决于您计划在项目中使用的 Python 版本。

Python 二

如果您打算继续使用Python 2,请使用以下命令安装Python包管理器pip:

1sudo apt-get install python-pip

现在你有pip,你可以轻松地通过键入来安装Django:

1sudo pip install django

您可以通过键入来验证安装成功:

1django-admin --version

1[secondary_label Output]
21.10.4

正如你所看到的,通过pip提供的版本比来自 Debian 存储库的版本更为更新(你的版本可能与上面的版本有所不同)。

Python 3 使用

如果您打算使用 Python 3 ,请使用以下命令安装pip:

1sudo apt-get install python3-pip

接下来,我们可以利用pip包管理器来通过键入安装Django:

1sudo pip3 install django

要验证安装是否正确完成,请键入:

1django-admin --version

1[secondary_label Output]
21.10.4

通过pip安装的版本应该是最新稳定版本(具体版本可能与上面显示的版本不同)。

Virtualenv 通过 pip 安装

也许在您的系统上安装Django的最灵活的方式是使用virtualenv工具,这个工具允许您创建虚拟Python环境,在那里您可以安装您想要的任何Python包,而不会影响系统的其他部分。

我们将首先从 Debian 存储库中安装pip。在开始之前,请刷新本地包索引:

1sudo apt-get update

安装 Django 所需的包和命令取决于您希望为您的项目使用的 Python 版本。

Python 二

第一个步骤是全球安装pip。当使用Python 2时,执行的命令是:

1sudo apt-get install python-pip

一旦安装了pip,您可以通过键入以下方式使用它来安装virtualenv包:

1sudo pip install virtualenv

现在,每次你开始一个新项目,你可以为它创建一个虚拟环境. 开始创建并移动到一个新的项目目录:

1mkdir ~/projectname
2cd ~/projectname

现在,通过键入项目目录中创建虚拟环境:

1virtualenv venv

这将安装一个独立的Python版本,以及pip,在您的项目目录中一个孤立的目录结构中。我们选择将我们的虚拟环境称为venv,但您可以命名为描述性的东西。

要将包装安装到隔离环境中,您必须通过键入:

1cd ~/projectname
2source venv/bin/activate

你的提示应该改变以反映你现在在你的虚拟环境. 它将看起来像 (venv)username@hostname:~/projectname$。

在你的新环境中,你可以使用pip来安装Django。你不需要使用sudo,因为你正在本地安装:

1pip install django

您可以通过键入来验证安装:

1django-admin --version

1[secondary_label Output]
21.10.4

正如你所看到的,Django已安装在虚拟环境中。

<$>[注] 注: 要退出虚拟环境,请从系统中的任何地方发出禁用命令:

1deactivate

您的提示应返回常规显示。

当您想要再次工作时,您应该通过返回项目目录并激活以下方式来重新激活虚拟环境:

1cd ~/projectname
2source venv/bin/activate

美元

Python 3 使用

第一步是在全球范围内安装pip。使用Python 3来执行此操作,请键入:

1sudo apt-get install python3-pip

接下来,使用您刚刚安装的软件包管理器来安装virtualenv Python 包:

1sudo pip3 install virtualenv

接下来,创建一个虚拟环境来存储新项目的包. 开始创建并移动到新项目目录:

1mkdir ~/projectname
2cd ~/projectname

在项目目录中创建虚拟环境,键入:

1virtualenv venv

这将将安装一个独立的Python版本,以及pip,在您的项目目录中一个孤立的目录结构中。将创建一个目录,名称作为一个论点。我们在这里选择了venv。

在将包安装到虚拟环境之前,您必须通过键入:

1cd ~/projectname
2source venv/bin/activate

您的命令提示现在应该以虚拟环境的名称为前缀,它将看起来像(venv)username@hostname:~/projectname$。

在你的新环境中,使用pip来安装Django. 请注意,即使我们使用Python 3,虚拟环境中的命令是pip(而不是pip3). 另外,请注意,你不需要使用sudo,因为你在本地安装:

1pip install django

您可以通过键入来验证安装:

1django-admin --version

1[secondary_label Output]
21.10.4

正如你所看到的,Django已安装在虚拟环境中。

<$>[注] 注: 要退出虚拟环境,请从系统中的任何地方发出禁用命令:

1deactivate

您的提示应返回常规显示。

当您想要再次工作时,您应该通过返回项目目录并激活以下方式来重新激活虚拟环境:

1cd ~/projectname
2source venv/bin/activate

美元

开发版通过Git安装

如果您需要开发版本的Django,您将需要从项目的git存储库下载和安装Django。

要做到这一点,您将首先在您的系统上安装git以apt。我们还需要pip,用于从下载的源代码中安装。包名称和命令取决于您计划使用的Python版本。

Python 二

如果您正在使用 Python 2,您可以通过键入更新您的包索引并安装所需的包:

1sudo apt-get update
2sudo apt-get install git python-pip

一旦你有git,你可以克隆Django存储库。在发布之间,这个存储库将有更多最新的功能和错误修复,以可能的稳定性为代价。你可以将该存储库克隆到一个名为django-dev的目录里,在你的主目录中键入:

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

一旦存储库被克隆,您可以使用pip来安装它. 我们将使用e选项来安装在可编辑模式中,这在从版本控制中安装时是必要的。

1sudo pip install -e ~/django-dev

您可以通过键入来验证安装成功:

1django-admin --version

1[secondary_label Output]
21.11.dev20161220175814

请记住,如果你想在一个环境中安装Django的开发版本,你可以将这个策略与virtualenv相结合。

Python 3 使用

如果您正在使用 Python 3 ,请更新您的包索引并通过键入安装git和pip:

1sudo apt-get update
2sudo apt-get install git python3-pip

接下来,您可以将Django存储库克隆到您的主目录中的名为django-dev的目录中,键入:

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

您可以直接从git目录中安装Django,使用pip。-e选项允许我们在可编辑模式下安装Django,这在安装从版本控制库时是必要的:

1sudo pip3 install -e ~/django-dev

您可以通过键入来验证安装成功:

1django-admin --version

1[secondary_label Output]
21.11.dev20161220175814

如果您希望在孤立的环境中安装开发版本,则可以将此策略与virtualenv策略相结合。

创建一个样本项目

一旦你安装了Django,我们可以告诉你如何开始一个项目。

创建项目基础

使用django-admin命令创建一个项目,在当前的目录中创建一个名为projectname的目录,在这个新的目录中创建一个管理脚本,另一个名为projectname的目录将与实际代码一起创建。

<$>[注] 注: 如果您已经创建了使用virtualenv命令的母项目目录,您可以告诉Django将管理脚本和内部目录直接放入现有目录,这将有助于避免额外的项目目录层。

1cd ~/projectname
2source venv/bin/activate
3django-admin startproject projectname .

请注意命令末尾的终点。 <$>

若要创建完整的目录结构(家长项目目录、管理脚本和内部项目目录),请键入:

1django-admin startproject projectname
2cd projectname

要启动数据库(默认情况下使用 SQLite),键入:

1./manage.py migrate

接下来,通过键入创建一个管理用户:

1./manage.py createsuperuser

您将被要求为用户选择用户名、电子邮件地址和密码。

在 Django 设置中更改 ALLOWED_HOSTS

在您可以测试您的应用程序之前,您需要修改 Django 设置中的指令之一。

通过键入打开设置文件:

1nano ~/projectname/projectname/settings.py

在内部,查找ALLOWED_HOSTS指令。这定义了可以用于连接到Django实例的地址或域名的白列表。任何未列入此列表的 Host 标题的输入请求都会引发一个例外。

在方块中,列出与您的 Django 服务器相关的 IP 地址或域名。每个项目都应该列出 在报价中 与条目分开的条目 ** 。如果您想响应域和任何子域的请求,请预先预定一个期限,直到条目开始。

1[label ~/myproject/myproject/settings.py]
2. . .
3# The simplest case: just add the domain name(s) and IP addresses of your Django server
4# ALLOWED_HOSTS = [ 'example.com', '203.0.113.5']
5# To respond to 'example.com' and any subdomains, start the domain with a dot
6# ALLOWED_HOSTS = ['.example.com', '203.0.113.5']
7ALLOWED_HOSTS = ['your_server_domain_or_IP', 'second_domain_or_IP', . . .]

完成后,保存并关闭文件。

测试您的开发服务器

接下来,启动 Django 开发服务器,看看新鲜的 Django 项目会是什么样子。

<$>[注] 注: 在尝试开发服务器之前,请确保在防火墙中打开端口。

如果你正在运行一个ufw防火墙,你可以通过键入打开相应的端口:

1sudo ufw allow 8000

如果您正在运行iptables防火墙,您需要的确切命令取决于当前的防火墙配置。

1sudo iptables -I INPUT -p tcp --dport 8000 -j ACCEPT

美元

通过键入启动开发服务器:

1~/projectname/manage.py runserver 0.0.0.0:8000

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

1http://server_ip_address:8000

你应该看到一些看起来像这样的东西:

现在,添加/admin到您的URL的末尾,进入管理员登录页面:

1server_ip_address:8000/admin

如果你输入你刚刚创建的 admin 用户名和密码,你应该被带到网站的 admin 部分:

当您完成浏览默认网站时,您可以通过在终端中键入CTRL-C来阻止开发服务器。

您创建的 Django 项目为设计一个更完整的网站提供了结构基础. 查看 Django 文档 有关如何构建应用程序和定制您的网站的更多信息。

结论

您现在应该在 Debian 8 服务器上安装 Django,提供您创建强大的 Web 应用程序所需的主要工具,您还应该知道如何启动新项目并启动开发人员服务器。