配置備忘單
這是一份 Gitea 配置文件的備忘單。它包含了大多數可以配置的設置以及它們的默認值。
對 Gitea 配置文件的任何更改應該在 custom/conf/app.ini
或任何相應的位置進行。從發行版安裝時,通常會在 /etc/gitea/conf/app.ini
中找到。
這裡提供的默認值是最佳努力(不是自動生成的)。它們在 app.example.ini 中準確記錄(s/main/<tag|release>)。任何格式為 %(X)s
的字符串都是由 ini 提供的功能,用於遞歸讀取值。
在下面的默認值中,形式為 $XYZ
的值指的是環境變量。(但是,請參閱 environment-to-ini
。)形式為 XxYyZz
的值指的是作為默認配置一部分列出的值。這些符號形式不會在您自己的 app.ini
文件中工作,僅在此處作為文檔列出。
包含 #
或 ;
的值必須使用 `
或 """
引號。
Gitea 配置更改需要完全重啟才能生效。
默認配置(非 app.ini
配置)
這些值是環境依賴的,但構成了許多值的基礎。它們將在運行 gitea help
或啟動時作為默認配置的一部分報告。它們在那裡發出的順序略有不同,但我們將在這裡按設置順序列出它們。
AppPath
:這是運行 gitea 二進制文件的絕對路徑。AppWorkPath
:這指的是gitea
二進制文件的“工作路徑”。它是通過使用以下層次結構中的第一個設置來確定的:app.ini
中的WORK_PATH
選項- 傳遞給二進制文件的
--work-path
標誌 - 環境變量
$GITEA_WORK_DIR
- 構建時設置的內置值(請參閱從源代碼構建)
- 否則,它默認為
AppPath
的目錄 - 如果上述任何一個是相對路徑,則它們將相對於
AppPath
的目錄變為絕對路徑
CustomPath
:這是自定義模板和其他選項的基本目錄。 它是通過使用以下層次結構中的第一個設置來確定的:- 傳遞給二進制文件的
--custom-path
標誌 - 環境變量
$GITEA_CUSTOM
- 構建時設置的內置值(請參閱從源代碼構建)
- 否則,它默認為
AppWorkPath
/custom
- 如果上述任何一個是相對路徑,則它們將相對於
AppWorkPath
的目錄變為絕對路徑
- 傳遞給二進制文件的
CustomConf
:這是app.ini
文件的路徑。- 傳遞給二進制文件的
--config
標誌 - 構建時設置的內置值(請參閱從源代碼構建)
- 否則,它默認為
CustomPath
/conf/app.ini
- 如果上述任何一個是相對路徑,則它們將相對於
CustomPath
的目錄變為絕對路徑
- 傳遞給二進制文件的
此外,還有 StaticRootPath
,可以在構建時設置為內置值,但否則默認為 AppWorkPath
總體(DEFAULT
)
APP_NAME
:Gitea: Git with a cup of tea:應用程序名稱,用於頁面標題。RUN_USER
:當前操作系統用戶名/$USER
/$USERNAME
例如 git:Gitea 將以此用戶運行。 這應該是一個專用的系統(非用戶)帳戶。不正確設置此項將導致 Gitea 無法啟動。RUN_MODE
:prod:應用程序運行模式,影響性能和調試:dev
或prod
,默認為prod
。模式dev
使 Gitea 更易於開發和調試,除dev
以外的值被視為prod
,適用於生產使用。WORK_PATH
:the-work-path:工作目錄,請參閱上面的 AppWorkPath 註釋。
存儲庫(repository
)
-
ROOT
:%(APP_DATA_PATH)s/gitea-repositories:存儲所有存儲庫數據的根路徑。 相對路徑解釋為AppWorkPath
/%(ROOT)s。 -
SCRIPT_TYPE
:bash:此服務器支持的腳本類型。通常這是bash
, 但有些用戶報告只有sh
可用。 -
DETECTED_CHARSETS_ORDER
:UTF-8, UTF-16BE, UTF-16LE, UTF-32BE, UTF-32LE, ISO-8859, windows-1252, ISO-8859, windows-1250, ISO-8859, ISO-8859, ISO-8859, windows-1253, ISO-8859, windows-1255, ISO-8859, windows-1251, windows-1256, KOI8-R, ISO-8859, windows-1254, Shift_JIS, GB18030, EUC-JP, EUC-KR, Big5, ISO-2022, ISO-2022, ISO-2022, IBM424_rtl, IBM424_ltr, IBM420_rtl, IBM420_ltr:檢測到的字符集的優先順序 - 如果檢測到的字符集具有相同的置信度,則列表中較早的字符集將優先於較晚的字符集。添加defaults
將在該點放置未命名的字符集。 -
ANSI_CHARSET
:empty:默認的 ANSI 字符集,用於覆蓋非 UTF-8 字符集。 -
FORCE_PRIVATE
:false:強制每個新存儲庫為私有。 -
DEFAULT_PRIVATE
:last:創建新存儲庫時的默認私有設置。 [last, private, public] -
DEFAULT_PUSH_CREATE_PRIVATE
:true:使用推送創建時的默認私有設置。 -
MAX_CREATION_LIMIT
:-1:每個用戶的全局最大創建限制,-1
表示無限制。 -
PREFERRED_LICENSES
:Apache License 2.0,MIT License:首選許可證,放在列表頂部。名稱必須與 options/license 或 custom/options/license 中的文件名匹配。 -
DISABLE_HTTP_GIT
:false:禁用通過 HTTP 協議與存儲庫交互的功能。 -
USE_COMPAT_SSH_URI
:false:在使用默認 SSH 端口時強制使用 ssh:// 克隆 URL 而不是 scp 風格的 URI。 -
GO_GET_CLONE_URL_PROTOCOL
:https:go get
請求返回存儲庫 URL 的協議,默認為 https。 -
ACCESS_CONTROL_ALLOW_ORIGIN
:empty:Access-Control-Allow-Origin 標頭的值, 默認不顯示。注意如果您未給出正確的值,這可能對您的網站有害。
-
DEFAULT_CLOSE_ISSUES_VIA_COMMITS_IN_ANY_BRANCH
:false:如果非默認分支上的提交標記為已關閉,則關閉問題。 -
ENABLE_PUSH_CREATE_USER
:false:允許用戶將本地存儲庫推送到 Gitea 並自動為用戶創建它們。 -
ENABLE_PUSH_CREATE_ORG
:false:允許用戶將本地存儲庫推送到 Gitea 並自動為組織創建它們。 -
DISABLED_REPO_UNITS
:empty:全局禁用的存儲庫單元的逗號分隔列表。允許的值:[repo.issues, repo.ext_issues, repo.pulls, repo.wiki, repo.ext_wiki, repo.projects, repo.packages, repo.actions] -
DEFAULT_REPO_UNITS
:repo.code,repo.releases,repo.issues,repo.pulls,repo.wiki,repo.projects,repo.packages,repo.actions:默認的新存儲庫單元的逗號分隔列表。允許的值:[repo.code, repo.releases, repo.issues, repo.pulls, repo.wiki, repo.projects, repo.packages, repo.actions]。注意:目前無法停用代碼和版本。如果您指定默認存儲庫單元,您應該仍然列出它們以確保未來的兼容性。外部 wiki 和問題跟踪器無法默認啟用,因為它需要額外的設置。無論是否在默認列表中,禁用的存儲庫單元都不會添加到新存儲庫中。 -
DEFAULT_FORK_REPO_UNITS
:repo.code,repo.pulls:默認的分叉存儲庫單元的逗號分隔列表。允許的值和規則與DEFAULT_REPO_UNITS
相同。 -
DEFAULT_MIRROR_REPO_UNITS
:repo.code,repo.releases,repo.issues,repo.wiki,repo.projects,repo.packages:默認的鏡像存儲庫單元的逗號分隔列表。允許的值和規則與DEFAULT_REPO_UNITS
相同。 -
DEFAULT_TEMPLATE_REPO_UNITS
:repo.code,repo.releases,repo.issues,repo.pulls,repo.wiki,repo.projects,repo.packages:默認的模板存儲庫單元的逗號分隔列表。允許的值和規則與DEFAULT_REPO_UNITS
相同。 -
PREFIX_ARCHIVE_FILES
:true:通過將它們放在以存儲庫命名的目錄中來為存檔文件添加前綴。 -
DISABLE_MIGRATIONS
:false:禁用遷移功能。 -
DISABLE_STARS
:false:禁用星標功能。 -
DEFAULT_BRANCH
:main:所有存儲庫的默認分支名稱。 -
ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES
:false:允許非管理員用戶採用未採用的存儲庫 -
ALLOW_DELETION_OF_UNADOPTED_REPOSITORIES
:false:允許非管理員用戶刪除未採用的存儲庫 -
DISABLE_DOWNLOAD_SOURCE_ARCHIVES
:false:不允許從 UI 下載源代碼存檔文件 -
ALLOW_FORK_WITHOUT_MAXIMUM_LIMIT
:true:允許無最大數量限制的分叉存儲庫
存儲庫 - 編輯器(repository.editor
)
LINE_WRAP_EXTENSIONS
:.txt,.md,.markdown,.mdown,.mkd,.livemd,:在 Monaco 編輯器中應換行的文件擴展名列表。用逗號分隔擴展名。要換行沒有擴展名的文件,只需放置一個逗號PREVIEWABLE_FILE_MODES
:markdown:具有預覽 API 的有效文件模式,例如api/v1/markdown
。用逗號分隔值。如果文件擴展名不匹配,則不會顯示編輯模式中的預覽選項卡。
存儲庫 - 拉取請求(repository.pull-request
)
WORK_IN_PROGRESS_PREFIXES
:WIP:,[WIP]:用於拉取請求標題中標記為進行中的前綴列表。這些是大小寫不敏感的匹配。CLOSE_KEYWORDS
:close, closes, closed, fix, fixes, fixed, resolve, resolves, resolved:用於拉取請求評論中自動關閉相關問題的關鍵字列表REOPEN_KEYWORDS
:reopen, reopens, reopened:用於拉取請求評論中自動重新打開相關問題的關鍵字列表DEFAULT_MERGE_STYLE
:merge:設置存儲庫創建的默認合併樣式,有效選項:merge
,rebase
,rebase-merge
,squash
,fast-forward-only
DEFAULT_MERGE_MESSAGE_COMMITS_LIMIT
:50:在默認的合併消息中,包含最多這麼多的提交。設置為-1
以包含所有提交DEFAULT_MERGE_MESSAGE_SIZE
:5120:在默認的合併消息中,限制提交消息的大小。設置為-1
以無限制。僅在POPULATE_SQUASH_COMMENT_WITH_COMMIT_MESSAGES
為true
時使用。DEFAULT_MERGE_MESSAGE_ALL_AUTHORS
:false:在默認的合併消息中,遍歷所有提交以包含所有作者,否則僅使用有限列表中的作者DEFAULT_MERGE_MESSAGE_MAX_APPROVERS
:10:在默認的合併消息中,限制列為Reviewed-by:
的審批者數量。設置為-1
以包含所有。DEFAULT_MERGE_MESSAGE_OFFICIAL_APPROVERS_ONLY
:true:在默認的合併消息中,僅包括正式允許審查的審批者。POPULATE_SQUASH_COMMENT_WITH_COMMIT_MESSAGES
:false:在默認的壓縮合併消息中,包含組成拉取請求的所有提交的提交消息。ADD_CO_COMMITTER_TRAILERS
:true:如果提交者與作者不匹配,則在合併提交消息中添加共同作者和共同提交者的尾部。TEST_CONFLICTING_PATCHES_WITH_GIT_APPLY
:false:PR 補丁使用三方合併方法進行測試,以發現是否存在衝突。如果此設置設置為 true,則將使用git apply
重新測試衝突的補丁 - 這是 1.18(及更早版本)中的先前行為,但效率較低。如果您發現需要此設置,請報告。RETARGET_CHILDREN_ON_MERGE
:true:在合併父拉取請求時,將子拉取請求重新定位到父拉取請求分支目標。僅適用於目標相同存儲庫的合併 PR。
存儲庫 - 問題(repository.issue
)
LOCK_REASONS
:Too heated,Off-topic,Resolved,Spam:可以鎖定拉取請求或問題的原因列表MAX_PINNED
:3:每個存儲庫的最大固定問題數量。設置為 0 以禁用固定問題。
存儲庫 - 上傳(repository.upload
)
ENABLED
:true:是否啟用存儲庫文件上傳TEMP_PATH
:data/tmp/uploads:上傳的路徑(內容在 Gitea 重啟時會被刪除)ALLOWED_TYPES
:empty:允許的文件擴展名(.zip
)、MIME 類型(text/plain
)或通配符類型(image/*
、audio/*
、video/*
)的逗號分隔列表。空值或*/*
允許所有類型。FILE_MAX_SIZE
:50:每個文件的最大大小(以 MB 為單位)。MAX_FILES
:5:每次上傳的最大文件數量
存儲庫 - 發行(repository.release
)
ALLOWED_TYPES
:empty:允許的文件擴展名(.zip
)、MIME 類型(text/plain
)