在 Ubuntu 22.04 上安装 Django Web 框架的方法

简介

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

在本指南中，您将在 Ubuntu 22.04 服务器上启动 Django。安装完成后，您将启动一个新项目，作为您网站的基础。

不同的安装方法

根据您的需求和如何配置开发环境，安装 Django 有不同的方法。这些方法各有优势，其中一种方法可能比其他方法更适合您的特定情况。

一些不同的安装方法包括：

• 从软件包全局安装：官方的 Ubuntu 软件仓库中包含了 Django 软件包，可以使用传统的 apt 软件包管理器进行安装。这种方法简单，但不如其他方法灵活。此外，仓库中包含的版本可能落后于项目官方提供的官方版本。
• 在虚拟环境中使用 pip 安装：您可以使用 venv 和 virtualenv 等工具在项目目录中创建一个独立的环境。虚拟环境允许您在项目目录中安装 Django，而不会影响更大的系统，同时还可以进行其他项目定制和包的安装。这通常是使用 Django 的最实用和推荐的方法。
• 使用 git 安装开发版本：如果您希望安装最新的开发版本而不是稳定版本，可以从 Git 仓库获取代码。这是获取最新功能/修复的必要步骤，并且可以在您的虚拟环境中完成。然而，开发版本不具有与更稳定版本相同的稳定性保证。

先决条件

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

从软件包全局安装

如果您希望使用 Ubuntu 软件仓库安装 Django，则该过程非常简单。

首先，使用 apt 更新本地软件包索引：

sudo apt update

接下来，检查您安装了哪个版本的 Python。22.04 默认安装了 Python 3.10，您可以通过输入以下命令进行验证：

python3 -V

您应该会看到如下输出：

Python 3.10.4

接下来，安装 Django：

sudo apt install python3-django

您可以通过输入以下命令来测试安装是否成功：

django-admin --version

3.2.12

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

在虚拟环境中使用 pip 安装

在系统中安装 Django 最灵活的方式是在虚拟环境中进行。我们将向您展示如何在使用 venv 模块创建的虚拟环境中安装 Django。venv 是 Python 3 标准库的一部分，允许您创建虚拟 Python 环境并安装 Python 包，而不会影响系统的其他部分。因此，您可以在项目基础上选择 Python 包，而不受其他项目需求的影响。

让我们首先刷新本地软件包索引：

sudo apt update

检查您安装了哪个版本的 Python：

python3 -V

Python 3.10.4

接下来，让我们从 Ubuntu 软件仓库安装 pip 和 venv：

sudo apt install python3-pip python3-venv

现在，每当您启动一个新项目时，您都可以为其创建一个虚拟环境。首先创建并进入一个新的项目目录：

mkdir ~/newproject
cd ~/newproject

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

python3 -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

4.0.4

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

要离开虚拟环境，您需要在系统的任何位置发出 deactivate 命令：

deactivate

您的提示符应该会恢复到常规显示。当您希望再次处理项目时，请通过返回到项目目录并激活来重新激活您的虚拟环境：

cd ~/newproject
source my_env/bin/activate

使用 Git 安装开发版本

如果你需要安装 Django 的开发版本，你可以从它的 Git 仓库中下载并安装 Django。让我们在虚拟环境中进行这个操作。

首先，让我们更新本地软件包索引：

sudo apt update

检查你已安装的 Python 版本：

python3 -V

Python 3.10.4

接下来，从官方仓库安装 pip 和 venv：

sudo apt install python3-pip python3-venv

下一步是克隆 Django 仓库。在发布之间，该仓库将具有更新的功能和可能牺牲稳定性的 bug 修复。你可以通过以下命令将仓库克隆到名为 ~/django-dev 的目录中：

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

切换到该目录：

cd ~/django-dev

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

python3 -m venv my_env

激活它：

source my_env/bin/activate

接下来，你可以使用 pip 安装仓库。-e 选项将以 “可编辑” 模式安装，这在从版本控制安装时是必需的：

pip install -e ~/django-dev

你可以通过输入以下命令来验证安装是否成功：

django-admin --version

4.0.4.2

再次说明，你看到的版本可能与此处显示的不匹配。

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

创建一个示例项目

安装了 Django 后，你可以开始构建你的项目。我们将介绍如何使用虚拟环境创建一个项目并在开发服务器上测试它。

首先，创建一个用于项目的目录并切换到该目录：

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

接下来，创建你的虚拟环境：

python3 -m venv my_env

激活该环境：

source my_env/bin/activate

安装 Django：

pip install django

要构建你的项目，你可以使用 django-admin 的 startproject 命令。我们将称我们的项目为 djangoproject，但你可以用其他名称替换它。startproject 将在当前工作目录中创建一个包含以下内容的目录：

• 一个管理脚本 manage.py，你可以用它来管理各种特定于 Django 的任务。
• 一个目录（与项目同名），其中包含实际的项目代码。

然而，为了避免有太多嵌套的目录，让我们告诉 Django 将管理脚本和内部目录放在当前目录中（注意末尾的点）：

django-admin startproject djangoproject .

要迁移数据库（此示例默认使用 SQLite），让我们使用 manage.py 的 migrate 命令。迁移将应用你对 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 auth.0010_alter_group_name_max_length... OK
  Applying auth.0011_update_proxy_permissions... OK
  Applying auth.0012_alter_user_first_name_max_length... OK
  Applying sessions.0001_initial... OK

最后，让我们创建一个管理员用户，这样你就可以使用 Django 管理界面。我们可以使用 createsuperuser 命令来完成这个操作：

python manage.py createsuperuser

系统会提示你输入用户名、电子邮件地址和用户的密码。

修改 Django 设置中的 ALLOWED_HOSTS

为了成功测试你的应用程序，你需要修改 Django 设置中的一个指令。

通过输入以下命令打开设置文件：

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

在文件中找到 ALLOWED_HOSTS 指令。这个指令定义了可以用于连接到 Django 实例的地址或域名列表。如果一个带有 Host 头的请求不在这个列表中，将会引发异常。Django 要求你设置这个值以防止一定类别的安全漏洞。

在方括号中，列出与你的 Django 服务器相关的 IP 地址或域名。每个条目应该用引号括起来，不同的条目之间用逗号分隔。如果你想要针对整个域和任何子域的请求，需要在条目的开头加上一个句点：

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 地址后面加上 :8000：

http://your_server_ip:8000

你应该会看到类似下面的内容：

!Django public page

要访问管理界面，将 /admin/ 添加到你的 URL 末尾：

http://your_server_ip:8000/admin/

这将带你到一个登录界面：

!Django admin login

如果你输入刚刚创建的管理员用户名和密码，你将可以访问站点的主要管理部分：

!Django admin page

要了解更多关于使用 Django 管理界面的信息，请参阅 “如何启用和连接 Django 管理界面”。

当你完成查看默认站点后，可以在终端中输入 CTRL-C 来停止开发服务器。

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

结论

现在你应该在你的 Ubuntu 22.04 服务器上安装了 Django，提供了创建强大的 Web 应用程序所需的主要工具。你还应该知道如何启动一个新项目并启动开发服务器。利用像 Django 这样完整的 Web 框架可以帮助加快开发速度，让你只专注于应用程序的独特方面。