Application settings API · Gitlab 中文文檔

# Application settings API > 原文：[https://docs.gitlab.com/ee/api/settings.html](https://docs.gitlab.com/ee/api/settings.html) * [Get current application settings](#get-current-application-settings) * [Change application settings](#change-application-settings) * [List of settings that can be accessed via API calls](#list-of-settings-that-can-be-accessed-via-api-calls) # Application settings API[](#application-settings-api-core-only "Permalink") 這些 API 調用使您可以閱讀和修改`/admin/application_settings/general`顯示的 GitLab 實例[應用程序設置](#list-of-settings-that-can-be-accessed-via-api-calls) . 您必須是管理員才能執行此操作. ## Get current application settings[](#get-current-application-settings "Permalink") 列出 GitLab 實例的當前[應用程序設置](#list-of-settings-that-can-be-accessed-via-api-calls) . ``` GET /application/settings ``` ``` curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/application/settings" ``` 響應示例： ``` { "default_projects_limit" : 100000, "signup_enabled" : true, "id" : 1, "default_branch_protection" : 2, "restricted_visibility_levels" : [], "password_authentication_enabled_for_web" : true, "after_sign_out_path" : null, "max_attachment_size" : 10, "max_import_size": 50, "user_oauth_applications" : true, "updated_at" : "2016-01-04T15:44:55.176Z", "session_expire_delay" : 10080, "home_page_url" : null, "default_snippet_visibility" : "private", "outbound_local_requests_whitelist": [], "domain_whitelist" : [], "domain_blacklist_enabled" : false, "domain_blacklist" : [], "created_at" : "2016-01-04T15:44:55.176Z", "default_ci_config_path" : null, "default_project_visibility" : "private", "default_group_visibility" : "private", "gravatar_enabled" : true, "sign_in_text" : null, "container_expiration_policies_enable_historic_entries": true, "container_registry_token_expire_delay": 5, "repository_storages_weighted": {"default": 100}, "plantuml_enabled": false, "plantuml_url": null, "terminal_max_session_time": 0, "polling_interval_multiplier": 1.0, "rsa_key_restriction": 0, "dsa_key_restriction": 0, "ecdsa_key_restriction": 0, "ed25519_key_restriction": 0, "first_day_of_week": 0, "enforce_terms": true, "terms": "Hello world!", "performance_bar_allowed_group_id": 42, "instance_statistics_visibility_private": false, "user_show_add_ssh_key_message": true, "local_markdown_version": 0, "allow_local_requests_from_hooks_and_services": true, "allow_local_requests_from_web_hooks_and_services": true, "allow_local_requests_from_system_hooks": false, "asset_proxy_enabled": true, "asset_proxy_url": "https://assets.example.com", "asset_proxy_whitelist": ["example.com", "*.example.com", "your-instance.com"], "npm_package_requests_forwarding": true, "snippet_size_limit": 52428800, "issues_create_limit": 300, "raw_blob_request_limit": 300, "wiki_page_max_content_bytes": 52428800 } ``` 在 GitLab 用戶[高級版或旗艦](https://about.gitlab.com/pricing/)也可以看到`file_template_project_id` ， `deletion_adjourned_period` ，或`geo_node_allowed_ips`參數： ``` { "id" : 1, "signup_enabled" : true, "file_template_project_id": 1, "geo_node_allowed_ips": "0.0.0.0/0, ::/0", "deletion_adjourned_period": 7, ... } ``` ## Change application settings[](#change-application-settings "Permalink") 使用 API??調用來修改 GitLab 實例[應用程序設置](#list-of-settings-that-can-be-accessed-via-api-calls) . ``` PUT /application/settings ``` ``` curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/application/settings?signup_enabled=false&default_project_visibility=internal" ``` 響應示例： ``` { "id": 1, "default_projects_limit": 100000, "signup_enabled": false, "password_authentication_enabled_for_web": true, "gravatar_enabled": true, "sign_in_text": "", "created_at": "2015-06-12T15:51:55.432Z", "updated_at": "2015-06-30T13:22:42.210Z", "home_page_url": "", "default_branch_protection": 2, "restricted_visibility_levels": [], "max_attachment_size": 10, "max_import_size": 50, "session_expire_delay": 10080, "default_ci_config_path" : null, "default_project_visibility": "internal", "default_snippet_visibility": "private", "default_group_visibility": "private", "outbound_local_requests_whitelist": [], "domain_whitelist": [], "domain_blacklist_enabled" : false, "domain_blacklist" : [], "external_authorization_service_enabled": true, "external_authorization_service_url": "https://authorize.me", "external_authorization_service_default_label": "default", "external_authorization_service_timeout": 0.5, "user_oauth_applications": true, "after_sign_out_path": "", "container_registry_token_expire_delay": 5, "repository_storages": ["default"], "plantuml_enabled": false, "plantuml_url": null, "terminal_max_session_time": 0, "polling_interval_multiplier": 1.0, "rsa_key_restriction": 0, "dsa_key_restriction": 0, "ecdsa_key_restriction": 0, "ed25519_key_restriction": 0, "first_day_of_week": 0, "enforce_terms": true, "terms": "Hello world!", "performance_bar_allowed_group_id": 42, "instance_statistics_visibility_private": false, "user_show_add_ssh_key_message": true, "file_template_project_id": 1, "local_markdown_version": 0, "asset_proxy_enabled": true, "asset_proxy_url": "https://assets.example.com", "asset_proxy_whitelist": ["example.com", "*.example.com", "your-instance.com"], "geo_node_allowed_ips": "0.0.0.0/0, ::/0", "allow_local_requests_from_hooks_and_services": true, "allow_local_requests_from_web_hooks_and_services": true, "allow_local_requests_from_system_hooks": false, "npm_package_requests_forwarding": true, "snippet_size_limit": 52428800, "issues_create_limit": 300, "raw_blob_request_limit": 300, "wiki_page_max_content_bytes": 52428800 } ``` 使用 GitLab [Premium 或 Ultimate 的](https://about.gitlab.com/pricing/)用戶可能還會看到以下參數： * `file_template_project_id` * `geo_node_allowed_ips` * `geo_status_timeout` * `deletion_adjourned_period` 響應示例： ``` "file_template_project_id": 1, "geo_node_allowed_ips": "0.0.0.0/0, ::/0" ``` ## List of settings that can be accessed via API calls[](#list-of-settings-that-can-be-accessed-via-api-calls "Permalink") 通常，所有設置都是可選的. 但是，如果啟用了某些設置，則需要設置其他設置才能正常運行. 這些要求在相關設置的說明中列出. | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `admin_notification_email` | string | no | 如果設置了濫用報告，它將發送到該地址. 濫用報告始終在管理區域中可用. | | `after_sign_out_path` | string | no | 注銷后將用戶重定向到的位置. | | `after_sign_up_text` | string | no | 注冊后向用戶顯示的文字 | | `akismet_api_key` | string | 要求： `akismet_enabled` | Akismet 垃圾郵件防護的 API 密鑰. | | `akismet_enabled` | boolean | no | （ **如果啟用，則要求：** `akismet_api_key` ）啟用或禁用 Akismet 垃圾郵件防護. | | `allow_group_owners_to_manage_ldap` | boolean | no | 設置為`true`以允許組所有者管理 LDAP | | `allow_local_requests_from_hooks_and_services` | boolean | no | （不建議使用：改用`allow_local_requests_from_web_hooks_and_services` ）允許從掛鉤和服務到本地網絡的請求. | | `allow_local_requests_from_system_hooks` | boolean | no | 允許從系統掛鉤向本地網絡發出請求. | | `allow_local_requests_from_web_hooks_and_services` | boolean | no | 允許從 Web 掛鉤和服務到本地網絡的請求. | | `archive_builds_in_human_readable` | string | no | 設置將作業視為過期和過期的持續時間. 一旦超過該時間，作業將被存檔，并且不再能夠重試. 將其設為空以永不過期作業. 它必須不少于 1 天，例如： `15 days` ， `1 month` ， `2 years` . | | `asset_proxy_enabled` | boolean | no | （ **如果啟用，則要求：** `asset_proxy_url` ）啟用資產代理. 需要重啟 GitLab 才能應用更改. | | `asset_proxy_secret_key` | string | no | 與資產代理服務器共享的機密. 需要重啟 GitLab 才能應用更改. | | `asset_proxy_url` | string | no | 資產代理服務器的 URL. 需要重啟 GitLab 才能應用更改. | | `asset_proxy_whitelist` | 字符串或字符串數??組 | no | 與這些域匹配的資產將不會被代理. 允許使用通配符. 您的 GitLab 安裝網址會自動列入白名單. 需要重啟 GitLab 才能應用更改. | | `authorized_keys_enabled` | boolean | no | 默認情況下，我們無需經過其他配置即可寫入`authorized_keys`文件以通過 SSH 支持 Git. 可以對 GitLab 進行優化，以通過數據庫文件對 SSH 密鑰進行身份驗證. 僅當您已將 OpenSSH 服務器配置為使用 AuthorizedKeysCommand 時，才禁用此功能. | | `auto_devops_domain` | string | no | 指定默認情況下用于每個項目的 Auto Review Apps 和 Auto Deploy 階段的域. | | `auto_devops_enabled` | boolean | no | 默認情況下，為項目啟用 Auto DevOps. 它將基于預定義的 CI / CD 配置自動構建，測試和部署應用程序. | | `check_namespace_plan` | boolean | no | 如果項目名稱空間的計劃包括該功能或項目為公共項目，則啟用此選項將僅使許可的 EE 功能可用于項目. | | `commit_email_hostname` | string | no | 自定義主機名（用于私人提交電子郵件）. | | `container_registry_token_expire_delay` | integer | no | 容器注冊表令牌持續時間（以分鐘為單位）. | | `default_artifacts_expire_in` | string | no | 設置每個作業的工件的默認到期時間. | | `default_branch_protection` | integer | no | 確定開發者是否可以掌握. 可以采用： `0` *（不受保護，開發人員和維護人員都可以推送新的提交，強制推送或刪除分支）* ， `1` *（部分受保護的開發人員和維護人員可以推送新的提交，但是不能強制推送或刪除分支）*或`2` *（受完全保護的開發人員無法推送新的提交，但維護者可以；沒有人可以強制推送或刪除分支）*作為參數. 默認值為`2` . | | `default_ci_config_path` | string | no | 新項目的默認 CI 配置路徑（如果未設置， `.gitlab-ci.yml` ）. | | `default_group_visibility` | string | no | 新群組獲得的可見度級別. 可以將`private` ， `internal`和`public`作為參數. 默認值為`private` . | | `default_project_creation` | integer | no | 默認的項目創建保護. 可以采用： `0` *（無人）* ， `1` *（維護者）*或`2` *（開發人員+維護者）* | | `default_projects_limit` | integer | no | 每個用戶的項目限制. 默認值為`100000` . | | `default_project_visibility` | string | no | 新項目獲得什么可見度級別. 可以將`private` ， `internal`和`public`作為參數. 默認值為`private` . | | `default_snippet_visibility` | string | no | 新摘要的可見性級別是多少. 可以將`private` ， `internal`和`public`作為參數. 默認值為`private` . | | `diff_max_patch_bytes` | integer | no | 最大差異補丁大小（字節）. | | `disabled_oauth_sign_in_sources` | 字符串數組 | no | 禁用的 OAuth 登錄源. | | `dns_rebinding_protection_enabled` | boolean | no | 實施 DNS 重新綁定攻擊保護. | | `domain_blacklist` | 字符串數組 | no | 電子郵件地址與這些域匹配的用戶將無法注冊. 允許使用通配符. 對多個條目使用單獨的行. 例如： `domain.com` ， `*.domain.com` . | | `domain_blacklist_enabled` | boolean | no | （ **如果啟用，則要求：** `domain_blacklist` ）允許阻止來自特定域的電子郵件的注冊. | | `domain_whitelist` | 字符串數組 | no | 強迫人們僅使用公司電子郵件進行注冊. 默認值為`null` ，表示沒有限制. | | `dsa_key_restriction` | integer | no | 上載 DSA 密鑰的最小允許位長. 默認值為`0` （無限制）. `-1`禁用 DSA 密鑰. | | `ecdsa_key_restriction` | integer | no | 上載的 ECDSA 密鑰的最小允許曲線大小（以位為單位）. 默認值為`0` （無限制）. `-1`禁用 ECDSA 密鑰. | | `ed25519_key_restriction` | integer | no | 上載的 ED25519 密鑰的最小允許曲線大小（以位為單位）. 默認值為`0` （無限制）. `-1`禁用 ED25519 鍵. | | `eks_integration_enabled` | boolean | no | 啟用與 Amazon EKS 的集成 | | `eks_account_id` | string | no | 亞馬遜帳號 | | `eks_access_key_id` | string | no | AWS IAM 訪問密鑰 ID | | `eks_secret_access_key` | string | no | AWS IAM 秘密訪問密鑰 | | `elasticsearch_aws_access_key` | string | no | AWS IAM 訪問密鑰 | | `elasticsearch_aws` | boolean | no | 啟用使用 AWS 托管的 Elasticsearch | | `elasticsearch_aws_region` | string | no | 配置 Elasticsearch 域的 AWS 區域 | | `elasticsearch_aws_secret_access_key` | string | no | AWS IAM 秘密訪問密鑰 | | `elasticsearch_indexed_field_length_limit` | integer | no | Elasticsearch 將索引的文本字段的最大大小. 0 值表示沒有限制. 這不適用于存儲庫和 Wiki 索引. | | `elasticsearch_indexing` | boolean | no | 啟用 Elasticsearch 索引 | | `elasticsearch_limit_indexing` | boolean | no | 限制 Elasticsearch 索引某些命名空間和項目 | | `elasticsearch_max_bulk_concurrency` | integer | no | 每個索引操作的 Elasticsearch 批量請求的最大并發性. 這僅適用于存儲庫索引操作. | | `elasticsearch_max_bulk_size_mb` | integer | no | Maximum size of Elasticsearch bulk indexing requests in MB. This only applies to repository indexing operations. | | `elasticsearch_namespace_ids` | 整數數組 | no | 如果啟用 elasticsearch_limit_indexing， `elasticsearch_limit_indexing`通過 Elasticsearch 進行索引的名稱空間. | | `elasticsearch_project_ids` | 整數數組 | no | 如果啟用了 elasticsearch_limit_indexing， `elasticsearch_limit_indexing`通過 Elasticsearch 進行索引的項目. | | `elasticsearch_search` | boolean | no | 啟用 Elasticsearch 搜索 | | `elasticsearch_url` | string | no | 用于連接到 Elasticsearch 的 URL. 使用逗號分隔的列表來支持集群（例如， `http://localhost:9200, http://localhost:9201"` ）.如果您的 Elasticsearch 實例受密碼保護，請在 URL 中傳遞`username:password` （例如， `http://<username>:<password>@<elastic_host>:9200/` ）. | | `email_additional_text` | string | no | 出于法律/審核/合規原因，在每封電子郵件的底部添加了其他文本 | | `email_author_in_body` | boolean | no | 某些電子郵件服務器不支持覆蓋電子郵件發件人名稱. 啟用此選項可在郵件正文中包含問題作者的名稱，合并請求或評論. | | `enabled_git_access_protocol` | string | no | 已啟用 Git 訪問協議. 允許的值為： `ssh` ， `http`和`nil`以允許兩種協議. | | `enforce_terms` | boolean | no | （ **如果啟用，則要求：** `terms` ）對所有用戶強制應用 ToS. | | `external_auth_client_cert` | string | no | （ **如果啟用，則要求：** `external_auth_client_key` ）用于與外部授權服務進行身份驗證的證書 | | `external_auth_client_key_pass` | string | no | 與外部服務進行身份驗證時用于私鑰的密碼，存儲時會加密 | | `external_auth_client_key` | string | 要求： `external_auth_client_cert` | 外部授權服務需要身份驗證時證書的私鑰，存儲時將被加密 | | `external_authorization_service_default_label` | string | 所需者： `external_authorization_service_enabled` | 請求授權時使用的默認分類標簽，并且在項目上未指定任何分類標簽 | | `external_authorization_service_enabled` | boolean | no | （ **如果啟用，則要求：** `external_authorization_service_default_label` ， `external_authorization_service_timeout`和`external_authorization_service_url` ）啟用使用外部授權服務訪問項目 | | `external_authorization_service_timeout` | float | 所需者： `external_authorization_service_enabled` | 授權請求終止后的超時時間（以秒為單位）. 當請求超時時，將拒絕用戶訪問. （最小值：0.001，最大值：10，步長：0.001） | | `external_authorization_service_url` | string | 所需者： `external_authorization_service_enabled` | 授權請求將定向到的 URL | | `file_template_project_id` | integer | no | 從中加載自定義文件模板的項目的 ID | | `first_day_of_week` | integer | no | 日歷視圖和日期選擇器的星期幾開始. 有效值為星期日（ `0` （默認），星期一（ `1` ）和星期六（ `6` . | | `geo_node_allowed_ips` | string | yes | 允許的輔助節點的 IP 和 CIDR 的逗號分隔列表. 例如`1.1.1.1, 2.2.2.0/24` . | | `geo_status_timeout` | integer | no | 請求獲取輔助節點狀態的超時時間（秒）. | | `gitaly_timeout_default` | integer | no | 默認 Gitaly 超時（以秒為單位）. 對于 Git 提取/推送操作或 Sidekiq 作業，不會強制使用此超時. 設置為`0`以禁用超時. | | `gitaly_timeout_fast` | integer | no | 快速運行超時，以秒為單位. 預計某些 Gitaly 行動會很快. 如果它們超過此閾值，則存儲碎片可能存在問題，并且"快速失敗"可以幫助維護 GitLab 實例的穩定性. 設置為`0`以禁用超時. | | `gitaly_timeout_medium` | integer | no | Gitaly 中度超時，以秒為單位. 這應該是快速超時和默認超時之間的一個值. 設置為`0`以禁用超時. | | `grafana_enabled` | boolean | no | 啟用 Grafana. | | `grafana_url` | string | no | Grafana URL. | | `gravatar_enabled` | boolean | no | 啟用 Gravatar. | | `hashed_storage_enabled` | boolean | no | 使用哈希存儲路徑創建新項目：啟用基于哈希的不可變路徑和存儲庫名稱，以將存儲庫存儲在磁盤上. 這樣可以避免在項目 URL 更改時必須移動或重命名存儲庫，并可以提高磁盤 I / O 性能. （從 13.0 開始始終啟用，在 14.0 中將刪除配置） | | `help_page_hide_commercial_content` | boolean | no | 隱藏幫助中與營銷相關的條目. | | `help_page_support_url` | string | no | 幫助頁面和幫助下拉列表的備用支持 URL. | | `help_page_text` | string | no | 幫助頁面上顯示的自定義文本. | | `help_text` | string | no | GitLab 服務器管理員信息 | | `hide_third_party_offers` | boolean | no | 不要在 GitLab 中顯示來自第三方的報價. | | `home_page_url` | string | no | 未登錄時重定向到該 URL. | | `housekeeping_bitmaps_enabled` | boolean | 要求： `housekeeping_enabled` | 啟用 Git 包文件位圖創建. | | `housekeeping_enabled` | boolean | no | （ **如果啟用，則要求：** `housekeeping_bitmaps_enabled` ， `housekeeping_full_repack_period` ， `housekeeping_gc_period`和`housekeeping_incremental_repack_period` ）.啟用或禁用 Git 整理. | | `housekeeping_full_repack_period` | integer | 要求： `housekeeping_enabled` | Git 推送的次數，之后運行增量`git repack` . | | `housekeeping_gc_period` | integer | 要求： `housekeeping_enabled` | 運行`git gc`之后的 Git 推送次數. | | `housekeeping_incremental_repack_period` | integer | 要求： `housekeeping_enabled` | Git 推送的次數，之后運行增量`git repack` . | | `html_emails_enabled` | boolean | no | 啟用 HTML 電子郵件. | | `import_sources` | 字符串數組 | no | 允許從中導入項目的來源，可能的值包括： `github` ， `bitbucket` ， `bitbucket_server` ， `gitlab` ， `google_code` ， `fogbugz` ， `git` ， `gitlab_project` ， `gitea` ， `manifest`和`phabricator` . | | `instance_statistics_visibility_private` | boolean | no | 設置為`true`實例統計信息僅對管理員可用. | | `local_markdown_version` | integer | no | 當任何緩存的 Markdown 無效時，請增加此值. | | `max_artifacts_size` | integer | no | 最大工件大小（MB） | | `max_attachment_size` | integer | no | 限制附件大小（MB） | | `max_import_size` | integer | no | 最大導入大小（MB）. 0 代表無限. 默認值= 50 | | `max_pages_size` | integer | no | 頁面存儲庫的最大大小（MB） | | `max_personal_access_token_lifetime` | integer | no | 個人訪問令牌的最大允許壽命（天） | | `metrics_method_call_threshold` | integer | no | 僅當方法調用花費的時間超過給定的毫秒數時，才會跟蹤該方法調用. | | `mirror_available` | boolean | no | 允許存儲庫鏡像由項目維護者配置. 如果禁用，則只有管理員可以配置存儲庫鏡像. | | `mirror_capacity_threshold` | integer | no | 搶先計劃更多鏡像之前需要提供的最小容量 | | `mirror_max_capacity` | integer | no | 可以同時同步的最大鏡像數. | | `mirror_max_delay` | integer | no | 計劃進行同步時，鏡像可以具有的兩次更新之間的最長時間（以分鐘為單位）. | | `npm_package_requests_forwarding` | boolean | no | 在 GitLab NPM 注冊表中找不到軟件包時，請使用 npmjs.org 作為默認的遠程存儲庫 | | `maintenance_mode` | boolean | no | 實例處于維護模式時，非管理員用戶可以使用只讀訪問權限登錄并發出只讀 API 請求 | | `maintenance_mode_message` | string | no | 實例處于維護模式時顯示的消息 | | `outbound_local_requests_whitelist` | 字符串數組 | no | 定義在禁用對鉤子和服務的本地請求時允許對本地請求的信任域或 ip 地址的列表. | | `pages_domain_verification_enabled` | boolean | no | 要求用戶證明自定義域的所有權. 域驗證是公共 GitLab 站點必不可少的安全措施. 在啟用域之前，要求用戶證明他們控制著域. | | `password_authentication_enabled_for_git` | boolean | no | 通過 GitLab 帳戶密碼啟用基于 HTTP（S）的 Git 身份驗證. 默認值為`true` . | | `password_authentication_enabled_for_web` | boolean | no | 通過 GitLab 帳戶密碼啟用 Web 界面的身份驗證. 默認值為`true` . | | `performance_bar_allowed_group_id` | string | no | （不建議使用：改用`performance_bar_allowed_group_path` ）允許切換性能欄的組的路徑. | | `performance_bar_allowed_group_path` | string | no | Path of the group that is allowed to toggle the performance bar. | | `performance_bar_enabled` | boolean | no | （不建議使用：傳遞`performance_bar_allowed_group_path: nil`代替）允許啟用性能欄. | | `plantuml_enabled` | boolean | no | （ **如果啟用，則要求：** `plantuml_url` ）啟用 PlantUML 集成. 默認值為`false` . | | `plantuml_url` | string | 要求： `plantuml_enabled` | 用于集成的 PlantUML 實例 URL. | | `polling_interval_multiplier` | decimal | no | Interval multiplier used by endpoints that perform polling. Set to `0` to disable polling. | | `deletion_adjourned_period` | integer | no | 刪除標記為刪除的項目或組之前要等待的天數. 值必須介于 0 到 90 之間. | | `project_export_enabled` | boolean | no | 啟用項目導出. | | `prometheus_metrics_enabled` | boolean | no | 啟用 Prometheus 指標. | | `protected_ci_variables` | boolean | no | 默認情況下，環境變量受保護. | | `pseudonymizer_enabled` | boolean | no | 啟用后，GitLab 將運行一個后臺作業，該作業將生成 GitLab 數據庫的假名化 CSV，并將其上傳到您配置的對象存儲目錄中. | | `push_event_hooks_limit` | integer | no | 一次按下更改（分支或標簽）的次數，以確定是否將觸發 Webhook 和服務. 如果超過該值，則不會提交 Webhooks 和服務. | | `push_event_activities_limit` | integer | no | 一次推送中更改（分支或標簽）的數量，以確定將創建單個推送事件還是批量推送事件. [如果批量推送事件](../user/admin_area/settings/push_event_activities_limit.html)超過該值， [則會創建](../user/admin_area/settings/push_event_activities_limit.html)該[事件](../user/admin_area/settings/push_event_activities_limit.html) . | | `recaptcha_enabled` | boolean | no | （ **如果啟用，則要求：** `recaptcha_private_key`和`recaptcha_site_key` ）啟用 reCAPTCHA. | | `recaptcha_private_key` | string | 要求： `recaptcha_enabled` | reCAPTCHA 的私鑰. | | `recaptcha_site_key` | string | 要求： `recaptcha_enabled` | reCAPTCHA 的站點密鑰. | | `receive_max_input_size` | integer | no | 最大推送大小（MB）. | | `repository_checks_enabled` | boolean | no | GitLab 將在所有項目和 Wiki 存儲庫中定期運行`git fsck` ，以查找靜默磁盤損壞問題. | | `repository_size_limit` | integer | no | 每個存儲庫的大小限制（MB） | | `repository_storages` | 字符串數組 | no | （GitLab 13.0 和更早版本）已啟用的存儲路徑的名稱列表，取自`gitlab.yml` . 在這些商店之一中創建新項目，這些項目是隨機選擇的. | | `repository_storages_weighted` | 字符串哈希到整數 | no | （GitLab 13.1 和更高版本）從`gitlab.yml`到權重的名稱的哈希值. 在這些存儲庫之一中創建新項目，并通過加權隨機選擇進行選擇. | | `require_two_factor_authentication` | boolean | no | （ **如果啟用，則要求：** `two_factor_grace_period` ）要求所有用戶設置兩因素身份驗證. | | `restricted_visibility_levels` | 字符串數組 | no | 非管理員用戶不能將所選級別用于組，項目或摘要. 可以將`private` ， `internal`和`public`作為參數. 默認值為`null` ，表示沒有限制. | | `rsa_key_restriction` | integer | no | 上載 RSA 密鑰的最小允許比特長度. 默認值為`0` （無限制）. `-1`禁用 RSA 密鑰. | | `send_user_confirmation_email` | boolean | no | 在注冊時發送確認電子郵件. | | `session_expire_delay` | integer | no | 會話持續時間（以分鐘為單位）. 需要重啟 GitLab 才能應用更改 | | `shared_runners_enabled` | boolean | no | （ **如果啟用，則要求：** `shared_runners_text`和`shared_runners_minutes` ）為新項目啟用共享運行器. | | `shared_runners_minutes` | integer | 所需者： `shared_runners_enabled` | 設置組每月可以在共享運行者上使用的最大管道分鐘數. | | `shared_runners_text` | string | 所需者： `shared_runners_enabled` | 共享跑步者文字. | | `signin_enabled` | string | no | （不建議使用：改為使用`password_authentication_enabled_for_web` ）該標志指示是否為 Web 界面啟用了密碼認證. | | `sign_in_text` | string | no | 登錄頁面上的文本. | | `signup_enabled` | boolean | no | 啟用注冊. 默認值為`true` . | | `slack_app_enabled` | boolean | no | （ **如果啟用，則要求：** `slack_app_id` ， `slack_app_secret`和`slack_app_secret` ）啟用 Slack 應用. | | `slack_app_id` | string | 所需者： `slack_app_enabled` | The app ID of the Slack-app. | | `slack_app_secret` | string | 所需者： `slack_app_enabled` | Slack-app 的應用程序秘訣. | | `slack_app_verification_token` | string | 所需者： `slack_app_enabled` | Slack-app 的驗證令牌. | | `snowplow_collector_hostname` | string | 所需者： `snowplow_enabled` | 掃雪機收集器主機名. （例如， `snowplow.trx.gitlab.net` ） | | `snowplow_cookie_domain` | string | no | Snowplow cookie 域. （例如， `.gitlab.com` ） | | `snowplow_enabled` | boolean | no | 啟用掃雪機跟蹤. | | `snowplow_app_id` | string | no | Snowplow 站點名稱/應用程序 ID. （例如`gitlab` ） | | `snowplow_iglu_registry_url` | string | no | Snowplow 基本 Iglu Schema 注冊表 URL，用于自定義上下文和自我描述事件' | | `sourcegraph_enabled` | boolean | no | 啟用 S??ourcegraph 集成. 默認值為`false` . **如果啟用，則需要** `sourcegraph_url` . | | `sourcegraph_url` | string | 要求： `sourcegraph_enabled` | 用于集成的 Sourcegraph 實例 URL. | | `sourcegraph_public_only` | boolean | no | 阻止將 Sourcegraph 加載到私有和內部項目中. 默認值為`true` . | | `spam_check_endpoint_enabled` | boolean | no | 通過外部 API 端點啟用垃圾郵件檢查. 默認值為`false` . | | `spam_check_endpoint_url` | string | no | 外部垃圾郵件檢查服務端點的 URL. | | `terminal_max_session_time` | integer | no | Web 終端 websocket 連接的最長時間（以秒為單位）. 設置為`0`表示無限時間. | | `terms` | text | 要求： `enforce_terms` | （ **要求：** `enforce_terms` ）ToS 的降價內容. | | `throttle_authenticated_api_enabled` | boolean | no | （ **如果啟用，則要求：** `throttle_authenticated_api_period_in_seconds`和`throttle_authenticated_api_requests_per_period` ）啟用經過身份驗證的 API 請求速率限制. 幫助減少請求量（例如，來自爬蟲或惡意機器人的請求量）. | | `throttle_authenticated_api_period_in_seconds` | integer | 所需者： `throttle_authenticated_api_enabled` _ 已驗證`throttle_authenticated_api_enabled` | 限速時間（秒）. | | `throttle_authenticated_api_requests_per_period` | integer | 所需者： `throttle_authenticated_api_enabled` _ 已驗證`throttle_authenticated_api_enabled` | 每個用戶每個時段的最大請求數. | | `throttle_authenticated_web_enabled` | boolean | no | （ **如果啟用，則要求：** `throttle_authenticated_web_period_in_seconds`和`throttle_authenticated_web_requests_per_period` ）啟用經過身份驗證的 Web 請求速率限制. 幫助減少請求量（例如，來自爬蟲或惡意機器人的請求量）. | | `throttle_authenticated_web_period_in_seconds` | integer | 所需者： `throttle_authenticated_web_enabled` _ 已驗證網絡 _ 已`throttle_authenticated_web_enabled` | 限速時間（秒）. | | `throttle_authenticated_web_requests_per_period` | integer | 所需者： `throttle_authenticated_web_enabled` _ 已驗證網絡 _ 已`throttle_authenticated_web_enabled` | 每個用戶每個時段的最大請求數. | | `throttle_unauthenticated_enabled` | boolean | no | （ **如果啟用，則要求：** `throttle_unauthenticated_period_in_seconds`和`throttle_unauthenticated_requests_per_period` ）啟用未認證的請求速率限制. 幫助減少請求量（例如，來自爬蟲或惡意機器人的請求量）. | | `throttle_unauthenticated_period_in_seconds` | integer | 所需者： `throttle_unauthenticated_enabled` _ 未`throttle_unauthenticated_enabled`的 _ `throttle_unauthenticated_enabled` | 限速時間（秒）. | | `throttle_unauthenticated_requests_per_period` | integer | required by: `throttle_unauthenticated_enabled` | 每個 IP 的每個周期的最大請求數. | | `time_tracking_limit_to_hours` | boolean | no | 將時間跟蹤單位的顯示限制為小時. 默認值為`false` . | | `two_factor_grace_period` | integer | 要求者： `require_two_factor_authentication` | 允許用戶跳過兩因素身份驗證的強制配置的時間（以小時為單位）. | | `unique_ips_limit_enabled` | boolean | no | （ **如果啟用，則要求：** `unique_ips_limit_per_user`和`unique_ips_limit_time_window` ）限制從多個`unique_ips_limit_time_window`登錄. | | `unique_ips_limit_per_user` | integer | 所需者： `unique_ips_limit_enabled` | 每個用戶的最大 IP 數. | | `unique_ips_limit_time_window` | integer | 所需者： `unique_ips_limit_enabled` | IP 將計入限制多少秒. | | `usage_ping_enabled` | boolean | no | GitLab 每周都會向 GitLab，Inc.報告許可證使用情況. | | `user_default_external` | boolean | no | 默認情況下，新注冊的用戶將是外部用戶. | | `user_default_internal_regex` | string | no | 指定電子郵件地址正則表達式模式以標識默認的內部用戶. | | `user_oauth_applications` | boolean | no | 允許用戶注冊任何應用程序以將 GitLab 用作 OAuth 提供程序. | | `user_show_add_ssh_key_message` | boolean | no | 設置為`false`時，向沒有上載 SSH 密鑰的用戶顯示"您將無法通過 SSH 推送或推送項目代碼"警告. | | `version_check_enabled` | boolean | no | 讓 GitLab 在更新可用時通知您. | | `web_ide_clientside_preview_enabled` | boolean | no | 實時預覽（允許使用 CodeSandbox 實時預覽在 Web IDE 中對 JavaScript 項目進行實時預覽）. | | `snippet_size_limit` | integer | no | 摘錄內容的最大大小（以**字節為單位）** . 默認值：52428800 字節（50MB）. | | `issues_create_limit` | integer | no | 每位用戶每分鐘每分鐘最多可創建問題的請求數. 默認值：300.要禁用限制，請將其設置為 0. | | `raw_blob_request_limit` | integer | no | 每條原始路徑每分鐘的最大請求數. 默認值：300.要禁用限制，請將其設置為 0. | | `wiki_page_max_content_bytes` | integer | no | Wiki 頁面的最大內容大小（以**字節為單位）** . 默認值：52428800 字節（50MB）. |