設定¶
如 Django 的一般做法，所有設定都儲存在 settings.py 中。
備註
變更這些設定後，必須重新啟動 Weblate，包括 WSGI 及 Celery 處理程序。
在它作為 mod_wsgi 執行的情況下，需要重新啟動 Apache，來重新載入設定。
也參考
還要請檢視 Django's documentation 中關於設定 Django 自身的參數。
ADMINS_CONTACT¶
設定聯絡表單向何處傳送電子郵件。如未設定，將使用來自 ADMINS 的電子郵件地址。
請將此值設為電子郵件地址清單：
ADMINS_CONTACT = ["admin@example.com", "support@example.com"]
也參考
ALLOWED_ASSET_DOMAINS¶
在 5.14 版被加入.
設定允許哪些網域取得 Weblate 中的資產。
這會防止從不受信任的來源載入資產，藉此強化安全性。資產由 Weblate 伺服器下載一次後儲存於本機，而不是直接從外部網域提供給使用者。
Weblate 會先將允許清單套用至初始 URL 及每個 HTTP 重新導向目標，再決定是否跟隨。若主機不在允許清單中，就會拒絕重新導向。
此設定應為主機名稱或網域清單。您可以使用完整限定名稱（例如 www.example.com），也可以在前方加上句點作為萬用字元，以比對所有子網域（例如 .example.com 會比對 cdn.example.com 及 static.example.com）。
預設為 ["*"]，代表允許所有網域。
範例
ALLOWED_ASSET_DOMAINS = [
# Allows only cdn.anotherdomain.org
"cdn.anotherdomain.org",
# Allows example.com and all its subdomains
".example.com",
]
目前用於下列位置：
螢幕擷圖上傳，請參閱 螢幕擷圖和視覺化情境
適用於 JavaScript 在地化 CDN 附加元件的遠端 HTML 下載
ALLOWED_MACHINERY_DOMAINS¶
設定專案層級機器翻譯設定明確允許哪些自訂機制網域。
此設定僅適用於機器翻譯服務，不會影響 ALLOWED_ASSET_DOMAINS。
此設定應為主機名稱或網域清單。您可以使用完整限定名稱，也可在前方加上句點作為萬用字元，以比對所有子網域。
預設為 []。
allowlist 會以兩種方式影響專案管理機制：允許設定端點通過對外驗證，並在決定是否可向使用者顯示遠端提供者錯誤細節或回應內容時，將相符主機標示為受信任。相符主機也豁免私有目標限制。對直接連線而言，Weblate 不會解析、繫結或驗證相符主機的對等端位址。僅加入網路目的地受信任的主機或網域。使用設定的 HTTP 代理 時，會信任 Proxy 解析目的地主機名稱。
ALLOWED_ASSET_SIZE¶
在 5.14 版被加入.
設定擷取或上傳至 Weblate 的資產大小上限（單位為位元組）。預設為 10 MB。
ASSET_PRIVATE_ALLOWLIST¶
在 2025.5 版被加入.
定義遠端資產下載在執行私人目標檢查時，可豁免 ASSET_RESTRICT_PRIVATE 的主機名稱或網域。項目遵循 Django 主機比對語意，因此可以使用 assets.internal.example 或 .internal.example 等值。
這不會取代 ALLOWED_ASSET_DOMAINS；遠端資產仍必須符合資產網域允許清單。
預設設定：
ASSET_PRIVATE_ALLOWLIST = []
ASSET_RESTRICT_PRIVATE¶
在 2025.5 版被加入.
拒絕指向內部或非公開地址的遠端資產 URL，除非目標主機包含在 ASSET_PRIVATE_ALLOWLIST 中。預設開啟。
啟用後，系統會拒絕在驗證期間無法解析的主機名稱，除非已明確將它們加入 ASSET_PRIVATE_ALLOWLIST。此設定目前適用於螢幕擷圖 URL 上傳，以及 JavaScript 在地化 CDN 附加元件的遠端 HTML 下載。
ALTCHA_COST¶
在 2025.5 版被加入.
ALTCHA 工作量證明挑戰的 Argon2id 時間成本。預設為 3。
取代套用於已移除 ALTCHA Widget v2 的 ALTCHA_MAX_NUMBER。
ALTCHA_MEMORY_COST¶
在 2025.5 版被加入.
Argon2id 記憶體成本（單位為 KiB）。預設為 65536。
ALTCHA_PARALLELISM¶
在 2025.5 版被加入.
Argon2id 平行係數。預設為 1。
也參考
ANONYMOUS_USER_NAME¶
未登入使用者的使用者名稱。
也參考
AUDITLOG_EXPIRY¶
Weblate 保留含有帳號活動資訊之稽核記錄的最長天數。
預設為 180 天。
AUTH_LOCK_ATTEMPTS¶
在rate限制應用前，授權嘗試失敗的最多次數。
目前，這應用在後面的位置：
登入。刪除帳號密碼，防止使用者不請求新的密碼而登入。
密碼重設。防止傳送新的電子郵件，避免過多密碼重設嘗試造成使用者收到大量信件。
預設為 10。
也參考
AUTO_UPDATE¶
以每天的頻率更新所有儲存庫。
提示
在不使用 通知掛勾 來自動更新 Weblate 儲存庫的情況下有用。
備註
為了向後相容，除了字串選項外，也提供開啟或關閉選項。
選項有：
"none"無每日更新。
"remote"alsoFalse只更新遠端儲存庫。
"full"也為True更新遠端，並合併工作副本。
備註
這需要 使用 Celery 的背景工作 工作，並在重啟後生效。
AVATAR_URL_PREFIX¶
建構頭像 URL 的前置字串，格式如下：${AVATAR_URL_PREFIX}/avatar/${MAIL_HASH}?${PARAMS}。已知下列服務可正常運作：
- Gravatar（預設）：https://gravatar.com/
AVATAR_URL_PREFIX = 'https://www.gravatar.com/'- Libravatar：https://www.libravatar.org/
AVATAR_URL_PREFIX = 'https://www.libravatar.org/'
也參考
AUTH_TOKEN_VALID¶
身分驗證權杖和密碼重設電子郵件中臨時密碼的有效時間。以秒為單位，預設為 172800（ 2 天）。
AUTH_PASSWORD_DAYS¶
Weblate 禁止使用者重複使用舊密碼的天數。
這項檢查以稽核記錄為依據，因此 AUDITLOG_EXPIRY 必須至少設為相同天數。
備註
自動修復很強大，但可能導致損壞；寫指令碼的時候要小心。
預設為 180 天。
AUTOFIX_LIST¶
當儲存字串時應用自動修復清單。
備註
提供實作 autofixer 介面的 Python 類別完整限定路徑。
可用的修復方式請參閱 自動修正。
可以選取使用哪一個：
AUTOFIX_LIST = (
"weblate.trans.autofixes.whitespace.SameBookendingWhitespace",
"weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsis",
)
BACKGROUND_TASKS¶
在 4.5.2 版被加入.
定義應為組件觸發冗長的維護工作的頻率。
此刻的控制項：
可能的選項：
monthly(this is the default)weeklydailynever
備註
當WebLate包含數千個組件時，不建議不要增加頻率。
BASIC_LANGUAGES¶
在 4.4 版被加入.
提供給使用者以開始新翻譯的語言清單。未指定時，系統會使用內建清單，其中包含所有常用語言，但不包含特定國家或地區的變體。
這只會限制沒有特殊權限的使用者加入不需要的語言。專案管理員仍能選擇 Weblate 中定義的全部語言。
備註
這不會為 Weblate 定義新語言，而只會篩選資料庫中的現有語言。
範例：
BASIC_LANGUAGES = {"cs", "it", "ja", "en"}
也參考
BORG_EXTRA_ARGS¶
在 4.9 版被加入.
您可以帶入額外的參數在 borg create 中使用，當觸發內建的備份機制時。
範例：
BORG_EXTRA_ARGS = ["--exclude", "vcs/"]
CACHE_DIR¶
在 4.16 版被加入.
Weblate 存放快取檔案的目錄。預設為 DATA_DIR 中的 cache 子目錄。
如果 DATA_DIR 位於網路檔案系統，請將此設定改為本機或暫存檔案系統。
Weblate 會將產生的輔助檔案儲存在此處，並執行其中部分檔案，因此 CACHE_DIR 必須可寫入，且掛載在允許執行檔案的檔案系統上。請避免對此目錄使用 noexec 掛載選項。
Docker 容器為此使用單獨的儲存區，請參閱 Docker 容器儲存區。
後面的子目錄通常存在：
ssh用於存取 VCS 的已產生輔助檔案。
fonts管理字型 的 font-config 快取。
avatar快取的使用者頭像，請參閱 頭像。
static靜態 Django 檔案的預設位置，由
STATIC_ROOT指定。見 提供靜態檔案。tesseract螢幕擷圖和視覺化情境 的 OCR 訓練資料。
CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC, CSP_FORM_SRC¶
自訂 Weblate 的 Content-Security-Policy 標頭。系統會根據啟用的第三方服務整合（Matomo、Google Analytics、Sentry 等）自動產生此標頭。
這些設定的預設值都是空白清單。
範例：
# Enable Cloudflare Javascript optimizations
CSP_SCRIPT_SRC = ["ajax.cloudflare.com"]
CHECK_LIST¶
翻譯時執行的品質檢查清單。
備註
為實施檢查介面的 Python 類提供完全合規的路徑。
調整檢查清單，來包括與您相關的那些檢查。
所有內建 品質檢查 預設都會啟用，您可以使用這些設定加以變更。在 範例設定 中，這些設定預設已註解，因此會使用預設值。每個 Weblate 新版本新增的檢查也會隨之執行。
可以關閉所有檢查：
CHECK_LIST = ()
可以只打開一部分檢查：
CHECK_LIST = (
"weblate.checks.chars.BeginNewlineCheck",
"weblate.checks.chars.EndNewlineCheck",
"weblate.checks.chars.MaxLengthCheck",
)
備註
變更此設定只會影響之後變更的翻譯；現有檢查仍會儲存在資料庫中。若要將變更也套用於已儲存的翻譯，請執行 updatechecks。
COMMIT_PENDING_HOURS¶
通過背景工作方式提交待定的變更之間的小時數。
COMPONENT_ZIP_UPLOAD_MAX_SIZE¶
在 5.17.1 版被加入.
設定上傳組件 ZIP 檔案的最大大小，單位為位元組。預設為 50 MB。
在 Docker 中，使用 WEBLATE_COMPONENT_ZIP_UPLOAD_MAX_SIZE 環境變數設定這個。
也參考
CONTACT_FORM¶
在 4.6 版被加入.
設定來自聯絡表單的電子郵件的傳送方式。選擇與您的電子郵件伺服器設定相符的設定。
"reply-to"依預設，寄件者會用作 Reply-To。
"from"寄件者會用作 From。您的電子郵件伺服器必須允許傳送此類電子郵件。
"disabled"完全停用聯絡表單。
在 5.15 版被加入.
也參考
DATA_DIR¶
Weblate 儲存所有資料的資料夾。其中包含 VCS 儲存庫的連結、全文索引，以及各種外部工具的設定檔案。
後面的子目錄通常存在：
homeHome 目錄用於呼叫指令碼。
sshSSH 金鑰和設定。
mediaDjango 媒體檔案的預設位置，由
MEDIA_ROOT指定。包含已上傳的螢幕擷圖，見 螢幕擷圖和視覺化情境。vcs用於翻譯的版本控制儲存庫。
backups每日備份資料，詳情請查閱 下載的資料用於備份。
fonts：使用者已上傳的字型，參閱： 管理字型 。
cache各種快取。可使用
CACHE_DIR置於別處。Docker 容器為此使用單獨的儲存區，請參閱 Docker 容器儲存區。
備註
Weblate 必須能夠寫入此目錄。以 WSGI 方式執行時，www-data 使用者應具備此目錄的寫入權限。
達成這個的最簡單方式是讓使用者作為目錄的所有者：
sudo chown www-data:www-data -R $DATA_DIR
預設為 /home/weblate/data，但預期需要被設定。
DATABASE_BACKUP¶
資料庫備份應該儲存為純文字，壓縮還是略過。授權值為：
"plain""compressed""none"
也參考
DEFAULT_ACCESS_CONTROL¶
新專案的預設存取控制設定：
0公開
1保護
100私人
200自訂
如果手動管理 ACL 則使用 Custom，這意味著不依賴於 Weblate 內部管理。
DEFAULT_AUTO_WATCH¶
在 4.5 版被加入.
設定新使用者是否應啟用 貢獻時自動關注專案。預設為 True。
也參考
DEFAULT_RESTRICTED_COMPONENT¶
在 4.1 版被加入.
組件限制的預設值。
default_add_message，default_addon_message，default_commit_message，default_delete_message，default_merge_message¶
不同操作的預設執行資訊，細節請查閱 組件設定。
內建預設值遵循 Conventional Commits，並在可用時加入 Weblate 連結。變更這些設定會影響新建立的預設值；既有訊息範本可以在設定表單中使用 還原網站預設值 重設。對於繼承的值，還原網站預設值也會停用該訊息的繼承。
DEFAULT_ADDONS¶
每個建立組件預設安裝的附加元件。
備註
此設定只影響新建立的組件。
範例：
DEFAULT_ADDONS = {
# Add-on with no parameters
"weblate.flags.target_edit": {},
# Add-on with parameters
"weblate.autotranslate.autotranslate": {
"mode": "suggest",
"filter_type": "todo",
"auto_source": "mt",
"component": "",
"engines": ["weblate-translation-memory"],
"threshold": "80",
},
}
DEFAULT_COMMITER_EMAIL¶
提交者電子郵件位址，預設為 noreply@weblate.org。
DEFAULT_COMMITER_NAME¶
提交者名稱，預設為 Weblate。
DEFAULT_LANGUAGE¶
在 4.3.2 版被加入.
任何新組件的 來源語言。
預設為 en。相符的語言物件需要存在於資料庫中。
DEFAULT_MERGE_STYLE¶
任何新組件的 合併類型。
rebase - 預設
merge
DEFAULT_TRANSLATION_REVIEW¶
在 5.16 版被加入.
設定 啟用檢閱 的預設值，預設關閉。
DEFAULT_SOURCE_REVIEW¶
在 5.16 版被加入.
設定 啟用來源檢閱 的預設值，預設關閉。
DEFAULT_AUTOCLEAN_TM¶
在 5.13 版被加入.
設定 自動清理翻譯記憶 的預設值。
DEFAULT_TRANSLATION_PROPAGATION¶
翻譯傳播的預設設定，預設為 True。
DEFAULT_PULL_MESSAGE¶
設定拉取請求的預設標題與訊息。
內建預設值遵循 Conventional Commits，並包含 Weblate 連結及翻譯狀態。
ENABLE_AVATARS¶
是否啟用以 Gravatar 為基礎的使用者頭像。預設啟用。
頭像會由伺服器擷取並快取，以降低洩漏私人資訊的風險，並加快使用體驗。
也參考
ENABLE_HOOKS¶
是否開啟匿名遠端掛勾。
也參考
ENABLE_HTTPS¶
在 5.7 版的變更: Weblate 現在需要使用 HTTPS 才能支援 WebAuthn。
將連結作為 HTTPS 還是 HTTP 傳送給 Weblate。這個設定影響傳送電子郵件，並產生絕對 URL。
在預設設定中，這也用於幾個與 HTTPS 相關的 Django 設定：啟用安全 Cookie、切換 HSTS，或啟用重新導向至 HTTPS URL。
在某些情況下，HTTPS 重新導向可能造成問題。如果使用反向 Proxy 終止 SSL，但 Proxy 未正確將協定標頭傳給 Django，就可能陷入無限重新導向。請調整反向 Proxy 設定，使其傳送 X-Forwarded-Proto 或 Forwarded 標頭，或設定 SECURE_PROXY_SSL_HEADER，讓 Django 能正確偵測 SSL 狀態。
如果停用此設定，Weblate 會因 otp_webauthn.E031 錯誤而無法啟動。您可以將這個錯誤加入 SILENCED_SYSTEM_CHECKS 以停止顯示，但 WebAuthn 仍無法在未使用 HTTPS 的網站上運作。
ENABLE_SHARING¶
開啟或關閉 社群 選單，讓使用者可以在社群網路上分享翻譯進度。
也參考
EXTRA_HTML_HEAD¶
在 4.15 版被加入.
將額外標記插入 HTML 標頭。例如，可用於驗證網站所有權：
EXTRA_HTML_HEAD = '<link href="https://fosstodon.org/@weblate" rel="me">'
警告
不會對字串進行清理，而是原封不動插入 HTML 標頭。
GET_HELP_URL¶
在 4.5.2 版被加入.
可以找到您的 Weblate 執行個體支援的 URL。
GITEA_CREDENTIALS¶
在 4.12 版被加入.
用於 Gitea 伺服器的憑證清單。
GITEA_CREDENTIALS = {
"try.gitea.io": {
"username": "weblate",
"token": "your-api-token",
},
}
設定字典包含為每個 API 主機定義的認證資訊。幾乎所有版本控制整合的結構都相同，詳見 設定版本控制憑證。
GITLAB_CREDENTIALS¶
在 4.3 版被加入.
用於 GitLab 伺服器的證明清單。
GITLAB_CREDENTIALS = {
"gitlab.com": {
"username": "weblate",
"token": "your-api-token",
},
}
備註
要能使用該 API，個人存取權杖需要 api 範圍。
設定字典包含為每個 API 主機定義的認證資訊。幾乎所有版本控制整合的結構都相同，詳見 設定版本控制憑證。
GITHUB_CREDENTIALS¶
在 4.3 版被加入.
用於 GitHub 伺服器的證明清單。
GITHUB_CREDENTIALS = {
"api.github.com": {
"username": "weblate",
"token": "your-api-token",
},
}
備註
可以使用細部權限個人存取權杖或傳統個人存取權杖。細部權限權杖只適用於單一組織，因此如果想讓 Weblate 將儲存庫 fork 至組織外（通常是使用者命名空間），就無法使用這種權杖。
要複製、推送並建立拉取請求，需要對 Contents 和 Pull requests 的讀取和寫入權限。
Administration 對 fork 儲存庫來說可能也是必需的，如果您打算使用 fork，而原始儲存庫並不公開。
提示
使用 api.github.com 作為 https://github.com/ 的 API 主機。
設定字典包含為每個 API 主機定義的認證資訊。幾乎所有版本控制整合的結構都相同，詳見 設定版本控制憑證。
GITHUB_LEGACY_APP_WEBHOOK_SECRET¶
在 2026.8 版被加入.
用於將事件傳遞至通用 GitHub webhook URL /hooks/github/ 的舊版 GitHub App webhook 祕密值。
此設定為空或其 X-Hub-Signature-256 不相符時，傳送至通用 URL 的應用程式 webhook 會遭拒絕。一般存放庫 webhook 不受影響。透過 Weblate 註冊的 GitHub Apps 使用各應用程式的 webhook URL，不使用此設定。
GITHUB_LEGACY_APP_WEBHOOK_SECRET = "your-webhook-secret"
BITBUCKETSERVER_CREDENTIALS¶
在 4.16 版被加入.
Bitbucket 資料中心憑證清單。
BITBUCKETSERVER_CREDENTIALS = {
"git.self-hosted.com": {
"username": "weblate",
"token": "http-access-token",
},
}
設定字典包含為每個 API 主機定義的認證資訊。幾乎所有版本控制整合的結構都相同，詳見 設定版本控制憑證。
BITBUCKETCLOUD_CREDENTIALS¶
在 5.8 版被加入.
Bitbucket Cloud 伺服器憑證清單。
BITBUCKETCLOUD_CREDENTIALS = {
"bitbucket.org": {
"username": "your-email",
"workspace": "your-workspace-slug",
"token": "your-api-token",
},
}
設定字典由每個 API 主機所定義的憑證組成。API 主機可能與網頁瀏覽器使用的主機不同；例如，GitHub API 的存取位址是 api.github.com。
下列設定對每個主機可用：
usernameAPI 使用者。
workspace使用者工作空間代稱。
token有 pullrequest:write 權限的 API 權杖。
此處未說明的其他設定可以在 設定版本控制憑證 中找到。
AZURE_DEVOPS_CREDENTIALS¶
在 5.2 版被加入.
Azure DevOps 伺服器憑證清單。
AZURE_DEVOPS_CREDENTIALS = {
"dev.azure.com": {
"username": "project-name",
"token": "your-api-token",
"organization": "organization-name",
},
}
設定字典由每個 API 主機所定義的憑證組成。API 主機可能與網頁瀏覽器使用的主機不同；例如，GitHub API 的存取位址是 api.github.com。
下列設定對每個主機可用：
usernameAzure DevOps 專案名稱。這不是儲存庫名稱。
organization專案的組織名稱。
workItemIds您所屬組織的工作項目 ID 選用清單。如有提供，建立的拉取請求會附上這些 ID。
tokenAPI 使用者的 API 權杖，必填。
此處未說明的其他設定可以在 設定版本控制憑證 中找到。
GOOGLE_ANALYTICS_ID¶
用於透過 Google Universal Analytics 啟用 Weblate 監測的 Google Analytics ID。
備註
Google Analytics 4 整合目前對 Weblate 不可用，請參閱 https://github.com/WeblateOrg/weblate/issues/14015。
HIDE_REPO_CREDENTIALS¶
隱藏儲存庫憑證避免出現在 web 介面中。在儲存庫網址帶有使用者名稱和密碼的情況下， Weblate 會在相關資訊顯示給使用者時將其隱藏起來。
例如，系統只會顯示 https://git.example.com/repo.git，而不是 https://user:password@git.example.com/repo.git。系統也會嘗試以類似方式清理 VCS 錯誤訊息。
備註
預設啟用。
VERSION_DISPLAY¶
在 5.17 版被加入.
控制 Weblate 公開自身版本的顯著程度。
支援的值有：
show在頁尾等共用使用者介面中顯示版本，並於
GET /api/metrics/中提供版本資訊。soft在顯眼的共享使用者介面中隱藏版本，但在 關於 頁面和
GET /api/metrics/中讓版本可發現。hide在共享的使用者介面和
GET /api/metrics/中隱藏版本。這還會使匿名文件連結指向最新文件而不是相符已安裝 Weblate 版本的文件。
隱藏版本是某些企業建議的安全實踐，但不能防止攻擊者透過試探行為來推測版本。
備註
預設值為 show。
HIDE_VERSION¶
在 4.3.1 版被加入.
在 5.17 版之後被棄用.
VERSION_DISPLAY 的相容性別稱。將這個設為 True 以取得和 VERSION_DISPLAY = "hide" 相同的行為。
INTERNAL_BOT_EMAIL_TEMPLATE¶
在 2026.7.1 版被加入.
用於產生內部 Weblate 機器人帳號電子郵件地址的範本。預設為 "noreply-{scope}-{name}@weblate.org"。
它可以包含 {scope} 、 {name} 、 {username} 、 {site_title} 和 {site_domain} 。
產生電子郵件地址的 @ 前部分時，請使用 {scope} 和 {name}。{username} 值包含內部的 scope:name 使用者名稱。
執行 migrate 時會更新既有的內部機器人帳號。專案 API 權杖帳號不受影響。
IP_BEHIND_REVERSE_PROXY¶
說明 Weblate 是否在反向代理後面執行。
如果設定為 True， Weblate 會從 IP_PROXY_HEADER 定義的標頭中得到 IP 位址。
警告
The reverse proxy which connects to Weblate must overwrite the configured
header or append a verified peer address at the position selected by
IP_PROXY_OFFSET. Weblate does not verify which peer supplied the
header, so trusting a client-controlled value allows IP address spoofing.
Ensure that untrusted clients cannot reach Weblate without passing through the trusted proxy.
備註
這並非預設啟用。
IP_PROXY_HEADER¶
說明當 IP_BEHIND_REVERSE_PROXY 開啟時，Weblate應該從那個標頭得到 IP 位址。
預設為 HTTP_X_FORWARDED_FOR。
IP_PROXY_OFFSET¶
在 5.0.1 版的變更: 預設已從 1 變更為 -1。
說明 IP_PROXY_HEADER 的哪部分用作用戶端 IP 位址。
取決於您的設定，這個標頭會包括幾個 IP 地址，（例如 X-Forwarded-For: client-ip, proxy-a, proxy-b），並且可以設定標頭的哪個地址在這裡用作客戶端 IP 地址。
警告
Setting this affects the security of your installation. Select only an address added or verified by a proxy under your control. Addresses supplied by the client are untrusted. Ensure that the selected offset matches how your proxies construct the header.
See <https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-For#security_and_privacy_concerns> for more details.
預設為 -1。
LEGAL_DOCUMENT_CSS_CLASS¶
在 2026.7 版被加入.
新增至法律文件範本外層包裝元素的 CSS 類別。
預設為 "tos"。Weblate 不會為此 class 套用樣式；自訂法律樣式可用它指定文件包裝器。若要在沒有 wrapper class 的情況下呈現法律文件，請設為空字串。
LEGAL_DOCUMENT_CSS_CLASS = ""
LEGAL_TOS_DATE¶
在 4.15 版被加入.
備註
您需要安裝 法律模組 以使其工作。
Date of the legal documents users last agreed to. Whenever the date changes, users are required to agree with the current terms of service and, when a privacy policy link is available, the privacy policy.
from datetime import date
LEGAL_TOS_DATE = date(2022, 2, 2)
LEGAL_URL¶
您的 Weblate 事例顯示其法律文件的 URL。
提示
如果在 Weblate 之外而非用 法律模組 模組託管法律文件時有用。啟用法律模組時，Weblate 預設連結到內部法律頁。
範例：
LEGAL_URL = "https://weblate.org/terms/"
也參考
LICENSE_EXTRA¶
包括在授權選擇中的其他授權。
備註
每個授權定義應該是其短名稱、長名稱、URL 和布林值的元組，表明其是否是自由授權。
例如：
LICENSE_EXTRA = [
(
"AGPL-3.0",
"GNU Affero General Public License v3.0",
"https://www.gnu.org/licenses/agpl-3.0-standalone.html",
True,
),
]
LICENSE_FILTER¶
在 4.3 版的變更: 設定此值為空現在會關閉授權警示。
要顯示的被篩選的授權清單。在設定為空時還關閉了授權警示。
備註
這個過濾器使用了短授權名稱。
例如：
LICENSE_FILTER = {"AGPL-3.0", "GPL-3.0-or-later"}
以下為停用授權警報的方法：
LICENSE_FILTER = set()
也參考
LICENSE_REQUIRED¶
定義了是否需要 組件設定 中的授權屬性。
備註
預設這是關閉的。
LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH¶
是否應限制給定翻譯的長度。限制為來源字串的長度 × 10 個字元。
提示
將其設定為 False 即可允許更長的翻譯（最多 10,000 個字元），而不管來源字串的長度。
備註
預設為 True.
LOCALIZE_CDN_URL 和 LOCALIZE_CDN_PATH¶
這些設定設定 JavaScript 在地化 CDN 和 翻譯檔案 CDN 在內的 CDN 附加元件。LOCALIZE_CDN_URL 定義了在地化 CDN 可用的根 URL，而 LOCALIZE_CDN_PATH 定義了 Weblate 應把 LOCALIZE_CDN_URL 將提供的產生檔案儲存在哪個路徑。您的 web 伺服器或 CDN 提供這些檔案，安全提供指南見 在地化 CDN。
提示
在 Hosted Weblate 中，這使用 https://weblate-cdn.com/。
MATOMO_SITE_ID¶
您想用來跟蹤 Weblate 的 Matomo（以前的 Piwik）網站的 ID。
備註
此整合不支援 Matomo Tag Manager。
也參考
MATOMO_URL¶
您想用於跟蹤 Weblate 使用情況的 Matomo（以前的 Piwik）安裝的完整 URL（包括結尾的斜槓）。請查閱 <https://matomo.org/> 瞭解詳情。
提示
此整合不支援 Matomo Tag Manager。
例如：
MATOMO_SITE_ID = 1
MATOMO_URL = "https://example.matomo.cloud/"
也參考
NEARBY_MESSAGES¶
在完整編輯器中要在各方向顯示的相鄰字串數。
這只是預設值，使用者可以在 使用者設定檔 中調整。
DEFAULT_PAGE_LIMIT¶
在 4.7 版被加入.
分頁啟用時顯示的預設元素數量。
PAGURE_CREDENTIALS¶
在 4.3.2 版被加入.
Pagure 伺服器憑證清單。
PAGURE_CREDENTIALS = {
"pagure.io": {
"username": "weblate",
"token": "your-api-token",
},
}
設定字典包含為每個 API 主機定義的認證資訊。幾乎所有版本控制整合的結構都相同，詳見 設定版本控制憑證。
PASSWORD_MINIMAL_STRENGTH¶
在 5.10.2 版被加入.
最小的密碼得分由 zxcvbn 密碼長度預測器進行評估。
預設為 0，表示停用強度檢查。
PASSWORD_RESET_URL¶
在 5.17 版被加入.
當身分驗證由 LDAP、SAML 或 OAuth 等外部身分提供方處理時的密碼重置 URL。
設定後，登入頁上的 忘記密碼了嗎？ 連結到此 URL 而不是 Weblate 內建的密碼重置頁面。
PRIVACY_URL¶
在 4.8.1 版被加入.
您的 Weblate 執行個體顯示其隱私政策的 URL。
提示
如果您將隱私權政策託管在 Weblate 之外，而非使用 法律模組 模組，這項設定就很實用。啟用法律模組時，Weblate 預設會連結至內部法律頁面。
範例：
PRIVACY_URL = "https://weblate.org/terms/"
也參考
PRIVATE_COMMIT_EMAIL_OPT_IN¶
在 4.15 版被加入.
設定私密提交電子郵件是手動啟用還是預設啟用（預設情況下為手動啟用）。
提示
此設定僅適用於未明確選擇提交電子郵件的使用者。
PRIVATE_COMMIT_EMAIL_TEMPLATE¶
在 4.15 版被加入.
為使用者產生私密提交電子郵件的範本。預設為 "{username}@users.noreply.{site_domain}" 。
其可以包含 {user_id} 、 {username} 、 {site_title} 與 {site_domain}。
設為空白字串以停用。
備註
除非透過 PRIVATE_COMMIT_EMAIL_OPT_IN 設定，否則使用不同的提交電子郵件對使用者而言預設處於手動啟用狀態。使用者可以在 個人檔案 中設定提交電子郵件。
PRIVATE_COMMIT_NAME_OPT_IN¶
在 5.16 版被加入.
設定私密提交名稱是手動啟用還是預設啟用（預設情況下為手動啟用）。
提示
此設定僅適用於未明確選擇提交名稱的使用者。
PRIVATE_COMMIT_NAME_TEMPLATE¶
在 5.16 版被加入.
為使用者產生私密提交名稱的範本。預設為 "{site_title} user {user_id}".
其可以包含 {user_id} 、 {username} 、 {site_title} 與 {site_domain}。
設為空白字串以停用。
備註
除非透過 PRIVATE_COMMIT_NAME_OPT_IN 設定，否則使用不同的提交名稱對使用者處於手動啟用狀態。使用者可以在 個人檔案 中設定提交名稱。
PROJECT_BACKUP_KEEP_COUNT¶
在 4.14 版被加入.
定義每個專案在伺服器上保留多少備份，預設值為 3。
也參考
PROJECT_BACKUP_KEEP_DAYS¶
在 4.14 版被加入.
定義每個專案的備份將存放多久在伺服器上。預設為 30 天。
也參考
PROJECT_BACKUP_UPLOAD_MAX_SIZE¶
在 5.17.1 版被加入.
設定上傳元件備份 ZIP 檔案的最大大小，單位為位元組。預設 536870912 位元組（512 MiB）。
在 Docker 中，請使用 WEBLATE_PROJECT_BACKUP_UPLOAD_MAX_SIZE 環境變數進行設定。Docker 設定也可能受 CLIENT_MAX_BODY_SIZE 限制；其他部署則可能受反向 Proxy 的要求本文大小限制。
也參考
PROJECT_BACKUP_IMPORT_MAX_MEMBERS¶
在 5.17 版被加入.
定義匯入專案備份時允許的 ZIP 條目的最大數量。
這是針對格式錯誤或刻意碎片化歸檔檔案的一種防護措施。預設為 100000 個條目。
在 Docker 中，使用 WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS 環境變數設定這個。
也參考
PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE¶
在 5.17.1 版被加入.
定義匯入的專案備份中 ZIP 項的最大的總未壓縮大小。預設為 536870912 位元組（512 MiB）。
這會限制上傳時很小，但在驗證或還原期間會展開成大量資料的封存檔。
在 Docker 中，使用 WEBLATE_PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE 環境變數設定這個。
也參考
PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE¶
在 5.17 版被加入.
定義匯入的專案備份中單一高度壓縮的 ZIP 條目的最大未壓縮大小（以位元組為單位）。
此限制僅適用於那些體積足夠大且壓縮程度足夠高、看起來可疑的條目。這裡特意允許使用體積大但壓縮率低的檔案，並且預計會受到 HTTP 上傳限制的約束。預設為 262144000 位元組（250 MiB）。
在 Docker 中，使用 WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE 環境變數設定這個。
也參考
PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE¶
在 5.17 版被加入.
定義 Weblate 在專案備份匯入期間開始考慮 ZIP 壓縮比的最小未壓縮大小（以位元組為單位）。
基於壓縮比的驗證會忽略較小的檔案，以避免拒絕那些壓縮效果良好且大小合理的檔案。預設為 1048576 位元組（1 MiB）。
在 Docker 中，使用 WEBLATE_PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE 環境變數設定這個。
也參考
PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO¶
在 5.17 版被加入.
定義專案備份匯入期間大型 ZIP 條目的未壓縮大小和壓縮大小之間允許的最大比例。
此設定與 PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE 和 PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE 配合使用來檢測可疑的壓縮條目，同時仍然允許大型儲存庫打包檔案和其他低壓縮率內容。預設為 250。
在 Docker 中，使用 WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO 環境變數設定這個。
也參考
PROJECT_NAME_RESTRICT_RE¶
在 4.15 版被加入.
定義用於限制專案命名的正規表示式。任何相符的名稱都將被拒絕。
也參考
PROJECT_WEB_RESTRICT_HOST¶
在 4.16.2 版被加入.
在專案網站中拒絕使用特定的主機。相符任何子網域，因此包含 example.com 會同樣攔截 test.example.com. 此清單只應包含小寫字串，進行相符前，解析的網網域稱會轉為小寫。
預設設定：
PROJECT_WEB_RESTRICT_HOST = {"localhost"}
PROJECT_WEB_RESTRICT_ALLOWLIST¶
在 5.17 版被加入.
定義一組驗證專案網站時排除在 PROJECT_WEB_RESTRICT_HOST、PROJECT_WEB_RESTRICT_NUMERIC、PROJECT_WEB_RESTRICT_PRIVATE 和 PROJECT_WEB_RESTRICT_RE 之外的專案辨識符號。專案辨識符號相符不區分大小寫。
警示
此排除削弱對相符專案的外聯 URL 保護，包括 PROJECT_WEB_RESTRICT_PRIVATE 所強制的內網目標限制。請只把它用於受信任的由管理員管理的專案，繞過這些檢查在此類專案中是有意為之的。
預設設定：
PROJECT_WEB_RESTRICT_ALLOWLIST = set()
PROJECT_WEB_RESTRICT_NUMERIC¶
在 4.16.2 版被加入.
拒絕在專案網站中使用數字 IP 位址。預設啟用。
PROJECT_WEB_RESTRICT_PRIVATE¶
在 5.17 版被加入.
拒絕使用指向內部或非公開地址的專案網站和儲存庫瀏覽器 URL。預設開啟。
PROJECT_WEB_RESTRICT_RE¶
在 4.15 版被加入.
定義正規表示式限制什麼可以被輸入為 專案網站。任何相符的 URL 都將被拒絕。
WEBHOOK_PRIVATE_ALLOWLIST¶
在 5.17 版被加入.
定於免於對外 webhook 傳送限制 WEBHOOK_RESTRICT_PRIVATE 設定的主機名稱或網域。條目遵守 Django 主機相符語義，因此可以使用 hooks.internal.example 或 .internal.example 等值。
預設設定：
WEBHOOK_PRIVATE_ALLOWLIST = []
WEBHOOK_RESTRICT_PRIVATE¶
在 5.17 版被加入.
拒絕指向內部或非公開地址的 webhook URL，除非目標主機包含在 WEBHOOK_PRIVATE_ALLOWLIST 中。預設開啟。
啟用後將拒絕驗證期間無法解析的主機名稱，除非在 WEBHOOK_PRIVATE_ALLOWLIST 中明確允許它們。
PUBLIC_ENGAGE¶
在 5.16.2 版被加入.
即使設定了 REQUIRE_LOGIN，仍允許公眾參與頁面。
也參考
REPORT_EXPIRY¶
定義所產生的翻譯報告要保留多少天。預設為 90 天。變更此值也會改變現有報告何時符合每日清理工作的移除條件。
RATELIMIT_NOTIFICATION_LIMITS¶
在 5.14 版被加入.
限制向單一使用者傳送多少條通知。
預設設定為：
# Multi-level rate limiting for email notifications
# Each tuple contains (max_emails, time_window_seconds)
RATELIMIT_NOTIFICATION_LIMITS = [
# Prevent burst sends - 3 emails per 2 minutes
(3, 120),
# Equalize to avoid getting blocked for too long - 10 emails per hour
(10, 3600),
# Daily limit: 50 emails per day
(50, 86400),
]
RATELIMIT_ATTEMPTS¶
在應用次數限制前，身分驗證嘗試的最多次數。
預設為 5。
RATELIMIT_WINDOW¶
套用速率限制後，身分驗證可維持有效的時間。
秒數預設為 300（5 分鐘）。
RATELIMIT_LOCKOUT¶
在應用次數限制後，身分驗證鎖定多久。
秒數預設為 600 （ 10 分鐘）。
REGISTRATION_ALLOW_BACKENDS¶
在 4.1 版被加入.
身分驗證後端的清單，允許從中註冊。這只限制新的註冊，使用者可以使用設定的身分驗證後端，來進行身分驗證和新增身分驗證。
限制註冊後端的同時，建議保持 REGISTRATION_OPEN 為開啟狀態，否則使用者將能夠註冊，但Weblate不會在使用者介面顯示註冊的連結。
範例：
REGISTRATION_ALLOW_BACKENDS = ["azuread-oauth2", "azuread-tenant-oauth2"]
提示
與身分驗證 URL 中使用的名稱相符的後端名稱。
REGISTRATION_CAPTCHA¶
新帳號註冊是否受 CAPTCHA 的保護。此功能預設開啟。
啟用後，所有要求使用者輸入電子郵件地址的頁面都會加入 CAPTCHA：
新帳號註冊。
找回密碼。
將電子郵件地址新增到帳號中。
供未登入使用者使用的聯絡表單。
保護目前由下列步驟組成：
使用者要解決的數學人機驗證。
給瀏覽器計算的工作量證明挑戰。其難度可以使用
ALTCHA_COST、ALTCHA_MEMORY_COST與ALTCHA_PARALLELISM調整。
REGISTRATION_EMAIL_MATCH¶
允許您篩選哪個電子郵件地址可以註冊。
預設為 .*，允許使用任何電子郵件地址註冊。
可以用它限制註冊到單一的電子郵件網域：
REGISTRATION_EMAIL_MATCH = r"^.*@weblate\.org$"
REGISTRATION_ALLOW_DISPOSABLE_EMAILS¶
在 5.16.1 版被加入.
允許使用一次性電子郵件網域進行註冊。啟用後，會繞過一次性網域遮蔽清單。預設為 False。
REGISTRATION_OPEN¶
目前是否允許註冊新帳號。預設為允許。
這個設定影響了內建的透過電子郵件地址或透過 Python 社交認證的身分驗證（可以允許某些後端使用 REGISTRATION_ALLOW_BACKENDS）。
備註
如果使用第三方身分驗證方法，如 LDAP 身分驗證，只是隱藏註冊表單，而新使用者仍然能夠登入並建立帳號。
REGISTRATION_REBIND¶
在 4.16 版被加入.
允許為現有使用者重新繫結身分驗證後端。在不同身分驗證提供者之間移轉時請開啟此選項。
備註
預設停用，不允許新增其他身分驗證後端到現有帳號。使用更多第三方身分驗證後端時，重新繫結可導致帳號淪陷。
REPOSITORY_ALERT_THRESHOLD¶
在 4.0.2 版被加入.
觸發儲存庫過期警告的閾值，或者包含了太多變更的閾值。預設為 25。
也參考
REQUIRE_LOGIN¶
在 4.1 版被加入.
這會啟用 django.contrib.auth.middleware.LoginRequiredMiddleware 並設定 REST 框架要求所有 API 端點進行身分驗證。
在 5.15 版的變更: Weblate 現在依賴於 Django 內建中介層。
備註
這被實作於 範例設定 中。對於 Docker，使用 WEBLATE_REQUIRE_LOGIN。
GOOGLE_CLOUD_ERROR_REPORTING¶
使用 Google Cloud Error Reporting 收集 收集錯誤報告與監測效能 的設定。設為 None 會停用整合；也可以設為 Google Cloud Error Reporting 用戶端關鍵字引數的字典。
Weblate 會自動將 service 設為 weblate，並將 version 設為目前的 Weblate version 或 Git revision。字典中的明確值會覆寫這些預設值。
OPENTELEMETRY_ENABLED¶
在 2026.6 版被加入.
使用 OpenTelemetry 啟用後端追蹤。預設為停用。
只有啟用此功能且已設定 OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT 時，才會匯出追蹤資料。
OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT¶
OpenTelemetry 的 OTLP HTTP 追蹤端點，例如 https://collector.example.com/v1/traces。
OPENTELEMETRY_EXPORTER_OTLP_HEADERS¶
OpenTelemetry OTLP 匯出程式的額外 HTTP 標頭。預設為空字典。
OPENTELEMETRY_EXTRA_RESOURCE_ATTRIBUTES¶
額外的 OpenTelemetry 資源屬性。預設為空字典。
OPENTELEMETRY_SERVICE_NAME¶
OpenTelemetry 服務名稱。預設為 weblate。
OPENTELEMETRY_TRACES_SAMPLE_RATE¶
設定 OpenTelemetry 跟蹤取樣率。設為 1 跟蹤所有事件，0（預設）停用跟蹤。
SENTRY_DSN¶
用於 收集錯誤報告與監測效能 的 Sentry DSN。
SENTRY_ENVIRONMENT¶
設定 Sentry 的環境。預設為 devel。
SENTRY_MONITOR_BEAT_TASKS¶
在 5.13 版被加入.
設定是否用 Sentry 監控 Celery Beat 任務。預設值是 True.
SENTRY_PROFILES_SAMPLE_RATE¶
設定效能監控的取樣率。設為 1 會分析所有已追蹤事件（預設值），設為 0 則停用分析。
也參考
SENTRY_SEND_PII¶
允許 Sentry 收集特定的個人可辨識身分資訊。此選項預設關閉。
在 5.7 版的變更: 預設關閉，曾經預設開啟。
SENTRY_TRACES_SAMPLE_RATE¶
設定剖析監控的取樣率。設為 1 會追蹤所有事件，設為 0（預設值）則停用追蹤。
也參考
SIMPLIFY_LANGUAGES¶
對於預設語言/國家組合使用簡單語言程式碼。例如，fr_FR 翻譯將使用 fr 語言程式碼。這通常是受歡迎的特性，因為它簡化了這些預設群組合列出的語言。
如果您想為每個變體提供不同的翻譯，請停用此設定。
SITE_DOMAIN¶
設定網站網域。這對於在很多地方獲得正確的絕對連結是必要的（例如啟用電子郵件、通知或 RSS 訂閱源）。
在 Weblate 執行在非標準埠時，這裡同樣要包括它。
範例：
# Production site with domain name
SITE_DOMAIN = "weblate.example.com"
# Local development with IP address and port
SITE_DOMAIN = "127.0.0.1:8000"
備註
這個設定應該只包含網域。對於設定協議，（開啟並強制 HTTPS）使用 ENABLE_HTTPS；對於修改 URL，使用 URL_PREFIX。
提示
對於 Docker 容器，網站網域是透過 WEBLATE_ALLOWED_HOSTS 設定的。
SITE_TITLE¶
被用於網站和傳送電子郵件的網站標題。
SPECIAL_CHARS¶
要包含在螢幕鍵盤的額外字元，虛擬鍵盤。
預設值為：
SPECIAL_CHARS = ("\t", "\n", "\u00a0", "…")
SINGLE_PROJECT¶
將使用者直接重定向到專案或組件，而不是顯示操作面板。可以將其設定為 True，這樣它只在 Weblate 中確實只有單一的專案時生效。另外可以設定專案代稱，將無條件地重定向到這個專案。
範例：
SINGLE_PROJECT = "test"
SSH_EXTRA_ARGS¶
在 4.9 版被加入.
允許在 Weblate 呼叫SSH時新增自訂引數。這會在連線到使用傳統加密或其他非標準功能的伺服器時幫助巨大。
例如，當 Weblate 的 SSH 連線失敗並提示 Unable to negotiate with legacyhost: no matching key exchange method found. Their offer: diffie-hellman-group1-sha1 時，您可以用以下方式啟用：
SSH_EXTRA_ARGS = "-oKexAlgorithms=+diffie-hellman-group1-sha1"
提示
該字串由 shell 評估，因此請確保任何空格和特殊字元都用引號括起來。
警告
這是受信任、由管理員控制的設定。任意 SSH options 可變更連線路由，並覆寫 VCS_RESTRICT_PRIVATE 提供的位址繫結。管理員應對所有設定引數的安全性及相容性影響負責。
也參考
STATUS_URL¶
Weblate 事例報告其狀態的 URL。
SUPPORT_STATUS_CHECK¶
在 5.5 版被加入.
停用每半年一次的支援狀態檢查；沒有有效支援訂閱時，也不會在超級使用者登入後將其重新導向至捐款頁面。
提示
購買支援訂閱改進您的 Weblate 體驗並推進 Weblate 專案進展。
TRANSLATION_UPLOAD_MAX_SIZE¶
在 5.17.1 版被加入.
設定上傳的翻譯檔案的最大大小，單位為位元組。預設 50 MB。
在 Docker 中，使用 WEBLATE_TRANSLATION_UPLOAD_MAX_SIZE 環境變數設定這個。
UNUSED_ALERT_DAYS¶
在 4.17 版被加入.
設定何時觸發 該組件似乎從未使用 警報。
預設為 365 天，設為 0 以關閉它。
UPDATE_LANGUAGES¶
在 4.3.2 版被加入.
控制在執行資料庫移轉時是否應該更新語言資料庫，預設開啟。這個設定對 setuplang 的呼叫沒有影響。
警告
這可能會讓語言顯示不一致。Weblate 的語言定義會持續擴充，停用更新後，已定義的語言可能不會顯示語言代碼。
也參考
URL_PREFIX¶
這個設定允許在一些路徑下執行 Weblate（否則它依賴於從 web 伺服器根目錄執行）。
備註
若要使用此設定，您也必須設定伺服器移除此路徑前置字串。例如在 WSGI 中，可透過設定 WSGIScriptAlias 達成。
提示
前置字串應以 / 開頭。
範例：
URL_PREFIX = "/translations"
備註
這個設定在 Django 內建伺服器中不起作用，必須調整 urls.py 來包含這個字首。
VCS_ALLOW_HOSTS¶
在 5.15 版被加入.
設定 VCS URL 時要允許的一組主機。預設是空組，表示完全不篩選。
啟用 VCS_RESTRICT_PRIVATE 時，相符主機也豁免私有目標限制。對無法將用戶端連線繫結至 Weblate 驗證位址的 VCS 後端（如 Mercurial 與 Subversion），也需要此豁免。
VCS_ALLOW_SCHEMES¶
在 5.15 版被加入.
設定 VCS URL 時要允許的一組 URL 方案。預設只允許 https and ssh.
VCS_RESTRICT_PRIVATE¶
在 5.17 版被加入.
拒絕指向內部或非公開地址的 VCS 儲存庫 URL，除非目標主機包含在 VCS_ALLOW_HOSTS 中。預設開啟。
啟用後，將拒絕無法在驗證期間解析的主機名稱，除非在 VCS_ALLOW_HOSTS 中明確包含它們。
對透過 HTTPS 或 SSH 存取的 Git 存放庫，Weblate 會將每個 VCS command 繫結至直接連線期間通過執行階段驗證的位址。設定的 HTTP Proxies 是受信任基礎架構，改由它們解析存放庫 hostname。自動跟隨 redirects 仍停用。永久同主機 HTTP redirects 會透過相同對外路徑另行探測、驗證並儲存為標準組件存放庫 URL。跨主機 redirects 必須手動設定。除非在 VCS_ALLOW_HOSTS 明確加入目標主機，否則 Mercurial、Subversion、自訂 VCS backends 及其他 URL schemes 都會遭拒絕。
建議採用封鎖內部、loopback、link-local、保留及 cloud metadata 位址範圍的網路層 egress filtering 作為深度防禦，尤其適用於自訂整合與管理員安裝的擴充功能。
VCS_API_DELAY¶
在 4.15.1 版被加入.
在 GitHub 拉取請求、GitLab 合併請求、Gitea 拉取請求、Pagure 合併請求 和 Azure DevOps 拉取請求 中設定第三方 API 呼叫之間的最小延遲（以秒為單位）。
從 Weblate 到服務 API 呼叫速率限制可避免過載使用。
如果您正受限於 GitHub 的二級限速器，提升這個值可能會有幫助。
預設值為 10。
VCS_API_TIMEOUT¶
在 5.15 版被加入.
在 GitHub 拉取請求、GitLab 合併請求、Gitea 拉取請求、Pagure 合併請求 和 Azure DevOps 拉取請求 中設定 fork 或建立合併請求等第三方 API 呼叫的超時秒數。
預設值為 10。
VCS_BACKENDS¶
可用的版本控制系統後端的設定。
備註
Weblate offers configured backends when their required commands are available. Exact command versions are validated by the deployment and periodic configuration health checks.
提示
可以使用這個來限制選擇或新增定製版本控制系統後端。
VCS_BACKENDS = ("weblate.vcs.git.GitRepository",)
也參考
VCS_CLONE_DEPTH¶
設定 Weblate應該對儲存庫進行深度為多少的複製。
備註
目前這只在 Git 中支援。預設 Weblate 進行儲存庫的淺複製，使複製更快並節省磁碟空間。根據應用（例如當使用自訂的 附加元件 時），您可能想要增加深度，或通過設定為 0 來完全關閉淺複製。
提示
在從 Weblate 推送而得到 fatal: protocol error: expected old/new/ref, got 'shallow <commit hash>' 錯誤的情況下，通過設定來完全關閉淺複製：
VCS_CLONE_DEPTH = 0
WEBLATE_ADDONS¶
可供使用的附加元件清單。為了使用，必須為給定的翻譯組件啟用它們。預設包括了所有內建附加元件，當擴充套件清單時您可能希望保持現有的附加元件處於啟用狀態，例如：
WEBLATE_ADDONS = (
# Built-in add-ons
"weblate.addons.gettext.GenerateMoAddon",
"weblate.addons.gettext.UpdateLinguasAddon",
"weblate.addons.gettext.UpdateConfigureAddon",
"weblate.addons.gettext.MsgmergeAddon",
"weblate.addons.gettext.GettextAuthorComments",
"weblate.addons.cleanup.CleanupAddon",
"weblate.addons.consistency.LanguageConsistencyAddon",
"weblate.addons.discovery.DiscoveryAddon",
"weblate.addons.flags.SourceEditAddon",
"weblate.addons.flags.TargetEditAddon",
"weblate.addons.flags.SameEditAddon",
"weblate.addons.flags.BulkEditAddon",
"weblate.addons.generate.GenerateFileAddon",
"weblate.addons.properties.PropertiesSortAddon",
"weblate.addons.git.GitSquashAddon",
"weblate.addons.removal.RemoveComments",
"weblate.addons.removal.RemoveSuggestions",
"weblate.addons.resx.ResxUpdateAddon",
"weblate.addons.autotranslate.AutoTranslateAddon",
"weblate.addons.cdn.CDNJSAddon",
# Add-on you want to include
"weblate.addons.example.ExampleAddon",
)
備註
從清單中刪除附加元件並不能將其從組件中解除安裝。Weblate 在這種情況下會崩潰。請先從所有組件中解除安裝附加元件，然後再將其從此清單中刪除。
ADDON_ACTIVITY_LOG_EXPIRY¶
在 5.6 版被加入.
設定要保留附加元件活動記錄多長時間。預設為 180 天。
WEBLATE_EXPORTERS¶
在 4.2 版被加入.
可用的匯出工具清單，其中的工具提供多種檔案格式的翻譯下載或術語庫。
也參考
WEBLATE_FORMATS¶
可供使用的檔案格式清單。
備註
預設清單已經具有了常見格式。
也參考
WEBLATE_MACHINERY¶
在 4.13 版被加入.
可供使用的檔案格式清單。
WEBLATE_GPG_IDENTITY¶
Weblate 對 Git 提交進行簽名的身分，例如：
WEBLATE_GPG_IDENTITY = "Weblate <weblate@example.com>"
在 Weblate GPG 金鑰環中搜尋相符的金鑰（DATA_DIR 下的 home/.gnupg）。如果找不到，則會產生一個金鑰，請查閱 使用 GnuPG 為 Git 提交簽名 瞭解詳情。
WEBSITE_REQUIRED¶
定義了在建立專案時是否需要指定 專案網站。預設開啟，因為這適合公共伺服器的設定。
WEBSITE_ALERTS_ENABLED¶
在 5.17 版被加入.
預設：True
定義 Weblate 是否應檢查專案網站可用性並對無法存取的專案網站顯示警報。
當設定為 False 時，Weblate 將跳過網站可用性檢查，並且不會產生專案網站警報。這在以下情況下非常有用：
您的網站位於防火牆後面，會阻止 Weblate 的請求
您希望避免因機器人防護而導致的 403/503 型別的錯誤
專案網站的可用性並非您安裝所關注的問題
也參考
設定版本控制憑證¶
提示
此部分將 VCS 憑證描述為 GITHUB_CREDENTIALS、GITLAB_CREDENTIALS、GITEA_CREDENTIALS、PAGURE_CREDENTIALS、BITBUCKETSERVER_CREDENTIALS。
設定字典由每個 API 主機所定義的憑證組成。API 主機可能與網頁瀏覽器使用的主機不同；例如，GitHub API 的存取位址是 api.github.com。
憑證也可以在 儲存庫推送 URL 或 原始碼儲存庫 中被覆蓋（如果沒有設定 URL），這些憑證的優先順序高於設定檔案中所指定的憑證。
下列設定對每個主機可用：
usernameAPI 使用者，必填。
tokenAPI 使用者的 API 權杖，必填。
scheme在 4.18 版被加入.
方案覆蓋。Weblate 嘗試從儲存庫 URL 解析方案並退回到
https。如果您正在內部執行 API 伺服器，您也許想轉而使用http，但考慮安全性。
提示
在 Docker 容器中，可使用環境變數設定憑證，見 程式碼託管網站認證資訊。