ABSOLUTE_URL_OVERRIDES¶

預設值：{} (空的字典)

一個字典，將 "app_label.model_name" 字串映射到接收模型物件並傳回其 URL 的函式。這是在每個安裝基礎上插入或覆寫 get_absolute_url() 方法的一種方式。範例

ABSOLUTE_URL_OVERRIDES = {
    "blogs.blog": lambda o: "/blogs/%s/" % o.slug,
    "news.story": lambda o: "/stories/%s/%s/" % (o.pub_year, o.slug),
}

此設定中使用的模型名稱應全部小寫，無論實際模型類別名稱的大小寫為何。

ADMINS¶

預設值：[] (空的列表)

所有接收程式碼錯誤通知的人員的列表。當 DEBUG=False 且 AdminEmailHandler 在 LOGGING 中設定時（預設情況下完成），Django 會將請求/回應週期中引發的例外狀況詳細資訊透過電子郵件發送給這些人員。

列表中的每個項目都應為 (完整姓名, 電子郵件地址) 的元組。範例

[("John", "john@example.com"), ("Mary", "mary@example.com")]

ALLOWED_HOSTS¶

預設值：[] (空的列表)

代表此 Django 網站可以服務的主機/網域名稱的字串列表。這是一種安全措施，可防止 HTTP 主機標頭攻擊，即使在許多看似安全的網路伺服器設定下，這種攻擊也是有可能的。

此列表中的值可以是完整限定名稱（例如 'www.example.com'），在這種情況下，它們將與請求的 Host 標頭完全匹配（不區分大小寫，不包括連接埠）。以句點開頭的值可以用作子網域萬用字元：'.example.com' 將匹配 example.com、www.example.com 和 example.com 的任何其他子網域。'*' 的值將匹配任何內容；在這種情況下，您有責任提供您自己的 Host 標頭驗證（可能在中間件中；如果是這樣，則此中間件必須在 MIDDLEWARE 中列出）。

Django 也允許任何項目的 完整限定網域名稱 (FQDN)。某些瀏覽器會在 Host 標頭中包含尾隨點，Django 在執行主機驗證時會將其剝離。

如果 Host 標頭（或如果啟用 USE_X_FORWARDED_HOST，則為 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_SLASH¶

預設值：True

設定為 True 時，如果請求 URL 與 URLconf 中的任何模式不匹配，且不以斜線結尾，則會向相同的 URL 發出 HTTP 重定向，並附加斜線。請注意，重定向可能會導致 POST 請求中提交的任何資料遺失。

只有在安裝 CommonMiddleware 時才會使用 APPEND_SLASH 設定（請參閱 中介軟體）。另請參閱 PREPEND_WWW。

CACHES¶

預設值

{
    "default": {
        "BACKEND": "django.core.cache.backends.locmem.LocMemCache",
    }
}

一個字典，其中包含將與 Django 一起使用的所有快取設定。它是一個巢狀字典，其內容將快取別名映射到包含個別快取的選項的字典。

CACHES 設定必須設定 default 快取；也可以指定任意數量的其他快取。如果您使用的快取後端不是本機記憶體快取，或者您需要定義多個快取，則需要其他選項。可以使用下列快取選項。

def make_key(key, key_prefix, version):
    return ":".join([key_prefix, str(version), key])

CACHES = {
    "default": {
        "BACKEND": "django.core.cache.backends.filebased.FileBasedCache",
        "LOCATION": "/var/tmp/django_cache",
    }
}

CACHE_MIDDLEWARE_ALIAS¶

預設值：'default'

用於快取中介軟體的快取連線。

CACHE_MIDDLEWARE_KEY_PREFIX¶

預設值：'' (空字串)

將會加在由快取中介軟體產生的快取鍵前面的字串。這個前綴會與KEY_PREFIX 設定合併；它不會取代它。

請參閱Django 的快取框架。

CACHE_MIDDLEWARE_SECONDS¶

預設值：600

為快取中介軟體快取頁面的預設整數秒數。

請參閱Django 的快取框架。

CSRF_COOKIE_AGE¶

預設值：31449600（約為 1 年，單位為秒）

CSRF Cookie 的有效期限，以秒為單位。

設定長時間到期時間的原因是為了避免使用者關閉瀏覽器或將頁面加入書籤，然後從瀏覽器快取載入該頁面的情況下出現問題。如果沒有永久性 Cookie，在這種情況下表單提交將會失敗。

某些瀏覽器（特別是 Internet Explorer）可能會不允許使用永久性 Cookie，或者在磁碟上的 Cookie Jar 索引可能已損毀，從而導致 CSRF 保護檢查（有時會間歇性地）失敗。將此設定更改為 None 以使用基於會話的 CSRF Cookie，這會將 Cookie 保存在記憶體中而不是永久儲存裝置上。

CSRF_COOKIE_DOMAIN¶

預設值：None

設定 CSRF Cookie 時要使用的網域。這對於輕鬆允許跨子網域請求被排除在正常的跨站請求偽造保護之外很有用。它應設定為一個字串，例如 ".example.com"，以允許來自一個子網域上的表單的 POST 請求被另一個子網域提供的檢視接受。

請注意，此設定的存在並不表示 Django 的 CSRF 保護預設可以防止跨子網域攻擊 - 請參閱CSRF 限制章節。

CSRF_COOKIE_HTTPONLY¶

預設值：False

是否在 CSRF Cookie 上使用 HttpOnly 標記。如果將此設定為 True，用戶端 JavaScript 將無法存取 CSRF Cookie。

將 CSRF Cookie 指定為 HttpOnly 並不會提供任何實際保護，因為 CSRF 只是為了防止跨網域攻擊。如果攻擊者可以透過 JavaScript 讀取 Cookie，他們已經與瀏覽器所知的同一網域上，因此他們可以為所欲為。（XSS 是一個比 CSRF 更大的漏洞。）

儘管此設定提供的實際好處不多，但有時安全稽核人員會要求這樣做。

如果您啟用此設定並且需要使用 AJAX 請求傳送 CSRF 權杖的值，您的 JavaScript 必須從隱藏的 CSRF 權杖表單輸入中獲取值，而不是從 Cookie 中獲取。

有關 HttpOnly 的詳細資訊，請參閱SESSION_COOKIE_HTTPONLY。

CSRF_COOKIE_NAME¶

預設值：'csrftoken'

用於 CSRF 驗證權杖的 Cookie 名稱。這可以是任何您想要的值（只要它與應用程式中的其他 Cookie 名稱不同）。請參閱跨站請求偽造保護。

CSRF_COOKIE_PATH¶

預設值：'/'

在 CSRF Cookie 上設定的路徑。這應該與您的 Django 安裝的 URL 路徑相符，或是該路徑的父路徑。

如果您有多個 Django 實例在同一個主機名稱下執行，這會很有用。它們可以使用不同的 Cookie 路徑，並且每個實例只會看到自己的 CSRF Cookie。

CSRF_COOKIE_SAMESITE¶

預設值：'Lax'

CSRF Cookie 上 SameSite 標記的值。此標記可防止 Cookie 在跨站請求中傳送。

有關 SameSite 的詳細資訊，請參閱SESSION_COOKIE_SAMESITE。

CSRF_COOKIE_SECURE¶

預設值：False

是否對 CSRF Cookie 使用安全 Cookie。如果將此設定為 True，Cookie 將被標記為「安全」，這表示瀏覽器可能會確保 Cookie 只會在 HTTPS 連線中傳送。

CSRF_USE_SESSIONS¶

預設值：False

是否將 CSRF 權杖儲存在使用者的會話中，而不是儲存在 Cookie 中。它需要使用 django.contrib.sessions。

將 CSRF 權杖儲存在 Cookie 中（Django 的預設值）是安全的，但將其儲存在會話中是其他 Web 框架中的常見做法，因此有時安全稽核人員會要求這樣做。

由於預設錯誤檢視需要 CSRF 權杖，因此如果使用 CSRF_USE_SESSIONS，SessionMiddleware 必須出現在 MIDDLEWARE 中，並且在任何可能會引發例外以觸發錯誤檢視的中介軟體之前（例如 PermissionDenied）。請參閱中介軟體排序。

CSRF_FAILURE_VIEW¶

預設值：'django.views.csrf.csrf_failure'

當傳入的請求被CSRF 保護拒絕時要使用的檢視函數的虛線路徑。該函數應該具有以下簽名

def csrf_failure(request, reason=""): ...

其中 reason 是一個簡短訊息（旨在供開發人員或記錄使用，而不是供最終使用者使用），表示請求被拒絕的原因。它應該傳回一個 HttpResponseForbidden。

django.views.csrf.csrf_failure() 接受一個額外的 template_name 參數，預設為 '403_csrf.html'。如果存在具有該名稱的範本，它將用於呈現該頁面。

CSRF_HEADER_NAME¶

預設值：'HTTP_X_CSRFTOKEN'

用於 CSRF 驗證的請求標頭名稱。

與 request.META 中的其他 HTTP 標頭一樣，從伺服器接收到的標頭名稱會被正規化，方法是將所有字元轉換為大寫，將所有連字號替換為底線，並在名稱中加上 'HTTP_' 前綴。例如，如果您的用戶端傳送 'X-XSRF-TOKEN' 標頭，則設定應為 'HTTP_X_XSRF_TOKEN'。

CSRF_TRUSTED_ORIGINS¶

預設值：[] (空的列表)

一個用於不安全請求（例如 POST）的信任來源列表。

對於包含 Origin 標頭的請求，Django 的 CSRF 保護機制要求該標頭與 Host 標頭中存在的來源相符。

對於不包含 Origin 標頭的安全不安全請求，該請求必須具有與 Host 標頭中存在的來源相符的 Referer 標頭。

這些檢查可以防止例如從 subdomain.example.com 發出的 POST 請求成功對抗 api.example.com。如果您需要跨來源的不安全請求，繼續使用這個範例，請將 'https://subdomain.example.com' 加入此列表（和/或如果請求來自不安全的頁面，則加入 http://...）。

此設定也支援子網域，因此您可以加入 'https://*.example.com'，例如，允許從 example.com 的所有子網域進行存取。

DATABASES¶

預設值：{} (空的字典)

一個包含所有要與 Django 一起使用的資料庫設定的字典。它是一個巢狀字典，其內容將資料庫別名對應到包含個別資料庫選項的字典。

DATABASES 設定必須設定一個 default 資料庫；也可以指定任何數量的額外資料庫。

最簡單的設定檔是使用 SQLite 的單一資料庫設定。可以使用以下方式設定

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.sqlite3",
        "NAME": "mydatabase",
    }
}

當連線到其他資料庫後端（例如 MariaDB、MySQL、Oracle 或 PostgreSQL）時，將需要額外的連線參數。請參閱下方關於如何指定其他資料庫類型的 ENGINE 設定。此範例適用於 PostgreSQL

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.postgresql",
        "NAME": "mydatabase",
        "USER": "mydatabaseuser",
        "PASSWORD": "mypassword",
        "HOST": "127.0.0.1",
        "PORT": "5432",
    }
}

以下可能需要用於更複雜設定的內部選項可供使用

"HOST": "/var/run/mysql"

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.postgresql",
        "USER": "mydatabaseuser",
        "NAME": "mydatabase",
        "TEST": {
            "NAME": "mytestdatabase",
        },
    },
}

DATA_UPLOAD_MAX_MEMORY_SIZE¶

預設值：2621440（即 2.5 MB）。

在引發 SuspiciousOperation (RequestDataTooBig) 之前，請求主體允許的最大位元組大小。當存取request.body 或 request.POST 時會執行檢查，並根據排除任何檔案上傳資料的總請求大小計算。您可以將此設定為None來停用檢查。預期接收異常大型表單提交的應用程式應調整此設定。

請求資料量與處理請求和填入 GET 和 POST 字典所需的記憶體量相關。如果未經檢查，大型請求可能會被用作阻斷服務攻擊向量。由於網路伺服器通常不執行深度請求檢查，因此無法在該層級執行類似的檢查。

另請參閱FILE_UPLOAD_MAX_MEMORY_SIZE。

DATA_UPLOAD_MAX_NUMBER_FIELDS¶

預設值：1000

在引發 SuspiciousOperation (TooManyFields) 之前，可透過 GET 或 POST 接收的最大參數數量。您可以將此設定為None來停用檢查。預期接收異常大量表單欄位的應用程式應調整此設定。

請求參數的數量與處理請求和填入 GET 和 POST 字典所需的時間量相關。如果未經檢查，大型請求可能會被用作阻斷服務攻擊向量。由於網路伺服器通常不執行深度請求檢查，因此無法在該層級執行類似的檢查。

DATA_UPLOAD_MAX_NUMBER_FILES¶

預設值：100

在 multipart/form-data 編碼的請求中，透過 POST 接收的最大檔案數量，超過此數量將會引發 SuspiciousOperation (TooManyFiles) 錯誤。您可以將此值設定為 None 來停用此檢查。預期會接收大量檔案欄位的應用程式應調整此設定。

接受的檔案數量與處理請求所需的時間和記憶體量相關。如果未加檢查，大型請求可能被用作阻斷服務攻擊的載體。由於網頁伺服器通常不執行深入的請求檢查，因此無法在該層級執行類似的檢查。

DATABASE_ROUTERS¶

預設值：[] (空的列表)

用於決定執行資料庫查詢時要使用哪個資料庫的路由列表。

請參閱關於 多資料庫組態中的自動資料庫路由 的文件。

DATE_FORMAT¶

預設值：'N j, Y' (例如 2月 4, 2003)

在系統的任何部分顯示日期欄位時使用的預設格式。請注意，地區設定指定的格式具有較高的優先權，並會改為套用。請參閱 允許的 日期 格式 字串。

另請參閱 DATETIME_FORMAT、TIME_FORMAT 和 SHORT_DATE_FORMAT。

DATE_INPUT_FORMATS¶

預設值

[
    "%Y-%m-%d",  # '2006-10-25'
    "%m/%d/%Y",  # '10/25/2006'
    "%m/%d/%y",  # '10/25/06'
    "%b %d %Y",  # 'Oct 25 2006'
    "%b %d, %Y",  # 'Oct 25, 2006'
    "%d %b %Y",  # '25 Oct 2006'
    "%d %b, %Y",  # '25 Oct, 2006'
    "%B %d %Y",  # 'October 25 2006'
    "%B %d, %Y",  # 'October 25, 2006'
    "%d %B %Y",  # '25 October 2006'
    "%d %B, %Y",  # '25 October, 2006'
]

在日期欄位輸入資料時將接受的格式列表。將按順序嘗試格式，使用第一個有效的格式。請注意，這些格式字串使用 Python 的 datetime 模組語法，而不是 date 模板篩選器的格式字串。

地區設定指定的格式具有較高的優先權，並會改為套用。

另請參閱 DATETIME_INPUT_FORMATS 和 TIME_INPUT_FORMATS。

DATETIME_FORMAT¶

預設值：'N j, Y, P' (例如 2月 4, 2003, 下午 4 點)

在系統的任何部分顯示日期時間欄位時使用的預設格式。請注意，地區設定指定的格式具有較高的優先權，並會改為套用。請參閱 允許的 日期 格式 字串。

另請參閱 DATE_FORMAT、TIME_FORMAT 和 SHORT_DATETIME_FORMAT。

DATETIME_INPUT_FORMATS¶

預設值

[
    "%Y-%m-%d %H:%M:%S",  # '2006-10-25 14:30:59'
    "%Y-%m-%d %H:%M:%S.%f",  # '2006-10-25 14:30:59.000200'
    "%Y-%m-%d %H:%M",  # '2006-10-25 14:30'
    "%m/%d/%Y %H:%M:%S",  # '10/25/2006 14:30:59'
    "%m/%d/%Y %H:%M:%S.%f",  # '10/25/2006 14:30:59.000200'
    "%m/%d/%Y %H:%M",  # '10/25/2006 14:30'
    "%m/%d/%y %H:%M:%S",  # '10/25/06 14:30:59'
    "%m/%d/%y %H:%M:%S.%f",  # '10/25/06 14:30:59.000200'
    "%m/%d/%y %H:%M",  # '10/25/06 14:30'
]

在日期時間欄位輸入資料時將接受的格式列表。將按順序嘗試格式，使用第一個有效的格式。請注意，這些格式字串使用 Python 的 datetime 模組語法，而不是 date 模板篩選器的格式字串。僅限日期的格式不包含在內，因為日期時間欄位會在最後嘗試 DATE_INPUT_FORMATS。

地區設定指定的格式具有較高的優先權，並會改為套用。

另請參閱 DATE_INPUT_FORMATS 和 TIME_INPUT_FORMATS。

DEBUG¶

預設值：False

一個布林值，用於開啟/關閉除錯模式。

永遠不要在開啟 DEBUG 的情況下將網站部署到生產環境。

除錯模式的主要功能之一是顯示詳細的錯誤頁面。如果您的應用程式在 DEBUG 為 True 時引發異常，Django 將顯示詳細的回溯，包括有關您環境的大量元數據，例如所有目前定義的 Django 設定 (來自 settings.py)。

作為安全措施，Django 將*不會*包含可能敏感的設定，例如 SECRET_KEY。具體而言，它將排除名稱包含以下任何內容的任何設定

• 'API'

• 'KEY'

• 'PASS'

• 'SECRET'

• 'SIGNATURE'

• 'TOKEN'

請注意，這些是*部分*匹配。'PASS' 也會匹配 PASSWORD，就像 'TOKEN' 也會匹配 TOKENIZED 等等。

儘管如此，請注意，您的除錯輸出始終會有不適合公開消費的部分。檔案路徑、組態選項等都為攻擊者提供了有關您伺服器的額外資訊。

同樣重要的是要記住，當在開啟 DEBUG 的情況下執行時，Django 會記住它執行的每個 SQL 查詢。這在您進行除錯時很有用，但它會迅速消耗生產伺服器上的記憶體。

最後，如果 DEBUG 為 False，您還需要正確設定 ALLOWED_HOSTS 設定。未能這樣做將導致所有請求都以「錯誤請求 (400)」返回。

DEBUG_PROPAGATE_EXCEPTIONS¶

預設值：False

如果設定為 True，則會跳過 Django 對檢視函數的異常處理 (handler500，或者如果 DEBUG 為 True 則使用除錯檢視) 和 500 回應的記錄 (django.request)，並且異常會向上傳播。

這對於某些測試設定可能很有用。除非您希望您的網頁伺服器（而不是 Django）產生「內部伺服器錯誤」回應，否則不應在實際網站上使用此設定。在這種情況下，請確保您的伺服器不會在回應中顯示堆疊追蹤或其他敏感資訊。

DECIMAL_SEPARATOR¶

預設值：'.' (點)

格式化小數時使用的預設小數分隔符號。

請注意，地區設定指定的格式具有較高的優先權，並會改為套用。

另請參閱 NUMBER_GROUPING、THOUSAND_SEPARATOR 和 USE_THOUSAND_SEPARATOR。

DEFAULT_AUTO_FIELD¶

預設值：'django.db.models.AutoField'

用於沒有具有 primary_key=True 欄位的模型的預設主鍵欄位類型。

DEFAULT_CHARSET¶

預設值： 'utf-8'

如果沒有手動指定 MIME 類型，則用於所有 HttpResponse 物件的預設字元集。在建構 Content-Type 標頭時使用。

DEFAULT_EXCEPTION_REPORTER¶

預設值：'django.views.debug.ExceptionReporter'

如果尚未將例外報告器類別指派給 HttpRequest 實例，則使用的預設例外報告器類別。請參閱 自訂錯誤報告。

DEFAULT_EXCEPTION_REPORTER_FILTER¶

預設值： 'django.views.debug.SafeExceptionReporterFilter'

如果尚未將例外報告器篩選類別指派給 HttpRequest 實例，則使用的預設例外報告器篩選類別。請參閱 篩選錯誤報告。

DEFAULT_FROM_EMAIL¶

預設值： 'webmaster@localhost'

來自網站管理員的自動信件的預設電子郵件地址。此地址用於外寄電子郵件的 From: 標頭中，並且可以採用所選電子郵件傳送協定中有效的任何格式。

這不會影響傳送給 ADMINS 和 MANAGERS 的錯誤訊息。請參閱 SERVER_EMAIL。

DEFAULT_INDEX_TABLESPACE¶

預設值：'' (空字串)

如果後端支援（請參閱 表格空間），則用於未指定表格空間的欄位索引的預設表格空間。

DEFAULT_TABLESPACE¶

預設值：'' (空字串)

如果後端支援（請參閱 表格空間），則用於未指定表格空間的模型的預設表格空間。

DISALLOWED_USER_AGENTS¶

預設值：[] (空的列表)

代表不允許訪問任何頁面的 User-Agent 字串的編譯後的正規表示式物件清單，系統範圍。用於機器人/爬蟲。僅在安裝 CommonMiddleware 時使用（請參閱 中介軟體）。

EMAIL_BACKEND¶

預設值： 'django.core.mail.backends.smtp.EmailBackend'

用於傳送電子郵件的後端。有關可用後端的列表，請參閱 電子郵件後端。

EMAIL_FILE_PATH¶

預設值：未定義

檔案電子郵件後端 用於儲存輸出檔案的目錄。

EMAIL_HOST¶

預設值： 'localhost'

用於傳送電子郵件的主機。

另請參閱 EMAIL_PORT。

EMAIL_HOST_PASSWORD¶

預設值：'' (空字串)

用於 EMAIL_HOST 中定義的 SMTP 伺服器的密碼。此設定與 EMAIL_HOST_USER 結合使用，以驗證 SMTP 伺服器。如果這些設定中的任何一個為空，Django 將不會嘗試驗證。

另請參閱 EMAIL_HOST_USER。

EMAIL_HOST_USER¶

預設值：'' (空字串)

用於 EMAIL_HOST 中定義的 SMTP 伺服器的使用者名稱。如果為空，Django 將不會嘗試驗證。

另請參閱 EMAIL_HOST_PASSWORD。

EMAIL_PORT¶

預設值： 25

用於 EMAIL_HOST 中定義的 SMTP 伺服器的連接埠。

EMAIL_SUBJECT_PREFIX¶

預設值： '[Django] '

使用 django.core.mail.mail_admins 或 django.core.mail.mail_managers 傳送的電子郵件訊息的主旨行前綴。您可能需要包含尾隨空格。

EMAIL_USE_LOCALTIME¶

預設值：False

是否以本機時區（True）或 UTC（False）傳送電子郵件訊息的 SMTP Date 標頭。

EMAIL_USE_TLS¶

預設值：False

與 SMTP 伺服器通訊時是否使用 TLS（安全）連線。這用於明確的 TLS 連線，通常在連接埠 587 上。如果您遇到連線掛斷的問題，請參閱隱含 TLS 設定 EMAIL_USE_SSL。

EMAIL_USE_SSL¶

預設值：False

與 SMTP 伺服器通訊時是否使用隱含 TLS（安全）連線。在大多數電子郵件文件中，此類型的 TLS 連線稱為 SSL。它通常在連接埠 465 上使用。如果您遇到問題，請參閱明確的 TLS 設定 EMAIL_USE_TLS。

請注意，EMAIL_USE_TLS/EMAIL_USE_SSL 是互斥的，因此只能將這些設定中的一個設定為 True。

EMAIL_SSL_CERTFILE¶

預設值：None

如果 EMAIL_USE_SSL 或 EMAIL_USE_TLS 為 True，您可以選擇性地指定用於 SSL 連線的 PEM 格式憑證鏈檔案的路徑。

EMAIL_SSL_KEYFILE¶

預設值：None

如果 EMAIL_USE_SSL 或 EMAIL_USE_TLS 為 True，您可以選擇性地指定用於 SSL 連接的 PEM 格式私鑰檔案路徑。

請注意，設定 EMAIL_SSL_CERTFILE 和 EMAIL_SSL_KEYFILE 不會導致任何憑證檢查。它們會被傳遞到底層的 SSL 連接。請參考 Python ssl.SSLContext.wrap_socket() 函式的說明文件，以了解如何處理憑證鏈檔案和私鑰檔案的詳細資訊。

EMAIL_TIMEOUT¶

預設值：None

指定連線嘗試等阻塞操作的逾時時間（以秒為單位）。

FILE_UPLOAD_HANDLERS¶

預設值

[
    "django.core.files.uploadhandler.MemoryFileUploadHandler",
    "django.core.files.uploadhandler.TemporaryFileUploadHandler",
]

用於上傳的處理程式清單。變更此設定可完全自訂，甚至替換 Django 的上傳流程。

詳情請參閱 管理檔案。

FILE_UPLOAD_MAX_MEMORY_SIZE¶

預設值：2621440（即 2.5 MB）。

上傳資料在被串流到檔案系統之前允許的最大大小（以位元組為單位）。詳情請參閱 管理檔案。

另請參閱 DATA_UPLOAD_MAX_MEMORY_SIZE。

FILE_UPLOAD_DIRECTORY_PERMISSIONS¶

預設值：None

在檔案上傳過程中建立的目錄所要套用的數字模式。

當使用 collectstatic 管理指令時，此設定也會決定收集的靜態目錄的預設權限。有關覆寫此設定的詳細資訊，請參閱 collectstatic。

此值反映了 FILE_UPLOAD_PERMISSIONS 設定的功能和注意事項。

FILE_UPLOAD_PERMISSIONS¶

預設值：0o644

要設定新上傳檔案的數字模式（即 0o644）。有關這些模式的含義的詳細資訊，請參閱 os.chmod() 的說明文件。

如果為 None，您將獲得與作業系統相關的行為。在大多數平台上，臨時檔案的模式將為 0o600，而從記憶體儲存的檔案將使用系統標準的 umask 儲存。

基於安全考量，這些權限不會應用於儲存在 FILE_UPLOAD_TEMP_DIR 的臨時檔案。

當使用 collectstatic 管理指令時，此設定也會決定收集的靜態檔案的預設權限。有關覆寫此設定的詳細資訊，請參閱 collectstatic。

FILE_UPLOAD_TEMP_DIR¶

預設值：None

在上傳檔案時，用於臨時儲存資料（通常是超過 FILE_UPLOAD_MAX_MEMORY_SIZE 的檔案）的目錄。如果為 None，Django 將使用作業系統的標準臨時目錄。例如，在 *nix 風格的作業系統上，此預設值將為 /tmp。

詳情請參閱 管理檔案。

FIRST_DAY_OF_WEEK¶

預設值：0（星期日）

一個代表一週第一天的數字。這在顯示日曆時特別有用。此值僅在不使用格式國際化或找不到目前地區設定的格式時使用。

該值必須是介於 0 到 6 之間的整數，其中 0 表示星期日，1 表示星期一，依此類推。

FIXTURE_DIRS¶

預設值：[] (空的列表)

除了每個應用程式的 fixtures 目錄之外，還會依搜尋順序搜尋 fixture 檔案的目錄清單。

請注意，即使在 Windows 上，這些路徑也應該使用 Unix 風格的正斜線。

請參閱 使用 fixtures 提供資料 和 Fixture 載入。

FORCE_SCRIPT_NAME¶

預設值：None

如果不是 None，則在任何 HTTP 請求中，此值將用作 SCRIPT_NAME 環境變數的值。此設定可用於覆寫伺服器提供的 SCRIPT_NAME 值，該值可能是慣用值的重寫版本或根本未提供。當提供 FORCE_SCRIPT_NAME 時，django.setup() 也會使用它來設定請求/回應週期之外的 URL 解析器腳本前綴（例如，在管理指令和獨立腳本中），以產生正確的 URL。

FORM_RENDERER¶

預設值：'django.forms.renderers.DjangoTemplates'

用於呈現表單和表單小部件的類別。它必須實作 低階呈現 API。包含的表單呈現器有

• 'django.forms.renderers.DjangoTemplates'

• 'django.forms.renderers.Jinja2'

• 'django.forms.renderers.TemplatesSetting'

FORMS_URLFIELD_ASSUME_HTTPS¶

預設值：False

將此過渡設定設定為 True，以便在 Django 5.x 發佈週期中選擇使用 "https" 作為 URLField.assume_scheme 的新預設值。

FORMAT_MODULE_PATH¶

預設值：None

包含專案地區設定的自訂格式定義的 Python 套件的完整 Python 路徑。如果不是 None，Django 會檢查以目前地區設定命名的目錄下的 formats.py 檔案，並使用此檔案中定義的格式。

包含格式定義的目錄名稱預期使用 地區設定名稱 標記法命名，例如 de、pt_BR、en_US 等。

例如，如果 FORMAT_MODULE_PATH 設定為 mysite.formats，且目前語言為 en（英文），Django 會預期類似以下的目錄樹

mysite/
    formats/
        __init__.py
        en/
            __init__.py
            formats.py

您也可以將此設定設定為 Python 路徑的清單，例如

FORMAT_MODULE_PATH = [
    "mysite.formats",
    "some_app.formats",
]

當 Django 搜尋特定格式時，它會瀏覽所有指定的 Python 路徑，直到找到實際定義該格式的模組為止。這表示在清單中較上層的套件中定義的格式，會優先於較下層套件中的相同格式。

可用的格式如下

• DATE_FORMAT

• DATE_INPUT_FORMATS

• DATETIME_FORMAT,

• DATETIME_INPUT_FORMATS

• DECIMAL_SEPARATOR

• FIRST_DAY_OF_WEEK

• MONTH_DAY_FORMAT

• NUMBER_GROUPING

• SHORT_DATE_FORMAT

• SHORT_DATETIME_FORMAT

• THOUSAND_SEPARATOR

• TIME_FORMAT

• TIME_INPUT_FORMATS

• YEAR_MONTH_FORMAT

IGNORABLE_404_URLS¶

預設值：[] (空的列表)

編譯後的正規表示式物件清單，這些物件描述在透過電子郵件回報 HTTP 404 錯誤時應忽略的 URL（請參閱如何管理錯誤回報）。正規表示式會與 request 的 完整路徑（包括查詢字串，如果有的話）進行比對。如果您的網站沒有提供常見的請求檔案（例如 favicon.ico 或 robots.txt），請使用此設定。

只有在啟用 BrokenLinkEmailsMiddleware 中介軟體時才會使用此設定（請參閱中介軟體）。

INSTALLED_APPS¶

預設值：[] (空的列表)

一個字串清單，指定在此 Django 安裝中啟用的所有應用程式。每個字串都應該是一個 Python 點式路徑，指向

• 應用程式配置類別（首選），或

• 包含應用程式的套件。

了解更多關於應用程式配置的資訊.

當多個應用程式提供相同資源（樣板、靜態檔案、管理命令、翻譯）的不同版本時，在 INSTALLED_APPS 中首先列出的應用程式具有優先權。

INTERNAL_IPS¶

預設值：[] (空的列表)

一個 IP 位址字串清單，這些位址：

• 允許 debug() 內容處理器將一些變數新增到樣板內容中。

• 即使未以工作人員使用者身分登入，也可以使用 admindocs 書籤。

• 在 AdminEmailHandler 電子郵件中，會被標記為「內部」（與「外部」相對）。

LANGUAGE_CODE¶

預設值：'en-us'

一個代表此安裝的語言代碼的字串。這應採用標準的語言 ID 格式。例如，美國英語是 "en-us"。另請參閱語言識別碼列表和國際化和本地化。

它有三個用途：

• 如果未使用地區設定中介軟體，則它會決定向所有使用者提供哪個翻譯。

• 如果地區設定中介軟體處於啟用狀態，則當無法確定使用者的首選語言或網站不支援該語言時，它會提供回退語言。當使用者首選語言中不存在給定文字的翻譯時，它還會提供回退翻譯。

• 如果透過 unlocalize 篩選器或 {% localize off %} 標籤明確停用本地化，則它會提供將應用的回退本地化格式。 有關詳細資訊，請參閱在樣板中控制本地化。

有關更多詳細資訊，請參閱Django 如何發現語言偏好設定。

LANGUAGE_COOKIE_AGE¶

預設值：None（在瀏覽器關閉時過期）

語言 Cookie 的有效期限，以秒為單位。

LANGUAGE_COOKIE_DOMAIN¶

預設值：None

用於語言 Cookie 的網域。將此設定為字串，例如 "example.com" 以用於跨網域 Cookie，或使用 None 以用於標準網域 Cookie。

在生產網站上更新此設定時請謹慎。如果您更新此設定以在先前使用標準網域 Cookie 的網站上啟用跨網域 Cookie，則具有舊網域的現有使用者 Cookie 將不會更新。這將導致網站使用者在這些 Cookie 持續存在的情況下無法切換語言。執行切換唯一安全可靠的選項是永久變更語言 Cookie 名稱（透過 LANGUAGE_COOKIE_NAME 設定），並新增一個中介軟體，將值從舊 Cookie 複製到新 Cookie，然後刪除舊 Cookie。

LANGUAGE_COOKIE_HTTPONLY¶

預設值：False

是否在語言 Cookie 上使用 HttpOnly 旗標。如果此設定為 True，則用戶端 JavaScript 將無法存取語言 Cookie。

有關 HttpOnly 的詳細資訊，請參閱SESSION_COOKIE_HTTPONLY。

LANGUAGE_COOKIE_NAME¶

預設值：'django_language'

用於語言 Cookie 的 Cookie 名稱。這可以是您想要的任何名稱（只要它與您應用程式中的其他 Cookie 名稱不同即可）。請參閱國際化和本地化。

LANGUAGE_COOKIE_PATH¶

預設值：'/'

在語言 Cookie 上設定的路徑。這應該與您的 Django 安裝的 URL 路徑相符，或是該路徑的父路徑。

如果您在同一主機名稱下執行多個 Django 執行個體，這會很有用。它們可以使用不同的 Cookie 路徑，並且每個執行個體只會看到自己的語言 Cookie。

在生產網站上更新此設定時請謹慎。如果您更新此設定以使用比先前更深的路徑，則具有舊路徑的現有使用者 Cookie 將不會更新。這將導致網站使用者在這些 Cookie 持續存在的情況下無法切換語言。執行切換唯一安全可靠的選項是永久變更語言 Cookie 名稱（透過 LANGUAGE_COOKIE_NAME 設定），並新增一個中介軟體，將值從舊 Cookie 複製到新 Cookie，然後刪除舊 Cookie。

LANGUAGE_COOKIE_SAMESITE¶

預設值：None

語言 Cookie 上 SameSite 旗標的值。此旗標可防止在跨網站請求中傳送 Cookie。

有關 SameSite 的詳細資訊，請參閱SESSION_COOKIE_SAMESITE。

LANGUAGE_COOKIE_SECURE¶

預設值：False

是否為語言 Cookie 使用安全 Cookie。如果此設定為 True，則該 Cookie 將被標記為「安全」，這表示瀏覽器可能會確保該 Cookie 僅在 HTTPS 連線下傳送。

LANGUAGES¶

預設值：所有可用語言的清單。此清單不斷成長，並且在此處包含副本將不可避免地迅速過時。您可以查看 django/conf/global_settings.py 中的翻譯語言的目前清單。

此清單是格式為（語言代碼，語言名稱）的 2 元組清單 – 例如，('ja', '日語')。這指定哪些語言可供選擇。請參閱國際化和本地化。

一般而言，預設值就足夠了。僅當您要將語言選擇限制為 Django 提供的語言的子集時，才設定此設定。

如果您定義自訂的 LANGUAGES 設定，您可以使用 gettext_lazy() 函式將語言名稱標記為翻譯字串。

這是一個範例設定檔：

from django.utils.translation import gettext_lazy as _

LANGUAGES = [
    ("de", _("German")),
    ("en", _("English")),
]

LANGUAGES_BIDI¶

預設值：所有從右到左書寫的語言代碼的清單。您可以查看 django/conf/global_settings.py 中的這些語言的目前清單。

此清單包含從右到左書寫的語言的語言代碼。

一般來說，預設值就已足夠。只有在您想要將語言選擇限制為 Django 提供的語言子集時，才需要設定此設定。如果您定義了自訂的 LANGUAGES 設定，則雙向語言列表可能包含在特定網站上未啟用的語言代碼。

LOCALE_PATHS¶

預設值：[] (空的列表)

Django 在其中尋找翻譯檔案的目錄列表。請參閱Django 如何發現翻譯。

範例

LOCALE_PATHS = [
    "/home/www/project/common_files/locale",
    "/var/local/translations/locale",
]

Django 將在這些路徑中尋找包含實際翻譯檔案的 <locale_code>/LC_MESSAGES 目錄。

LOGGING¶

預設值：一個記錄設定字典。

一個包含設定資訊的資料結構。當它不為空時，此資料結構的內容將作為參數傳遞給 LOGGING_CONFIG 中描述的設定方法。

在其他方面，當 DEBUG 為 False 時，預設記錄設定會將 HTTP 500 伺服器錯誤傳遞給電子郵件記錄處理程式。另請參閱設定記錄。

您可以透過查看 django/utils/log.py 來查看預設的記錄設定。

LOGGING_CONFIG¶

預設值：'logging.config.dictConfig'

一個可呼叫程式的路徑，該程式將用於設定 Django 專案中的記錄。預設情況下，指向 Python 的 dictConfig 設定方法的一個實例。

如果您將 LOGGING_CONFIG 設定為 None，則將會跳過記錄設定過程。

MANAGERS¶

預設值：[] (空的列表)

與 ADMINS 格式相同的列表，指定當 BrokenLinkEmailsMiddleware 啟用時，應該收到斷線連結通知的人員。

MEDIA_ROOT¶

預設值：'' (空字串)

將保存使用者上傳檔案的目錄的絕對檔案系統路徑。

範例："/var/www/example.com/media/"

另請參閱 MEDIA_URL。

MEDIA_URL¶

預設值：'' (空字串)

處理從 MEDIA_ROOT 提供的媒體的 URL，用於管理儲存的檔案。如果設定為非空值，則必須以斜線結尾。您需要在開發和生產環境中設定這些檔案以進行提供。

如果您想在範本中使用 {{ MEDIA_URL }}，請在 TEMPLATES 的 'context_processors' 選項中加入 'django.template.context_processors.media'。

範例："https://media.example.com/"

MIDDLEWARE¶

預設值：None

要使用的中間件列表。請參閱中間件。

MIGRATION_MODULES¶

預設值：{} (空的字典)

一個字典，指定在每個應用程式的基礎上，可以在哪裡找到遷移模組。此設定的預設值為空字典，但遷移模組的預設套件名稱為 migrations。

範例

{"blog": "blog.db_migrations"}

在此情況下，與 blog 應用程式相關的遷移將包含在 blog.db_migrations 套件中。

如果您提供 app_label 引數，makemigrations 將會自動建立套件（如果它尚不存在）。

當您為應用程式提供 None 作為值時，無論是否存在 migrations 子模組，Django 都會將應用程式視為沒有遷移的應用程式。例如，這可以在測試設定檔案中用於在測試時跳過遷移（仍會為應用程式的模型建立表格）。若要在測試期間停用所有應用程式的遷移，您可以將 MIGRATE 設定為 False 來代替。 如果在您的一般專案設定中使用 MIGRATION_MODULES，請記住如果您想要為應用程式建立表格，請使用 migrate --run-syncdb 選項。

MONTH_DAY_FORMAT¶

預設值：'F j'

當只顯示月份和日期時，在 Django 管理變更清單頁面上以及系統的其他部分中，用於日期欄位的預設格式。

例如，當 Django 管理變更清單頁面正按日期向下鑽取進行篩選時，給定日期的標頭會顯示日期和月份。不同的地區有不同的格式。例如，美式英語會說「January 1」，而西班牙語可能會說「1 Enero」。

請注意，相應的地區設定指定的格式具有較高的優先順序，並且會改為應用。

請參閱允許的 日期 格式 字串。另請參閱 DATE_FORMAT、 DATETIME_FORMAT、TIME_FORMAT 和 YEAR_MONTH_FORMAT。

NUMBER_GROUPING¶

預設值：0

數字整數部分的分組位數。

常見用法是顯示千位分隔符。如果此設定為 0，則不會對數字應用分組。如果此設定大於 0，則會使用 THOUSAND_SEPARATOR 作為這些組之間的分隔符。

某些地區設定使用非統一的數字分組，例如 en_IN 中的 10,00,00,000。對於這種情況，您可以提供一個序列，其中包含要應用數字組大小的數量。第一個數字定義小數點分隔符之前的組大小，後面的每個數字定義前面組的大小。如果序列以 -1 終止，則不會執行進一步的分組。如果序列以 0 終止，則最後一個組大小將用於數字的其餘部分。

用於 en_IN 的範例元組

NUMBER_GROUPING = (3, 2, 0)

請注意，地區設定指定的格式具有較高的優先權，並會改為套用。

另請參閱 DECIMAL_SEPARATOR、THOUSAND_SEPARATOR 和 USE_THOUSAND_SEPARATOR。

PREPEND_WWW¶

預設值：False

是否在沒有 “www.” 子網域的 URL 前面加上它。這僅在安裝了 CommonMiddleware 時使用（請參閱 中介軟體）。另請參閱 APPEND_SLASH。

ROOT_URLCONF¶

預設值：未定義

一個字串，表示根 URL 設定檔的完整 Python 匯入路徑，例如 "mydjangoapps.urls"。可以透過在傳入的 HttpRequest 物件上設定屬性 urlconf 來針對每個請求覆寫。有關詳細資訊，請參閱 Django 如何處理請求。

SECRET_KEY¶

預設值：'' (空字串)

特定 Django 安裝的金鑰。這用於提供 密碼編譯簽名，並且應設定為唯一、不可預測的值。

django-admin startproject 會自動將隨機產生的 SECRET_KEY 新增到每個新專案中。

金鑰的使用不應假設它是文字或位元組。每次使用都應經過 force_str() 或 force_bytes() 轉換為所需的類型。

如果未設定 SECRET_KEY，Django 將拒絕啟動。

金鑰用於

• 如果您使用的是 django.contrib.sessions.backends.cache 以外的任何其他工作階段後端，或使用預設的 get_session_auth_hash()，則所有工作階段。

• 如果您使用的是 CookieStorage 或 FallbackStorage，則所有訊息。

• 所有 PasswordResetView 權杖。

• 任何使用 密碼編譯簽名 的情況，除非提供不同的金鑰。

當不再將金鑰設定為 SECRET_KEY 或包含在 SECRET_KEY_FALLBACKS 中時，上述所有內容都將失效。在輪換您的金鑰時，您應該暫時將舊金鑰移至 SECRET_KEY_FALLBACKS。金鑰不適用於使用者的密碼，並且金鑰輪換不會影響它們。

SECRET_KEY_FALLBACKS¶

預設值： []

特定 Django 安裝的備用金鑰清單。這些用於允許輪換 SECRET_KEY。

為了輪換您的金鑰，請設定新的 SECRET_KEY 並將先前的值移至 SECRET_KEY_FALLBACKS 的開頭。然後，當您準備好使工作階段、密碼重設權杖等使用它們過期時，請從 SECRET_KEY_FALLBACKS 的末尾移除舊值。

金鑰值的使用不應假設它們是文字或位元組。每次使用都應經過 force_str() 或 force_bytes() 轉換為所需的類型。

SECURE_CONTENT_TYPE_NOSNIFF¶

預設值：True

如果為 True，SecurityMiddleware 會在所有尚未設定的響應中設定 X-Content-Type-Options: nosniff 標頭。

SECURE_CROSS_ORIGIN_OPENER_POLICY¶

預設值： 'same-origin'

除非設定為 None，否則 SecurityMiddleware 會將所有尚未設定的響應中的 跨來源開啟器政策 標頭設定為所提供的值。

SECURE_HSTS_INCLUDE_SUBDOMAINS¶

預設值：False

如果為 True，則 SecurityMiddleware 會將 includeSubDomains 指令新增至 HTTP Strict Transport Security 標頭。除非將 SECURE_HSTS_SECONDS 設定為非零值，否則它無效。

SECURE_HSTS_PRELOAD¶

預設值：False

如果為 True，則 SecurityMiddleware 會將 preload 指令新增至 HTTP Strict Transport Security 標頭。除非將 SECURE_HSTS_SECONDS 設定為非零值，否則它無效。

SECURE_HSTS_SECONDS¶

預設值：0

如果設定為非零整數值，則 SecurityMiddleware 會在所有尚未設定的響應中設定 HTTP Strict Transport Security 標頭。

SECURE_PROXY_SSL_HEADER¶

預設值：None

一個元組，表示一個 HTTP 標頭/值組合，用於表示請求是安全的。這控制請求物件的 is_secure() 方法的行為。

預設情況下，is_secure() 會透過確認請求的 URL 是否使用 https:// 來判斷請求是否安全。此方法對於 Django 的 CSRF 保護非常重要，並且可能會被您自己的程式碼或第三方應用程式使用。

但是，如果您的 Django 應用程式位於 Proxy 後方，Proxy 可能會「吞噬」原始請求是否使用 HTTPS 的資訊。如果 Proxy 和 Django 之間存在非 HTTPS 連線，則 is_secure() 將始終返回 False – 即使對於最終使用者透過 HTTPS 發出的請求也是如此。相反地，如果 Proxy 和 Django 之間存在 HTTPS 連線，則 is_secure() 將始終返回 True – 即使對於最初透過 HTTP 發出的請求也是如此。

在這種情況下，請設定您的 Proxy 以設定自訂 HTTP 標頭，告知 Django 請求是否透過 HTTPS 傳入，並設定 SECURE_PROXY_SSL_HEADER，以便 Django 知道要尋找哪個標頭。

設定一個包含兩個元素的元組 – 要尋找的標頭名稱和所需的值。例如

SECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")

這告訴 Django 信任來自我們 Proxy 的 X-Forwarded-Proto 標頭，並且當

• 標頭值為 'https' 時，保證請求是安全的（即，它最初是透過 HTTPS 傳入的），或

• 在以逗號分隔的協定清單中（例如 'https,http,http'），其初始、最左邊的值為 'https'。

只有在您控制您的 Proxy 或具有其他保證它會適當設定/移除此標頭的情況下，您才應該設定此設定。

請注意，標頭需要採用 request.META 所使用的格式 – 全部大寫，並且可能以 HTTP_ 開頭。（請記住，Django 會在將標頭提供給 request.META 之前，自動將 'HTTP_' 添加到 x-標頭名稱的開頭。）

SECURE_REDIRECT_EXEMPT¶

預設值：[] (空的列表)

如果 URL 路徑符合此清單中的正規表示式，則請求不會被重新導向到 HTTPS。SecurityMiddleware 會從 URL 路徑中移除開頭斜線，因此模式不應包含它們，例如 SECURE_REDIRECT_EXEMPT = [r'^no-ssl/$', …]。如果 SECURE_SSL_REDIRECT 為 False，則此設定無效。

SECURE_REFERRER_POLICY¶

預設值： 'same-origin'

如果已設定，SecurityMiddleware 會將 Referrer Policy 標頭設定為提供的值，並設定在所有尚未擁有該標頭的回應上。

SECURE_SSL_HOST¶

預設值：None

如果為字串（例如 secure.example.com），所有 SSL 重新導向都會被導向至此主機，而不是原始請求的主機（例如 www.example.com）。如果 SECURE_SSL_REDIRECT 為 False，則此設定無效。

SECURE_SSL_REDIRECT¶

預設值：False

如果為 True，SecurityMiddleware 會將所有非 HTTPS 請求重新導向至 HTTPS（除了符合 SECURE_REDIRECT_EXEMPT 中列出的正規表示式的 URL 之外）。

SERIALIZATION_MODULES¶

預設值：未定義

包含序列化器定義的模組（以字串形式提供）的字典，並以該序列化類型的字串識別碼作為鍵。例如，若要定義 YAML 序列化器，請使用

SERIALIZATION_MODULES = {"yaml": "path.to.yaml_serializer"}

SERVER_EMAIL¶

預設值：'root@localhost'

錯誤訊息的寄件者電子郵件地址，例如傳送給 ADMINS 和 MANAGERS 的訊息。此地址用於 From: 標頭中，並且可以採用所選電子郵件傳送協定中有效的任何格式。

SHORT_DATE_FORMAT¶

預設值：'m/d/Y' (例如 12/31/2003)

可用於在範本上顯示日期欄位的格式。請注意，對應的地區設定格式具有較高的優先順序，並且將改為套用。請參閱 允許的日期格式字串。

另請參閱 DATE_FORMAT 和 SHORT_DATETIME_FORMAT。

SHORT_DATETIME_FORMAT¶

預設值：'m/d/Y P' (例如 12/31/2003 下午 4 點)

可用於在範本上顯示日期時間欄位的格式。請注意，對應的地區設定格式具有較高的優先順序，並且將改為套用。請參閱 允許的日期格式字串。

另請參閱 DATE_FORMAT 和 SHORT_DATE_FORMAT。

SIGNING_BACKEND¶

預設值：'django.core.signing.TimestampSigner'

用於簽署 Cookie 和其他資料的後端。

另請參閱 密碼編譯簽章 文件。

SILENCED_SYSTEM_CHECKS¶

預設值：[] (空的列表)

您希望永久確認和忽略的系統檢查框架產生的訊息識別碼清單（即 ["models.W001"]）。已靜音的檢查將不會輸出到主控台。

另請參閱 系統檢查框架 文件。

STORAGES¶

預設值

{
    "default": {
        "BACKEND": "django.core.files.storage.FileSystemStorage",
    },
    "staticfiles": {
        "BACKEND": "django.contrib.staticfiles.storage.StaticFilesStorage",
    },
}

包含要與 Django 一起使用的所有儲存設定的字典。它是一個巢狀字典，其內容將儲存別名對應到包含個別儲存選項的字典。

儲存可以具有您選擇的任何別名。但是，有兩個具有特殊意義的別名

• 用於管理檔案的default。'django.core.files.storage.FileSystemStorage' 是預設的儲存引擎。

• 用於管理靜態檔案的staticfiles。'django.contrib.staticfiles.storage.StaticFilesStorage' 是預設的儲存引擎。

以下是一個 settings.py 片段範例，定義了一個名為 example 的自訂檔案儲存。

STORAGES = {
    # ...
    "example": {
        "BACKEND": "django.core.files.storage.FileSystemStorage",
        "OPTIONS": {
            "location": "/example",
            "base_url": "/example/",
        },
    },
}

OPTIONS 在初始化時會以 **kwargs 的形式傳遞到 BACKEND。

可以從 django.core.files.storage.storages 取得可用的儲存後端實例。使用與 STORAGES 中的後端定義相對應的鍵。

TEMPLATES¶

預設值：[] (空的列表)

一個包含所有 Django 要使用的模板引擎設定的列表。列表中的每個項目都是一個字典，包含個別引擎的選項。

以下是一個設置，告知 Django 模板引擎從每個已安裝應用程式內的 templates 子目錄載入模板。

TEMPLATES = [
    {
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        "APP_DIRS": True,
    },
]

以下選項適用於所有後端。

TEST_RUNNER¶

預設值：'django.test.runner.DiscoverRunner'

用於啟動測試套件的類別名稱。請參閱使用不同的測試框架。

TEST_NON_SERIALIZED_APPS¶

預設值：[] (空的列表)

為了在 TransactionTestCase 和沒有事務的資料庫後端之間，還原測試之間的資料庫狀態，Django 會在開始測試執行時序列化所有應用程式的內容，以便在執行需要此功能的測試之前，從該副本重新載入。

這會減慢測試執行器的啟動時間；如果您知道某些應用程式不需要此功能，您可以將它們的完整名稱新增到此處（例如 'django.contrib.contenttypes'）以將它們排除在此序列化程序之外。

THOUSAND_SEPARATOR¶

預設值：',' (逗號)

格式化數字時使用的預設千位分隔符。只有當 USE_THOUSAND_SEPARATOR 為 True 且 NUMBER_GROUPING 大於 0 時，才會使用此設定。

請注意，地區設定指定的格式具有較高的優先權，並會改為套用。

另請參閱 NUMBER_GROUPING、DECIMAL_SEPARATOR 和 USE_THOUSAND_SEPARATOR。

TIME_FORMAT¶

預設值：'P'（例如 下午4點）

在系統任何部分顯示時間欄位時使用的預設格式。請注意，locale 指定的格式具有較高的優先順序，將改為套用。請參閱允許的 日期 格式 字串。

另請參閱 DATE_FORMAT 和 DATETIME_FORMAT。

TIME_INPUT_FORMATS¶

預設值

[
    "%H:%M:%S",  # '14:30:59'
    "%H:%M:%S.%f",  # '14:30:59.000200'
    "%H:%M",  # '14:30'
]

在時間欄位輸入資料時將接受的格式列表。將依序嘗試格式，使用第一個有效的格式。請注意，這些格式字串使用 Python 的 datetime 模組語法，而不是來自 date 模板篩選器的格式字串。

地區設定指定的格式具有較高的優先權，並會改為套用。

另請參閱 DATE_INPUT_FORMATS 和 DATETIME_INPUT_FORMATS。

TIME_ZONE¶

預設值：'America/Chicago'

表示此安裝時區的字串。請參閱時區列表。

請注意，這不一定是伺服器的時區。例如，一個伺服器可能會為多個 Django 驅動的網站提供服務，每個網站都有單獨的時區設定。

當 USE_TZ 為 False 時，這是 Django 將儲存所有日期時間的時區。當 USE_TZ 為 True 時，這是 Django 將用於在範本中顯示日期時間，以及解釋表單中輸入的日期時間的預設時區。

在 Unix 環境（已實作 time.tzset() 的環境）中，Django 會將 os.environ['TZ'] 變數設定為您在 TIME_ZONE 設定中指定時區。因此，您的所有視圖和模型都會自動在此時區中運作。但是，如果您使用手動設定設定中所述的手動設定選項，Django 將不會設定 TZ 環境變數。如果 Django 沒有設定 TZ 環境變數，您必須確保您的進程在正確的環境中執行。

USE_I18N¶

預設值：True

一個布林值，指定是否應啟用 Django 的翻譯系統。這提供了一種關閉它的方法，以提高效能。如果將此值設定為 False，Django 將進行一些最佳化，以避免載入翻譯機制。

另請參閱 LANGUAGE_CODE 和 USE_TZ。

USE_THOUSAND_SEPARATOR¶

預設值：False

一個布林值，指定是否要使用千位分隔符顯示數字。當設定為 True 時，Django 會使用 NUMBER_GROUPING 和 THOUSAND_SEPARATOR 設定來格式化數字。後兩者設定也可能由地區設定決定，地區設定具有優先權。

另請參閱 DECIMAL_SEPARATOR、NUMBER_GROUPING 和 THOUSAND_SEPARATOR。

USE_TZ¶

預設值：True

一個布林值，指定預設情況下日期時間是否會使用時區感知。如果將此值設定為 True，Django 會在內部使用時區感知的日期時間。

當 USE_TZ 為 False 時，Django 會在本地時間使用樸素的日期時間，但解析 ISO 8601 格式的字串時除外，如果存在時區資訊，則會始終保留。

另請參閱 TIME_ZONE 和 USE_I18N。

USE_X_FORWARDED_HOST¶

預設值：False

一個布林值，指定是否優先使用 X-Forwarded-Host 標頭，而不是 Host 標頭。只有在使用設定此標頭的 Proxy 時才應啟用此選項。

此設定優先於 USE_X_FORWARDED_PORT。根據 RFC 7239 第 5.3 節，X-Forwarded-Host 標頭可以包含連接埠號碼，在這種情況下，您不應使用 USE_X_FORWARDED_PORT。

USE_X_FORWARDED_PORT¶

預設值：False

一個布林值，指定是否優先使用 X-Forwarded-Port 標頭，而不是 SERVER_PORT META 變數。只有在使用設定此標頭的 Proxy 時才應啟用此選項。

USE_X_FORWARDED_HOST 優先於此設定。

WSGI_APPLICATION¶

預設值：None

Django 內建伺服器（例如 runserver）將使用的 WSGI 應用程式物件的完整 Python 路徑。django-admin startproject 管理命令將建立一個標準的 wsgi.py 檔案，其中包含一個 application 可呼叫物件，並將此設定指向該 application。

如果未設定，將會使用 django.core.wsgi.get_wsgi_application() 的傳回值。在這種情況下，runserver 的行為將與先前的 Django 版本相同。

YEAR_MONTH_FORMAT¶

預設值：'F Y'

在 Django 管理變更列表頁面上，以及可能由系統其他部分使用時，針對日期欄位預設使用的格式，在僅顯示年份和月份時使用。

例如，當 Django 管理變更列表頁面依日期向下鑽取篩選時，給定月份的標頭會顯示月份和年份。不同的地區設定有不同的格式。例如，美國英語會說「January 2006」，而另一個地區設定可能會說「2006/January」。

請注意，相應的地區設定指定的格式具有較高的優先順序，並且會改為應用。

請參閱 允許的 日期 格式 字串。另請參閱 DATE_FORMAT、DATETIME_FORMAT、TIME_FORMAT 和 MONTH_DAY_FORMAT。

X_FRAME_OPTIONS¶

預設值：'DENY'

XFrameOptionsMiddleware 使用的 X-Frame-Options 標頭的預設值。請參閱點擊劫持保護文件。

AUTHENTICATION_BACKENDS¶

預設值：['django.contrib.auth.backends.ModelBackend']

在嘗試驗證使用者時使用的驗證後端類別清單（以字串表示）。有關詳細資訊，請參閱驗證後端文件。

AUTH_USER_MODEL¶

預設值：'auth.User'

用於表示使用者的模型。請參閱替換自訂使用者模型。

LOGIN_REDIRECT_URL¶

預設值：'/accounts/profile/'

當 LoginView 沒有收到 next GET 參數時，登入後將請求重新導向到的 URL 或已命名的 URL 模式。

LOGIN_URL¶

預設值：'/accounts/login/'

當使用 login_required() 裝飾器、LoginRequiredMixin、AccessMixin，或當安裝 LoginRequiredMiddleware 時，請求會被重新導向至此 URL 或已命名的 URL 模式進行登入。

LOGOUT_REDIRECT_URL¶

預設值：None

如果 LogoutView 沒有 next_page 屬性，則登出後請求會被重新導向至此 URL 或已命名的 URL 模式。

如果為 None，則不會執行重新導向，並會渲染登出檢視。

PASSWORD_RESET_TIMEOUT¶

預設值：259200 (3 天，單位為秒)

密碼重設連結的有效秒數。

由 PasswordResetConfirmView 使用。

PASSWORD_HASHERS¶

請參閱Django 如何儲存密碼。

預設值

[
    "django.contrib.auth.hashers.PBKDF2PasswordHasher",
    "django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher",
    "django.contrib.auth.hashers.Argon2PasswordHasher",
    "django.contrib.auth.hashers.BCryptSHA256PasswordHasher",
    "django.contrib.auth.hashers.ScryptPasswordHasher",
]

AUTH_PASSWORD_VALIDATORS¶

預設值：[] (空的列表)

用於檢查使用者密碼強度的驗證器列表。有關詳細資訊，請參閱密碼驗證。預設情況下，不會執行任何驗證，所有密碼都會被接受。

MESSAGE_LEVEL¶

預設值：messages.INFO

設定訊息框架將記錄的最低訊息等級。有關詳細資訊，請參閱訊息等級。

from django.contrib.messages import constants as message_constants

MESSAGE_LEVEL = message_constants.DEBUG

MESSAGE_STORAGE¶

預設值：'django.contrib.messages.storage.fallback.FallbackStorage'

控制 Django 儲存訊息資料的位置。有效的值為：

• 'django.contrib.messages.storage.fallback.FallbackStorage'

• 'django.contrib.messages.storage.session.SessionStorage'

• 'django.contrib.messages.storage.cookie.CookieStorage'

有關詳細資訊，請參閱訊息儲存後端。

使用 cookie 的後端 - CookieStorage 和 FallbackStorage - 在設定其 cookie 時，會使用 SESSION_COOKIE_DOMAIN、SESSION_COOKIE_SECURE 和 SESSION_COOKIE_HTTPONLY 的值。

MESSAGE_TAGS¶

預設值

{
    messages.DEBUG: "debug",
    messages.INFO: "info",
    messages.SUCCESS: "success",
    messages.WARNING: "warning",
    messages.ERROR: "error",
}

此設定會將訊息等級對應到訊息標籤，訊息標籤通常會以 HTML 中的 CSS 類別呈現。如果您指定一個值，它會擴充預設值。這表示您只需要指定您需要覆寫的值。有關詳細資訊，請參閱上述顯示訊息。

from django.contrib.messages import constants as message_constants

MESSAGE_TAGS = {message_constants.INFO: ""}

SESSION_CACHE_ALIAS¶

預設值：'default'

如果您正在使用基於快取的 session 儲存，此設定會選擇要使用的快取。

SESSION_COOKIE_AGE¶

預設值：1209600 (2 週，單位為秒)

Session cookie 的有效時間，單位為秒。

SESSION_COOKIE_DOMAIN¶

預設值：None

用於 session cookie 的網域。將此設定為字串，例如 "example.com"，以使用跨網域 cookie，或者使用 None 來使用標準網域 cookie。

若要使用跨網域 cookie 和 CSRF_USE_SESSIONS，您必須包含一個開頭點（例如 ".example.com"）以配合 CSRF 中介軟體的 referer 檢查。

在生產網站上更新此設定時請務必謹慎。如果您更新此設定以在先前使用標準網域 cookie 的網站上啟用跨網域 cookie，則現有使用者的 cookie 將設定為舊網域。這可能會導致他們只要這些 cookie 仍然存在就無法登入。

此設定也會影響 django.contrib.messages 設定的 cookie。

SESSION_COOKIE_HTTPONLY¶

預設值：True

是否在 session cookie 上使用 HttpOnly 標誌。如果此設定為 True，則用戶端 JavaScript 將無法存取 session cookie。

HttpOnly 是包含在 Set-Cookie HTTP 回應標頭中的一個標誌。它是 RFC 6265 第 4.1.2.6 節 cookie 標準的一部分，並且可以成為減輕用戶端腳本存取受保護 cookie 資料風險的有效方法。

這使得攻擊者要將跨網站腳本漏洞升級為完全劫持使用者 session 變得更加困難。沒有太多充分的理由關閉此功能。您的程式碼不應從 JavaScript 讀取 session cookie。

SESSION_COOKIE_NAME¶

預設值：'sessionid'

用於 session 的 cookie 名稱。這可以是您想要的任何名稱（只要它與您應用程式中的其他 cookie 名稱不同）。

SESSION_COOKIE_PATH¶

預設值：'/'

設定在 session cookie 中的路徑。這應該與您的 Django 安裝的 URL 路徑相符，或是該路徑的父路徑。

如果您在同一個主機名稱下執行多個 Django 實例，這會很有用。它們可以使用不同的 cookie 路徑，而且每個實例只會看到自己的 session cookie。

SESSION_COOKIE_SAMESITE¶

預設值：'Lax'

session cookie 上 SameSite 標記的值。此標記會防止 cookie 在跨網站請求中被傳送，從而防止 CSRF 攻擊，並使某些竊取 session cookie 的方法變得不可能。

此設定的可能值為

• 'Strict'：防止瀏覽器在所有跨網站瀏覽情境中，將 cookie 傳送至目標網站，即使是跟隨一般連結時也是如此。

  舉例來說，對於類似 GitHub 的網站，這表示如果登入的使用者點擊公司討論區或電子郵件中張貼的私人 GitHub 專案連結，GitHub 將不會收到 session cookie，使用者也將無法存取該專案。然而，銀行網站很可能不希望允許從外部網站連結任何交易頁面，因此 'Strict' 標記會很適合。

• 'Lax'（預設）：在安全性與可用性之間取得平衡，適用於希望使用者從外部連結到達後仍能維持登入狀態的網站。

  在 GitHub 的情況下，當跟隨來自外部網站的一般連結時，會允許 session cookie，但在容易發生 CSRF 的請求方法（例如 POST）中會被封鎖。

• 'None'（字串）：session cookie 將會與所有同網站和跨網站請求一起傳送。

• False：停用此標記。

SESSION_COOKIE_SECURE¶

預設值：False

是否為 session cookie 使用安全 cookie。如果此設定為 True，cookie 會被標記為「安全」，這表示瀏覽器可能會確保 cookie 只會在 HTTPS 連線下傳送。

關閉此設定並非好主意，因為攻擊者可以使用封包截取器擷取未加密的 session cookie，並使用該 cookie 來劫持使用者的 session。

SESSION_ENGINE¶

預設值：'django.contrib.sessions.backends.db'

控制 Django 儲存 session 資料的位置。包含的引擎有

• '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 引擎 以取得更多詳細資訊。

SESSION_EXPIRE_AT_BROWSER_CLOSE¶

預設值：False

是否在使用者關閉瀏覽器時過期 session。請參閱 瀏覽器長度 session 與永久 session。

SESSION_FILE_PATH¶

預設值：None

如果您使用基於檔案的 session 儲存，此設定會設定 Django 儲存 session 資料的目錄。當使用預設值 (None) 時，Django 將會使用系統的標準暫存目錄。

SESSION_SAVE_EVERY_REQUEST¶

預設值：False

是否在每次請求時都儲存 session 資料。如果此設定為 False （預設），則只有在 session 資料被修改時才會儲存 — 也就是說，只有在任何字典值被賦值或刪除時。即使啟用此設定，也不會建立空的 session。

SESSION_SERIALIZER¶

預設值：'django.contrib.sessions.serializers.JSONSerializer'

用於序列化 session 資料的序列化器類別的完整導入路徑。包含的序列化器是

• 'django.contrib.sessions.serializers.JSONSerializer'

請參閱 Session 序列化 以取得詳細資訊。

SITE_ID¶

預設值：未定義

django_site 資料庫表格中目前網站的 ID（整數）。這是為了讓應用程式資料可以連結到特定的網站，並且單一資料庫可以管理多個網站的內容。

STATIC_ROOT¶

預設值：None

collectstatic 將會收集要部署的靜態檔案的目錄的絕對路徑。

範例："/var/www/example.com/static/"

如果已啟用 staticfiles contrib 應用程式（如預設專案範本中所示），collectstatic 管理命令會將靜態檔案收集到此目錄中。請參閱關於管理靜態檔案的教學文件以取得更多使用上的詳細資訊。

STATIC_URL¶

預設值：None

當參考位於 STATIC_ROOT 中的靜態檔案時要使用的 URL。

範例："static/" 或 "https://static.example.com/"

如果不是 None，這將被用作 資產定義（Media 類別）和 staticfiles 應用程式 的基礎路徑。

如果設定為非空值，則必須以斜線結尾。

您可能需要在開發環境中設定這些檔案以供使用，而且絕對需要在生產環境中設定。

STATICFILES_DIRS¶

預設值：[] (空的列表)

如果啟用 FileSystemFinder 尋找器，例如您使用 collectstatic 或 findstatic 管理命令，或使用靜態檔案服務檢視時，此設定會定義 staticfiles 應用程式將會遍歷的其他位置。

這應該設定為字串列表，其中包含指向您的額外檔案目錄的完整路徑，例如：

STATICFILES_DIRS = [
    "/home/special.polls.com/polls/static",
    "/home/polls.com/polls/static",
    "/opt/webfiles/common",
]

請注意，這些路徑應該使用 Unix 風格的正斜線，即使在 Windows 上也一樣 (例如，"C:/Users/user/mysite/extra_static_content")。

STATICFILES_DIRS = [
    # ...
    ("downloads", "/opt/webfiles/stats"),
]

<a href="{% static 'downloads/polls_20101022.tar.gz' %}">

STATICFILES_FINDERS¶

預設值

[
    "django.contrib.staticfiles.finders.FileSystemFinder",
    "django.contrib.staticfiles.finders.AppDirectoriesFinder",
]

知道如何在各種位置尋找靜態檔案的尋找器後端列表。

預設會尋找儲存在 STATICFILES_DIRS 設定中的檔案（使用 django.contrib.staticfiles.finders.FileSystemFinder）以及每個應用程式的 static 子目錄中的檔案（使用 django.contrib.staticfiles.finders.AppDirectoriesFinder）。如果存在多個同名檔案，將會使用找到的第一個檔案。

預設會停用一個尋找器：django.contrib.staticfiles.finders.DefaultStorageFinder。如果將其加入到您的 STATICFILES_FINDERS 設定中，它將會在 STORAGES 設定中由 default 鍵定義的預設檔案儲存空間中尋找靜態檔案。

靜態檔案尋找器目前被視為私有介面，因此這個介面沒有文件說明。

快取¶

• CACHES

• CACHE_MIDDLEWARE_ALIAS

• CACHE_MIDDLEWARE_KEY_PREFIX

• CACHE_MIDDLEWARE_SECONDS

資料庫¶

• DATABASES

• DATABASE_ROUTERS

• DEFAULT_INDEX_TABLESPACE

• DEFAULT_TABLESPACE

除錯¶

• DEBUG

• DEBUG_PROPAGATE_EXCEPTIONS

電子郵件¶

• ADMINS

• DEFAULT_CHARSET

• DEFAULT_FROM_EMAIL

• EMAIL_BACKEND

• EMAIL_FILE_PATH

• EMAIL_HOST

• EMAIL_HOST_PASSWORD

• EMAIL_HOST_USER

• EMAIL_PORT

• EMAIL_SSL_CERTFILE

• EMAIL_SSL_KEYFILE

• EMAIL_SUBJECT_PREFIX

• EMAIL_TIMEOUT

• EMAIL_USE_LOCALTIME

• EMAIL_USE_TLS

• MANAGERS

• SERVER_EMAIL

錯誤回報¶

• DEFAULT_EXCEPTION_REPORTER

• DEFAULT_EXCEPTION_REPORTER_FILTER

• IGNORABLE_404_URLS

• MANAGERS

• SILENCED_SYSTEM_CHECKS

檔案上傳¶

• FILE_UPLOAD_HANDLERS

• FILE_UPLOAD_MAX_MEMORY_SIZE

• FILE_UPLOAD_PERMISSIONS

• FILE_UPLOAD_TEMP_DIR

• MEDIA_ROOT

• MEDIA_URL

• STORAGES

表單¶

• FORM_RENDERER

• FORMS_URLFIELD_ASSUME_HTTPS

全球化 (i18n/l10n)¶

HTTP¶

• DATA_UPLOAD_MAX_MEMORY_SIZE

• DATA_UPLOAD_MAX_NUMBER_FIELDS

• DATA_UPLOAD_MAX_NUMBER_FILES

• DEFAULT_CHARSET

• DISALLOWED_USER_AGENTS

• FORCE_SCRIPT_NAME

• INTERNAL_IPS

• MIDDLEWARE

• 安全性

  • SECURE_CONTENT_TYPE_NOSNIFF

  • SECURE_CROSS_ORIGIN_OPENER_POLICY

  • SECURE_HSTS_INCLUDE_SUBDOMAINS

  • SECURE_HSTS_PRELOAD

  • SECURE_HSTS_SECONDS

  • SECURE_PROXY_SSL_HEADER

  • SECURE_REDIRECT_EXEMPT

  • SECURE_REFERRER_POLICY

  • SECURE_SSL_HOST

  • SECURE_SSL_REDIRECT

• SIGNING_BACKEND

• USE_X_FORWARDED_HOST

• USE_X_FORWARDED_PORT

• WSGI_APPLICATION

記錄¶

• LOGGING

• LOGGING_CONFIG

模型¶

• ABSOLUTE_URL_OVERRIDES

• FIXTURE_DIRS

• INSTALLED_APPS

安全性¶

• 跨站請求偽造保護

  • CSRF_COOKIE_DOMAIN

  • CSRF_COOKIE_NAME

  • CSRF_COOKIE_PATH

  • CSRF_COOKIE_SAMESITE

  • CSRF_COOKIE_SECURE

  • CSRF_FAILURE_VIEW

  • CSRF_HEADER_NAME

  • CSRF_TRUSTED_ORIGINS

  • CSRF_USE_SESSIONS

• SECRET_KEY

• SECRET_KEY_FALLBACKS

• X_FRAME_OPTIONS

序列化¶

• DEFAULT_CHARSET

• SERIALIZATION_MODULES

範本¶

• TEMPLATES

測試¶

• 資料庫： TEST

• TEST_NON_SERIALIZED_APPS

• TEST_RUNNER

網址¶

• APPEND_SLASH

• PREPEND_WWW

• ROOT_URLCONF