下面是 Django 核心中可用的配置及其默认值的列表。下面列出了 contrib 应用提供的设置，后面是核心配置的专题索引。关于介绍性资料，请看 配置专题指南。
\nABSOLUTE_URL_OVERRIDESLink to this heading#默认： {} （空字典）
将 "app_label.model_name" 字符串映射到接受模型对象并返回其 URL 的函数的字典。这是一种在每个预安装基础上插入或覆盖 get_absolute_url() 方法的方式。例如：
ABSOLUTE_URL_OVERRIDES = {\n 'blogs.blog': lambda o: "/blogs/%s/" % o.slug,\n 'news.story': lambda o: "/stories/%s/%s/" % (o.pub_year, o.slug),\n}\n在此配置中使用的模型名称应全部为小写，与实际模型类名称的大小写无关。
\nADMINSLink to this heading#默认： [] （空列表）
所有收到代码错误通知的人的列表。当 DEBUG=False 和 AdminEmailHandler 中设置了 LOGGING 时（默认情况下是这样做的），Django 会将请求／响应周期中出现的异常的详细信息通过邮件发送给这些人。
列表中的每个项目应该是一个元组 (全名, 电子邮件地址)。例如：
\n[('John', 'john@example.com'), ('Mary', 'mary@example.com')]\nALLOWED_HOSTSLink to this heading#默认： [] （空列表）
一个代表这个 Django 网站可以服务的主机／域名的字符串列表。这是一个安全措施，以防止 HTTP 主机头攻击 ，即使在许多看似安全的 Web 服务器配置下也有可能发生。
\n这个列表中的值可以是完全限定的名称（例如 'www.example.com），在这种情况下，它们将与请求的 Host 头完全匹配（不区分大小写，不包括端口）。以英文句号开头的值可以用作子域通配符。'.example.com' 将匹配 example.com、www.example.com 和 example.com 的任何其他子域。'*' 的值将匹配任何东西；在这种情况下，你要负责提供你自己的 Host 头的验证（也许是在一个中间件中；如果是这样，这个中间件必须首先在 MIDDLEWARE 中列出）。
Django 也允许在任何条目中使用 完全合格的域名（FQDN） 。有些浏览器在 Host 头中包含了一个尾部的点，Django 在执行主机验证时将其去掉。
如果 Host 头（或者 X-Forwarded-Host 如果 USE_X_FORWARDED_HOST 被启用的话）不符合这个列表中的任何值，则 django.http.HttpRequest.get_host() 方法将引发 SuspiciousOperation。
当 DEBUG`为``True` 和 ALLOWED_HOSTS 为空时，主机将根据 ['.localhost', '127.0.0.1', '[::1]'] 进行验证。
ALLOWED_HOSTS 也是 在运行测试时进行检查的。
这些验证仅通过 get_host() 来实现；如果你的代码直接从 request.META 得到 Host 头部，你就绕过了这种安全保护机制。
APPEND_SLASHLink to this heading#默认： True
当设置为 True 时，如果请求的 URL 不符合 URLconf 中的任何模式，并且不以斜线结尾，则会发出一个 HTTP 重定向到相同的URL，并附加一个斜线。注意，重定向可能会导致 POST 请求中提交的任何数据丢失。
APPEND_SLASH 的配置只有在安装了 CommonMiddleware 的情况下才会使用（参见 中间件）。也请参见 PREPEND_WWW。
CACHESLink to this heading#默认：
\n{\n 'default': {\n 'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',\n }\n}\n一个包含所有 Django 缓存配置的字典。它是一个嵌套的字典，其内容将缓存别名映射到一个包含单个缓存选项的字典中。
\nCACHES 配置必须设置一个 default 缓存；也可以指定任何数量的附加缓存。如果你使用的是本地内存缓存以外的缓存后端，或者你需要定义多个缓存，则需要其他选项。以下是可用的缓存选项。
BACKENDLink to this heading#默认： '' （空字符串）
要使用的缓存后端。内置的缓存后端有：
\n'django.core.cache.backends.db.DatabaseCache'
'django.core.cache.backends.dummy.DummyCache'
'django.core.cache.backends.filebased.FileBasedCache'
'django.core.cache.backends.locmem.LocMemCache'
'django.core.cache.backends.memcached.PyMemcacheCache'
'django.core.cache.backends.memcached.PyLibMCCache'
'django.core.cache.backends.redis.RedisCache'
你可以通过将 :set:`BACKEND <CACHES-BACKEND>` 设置为一个完全限定的缓存后端类的路径（例如 mypackage.backends.whatever.WhateverCache），来使用一个不在 Django 中的缓存后端。
KEY_FUNCTIONLink to this heading#一个字符串，包含一个指向函数（或任何可调用）的点分隔路径，定义如何将前缀、版本和密钥组成一个最终的缓存密钥。默认的实现相当于函数：
\ndef make_key(key, key_prefix, version):\n return ':'.join([key_prefix, str(version), key])\n你可以使用任何你想要的密钥函数，只要它有相同的参数签名。
\n查看 缓存文档 获取更多信息。
\nKEY_PREFIXLink to this heading#默认： '' （空字符串）
一个自动包含在 Django 服务器使用的所有缓存键中的字符串（默认情况下是前缀）。
\n查看 缓存文档 获取更多信息。
\nLOCATIONLink to this heading#默认： '' （空字符串）
要使用的高速缓存的位置。可能是文件系统缓存的目录，memcache 服务器的主机和端口，或者是本地内存缓存的识别名称，例如：
\nCACHES = {\n 'default': {\n 'BACKEND': 'django.core.cache.backends.filebased.FileBasedCache',\n 'LOCATION': '/var/tmp/django_cache',\n }\n}\nOPTIONSLink to this heading#默认： None
传递给缓存后端的额外参数。可用的参数根据你的缓存后端不同而不同。
\n关于可用参数的一些信息可以在 缓存参数 文档中找到。更多信息，请查阅你的后端模块自己的文档。
\nTIMEOUTLink to this heading#默认： 300
The number of seconds before a cache entry is considered stale. If the value of\nthis setting is None, cache entries will not expire. A value of 0\ncauses keys to immediately expire (effectively "don't cache").
VERSIONLink to this heading#默认： 1
Django 服务器生成的缓存密钥的默认版本号。
\n查看 缓存文档 获取更多信息。
\nCACHE_MIDDLEWARE_ALIASLink to this heading#默认： 'default'
用于 缓存中间件 的缓存连接。
\nCACHE_MIDDLEWARE_KEY_PREFIXLink to this heading#默认： '' （空字符串）
由 缓存中间件 生成的缓存密钥前缀的字符串。这个前缀与 KEY_PREFIX 的配置结合在一起，而不是取代它。
参见 Django 缓存框架。
\nCACHE_MIDDLEWARE_SECONDSLink to this heading#默认： 600
默认为 缓存中间件 缓存页面的秒数。
\n参见 Django 缓存框架。
\nCSRF_USE_SESSIONSLink to this heading#默认：False
是否将 CSRF 标记存储在用户的会话中，而不是 cookie 中。这需要使用 django.contrib.session。
将 CSRF 令牌存储在 cookie 中（Django 的默认值）是安全的，但将其存储在 session 中是其他 Web 框架的常见做法，因此有时会被安全审计人员要求。
\n由于 默认错误视图 需要CSRF令牌，所以 SessionMiddleware 必须出现在 MIDDLEWARE 中，在任何可能引发异常以触发错误视图的中间件（如 PermissionDenied）之前，如果你正在使用 CSRF_USE_SESSIONS。参见 中间件顺序。
CSRF_FAILURE_VIEWLink to this heading#默认： 'django.views.csrf.csrf_failure'
当传入的请求被 CSRF 保护 拒绝时，要使用的视图函数的点分隔路径。该函数应具有以下签名：
\ndef csrf_failure(request, reason=""):\n ...\n其中 reason 是一个简短的消息（针对开发者或日志记录，而不是针对终端用户），表示请求被拒绝的原因，它应该返回一个 HttpResponseForbidden。
django.views.csrf.csrf_failure() 接受一个额外的 template_name 参数，默认为 '403_csrf.html'。如果存在该名称的模板，它将被用来渲染页面。
CSRF_HEADER_NAMELink to this heading#默认： 'HTTP_X_CSRFTOKEN'
用于 CSRF 认证的请求头的名称。
\n与 request.META 中的其他 HTTP 头文件一样，从服务器接收到的头文件名通过将所有字符转换为大写字母，用下划线代替任何连字符，并在名称中添加 'HTTP_' 前缀进行规范化。例如，如果你的客户端发送了一个 'X-XSRF-TOKEN' 头，配置应该是 'HTTP_X_XSRF_TOKEN'。
CSRF_TRUSTED_ORIGINSLink to this heading#默认： [] （空列表）
A list of trusted origins for unsafe requests (e.g. POST).
For requests that include the Origin header, Django's CSRF protection\nrequires that header match the origin present in the Host header.
For a secure unsafe\nrequest that doesn't include the Origin header, the request must have a\nReferer header that matches the origin present in the Host header.
These checks prevent, for example, a POST request from\nsubdomain.example.com from succeeding against api.example.com. If you\nneed cross-origin unsafe requests, continuing the example, add\n'https://subdomain.example.com' to this list (and/or http://... if\nrequests originate from an insecure page).
The setting also supports subdomains, so you could add\n'https://*.example.com', for example, to allow access from all subdomains\nof example.com.
DATABASESLink to this heading#默认： {} （空字典）
一个包含所有数据库配置的字典，用于 Django。它是一个嵌套的字典，其内容是将一个数据库别名映射到一个包含单个数据库选项的字典中。
\nDATABASES 配置必须设置一个 default 数据库；也可以指定任何数量的其他数据库。
最简单的配置文件是使用 SQLite 的单数据库配置。可以通过以下方式进行配置：
\nDATABASES = {\n 'default': {\n 'ENGINE': 'django.db.backends.sqlite3',\n 'NAME': 'mydatabase',\n }\n}\n当连接到其他数据库后端时，如 MariaDB、MySQL、Oracle 或 PostgreSQL，将需要额外的连接参数。请参阅下面的 ENGINE 配置，了解如何指定其他数据库类型。这个例子是针对 PostgreSQL：
DATABASES = {\n 'default': {\n 'ENGINE': 'django.db.backends.postgresql',\n 'NAME': 'mydatabase',\n 'USER': 'mydatabaseuser',\n 'PASSWORD': 'mypassword',\n 'HOST': '127.0.0.1',\n 'PORT': '5432',\n }\n}\n以下是更复杂配置可能需要的内部选项：
\nATOMIC_REQUESTSLink to this heading#默认：False
将此设置为 True，以将每个视图包裹在这个数据库的事务中。参见 连结事务与 HTTP 请求。
AUTOCOMMITLink to this heading#默认： True
如果你想 禁用 Django 的事务管理 并实现你自己的事务管理，请将此设置为 False。
ENGINELink to this heading#默认： '' （空字符串）
要使用的数据库后端。内置的数据库后端有：
\n'django.db.backends.postgresql'
'django.db.backends.mysql'
'django.db.backends.sqlite3'
'django.db.backends.oracle'
你可以通过将 ENGINE 设置为一个完全限定的路径（例如： mypackage.backends.whatever），来使用一个不在 Django 中的数据库后端。
HOSTLink to this heading#默认： '' （空字符串）
连接到数据库时使用的主机。空字符串表示本地主机。不用于 SQLite。
\n如果这个值以斜线（'/'）开头，并且你正在使用 MySQL，MySQL 将通过 Unix 套接字连接到指定的套接字。例如：
"HOST": '/var/run/mysql'\n如果你使用的是 MySQL，并且这个值 没有 以斜线开头，那么这个值被认为是主机。
\n如果你使用的是 PostgreSQL，默认情况下（空 HOST），与数据库的连接是通过 UNIX 域套接字（pg_hba.conf 中的 'local' ）完成的。如果你的 UNIX 域套接字不在标准位置，请使用 postgresql.conf 中的 unix_socket_directory 的相同值。如果你想通过 TCP 套接字连接，将 HOST 设置为 'localhost' 或 '127.0.0.1'（pg_hba.conf 中的 'host' 行）。在 Windows 上，你应该总是定义 HOST，因为 UNIX 域套接字是不可用的。
NAMELink to this heading#默认： '' （空字符串）
要使用的数据库的名称。对于 SQLite，它是数据库文件的完整路径。当指定路径时，总是使用斜线，即使在 Windows 上也是如此（例如 C:/homes/user/mysite/sqlite3.db）。
CONN_MAX_AGELink to this heading#默认： 0
The lifetime of a database connection, as an integer of seconds. Use 0 to\nclose database connections at the end of each request — Django's historical\nbehavior — and None for unlimited persistent database connections.
CONN_HEALTH_CHECKSLink to this heading#默认：False
If set to True, existing persistent database connections will be health checked before they are\nreused in each request performing database access. If the health check fails,\nthe connection will be reestablished without failing the request when the\nconnection is no longer usable but the database server is ready to accept and\nserve new connections (e.g. after database server restart closing existing\nconnections).
OPTIONSLink to this heading#默认： {} （空字典）
连接到数据库时要使用的额外参数。可用的参数根据你的数据库后端不同而不同。
\n关于可用参数的一些信息可以在 数据库后端 文档中找到。更多信息，请查阅你的后端模块自己的文档。
\nPASSWORDLink to this heading#默认： '' （空字符串）
连接到数据库时使用的密码。不用于 SQLite。
\nPORTLink to this heading#默认： '' （空字符串）
连接到数据库时要使用的端口。空字符串表示默认端口。不用于 SQLite。
\nTIME_ZONELink to this heading#默认： None
代表该数据库连接时区的字符串或 None。DATABASES 配置的这个内部选项与一般的 TIME_ZONE 配置接受相同的值。
当 USE_TZ 为 True 且设置了这个选项时，从数据库中读取日期时间会返回这个时区的感知日期时间，而不是 UTC。当 USE_TZ 为 False 时，设置该选项是错误的。
如果数据库后端不支持时区（如 SQLite、MySQL、Oracle），如果设置了这个选项，Django 会根据这个选项以当地时间读写日期，如果没有设置，则以 UTC 时间读写。
\n改变连接时区会改变从数据库中读取和写入日期的方式。
\nIf Django manages the database and you don't have a strong reason to do\notherwise, you should leave this option unset. It's best to store datetimes\nin UTC because it avoids ambiguous or nonexistent datetimes during daylight\nsaving time changes. Also, receiving datetimes in UTC keeps datetime\narithmetic simple — there's no need to consider potential offset changes\nover a DST transition.
如果你连接的第三方数据库以当地时间而不是 UTC 存储日期，那么你必须将这个选项设置为合适的时区。同样，如果 Django 管理数据库，但第三方系统连接到同一个数据库，并希望找到当地时间的日期，那么你必须设置这个选项。
如果数据库后端支持时区（如 PostgreSQL），很少需要 TIME_ZONE 选项。它可以在任何时候改变；数据库会负责将日期时间转换为所需的时区。
设置数据库连接的时区对于运行涉及数据库提供的日期／时间函数的原始 SQL 查询（如 date_trunc）可能很有用，因为其结果取决于时区。
However, this has a downside: receiving all datetimes in local time makes\ndatetime arithmetic more tricky — you must account for possible offset\nchanges over DST transitions.
\n考虑在原始 SQL 查询中使用 AT TIME ZONE 明确转换为当地时间，而不是设置 TIME_ZONE 选项。
DISABLE_SERVER_SIDE_CURSORSLink to this heading#默认：False
如果你想通过 QuerySet.iterator() 禁用服务器端游标的使用，请将其设置为 True。 事务池和服务器端游标 描述了使用情况。
这是 PostgreSQL 特有的配置。
\nUSERLink to this heading#默认： '' （空字符串）
连接数据库时要使用的用户名。不用于 SQLite。
\nTESTLink to this heading#默认： {} （空字典）
测试数据库的设置字典；关于测试数据库的创建和使用的更多细节，见 测试数据库。
\n下面是一个测试数据库配置的例子：
\nDATABASES = {\n 'default': {\n 'ENGINE': 'django.db.backends.postgresql',\n 'USER': 'mydatabaseuser',\n 'NAME': 'mydatabase',\n 'TEST': {\n 'NAME': 'mytestdatabase',\n },\n },\n}\nTEST 字典中的下列键可供使用：
CHARSETLink to this heading#默认： None
用于创建测试数据库的字符集编码。这个字符串的值是直接传递给数据库的，所以它的格式是特定于后端的。
\n由 PostgreSQL （postgresql）和 MySQL （mysql）后端支持。
COLLATIONLink to this heading#默认： None
创建测试数据库时要使用的字符序。这个值是直接传递给后端的，所以它的格式是后端特定的。
\n仅支持 mysql 后端（详见 MySQL 手册 ）。
DEPENDENCIESLink to this heading#默认：['default']，适用于除 default 以外的所有数据库，后者没有依赖性。
数据库的创建顺序依赖性。详见 控制测试数据库的创建顺序 的文档。
\nMIGRATELink to this heading#默认： True
当设置为 False 时，在创建测试数据库时不会运行迁移。这类似于在 MIGRATION_MODULES 中设置 None 作为一个值，但适用于所有应用程序。
MIRRORLink to this heading#默认： None
The alias of the database that this database should mirror during\ntesting. It depends on transactions and therefore must be used within\nTransactionTestCase instead of\nTestCase.
该配置允许测试多个数据库的主／副本（某些数据库称为主／从）配置。详情请参见 测试主／副本配置 的文档。
\nNAMELink to this heading#默认： None
运行测试套件时要使用的数据库名称。
\n如果 SQLite 数据库引擎使用默认值（None），则测试将使用内存常驻数据库。对于所有其他数据库引擎，测试数据库将使用 'test_' + DATABASE_NAME 的名称。
查看 测试数据库。
\nSERIALIZELink to this heading#布尔值，用于控制默认的测试运行器是否在运行测试之前将数据库序列化为内存中的 JSON 字符串（如果没有事务，用于在测试之间恢复数据库状态）。如果你没有任何带有 serialized_rollback=True 的测试类，你可以将其设置为 False 以加快创建时间。
TEMPLATELink to this heading#这是 PostgreSQL 特有的配置。
\ntemplate 的名称（例如 'template0'），用于创建测试数据库。
CREATE_DBLink to this heading#默认： True
这是 Oracle 特有的配置。
\n如果设置为 False，测试表空间不会在测试开始时自动创建，也不会在测试结束时删除。
CREATE_USERLink to this heading#默认： True
这是 Oracle 特有的配置。
\n如果设置为 False，测试用户不会在测试开始时自动创建，也不会在测试结束时删除。
USERLink to this heading#默认： None
这是 Oracle 特有的配置。
\n连接到 Oracle 数据库时使用的用户名。如果没有提供，Django 将使用 'test_' + USER。
PASSWORDLink to this heading#默认： None
这是 Oracle 特有的配置。
\n连接到 Oracle 数据库时使用的密码。如果没有提供，Django 会随机生成一个密码。
\nORACLE_MANAGED_FILESLink to this heading#默认：False
这是 Oracle 特有的配置。
\nDATAFILE 和 DATAFILE_TMP 将被忽略。
TBLSPACELink to this heading#默认： None
这是 Oracle 特有的配置。
\n运行测试时使用的表空间的名称。如果没有提供，Django 将使用 'test_' + USER。
TBLSPACE_TMPLink to this heading#默认： None
这是 Oracle 特有的配置。
\n运行测试时使用的临时表空间的名称。如果没有提供，Django 将使用 'test_' + USER + '_temp'。
DATAFILELink to this heading#默认： None
这是 Oracle 特有的配置。
\nTBLSPACE 要使用的数据文件名。如果没有提供，Django 将使用 TBLSPACE + '.dbf'。
DATAFILE_TMPLink to this heading#默认： None
这是 Oracle 特有的配置。
\nTBLSPACE_TMP 的数据文件名。如果没有提供，Django 将使用 TBLSPACE_TMP + '.dbf'。
DATAFILE_MAXSIZELink to this heading#默认： '500M'
这是 Oracle 特有的配置。
\nDATAFILE 允许增长的最大尺寸。
\nDATAFILE_TMP_MAXSIZELink to this heading#默认： '500M'
这是 Oracle 特有的配置。
\nDATAFILE_TMP 允许增长的最大尺寸。
\nDATAFILE_SIZELink to this heading#默认： '50M'
这是 Oracle 特有的配置。
\nDATAFILE 的初始大小。
\nDATAFILE_TMP_SIZELink to this heading#默认： '50M'
这是 Oracle 特有的配置。
\nDATAFILE_TMP 的初始大小。
\nDATAFILE_EXTSIZELink to this heading#默认： '25M'
这是 Oracle 特有的配置。
\n当需要更多空间时，DATAFILE 的扩展量。
\nDATAFILE_TMP_EXTSIZELink to this heading#默认： '25M'
这是 Oracle 特有的配置。
\n当需要更多空间时，DATAFILE_TMP 的扩展量。
\nDATA_UPLOAD_MAX_MEMORY_SIZELink to this heading#默认： 2621440 （即 2.5 MB）。
请求体在引发 SuspiciousOperation （RequestDataTooBig）之前的最大字节数。这个检查是在访问 request.body 或 request.POST 时进行的，是根据请求的总大小计算的，不包括任何文件上传数据。你可以将其设置为 None 以禁用该检查。预计会收到非常大的上传表单的应用程序应该调整这个配置。
请求数据的数量与处理请求和填充 GET 和 POST 字典所需的内存量相关。如果不进行检查，大的请求可能会被用作拒绝服务的攻击载体。由于 Web 服务器通常不会进行深层的请求检查，所以不可能在这个层面进行类似的检查。
\n\nDATA_UPLOAD_MAX_NUMBER_FIELDSLink to this heading#默认： 1000
在发生 SuspiciousOperation （TooManyFields）之前，可以通过 GET 或 POST 接收到的参数的最大数量。你可以将其设置为 None 来禁用该检查。预计会收到异常多的表单字段的应用程序应该调整这个配置。
请求参数的数量与处理请求和填充 GET 和 POST 字典所需的时间有关。如果不加以检查，大的请求可能会被用作拒绝服务攻击的载体。由于 Web 服务器通常不会进行深层的请求检查，所以不可能在这个层面进行类似的检查。
\nDATA_UPLOAD_MAX_NUMBER_FILESLink to this heading#Default: 100
The maximum number of files that may be received via POST in a\nmultipart/form-data encoded request before a\nSuspiciousOperation (TooManyFiles) is\nraised. You can set this to None to disable the check. Applications that\nare expected to receive an unusually large number of file fields should tune\nthis setting.
The number of accepted files is correlated to the amount of time and memory\nneeded to process the request. Large requests could be used as a\ndenial-of-service attack vector if left unchecked. Since web servers don't\ntypically perform deep request inspection, it's not possible to perform a\nsimilar check at that level.
\nDATABASE_ROUTERSLink to this heading#默认： [] （空列表）
在执行数据库查询时，将用于确定使用哪个数据库的路由器列表。
\n参见 多数据库配置中的自动数据库路由 的文档。
\nDATE_FORMATLink to this heading#默认： 'N j, Y' （例如 Feb. 4, 2003）
在系统的任何部分显示日期字段时使用的默认格式。请注意，如果 USE_L10N 被设置为 True，那么本地决定的格式具有更高的优先权，并将被应用。参见 允许的日期格式字符串。
DATE_INPUT_FORMATSLink to this heading#默认：
\n[\n '%Y-%m-%d', # '2006-10-25'\n '%m/%d/%Y', # '10/25/2006'\n '%m/%d/%y', # '10/25/06'\n '%b %d %Y', # 'Oct 25 2006'\n '%b %d, %Y', # 'Oct 25, 2006'\n '%d %b %Y', # '25 Oct 2006'\n '%d %b, %Y', # '25 Oct, 2006'\n '%B %d %Y', # 'October 25 2006'\n '%B %d, %Y', # 'October 25, 2006'\n '%d %B %Y', # '25 October 2006'\n '%d %B, %Y', # '25 October, 2006'\n]\n在日期字段上输入数据时接受的格式列表。格式将按顺序被尝试，使用第一个有效的格式。注意这些格式字符串使用 Python 的 datetime 模块语法，而不是来自 date 模板过滤器的格式字符串。
当 USE_L10N 为 True 时，将采用本地规定的格式，具有更高的优先权。
DATETIME_FORMATLink to this heading#默认： 'N j, Y, P' （例如 Feb. 4, 2003, 4 p.m.）
在系统的任何部分显示日期时间字段时使用的默认格式。请注意，如果 USE_L10N 被设置为 True，那么本地决定的格式具有更高的优先权，并将被应用。参见 允许的日期格式字符串。
DATETIME_INPUT_FORMATSLink to this heading#默认：
\n[\n '%Y-%m-%d %H:%M:%S', # '2006-10-25 14:30:59'\n '%Y-%m-%d %H:%M:%S.%f', # '2006-10-25 14:30:59.000200'\n '%Y-%m-%d %H:%M', # '2006-10-25 14:30'\n '%m/%d/%Y %H:%M:%S', # '10/25/2006 14:30:59'\n '%m/%d/%Y %H:%M:%S.%f', # '10/25/2006 14:30:59.000200'\n '%m/%d/%Y %H:%M', # '10/25/2006 14:30'\n '%m/%d/%y %H:%M:%S', # '10/25/06 14:30:59'\n '%m/%d/%y %H:%M:%S.%f', # '10/25/06 14:30:59.000200'\n '%m/%d/%y %H:%M', # '10/25/06 14:30'\n]\n在日期时间字段上输入数据时可接受的格式列表。格式将按顺序被尝试，使用第一个有效的格式。注意这些格式字符串使用 Python 的 datetime 模块语法，而不是 date 模板过滤器的格式字符串。纯日期格式不包括在内，因为日期时间字段会在最后时刻自动尝试 DATE_INPUT_FORMATS。
当 USE_L10N 为 True 时，将采用本地规定的格式，具有更高的优先权。
DEBUGLink to this heading#默认：False
一个开启、关闭调试模式的布尔值。
\n永远不要在 DEBUG 开启的情况下将网站部署到生产中。
调试模式的主要功能之一是显示详细的错误页面。如果你的应用程序在 DEBUG 为 True 时引发了异常，Django 会显示一个详细的回溯，包括很多关于你的环境的元数据，比如所有当前定义的 Django 配置（来自 settings.py）。
作为一项安全措施，Django将 不 包含可能是敏感的配置，如 SECRET_KEY。具体来说，它将排除任何名称中包含以下内容的配置。
'API'
'KEY'
'PASS'
'SECRET'
'SIGNATURE'
'TOKEN'
请注意，这些是 部分 匹配。'PASS' 也将与 PASSWORD 匹配，正如 'TOKEN' 也将与 TOKENIZED 匹配，以此类推。
不过，请注意，你的调试输出中总会有一些部分是不适合公开的。文件路径、配置选项等都会给攻击者提供关于你的服务器的额外信息。
\n同样重要的是，当 DEBUG 开启时，Django 会记住它执行的每个 SQL 查询。这在调试时很有用，但在生产服务器上会迅速消耗内存。
最后，如果 DEBUG 为 False，还需要正确设置 ALLOWED_HOSTS 配置。否则，所有的请求都会以 “Bad Request (400) ” 返回。
DEBUG_PROPAGATE_EXCEPTIONSLink to this heading#默认：False
If set to True, Django's exception handling of view functions\n(handler500, or the debug view if DEBUG\nis True) and logging of 500 responses (django.request) is\nskipped and exceptions propagate upward.
这对于一些测试配置是有用的。除非你想让你的 web 服务器（而不是 Django）生成“内部服务器错误”的响应，否则它不应该被用于实时站点。在这种情况下，确保你的服务器不会在响应中显示堆栈跟踪或其他敏感信息。
\nDECIMAL_SEPARATORLink to this heading#默认： '.' （点）
格式化小数时使用的默认小数分隔符。
\n请注意，如果 USE_L10N 设置为 True，那么将采用本地决定的格式，具有更高的优先权。
另见 NUMBER_GROUPING、THOUSAND_SEPARATOR 和 USE_THOUSAND_SEPARATOR。
DEFAULT_AUTO_FIELDLink to this heading#默认： 'django.db.models.AutoField'
默认的主键字段类型，用于没有带有 primary_key=True 字段的模型。
DEFAULT_CHARSETLink to this heading#默认： 'utf-8'
如果没有手动指定 MIME 类型，所有 HttpResponse 对象将使用默认字符集。在构建 Content-Type 头时使用。
DEFAULT_EXCEPTION_REPORTERLink to this heading#默认： 'django.views.debug.ExceptionReporter'
如果还没有为 HttpRequest 实例分配任何异常报告类，则使用默认的异常报告类。参见 自定义错误报告。
DEFAULT_EXCEPTION_REPORTER_FILTERLink to this heading#默认： 'django.views.debug.SafeExceptionReporterFilter'
如果还没有为 HttpRequest 实例分配任何异常报告过滤类，则使用默认的异常报告过滤类。参见 过滤错误报告。
DEFAULT_FILE_STORAGELink to this heading#默认： 'django.core.files.storage.FileSystemStorage'
默认的文件存储类，用于任何与文件相关的操作，不指定特定的存储系统。参见 管理文件。
\nDEFAULT_FROM_EMAILLink to this heading#默认： 'webmaster@localhost'
默认电子邮件地址，用于网站管理员的各种自动通信。这不包括发送到 ADMINS 和 MANAGERS 的错误信息；关于这一点，请参见 SERVER_EMAIL。
DEFAULT_INDEX_TABLESPACELink to this heading#默认： '' （空字符串）
如果后端支持的话，在没有指定索引的字段上使用的默认表空间（参见 表空间（Tablespaces））。
\nDEFAULT_TABLESPACELink to this heading#默认： '' （空字符串）
对于没有指定表空间的模型，如果后端支持，则使用默认表空间（参见 表空间（Tablespaces））。
\nDISALLOWED_USER_AGENTSLink to this heading#默认： [] （空列表）
编译后的正则表达式对象列表，代表全系统范围内不允许访问任何页面的 User-Agent 字符串。用于机器人／爬虫。只有在安装了 CommonMiddleware 的情况下才会使用（参见 中间件）。
EMAIL_BACKENDLink to this heading#默认： 'django.core.mail.backends.smtp.EmailBackend'
用于发送邮件的后端。关于可用的后端列表，请参见 发送邮件。
\nEMAIL_FILE_PATHLink to this heading#默认：未定义
\n文件邮件后端 用来存储输出文件的目录。
\nEMAIL_HOSTLink to this heading#默认： 'localhost'
用于发送电子邮件的主机。
\n另见 EMAIL_PORT。
EMAIL_HOST_PASSWORDLink to this heading#默认： '' （空字符串）
在 EMAIL_HOST 中定义的 SMTP 服务器使用的密码。这个配置和 EMAIL_HOST_USER 中的密码一起使用。如果这两个配置中的任何一个为空，Django 就不会尝试验证。
另见 EMAIL_HOST_USER。
EMAIL_HOST_USERLink to this heading#默认： '' （空字符串）
在 EMAIL_HOST 中定义的 SMTP 服务器的用户名。如果为空，Django 将不会尝试认证。
EMAIL_PORTLink to this heading#默认： 25
在 :setting:`EMAIL_HOST' 中定义的 SMTP 服务器使用的端口。
\nEMAIL_SUBJECT_PREFIXLink to this heading#默认： '[Django] '
用 django.core.mail.mail_admins 或 django.core.mail.mail_managers 发送邮件的主题行前缀。你可能会想要包含尾部的空格。
EMAIL_USE_LOCALTIMELink to this heading#默认：False
是否以当地时区（True）或 UTC（False）发送 SMTP Date 邮件头。
EMAIL_USE_TLSLink to this heading#默认：False
与 SMTP 服务器对话时是否使用 TLS（安全）连接。这用于显式 TLS 连接，一般在 587 端口。如果你遇到挂起的连接，请查看隐式 TLS 配置 EMAIL_USE_SSL。
EMAIL_USE_SSLLink to this heading#默认：False
与 SMTP 服务器对话时是否使用隐式 TLS（安全）连接。在大多数电子邮件文档中，这种类型的 TLS 连接被称为 SSL。它通常在 465 端口使用。如果你遇到问题，请查看显式 TLS 配置 EMAIL_USE_TLS。
注意 EMAIL_USE_TLS ／ EMAIL_USE_SSL 是相互排斥的，所以只能将其中一个设置为 True。
EMAIL_SSL_CERTFILELink to this heading#默认： None
如果 EMAIL_USE_SSL 或 EMAIL_USE_TLS 是 True，你可以选择指定一个 PEM 格式的证书链文件的路径，用于 SSL 连接。
EMAIL_SSL_KEYFILELink to this heading#默认： None
如果 EMAIL_USE_SSL 或 EMAIL_USE_TLS 为 True，你可以选择性地指定用于 SSL 连接的 PEM 格式化私钥文件的路径。
Note that setting EMAIL_SSL_CERTFILE and EMAIL_SSL_KEYFILE\ndoesn't result in any certificate checking. They're passed to the underlying SSL\nconnection. Please refer to the documentation of Python's\nssl.SSLContext.wrap_socket() function for details on how the\ncertificate chain file and private key file are handled.
EMAIL_TIMEOUTLink to this heading#默认： None
指定阻止连接尝试等操作的超时时间，以秒为单位。
\nFILE_UPLOAD_HANDLERSLink to this heading#默认：
\n[\n 'django.core.files.uploadhandler.MemoryFileUploadHandler',\n 'django.core.files.uploadhandler.TemporaryFileUploadHandler',\n]\n上传过程中使用的处理程序列表。改变这个配置可以完全自定义——甚至替换——Django 的上传过程。
\n详情参见 管理文件。
\nFILE_UPLOAD_MAX_MEMORY_SIZELink to this heading#默认： 2621440 （即 2.5 MB）。
上传的文件在被传送到文件系统之前的最大尺寸（以字节为单位）。详见 管理文件。
\n\nFILE_UPLOAD_DIRECTORY_PERMISSIONSLink to this heading#默认： None
适用于上传文件过程中创建的目录的数字模式。
\n当使用 collectstatic 管理命令时，这个配置也决定了收集的静态目录的默认权限。覆盖它的细节请参见 collectstatic。
这个值反映了 FILE_UPLOAD_PERMISSIONS 配置的功能和注意事项。
FILE_UPLOAD_PERMISSIONSLink to this heading#默认： 0o644
设置新上传文件的数字模式（即 0o644）。关于这些模式的更多信息，请参见 os.chmod() 的文档。
如果 None，你会得到操作系统依赖的行为。在大多数平台上，临时文件的模式为 0o600，从内存中保存的文件将使用系统的标准 umask 保存。
出于安全考虑，这些权限不应用于存储在 FILE_UPLOAD_TEMP_DIR 中的临时文件。
当使用 collectstatic 管理命令时，这个配置也决定了收集的静态文件的默认权限。覆盖它的细节请参见 collectstatic。
FILE_UPLOAD_TEMP_DIRLink to this heading#默认： None
上传文件时要临时存储数据的目录（一般是大于 FILE_UPLOAD_MAX_MEMORY_SIZE 的文件）。如果 None，Django 将使用操作系统的标准临时目录。例如，在 *nix 风格的操作系统上，会默认为 /tmp。
详情参见 管理文件。
\nFIRST_DAY_OF_WEEKLink to this heading#默认： 0 （星期日）
代表一周第一天的数字。这在显示日历时特别有用。该值仅在不使用格式国际化时使用，或者当无法为当前语言环境找到格式时使用。
\n该值必须是 0 到 6 的整数，其中 0 代表周日，1 代表周一，以此类推。
\nFIXTURE_DIRSLink to this heading#默认： [] （空列表）
除了每个应用程序的 fixtures 目录外，按搜索顺序列出了搜索辅助工具文件的目录。
请注意，这些路径应该使用 Unix 风格的斜线，即使在 Windows 上也是如此。
\n参见 通过固定内容提供数据 和 辅助工具加载。
\nFORCE_SCRIPT_NAMELink to this heading#默认： None
如果不是 None，将作为任何 HTTP 请求中 SCRIPT_NAME 环境变量的值。这个设置可以用来覆盖服务器提供的 SCRIPT_NAME 的值，这个值可能是首选值的重写版本，也可能根本没有提供。它还被 django.setup() 用来在请求／响应周期之外设置 URL 解析器脚本前缀（例如在管理命令和独立脚本中），以便在 SCRIPT_NAME 不是 / 时生成正确的 URL。
FORM_RENDERERLink to this heading#默认： 'django.forms.renderers.DjangoTemplates'
The class that renders forms and form widgets. It must implement\nthe low-level render API. Included form\nrenderers are:
\n\nFORMAT_MODULE_PATHLink to this heading#默认： None
一个 Python 包的完整 Python 路径，该 Python 包包含了项目 locale 的自定义格式定义。如果不是 None，Django 将检查当前 locale 目录下的 formats.py 文件，并将使用该文件中定义的格式。
例如，如果 FORMAT_MODULE_PATH 设置为 mysite. formats，当前语言为 en （英语），Django 将期望得到一个目录树，如：
mysite/\n formats/\n __init__.py\n en/\n __init__.py\n formats.py\n你也可以将此设置为 Python 路径列表，例如：
\nFORMAT_MODULE_PATH = [\n 'mysite.formats',\n 'some_app.formats',\n]\n当 Django 搜索某个格式时，它将通过所有给定的 Python 路径，直到找到一个真正定义该格式的模块。这意味着在列表中较远处的包中定义的格式将优先于较远处的包中的格式。
\n可用格式：
\n\nIGNORABLE_404_URLSLink to this heading#默认： [] （空列表）
编译的正则表达式对象列表，这些对象描述了在通过电子邮件报告 HTTP 404 错误时应该被忽略的 URL（参见 如何管理错误报告）。正则表达式与 request 的完整路径 （包括查询字符串，如果有的话）进行匹配。如果你的网站没有提供常用的请求文件，如 favicon.ico 或 robots.txt，请使用此选项。
只有当 BrokenLinkEmailsMiddleware 被启用时，才会使用这个功能（参见 中间件）。
INSTALLED_APPSLink to this heading#默认： [] （空列表）
一个字符串的列表，表示在这个 Django 安装中所有被启用的应用程序。每一个字符串都应该是一个 Python 的点分隔路径。
\n应用程序配置类（首选），或
包含应用程序的包。
当多个应用程序提供同一资源的不同版本（模板、静态文件、管理命令、翻译）时， INSTALLED_APPS 中排在第一位的应用程序具有优先权。
INTERNAL_IPSLink to this heading#默认： [] （空列表）
一个 IP 地址的列表，作为字符串，它：
\n允许 debug() 上下文处理器为模板上下文添加一些变量。
即使不以员工用户身份登录，也可以使用 管理文档书签。
在 AdminEmailHandler 邮件中被标记为“internal”（与 “EXTERNAL”相对）。
LANGUAGE_CODELink to this heading#默认： 'en-us'
代表本次安装的语言代码的字符串。这应该是标准的 language ID 格式。例如，美国英语是 "en-us"。也请参见 语言标识符列表 和 国际化和本地化。
:setting:`USE_I18N' 必须是激活状态，该配置才会有效果。
\n它有两个作用：
\n如果没有使用 locale 中间件，它决定向所有用户提供哪种翻译。
如果 locale 中间件是激活的，它提供了一个后备语言，以防用户的首选语言无法确定或网站不支持。当用户的首选语言不存在给定字词的翻译时，它也会提供后备翻译。
更多细节请参考 Django 如何发现语言偏好。
\nLANGUAGESLink to this heading#默认值。所有可用语言的清单。这个列表在不断的增加，如果在这里加入一个副本，那么不可避免的会很快过时。你可以在 django/conf/global_settings.py 中查看当前的翻译语言列表。
\n该列表是一个由两个元组组成的列表，其格式为 (language code, language name) ——例如，('ja', 'Japanese')。这指定了哪些语言可以选择。见 国际化和本地化。
一般来说，默认值就可以了。只有当你想将语言选择限制在 Django 提供的语言子集时，才需要设置此配置。
\n如果你定义了一个自定义的 LANGUAGES 配置，你可以使用 gettext_lazy() 函数将语言名称标记为翻译字符串。
以下是一个示例配置文件：
\nfrom django.utils.translation import gettext_lazy as _\n\nLANGUAGES = [\n ('de', _('German')),\n ('en', _('English')),\n]\nLANGUAGES_BIDILink to this heading#默认值。所有从右到左书写的语言代码的列表。你可以在 django/conf/global_settings.py 中查看这些语言的当前列表。
\n列表中包含 语言代码，用于从右到左书写的语言。
\n一般来说，默认值就可以了。只有当你想将语言选择限制在 Django 提供的语言子集时，才设置这个配置。如果你定义了一个自定义的 LANGUAGES 配置，双向语言列表中可能会包含一些在特定网站上没有启用的语言代码。
LOCALE_PATHSLink to this heading#默认： [] （空列表）
Django 寻找翻译文件的目录列表。参见 Django 如何发现翻译。
\n举例：
\nLOCALE_PATHS = [\n '/home/www/project/common_files/locale',\n '/var/local/translations/locale',\n]\nDjango 会在这些路径中寻找包含实际翻译文件的 <locale_code>/LC_MESSAGES 目录。
LOGGINGLink to this heading#默认：日志配置字典。
\nA data structure containing configuration information. When not-empty, the\ncontents of this data structure will be passed as the argument to the\nconfiguration method described in LOGGING_CONFIG.
其中，当 DEBUG 为 False 时，默认的日志配置会将 HTTP 500 服务器错误传递给电子邮件日志处理程序。也请参见 日志模块的配置。
你可以通过查看 django/utils/log.py 中的默认日志配置。
\nLOGGING_CONFIGLink to this heading#默认： 'logging.config.dictConfig'
Django 项目中用于配置日志的可调用路径。默认指向 Python 的 dictConfig 配置方法的实例。
\n如果将 LOGGING_CONFIG 配置为 None，将跳过日志配置过程。
MANAGERSLink to this heading#默认： [] （空列表）
一个与 ADMINS 格式相同的列表，用于指定当 BrokenLinkEmailsMiddleware 被启用时，谁应该收到断链通知。
MEDIA_ROOTLink to this heading#默认： '' （空字符串）
保存 用户上传的文件 目录的绝对文件系统路径。
\n例如： "/var/www/example.com/media/"
另见 MEDIA_URL。
MEDIA_URLLink to this heading#默认： '' （空字符串）
处理从 MEDIA_ROOT 提供的媒体的 URL，用于 管理存储文件。如果设置为非空值，则必须以斜线结束。在开发和生产环境中，你都需要 配置这些文件被服务。
如果你想在模板中使用 {{ MEDIA_URL }}，在 TEMPLATES 的 ''context_processors' 选项中添加 'django.template.context_processors.media'。
例如： "http://media.example.com/"
MIDDLEWARELink to this heading#默认： None
要使用的中间件列表。参见 中间件。
\nMIGRATION_MODULESLink to this heading#默认： {} （空字典）
一个指定包的字典，在每个应用程序的基础上可以找到迁移模块。这个配置的默认值是一个空字典，但迁移模块的默认包名是 migrations。
举例：
\n{'blog': 'blog.db_migrations'}\n在这种情况下，与 blog 应用有关的迁移将包含在 blog.db_migrations 包中。
如果你提供了 app_label 参数， makemigrations 将自动创建包，如果它还不存在。
当你为一个应用程序提供 None 作为一个值时，Django 会将该应用程序视为一个没有迁移的应用程序，而不考虑是否存在 migrations 子模块。例如，在测试设置文件中，这可以用来在测试时跳过迁移（仍然会为应用程序的模型创建表）。要在测试期间禁止所有应用程序的迁移，你可以将 MIGRATE 设置为 False。如果在你的一般项目配置中使用了 MIGRATION_MODULES，如果你想为应用程序创建表，记得使用 migrate --run-syncdb 选项。
MONTH_DAY_FORMATLink to this heading#默认： 'F j'
在 Django admin change-list 页面上的日期字段的默认格式——也可能被系统的其他部分使用——在只显示月份和日期的情况下。
\n例如，当 Django 管理员的变更列表页面被日期 drilldown 过滤时，给定的一天的标题会显示日期和月份。不同的地域有不同的格式。例如，美国英语会说“January 1”，而西班牙语可能会说“1 Enero”。
\n请注意，如果 USE_L10N 设置为 True，则相应的本地决定的格式具有更高的优先权，并将被应用。
查看 允许的日期格式字符串。另见 DATE_FORMAT、DATETIME_FORMAT、TIME_FORMAT 和 YEAR_MONTH_FORMAT。
NUMBER_GROUPINGLink to this heading#默认： 0
一个数字的整数部分的数字组合在一起的数量。
\n常见的用途是显示千位数的分隔符。如果该设置为 0，则不会对该数字进行分组。如果这个设置大于 0，那么 THOUSAND_SEPARATOR 将被用作这些组之间的分隔符。
有些地方使用非统一的数字分组，例如 en_IN 中的 10,00,00,000。对于这种情况，你可以提供一个序列，其中包含要应用的数字组大小。第一个数字定义小数定界符之前的组的大小，后面的每个数字定义前面组的大小。如果序列以 -1 结束，则不会再进行分组。如果序列以 0 结束，则在剩余的数字中使用最后一组的大小。
en_IN 的元组示例：
NUMBER_GROUPING = (3, 2, 0)\n请注意，如果 USE_L10N 设置为 True，那么将采用本地决定的格式，具有更高的优先权。
另见 DECIMAL_SEPARATOR、THOUSAND_SEPARATOR 和 USE_THOUSAND_SEPARATOR。
PREPEND_WWWLink to this heading#默认：False
是否给没有“www.”子域的 URL 加前缀。只有在安装了 CommonMiddleware 的情况下才会使用（参见 中间件）。也请参见 APPEND_SLASH。
ROOT_URLCONFLink to this heading#默认：未定义
\n一个字符串，代表你的根 URLconf 的完整 Python 导入路径，例如 "mydjangoapps.urls"。可以通过在传入的 HttpRequest 对象上设置属性 urlconf 来覆盖每个请求。详情请参见 Django 如何处理一个请求。
SECRET_KEYLink to this heading#默认： '' （空字符串）
一个特定 Django 安装的密钥。用于提供 加密签名，并且应该设置为一个唯一的、不可预测的值。
\ndjango-admin startproject 自动为每个新项目添加一个随机生成的 SECRET_KEY。
键的使用不应该假设是文本或字节。每次使用都应该通过 force_str() 或 force_bytes() 将其转换为所需类型。
如果 SECRET_KEY 没有设置，Django 将拒绝启动。
密钥用于：
\n所有 会话 如果你使用的是 django.contrib.session.backends.cache 以外的任何其他会话后端，或者使用的是默认的 get_session_auth_hash()。
所有 消息，如果你使用了 CookieStorage 或 FallbackStorage。
所有 PasswordResetView 密钥。
加密签名 的任何使用，除非提供不同的密钥。
When a secret key is no longer set as SECRET_KEY or contained within\nSECRET_KEY_FALLBACKS all of the above will be invalidated. When\nrotating your secret key, you should move the old key to\nSECRET_KEY_FALLBACKS temporarily. Secret keys are not used for\npasswords of users and key rotation will not affect them.
SECRET_KEY_FALLBACKSLink to this heading#Default: []
A list of fallback secret keys for a particular Django installation. These are\nused to allow rotation of the SECRET_KEY.
In order to rotate your secret keys, set a new SECRET_KEY and move the\nprevious value to the beginning of SECRET_KEY_FALLBACKS. Then remove the\nold values from the end of the SECRET_KEY_FALLBACKS when you are ready to\nexpire the sessions, password reset tokens, and so on, that make use of them.
Uses of the secret key values shouldn't assume that they are text or bytes.\nEvery use should go through force_str() or\nforce_bytes() to convert it to the desired type.
SECURE_CONTENT_TYPE_NOSNIFFLink to this heading#默认： True
如果 True，则 SecurityMiddleware 会在所有响应中设置 X-Content-Type-Options: nosniff 头。
SECURE_CROSS_ORIGIN_OPENER_POLICYLink to this heading#默认： 'same-origin'
Unless set to None, the\nSecurityMiddleware sets the\nCross-Origin Opener Policy header on all responses that do not already\nhave it to the value provided.
SECURE_HSTS_INCLUDE_SUBDOMAINSLink to this heading#默认：False
如果 True，则 SecurityMiddleware 在 HTTP 严格传输安全 头中添加 includeSubDomains 指令。除非 SECURE_HSTS_SECONDS 被设置为非零值，否则它没有任何效果。
SECURE_HSTS_PRELOADLink to this heading#默认：False
如果 True，则 SecurityMiddleware 在 HTTP 严格传输安全 头中添加 preload 指令。除非 SECURE_HSTS_SECONDS 设置为非零值，否则没有效果。
SECURE_HSTS_SECONDSLink to this heading#默认： 0
如果设置为非零的整数值，则 SecurityMiddleware 会对所有尚未设置 HTTP 严格传输安全 头的响应进行设置。
SECURE_PROXY_SSL_HEADERLink to this heading#默认： None
A tuple representing an HTTP header/value combination that signifies a request\nis secure. This controls the behavior of the request object's is_secure()\nmethod.
默认情况下，is_secure() 通过确认请求的 URL 使用 https:// 来判断请求是否安全。这个方法对 Django 的 CSRF 保护很重要，你自己的代码或第三方应用可能会用到它。
如果你的 Django 应用是在代理服务器后面，那么无论原始请求是否使用 HTTPS，代理服务器都可能会“吞噬”。如果代理和 Django 之间有一个非 HTTPS 的连接，那么 is_secure() 总是返回 False ——即使是终端用户通过 HTTPS 发出的请求。相反，如果代理和 Django 之间有 HTTPS 连接，那么 is_secure() 将总是返回 True ——即使是对最终用户通过 HTTPS 发出的请求。
在这种情况下，配置你的代理服务器，设置一个自定义的 HTTP 头，告诉 Django 这个请求是否是通过 HTTPS 进来的，并设置 SECURE_PROXY_SSL_HEADER，这样 Django 就知道要找什么头了。
设置一个包含两个元素的元组——要查找的头的名称和所需的值。例如：
\nSECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')\nThis tells Django to trust the X-Forwarded-Proto header that comes from our\nproxy and that the request is guaranteed to be secure (i.e., it originally came\nin via HTTPS) when:
the header value is 'https', or
its initial, leftmost value is 'https' in the case of a comma-separated\nlist of protocols (e.g. 'https,http,http').
如果你控制了你的代理或者有其他的保证，你应该 只 设置这个配置，它可以适当地设置／剥离这个头。
\n需要注意的是，头的格式需要和 request.META 使用的格式一样——全大写，并且可能以 HTTP_ 开头。（记住，Django 会在 x-header 名称的开头自动加上 'HTTP_'，然后才会在 request.META 中使用。）
SECURE_REDIRECT_EXEMPTLink to this heading#默认： [] （空列表）
如果一个 URL 路径与这个列表中的正则表达式相匹配，那么请求将不会被重定向到 HTTPS。SecurityMiddleware 会从 URL 路径中去掉前导斜杠，所以模式不应该包含它们，例如 SECURE_REDIRECT_EXEMPT = [r'^no-ssl/$', ...]。如果 SECURE_SSL_REDIRECT 是 False，这个配置就没有效果。
SECURE_REFERRER_POLICYLink to this heading#默认： 'same-origin'
如果设置了 SecurityMiddleware，则会在所有响应中设置 :ref:`referrer-policy`头，如果还没有该头，则将其设置为提供的值。
SECURE_SSL_HOSTLink to this heading#默认： None
如果是一个字符串（如 secure.example.com），所有 SSL 重定向都将指向这个主机，而不是最初请求的主机（如 www.example.com）。如果 SECURE_SSL_REDIRECT 为 False，则该配置没有效果。
SECURE_SSL_REDIRECTLink to this heading#默认：False
如果 True，则 SecurityMiddleware 重定向 所有非 HTTPS 的请求都会转为 HTTPS（除了那些匹配 SECURE_REDIRECT_EXEMPT 中所列正则表达式的 URL）。
SERIALIZATION_MODULESLink to this heading#默认：未定义
\n一个包含序列化器定义（以字符串形式提供）的模块字典，以该序列化类型的字符串标识符为键。例如，要定义一个 YAML 序列化器，使用：
\nSERIALIZATION_MODULES = {'yaml': 'path.to.yaml_serializer'}\nSERVER_EMAILLink to this heading#默认： 'root@localhost'
SHORT_DATE_FORMATLink to this heading#默认 ：'m/d/Y' （例如 12/31/2003）
可用于在模板上显示日期字段的可用格式。请注意，如果 USE_L10N 被设置为 True，那么相应的本地决定的格式具有更高的优先权，并将被应用。参见 允许的日期格式字符串。
SHORT_DATETIME_FORMATLink to this heading#默认： 'm/d/Y P' （例如 12/31/2003 4 p.m.）
可用于在模板上显示日期时间字段的可用格式。请注意，如果 USE_L10N 被设置为 True，那么相应的本地决定的格式具有更高的优先级，并将被应用。参见 允许的日期格式字符串。
另见 DATE_FORMAT 和 SHORT_DATE_FORMAT。
SIGNING_BACKENDLink to this heading#默认： 'django.core.signing.TimestampSigner'
用于签署 cookie 和其他数据的后端。
\n另见 加密签名 文档。
\nSILENCED_SYSTEM_CHECKSLink to this heading#默认： [] （空列表）
你希望永久获取和忽略的系统检查框架生成的消息标识符列表（即 ["models.W001"]）。静默检查不会被输出到控制台。
另见 系统检查框架 文档。
\nTEMPLATESLink to this heading#默认： [] （空列表）
一个包含所有 Django 模板引擎的配置的列表。列表中的每一项都是一个字典，包含了各个引擎的选项。
\n下面是一个配置，告诉 Django 模板引擎从每个安装好的应用程序中的 templates 子目录中加载模板：
TEMPLATES = [\n {\n 'BACKEND': 'django.template.backends.django.DjangoTemplates',\n 'APP_DIRS': True,\n },\n]\n以下选项适用于所有后端。
\nBACKENDLink to this heading#默认：未定义
\n要使用的模板后端。内置的模板后端有：
\n'django.template.backends.django.DjangoTemplates'
'django.template.backends.jinja2.Jinja2'
你可以通过将 BACKEND 设置为一个完全限定的路径（例如 'mypackage.whatever.Backend'）来使用一个不在 Django 中的模板后端。
NAMELink to this heading#默认：见下方
\n这个特定模板引擎的别称。它是一个标识符，允许选择一个引擎进行渲染。所有配置的模板引擎的别名必须是唯一的。
\n它默认为定义引擎类的模块名称，即 BACKEND 的下一个到最后一个，如果没有提供的话。例如，如果后端是 'mypackage.whatever.Backend'，那么它的默认名称是 'whatever'。
DIRSLink to this heading#默认： [] （空列表）
按照搜索顺序，引擎应该查找模板源文件的目录。
\nAPP_DIRSLink to this heading#默认：False
引擎是否应该在已安装的应用程序中查找模板源文件。
\n\nOPTIONSLink to this heading#默认值： {} （空字典）
要传递给模板后台的额外参数。根据模板后端的不同，可用的参数也不同。参见 DjangoTemplates 和 Jinja2 了解内置后端的选项。
TEST_RUNNERLink to this heading#默认： 'django.test.runner.DiscoverRunner'
用于启动测试套件的类的名称。参见 使用不同的测试框架。
\nTEST_NON_SERIALIZED_APPSLink to this heading#默认： [] （空列表）
为了在 TransactionTestCase 和没有事务的数据库后端测试之间恢复数据库状态，Django 在启动测试运行时，会 序列化所有应用的内容，这样就可以在运行需要的测试之前，从该副本重新加载。
这将减慢测试运行器的启动时间；如果你有一些应用程序不需要这个功能，你可以在这里添加它们的全名（例如 'django.contrib.contenttypes'），将它们从这个序列化过程中排除。
THOUSAND_SEPARATORLink to this heading#默认： ',' （英文逗号）
格式化数字时使用的默认千位分隔符。只有当 USE_THOUSAND_SEPARATOR 为 True 和 NUMBER_GROUPING 大于 0 时，才使用此配置。
请注意，如果 USE_L10N 设置为 True，那么将采用本地决定的格式，具有更高的优先权。
另见 NUMBER_GROUPING、DECIMAL_SEPARATOR 和 USE_THOUSAND_SEPARATOR。
TIME_FORMATLink to this heading#默认： 'P' （例如 4 p.m.）
在系统的任何部分显示时间字段时使用的默认格式。请注意，如果 USE_L10N 被设置为 True，那么本地决定的格式具有更高的优先权，并将被应用。参见 允许的日期格式字符串。
另见 DATE_FORMAT 和 DATETIME_FORMAT。
TIME_INPUT_FORMATSLink to this heading#默认：
\n[\n '%H:%M:%S', # '14:30:59'\n '%H:%M:%S.%f', # '14:30:59.000200'\n '%H:%M', # '14:30'\n]\n在时间字段上输入数据时可接受的格式列表。格式将按顺序被尝试，使用第一个有效的格式。注意这些格式字符串使用 Python 的 datetime 模块语法，而不是来自 date 模板过滤器的格式字符串。
当 USE_L10N 为 True 时，将采用本地规定的格式，具有更高的优先权。
TIME_ZONELink to this heading#默认： 'America/Chicago'
表示本次安装的时区的字符串。参见 时区列表 。
\n\n注意，这不一定是服务器的时区。例如，一个服务器可能服务于多个 Django 网站，每个网站都有单独的时区配置。
\n当 USE_TZ 为 False 时，这是 Django 存储所有日期时间的时区。当 USE_TZ 为 True 时，这是 Django 在模板中显示日期时间和解释表单中输入的日期时间的默认时区。
在 Unix 环境下（实现了 time.tzset()），Django 将 os.environ['TZ'] 变量设置为你在 TIME_ZONE 配置中指定的时区。这样，你所有的视图和模型都会自动在这个时区运行。但是，如果你使用的是 手动设置配置 中描述的手动配置选项，Django 就不会设置 TZ 环境变量。如果 Django 没有设置 TZ 环境变量，那么就需要你确保你的进程运行在正确的环境中。
USE_DEPRECATED_PYTZLink to this heading#默认：False
A boolean that specifies whether to use pytz, rather than zoneinfo,\nas the default time zone implementation.
USE_I18NLink to this heading#默认： True
一个布尔值，用于指定是否应该启用 Django 的翻译系统。这提供了一个关闭翻译系统的方法，以保证性能。如果设置为 False，Django 会进行一些优化，以避免加载翻译机制。
另见 LANGUAGE_CODE'、 :setting:`USE_L10N 和 :setting:`USE_TZ'。
USE_L10NLink to this heading#默认： True
一个布尔值，用于指定是否默认启用数据的本地化格式。如果设置为 True，例如，Django 将使用当前语言的格式来显示数字和日期。
另见 LANGUAGE_CODE、USE_I18N 和 USE_TZ。
USE_THOUSAND_SEPARATORLink to this heading#默认：False
A boolean that specifies whether to display numbers using a thousand separator.\nWhen set to True and USE_L10N is also True, Django will\nformat numbers using the NUMBER_GROUPING and\nTHOUSAND_SEPARATOR settings. The latter two settings may also be\ndictated by the locale, which takes precedence.
USE_TZLink to this heading#默认：False
一个布尔值，用于指定 Django 是否默认使用时区感知。如果设置为 True，Django 将在内部使用时区感知的日期。
当 USE_TZ 为 False 时，Django 将使用本地时间的本地日期，除非在解析 ISO 8601 格式的字符串时，如果存在时区信息，则会一直保留。
USE_X_FORWARDED_HOSTLink to this heading#默认：False
一个布尔值，用于指定是否使用 X-Forwarded-Host 头，而不是 Host 头。只有在使用设置该头的代理时才应启用。
此设置优先于 USE_X_FORWARDED_PORT。根据 RFC 7239 Section 5.3，X-Forwarded-Host 头可以包括端口号，在这种情况下，你不应该使用 USE_X_FORWARDED_PORT。
USE_X_FORWARDED_PORTLink to this heading#默认：False
一个布尔值，用于指定是否使用 X-Forwarded-Port 头，而不是 SERVER_PORT``META 变量。只有在使用设置该头的代理时，才应启用。
USE_X_FORWARDED_HOST 优先于此配置。
WSGI_APPLICATIONLink to this heading#默认： None
Django 内置服务器（如 runserver）将使用的 WSGI 应用对象的完整 Python 路径。django-admin startproject 管理命令将创建一个标准的 wsgi.py 文件，其中有一个 application 可调用，并将此配置指向该 application。
如果没有设置，将使用 django.core.wsgi.get_wsgi_application() 的返回值。在这种情况下， runserver 的行为将与之前的 Django 版本相同。
YEAR_MONTH_FORMATLink to this heading#默认： 'F Y'
在 Django admin change-list 页面中，当只显示年和月的时候，默认的日期字段的格式也可能被系统的其他部分使用。
\n例如，当 Django 管理员的变更列表页面被日期 drilldown 过滤时，给定月份的头显示月份和年份。不同的地域有不同的格式。例如，美国英语会说“January 2006”，而另一个地方语言可能会说 “2006/January”。
\n请注意，如果 USE_L10N 设置为 True，则相应的本地决定的格式具有更高的优先权，并将被应用。
查看 允许的日期格式字符串。另见 DATE_FORMAT、DATETIME_FORMAT、TIME_FORMAT 和 MONTH_DAY_FORMAT。
X_FRAME_OPTIONSLink to this heading#默认： 'DENY'
XFrameOptionsMiddleware 使用的 X- Frame-Options 头的默认值。参见 点击劫持保护 文档。
django.contrib.auth 的配置。
AUTHENTICATION_BACKENDSLink to this heading#默认： ['django.contrib.auth.backends.ModelBackend']
当试图认证用户时，要使用的认证后端类（字符串）列表。详情请参见 认证后端文档。
\nAUTH_USER_MODELLink to this heading#默认： 'auth.User'
用来表示用户的模型。见 替换一个自定义的 User 模型。。
\n\nLOGIN_REDIRECT_URLLink to this heading#默认： '/accounts/profile/'
LOGIN_URLLink to this heading#默认： '/accounts/login/'
当使用 login_required() 装饰器、LoginRequiredMixin 或 AccessMixin 时，重定向请求登录的 URL 或 命名 URL 模式。
LOGOUT_REDIRECT_URLLink to this heading#默认： None
如果 LogoutView 没有 next_page 属性，则注销后重定向请求的 URL 或 命名 URL 模式。
如果 None，将不执行重定向，并显示注销视图。
PASSWORD_RESET_TIMEOUTLink to this heading#默认： 259200 （3 天，以秒为单位）
密码重置链接的有效秒数。
\n由 PasswordResetConfirmView 使用。
PASSWORD_HASHERSLink to this heading#查看 Django 如何存储密码。
\n默认：
\n[\n 'django.contrib.auth.hashers.PBKDF2PasswordHasher',\n 'django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher',\n 'django.contrib.auth.hashers.Argon2PasswordHasher',\n 'django.contrib.auth.hashers.BCryptSHA256PasswordHasher',\n]\nAUTH_PASSWORD_VALIDATORSLink to this heading#默认： [] （空列表）
用于检查用户密码强度的验证器列表。更多细节请参见 密码验证。默认情况下，不执行验证，所有密码都被接受。
\nMESSAGE_LEVELLink to this heading#默认： messages.INFO
设置消息框架将记录的最小消息级别。详见 消息级别。
\n\nMESSAGE_STORAGELink to this heading#默认： 'django.contrib.messages.storage.fallback.FallbackStorage'
控制 Django 存储消息数据的地方。有效值是：
\n'django.contrib.messages.storage.fallback.FallbackStorage'
'django.contrib.messages.storage.session.SessionStorage'
'django.contrib.messages.storage.cookie.CookieStorage'
详见 消息储存后端。
\n使用 cookie 的后端—— CookieStorage 和 FallbackStorage ——在设置它们的 cookie 时，使用 SESSION_COOKIE_DOMAIN、SESSION_COOKIE_SECURE 和 SESSION_COOKIE_HTTPONLY 的值。
SESSION_CACHE_ALIASLink to this heading#默认： 'default'
如果你使用的是 基于缓存的会话存储，这将选择要使用的缓存。
\nSESSION_ENGINELink to this heading#默认： 'django.contrib.sessions.backends.db'
控制 Django 存储会话数据的地方。包括的引擎有：
\n'django.contrib.sessions.backends.db'
'django.contrib.sessions.backends.file'
'django.contrib.sessions.backends.cache'
'django.contrib.sessions.backends.cached_db'
'django.contrib.sessions.backends.signed_cookies'
详见 配置会话(session)引擎。
\nSESSION_EXPIRE_AT_BROWSER_CLOSELink to this heading#默认：False
是否在用户关闭浏览器时结束会话。参见 Browser-length 会话 vs 持久会话。
\nSESSION_FILE_PATHLink to this heading#默认： None
如果你使用的是基于文件的会话存储，那么这个选项设置了 Django 存储会话数据的目录，当使用默认值（None）时，Django 将使用系统的标准临时目录。
SESSION_SAVE_EVERY_REQUESTLink to this heading#默认：False
是否在每次请求时保存会话数据。如果这个配置是 False （默认），那么会话数据只有在被修改时才会被保存，也就是说，如果它的任何字典值被分配或删除，那么会话数据就会被保存。即使这个配置是活动的，也不会创建空会话。
SESSION_SERIALIZERLink to this heading#默认： 'django.contrib.sessions.serializers.JSONSerializer'
Full import path of a serializer class to use for serializing session data.\nIncluded serializer is:
\n'django.contrib.sessions.serializers.JSONSerializer'
See 会话序列化 for details.
\ndjango.contrib.sites 的配置。
SITE_IDLink to this heading#默认：未定义
\n当前网站在 django_site 数据库表中的 ID，为整数。这样，应用数据就可以挂到特定的站点上，一个数据库可以管理多个站点的内容。
django.contrib.staticfiles 的配置。
STATIC_ROOTLink to this heading#默认： None
collectstatic 将收集静态文件进行部署的目录的绝对路径。
例如： "/var/www/example.com/static/"
如果 staticfiles contrib 应用已启用（如在默认的项目模板中）， collectstatic 管理命令将收集静态文件到这个目录。更多使用方法请参见 管理静态文件 的操作指南。
STATIC_URLLink to this heading#默认： None
引用位于 STATIC_ROOT 中的静态文件时要使用的 URL。
Example: "static/" or "http://static.example.com/"
如果不是 None，这将被用作 资源定义 （Media 类）和 静态文件应用 的基本路径。
如果设置为非空值，必须以斜线结束。
\n你可能需要 在开发中服务这些文件，在 生产中 肯定需要这样做。
\n\nSTATICFILES_DIRSLink to this heading#默认： [] （空列表）
这个配置定义了静态文件应用在启用 FileSystemFinder 查找器时将穿越的额外位置，例如，如果你使用 collectstatic 或 findstatic 管理命令或使用静态文件服务视图。
这应该被设置为包含附加文件目录完整路径的字符串列表，例如：
\nSTATICFILES_DIRS = [\n "/home/special.polls.com/polls/static",\n "/home/polls.com/polls/static",\n "/opt/webfiles/common",\n]\n请注意，这些路径应该使用 Unix 风格的斜线，即使在 Windows 上也是如此（例如 "C:/Users/user/mysite/extra_static_content"）。
如果你想用一个额外的命名空间来引用其中一个位置的文件，你可以 可选的 提供一个前缀作为 (prefix, path) 的元组，例如：
STATICFILES_DIRS = [\n # ...\n ("downloads", "/opt/webfiles/stats"),\n]\nFor example, assuming you have STATIC_URL set to 'static/', the\ncollectstatic management command would collect the "stats" files\nin a 'downloads' subdirectory of STATIC_ROOT.
这将允许你在你的模板中用 '/static/downloads/polls_20101022.tar.gz' 引用本地文件 '/opt/webfiles/stats/polls_20101022.tar.gz'，例如：
<a href="{% static 'downloads/polls_20101022.tar.gz' %}">\nSTATICFILES_STORAGELink to this heading#默认： 'django.contrib.staticfiles.storage.StaticFilesStorage'
使用 collectstatic 管理命令收集静态文件时要使用的文件存储引擎。
在此配置中定义的存储后端的即用实例可以在 django.contrib.staticfiles.storage.staticfiles_storage 中找到。
例如，参见 从云服务或 CDN 提供静态文件服务。
\nSTATICFILES_FINDERSLink to this heading#默认：
\n[\n 'django.contrib.staticfiles.finders.FileSystemFinder',\n 'django.contrib.staticfiles.finders.AppDirectoriesFinder',\n]\n知道如何找到不同位置的静态文件的查找器后端列表。
\n默认情况下，将查找存储在 STATICFILES_DIRS 配置中的文件（使用 django.contrib.staticfiles.finders.FileSystemFinder）和每个应用程序的 static 子目录中的文件（使用 django.contrib.staticfiles.finders.AppDirectoriesFinder）。如果存在多个同名文件，将使用第一个找到的文件。
有一个查找器是默认禁用的： django.contrib.staticfiles.finders.DefaultStorageFinder。如果添加到你的 STATICFILES_FINDERS 配置中，它将在 DEFAULT_FILE_STORAGE 配置所定义的默认文件存储中查找静态文件。
静态文件查找器目前被认为是一个私有接口，因此这个接口是没有文档的。
\ni18n ／ l10n）Link to this heading#安全
\n\n数据库： TEST