Django allowed_hosts|极客教程

Django allowed_hosts

1. 简介

在进行 Django 开发中，经常会遇到 “Disallowed Host” 的错误。这个错误是由 Django 的安全机制引起的，用于防止恶意请求的访问。本文将详细介绍 Django 的 allowed hosts（允许的主机）相关内容，包括什么是 allowed hosts、为什么需要配置 allowed hosts、如何设置 allowed hosts 等。

2. 什么是 Allowed Hosts？

Allowed hosts 是 Django 中的一个安全设置，用于指定允许访问 Django 网站的主机名（或 IP 地址）。只有在 allowed hosts 列表中的主机才可以正常访问 Django 应用程序，其他主机则会被视为不允许的主机。

具体而言，当使用 runserver 开发服务器运行 Django 应用程序时，Django 会检查传入的 HTTP 请求的 “Host” 头部。如果 “Host” 头部的值不在 allowed hosts 列表中，就会抛出一个 DisallowedHost 异常，同时返回状态码为 400 Bad Request。同样，当使用生产服务器部署 Django 应用程序时，也会进行 allowed hosts 的检查。

3. 为什么需要配置 Allowed Hosts？

配置 Allowed Hosts 的目的是确保只有可信任的主机可以访问 Django 应用程序。默认情况下，Django 的 settings.py 文件中没有配置 Allowed Hosts，这样会导致任何主机都可以访问应用程序。然而，在实际部署中，我们通常需要限制只有我们信任的主机可以与应用程序进行交互，以提高应用程序的安全性。

未配置 Allowed Hosts 的情况下，如果有人知道了我们的应用程序地址，并尝试通过直接发送 HTTP 请求来访问应用程序，那么 Django 会拒绝这些请求并抛出 DisallowedHost 异常。这个安全特性可以有效地防止未经授权的访问。

4. 如何配置 Allowed Hosts？

要配置 Allowed Hosts，我们需要在 Django 项目的 settings.py 文件中进行设置。具体而言，我们需要在该文件中找到 ALLOWED_HOSTS 变量，并将想要允许的主机添加到该列表中。

以下是一个示例的 settings.py 文件中的 Allowed Hosts 配置：

# settings.py
ALLOWED_HOSTS = ['example.com', 'www.example.com']

在上述示例中，只有 example.com 和 www.example.com 这两个主机可以访问 Django 应用程序。如果收到其他主机的请求，Django 将拒绝访问并抛出异常。

为方便开发和调试，Django 还提供了一种特殊的配置方式，即允许所有的主机访问应用程序。使用以下设置可以将所有主机都添加到 allowed hosts 列表中，这在开发阶段非常有用：

# settings.py
ALLOWED_HOSTS = ['*']

其中 * 表示所有主机都被允许访问应用程序。请注意，不建议在生产环境中使用此设置，因为这会降低应用程序的安全性。

5. Allowed Hosts 的常见问题

5.1 如何配置多个域名？

如果你的 Django 应用程序有多个域名，例如 example.com 和 example.net，你可以将所有域名都添加到 allowed hosts 的列表中：

# settings.py
ALLOWED_HOSTS = ['.example.com', '.example.net']

在上述配置中，以 . 开头的域名模式表示允许访问该域及其所有子域。

5.2 如何配置 IP 地址？

如果你想允许某个特定的 IP 地址访问你的 Django 应用程序，可以直接将该 IP 地址添加到 allowed hosts 的列表中：

# settings.py
ALLOWED_HOSTS = ['192.168.0.100']

在上述配置中，只有 IP 地址 192.168.0.100 可以访问 Django 应用程序。

5.3 如何配置通配符？

你可以使用通配符 * 来模糊匹配域名或 IP 地址。例如，如果你想允许所有以 example. 开头的域名访问应用程序，可以配置如下：

# settings.py
ALLOWED_HOSTS = ['.example.*']

在上述配置中，任何以 example. 开头的域名都可以访问应用程序。

6. Allowed Hosts 的注意事项

以下是一些配置 Allowed Hosts 时需要注意的事项：

在生产环境中，不要使用通配符 *，除非你确实需要允许所有主机访问应用程序。这会降低应用程序的安全性。
在开发环境中，为了方便调试，可以使用 ['*'] 允许所有主机访问应用程序。但要记得在部署到生产环境时，修改为正确的 allowed hosts。
当修改 Allowed Hosts 配置后，要重新启动 Django 服务器才能生效。

7. 结论

Allowed Hosts 是 Django 提供的一个重要安全特性，用于限制只有特定的主机可以访问应用程序。通过合理配置 Allowed Hosts，可以提高应用程序的安全性，并防止未经授权的访问。

在开发和部署 Django 应用程序时，请务必正确配置 Allowed Hosts，避免因未授权主机的访问而引发安全问题。

Django allowed_hosts