gitea/gitea-docs
1
0
Fork 0
mirror of https://gitea.com/gitea/docs.git synced 2026-07-22 11:17:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update zh tw languages and fix some broken links (#455)

Browse Source 
---------

Co-authored-by: silverwind <me@silverwind.io>
Co-authored-by: silverwind <2021+silverwind@noreply.gitea.com>
Reviewed-on: https://gitea.com/gitea/docs/pulls/455
Reviewed-by: silverwind <2021+silverwind@noreply.gitea.com>
This commit is contained in:
Lunny Xiao
2026-07-09 23:41:46 +00:00
parent c0f8a04185
commit 965c269495
652 changed files with 30864 additions and 30792 deletions
Download Patch File Download Diff File Expand all files Collapse all files

724
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.26/administration/command-line.md
View File

@@ -11,523 +11,523 @@ aliases:
## 用法
`gitea [全局选项] 命令 [命令或全局选项] [参数...]`
`gitea [全域選項] 命令 [命令或全域選項] [參數...]`
## 全局选项
## 全域選項
所有全局选项均可被放置在命令级别。
所有全域選項均可被放置在命令級別。
- `--help`，`-h`：显示帮助文本并退出。可选。
- `--version`，`-v`：显示版本信息并退出。可选。 (示例：`Gitea version 1.1.0+218-g7b907ed built with: bindata, sqlite`)。
- `--custom-path path`，`-C path`：Gitea 自定义文件夹的路径。可选。 (默认值：`AppWorkPath`/custom 或 `$GITEA_CUSTOM`)。
- `--config path`，`-c path`：Gitea 配置文件的路径。可选。 (默认值：`custom`/conf/app.ini)。
- `--work-path path`，`-w path`：Gitea 的 `AppWorkPath`。可选。 (默认值：LOCATION_OF_GITEA_BINARY 或 `$GITEA_WORK_DIR`)
- `--help`，`-h`：顯示幫助文本並退出。可選。
- `--version`，`-v`：顯示版本資訊並退出。可選。 (範例：`Gitea version 1.1.0+218-g7b907ed built with: bindata, sqlite`)。
- `--custom-path path`，`-C path`：Gitea 自訂文件夾的路徑。可選。 (預設值：`AppWorkPath`/custom 或 `$GITEA_CUSTOM`)。
- `--config path`，`-c path`：Gitea 設定文件的路徑。可選。 (預設值：`custom`/conf/app.ini)。
- `--work-path path`，`-w path`：Gitea 的 `AppWorkPath`。可選。 (預設值：LOCATION_OF_GITEA_BINARY 或 `$GITEA_WORK_DIR`)
注意：默认的 custom-path、config 和 work-path 也可以在构建时更改（如果需要）。
注意：預設的 custom-path、config 和 work-path 也可以在構建時更改（如果需要）。
## 命令
### web
启动服务器：
啟動伺服器：
- 选项：
- `--port number`，`-p number`：端口号。可选。 (默认值：3000)。覆盖配置文件中的设置。
- `--install-port number`：运行安装页面的端口号。可选。 (默认值：3000)。覆盖配置文件中的设置。
- `--pid path`，`-P path`：Pid 文件的路径。可选。
- `--quiet`，`-q`：只在控制台上输出 Fatal 日志，用于在设置日志之前发出的日志。
- `--verbose`：在控制台上输出跟踪日志，用于在设置日志之前发出的日志。
- 示例：
- 選項：
- `--port number`，`-p number`：端口號。可選。 (預設值：3000)。覆蓋設定文件中的設定。
- `--install-port number`：運行安裝頁面的端口號。可選。 (預設值：3000)。覆蓋設定文件中的設定。
- `--pid path`，`-P path`：Pid 文件的路徑。可選。
- `--quiet`，`-q`：只在控制檯上輸出 Fatal 日誌，用於在設定日誌之前發出的日誌。
- `--verbose`：在控制檯上輸出跟蹤日誌，用於在設定日誌之前發出的日誌。
- 範例：
- `gitea web`
- `gitea web --port 80`
- `gitea web --config /etc/gitea.ini --pid /some/custom/gitea.pid`
- 注意：
- Gitea 不应以 root 用户身份运行。要绑定到低于 1024 的端口，您可以在 Linux 上使用 setcap 命令：`sudo setcap 'cap_net_bind_service=+ep' /path/to/gitea`。每次更新 Gitea 都需要重新执行此操作。
- Gitea 不應以 root 使用者身份運行。要綁定到低於 1024 的端口，您可以在 Linux 上使用 setcap 命令：`sudo setcap 'cap_net_bind_service=+ep' /path/to/gitea`。每次更新 Gitea 都需要重新執行此操作。
### admin
管理员操作：
管理員操作：
- 命令：
- `user`：
- `list`：
- 选项：
- `--admin`：仅列出管理员用户。可选。
- 描述：列出所有现有用户。
- 示例：
- 選項：
- `--admin`：僅列出管理員使用者。可選。
- 描述：列出所有現有使用者。
- 範例：
- `gitea admin user list`
- `delete`：
- 选项：
- `--email`：要删除的用户的电子邮件。
- `--username`：要删除的用户的用户名。
- `--id`：要删除的用户的 ID。
- 必须提供 `--id`、`--username` 或 `--email` 中的一个。如果提供多个，则所有条件必须匹配。
- 示例：
- 選項：
- `--email`：要刪除的使用者的電子郵件。
- `--username`：要刪除的使用者的使用者名稱。
- `--id`：要刪除的使用者的 ID。
- 必須提供 `--id`、`--username` 或 `--email` 中的一個。如果提供多個，則所有條件必須匹配。
- 範例：
- `gitea admin user delete --id 1`
- `create`：
- 选项：
- `--name value`：用户名。必填。自 Gitea 1.9.0 版本起，请改用 `--username` 标志。
- `--username value`：用户名。必填。Gitea 1.9.0 新增。
- `--password value`：密码。必填。
- `--email value`：邮箱。必填。
- `--admin`：如果提供此选项，将创建一个管理员用户。可选。
- `--access-token`：如果提供，将为用户创建访问令牌。可选。（默认值：false）。
- `--must-change-password`：如果提供，创建的用户将在初始登录后需要选择一个新密码。可选。（默认值：true）。
- `--random-password`：如果提供，将使用随机生成的密码作为创建用户的密码。`--password` 的值将被忽略。可选。
- `--random-password-length`：如果提供，将用于配置随机生成密码的长度。可选。（默认值：12）
- 示例：
- 選項：
- `--name value`：使用者名稱。必填。自 Gitea 1.9.0 版本起，請改用 `--username` 標誌。
- `--username value`：使用者名稱。必填。Gitea 1.9.0 新增。
- `--password value`：密碼。必填。
- `--email value`：郵箱。必填。
- `--admin`：如果提供此選項，將建立一個管理員使用者。可選。
- `--access-token`：如果提供，將為使用者建立存取權杖。可選。（預設值：false）。
- `--must-change-password`：如果提供，建立的使用者將在初始登入後需要選擇一個新密碼。可選。（預設值：true）。
- `--random-password`：如果提供，將使用隨機生成的密碼作為建立使用者的密碼。`--password` 的值將被忽略。可選。
- `--random-password-length`：如果提供，將用於設定隨機生成密碼的長度。可選。（預設值：12）
- 範例：
- `gitea admin user create --username myname --password asecurepassword --email me@example.com`
- `change-password`：
- 选项：
- `--username value`，`-u value`：用户名。必填。
- `--password value`，`-p value`：新密码。必填。
- 示例：
- 選項：
- `--username value`，`-u value`：使用者名稱。必填。
- `--password value`，`-p value`：新密碼。必填。
- 範例：
- `gitea admin user change-password --username myname --password asecurepassword`
- `must-change-password`：
- 参数：
- `[username...]`：需要更改密码的用户
- 选项：
- `--all`，`-A`：强制所有用户更改密码
- `--exclude username`，`-e username`：排除给定的用户。可以多次设置。
- `--unset`：撤销对给定用户的强制密码更改
- 參數：
- `[username...]`：需要更改密碼的使用者
- 選項：
- `--all`，`-A`：強制所有使用者更改密碼
- `--exclude username`，`-e username`：排除給定的使用者。可以多次設定。
- `--unset`：撤銷對給定使用者的強制密碼更改
- `regenerate`：
- 选项：
- `hooks`：重新生成所有仓库的 Git Hooks。
- 選項：
- `hooks`：重新生成所有儲存庫的 Git Hooks。
- `keys`：重新生成 authorized_keys 文件。
- 示例：
- 範例：
- `gitea admin regenerate hooks`
- `gitea admin regenerate keys`
- `auth`：
- `list`：
- 描述：列出所有存在的外部认证源。
- 示例：
- 描述：列出所有存在的外部認證源。
- 範例：
- `gitea admin auth list`
- `delete`：
- 选项：
- `--id`：要删除的源的 ID。必填。
- 示例：
- 選項：
- `--id`：要刪除的源的 ID。必填。
- 範例：
- `gitea admin auth delete --id 1`
- `add-oauth`：
- 选项：
- `--name`：应用程序名称。
- 選項：
- `--name`：應用程式名稱。
- `--provider`：OAuth2 提供者。
- `--key`：客户端 ID（Key）。
- `--secret`：客户端密钥。
- `--auto-discover-url`：OpenID Connect 自动发现 URL（仅在使用 OpenID Connect 作为提供程序时需要）。
- `--use-custom-urls`：在 GitLab/GitHub OAuth 端点上使用自定义 URL。
- `--custom-tenant-id`：在 OAuth 端点上使用自定义租户 ID。
- `--custom-auth-url`：使用自定义授权 URL（GitLab/GitHub 的选项）。
- `--custom-token-url`：使用自定义令牌 URL（GitLab/GitHub 的选项）。
- `--custom-profile-url`：使用自定义配置文件 URL（GitLab/GitHub 的选项）。
- `--custom-email-url`：使用自定义电子邮件 URL（GitHub 的选项）。
- `--icon-url`：OAuth2 登录源的自定义图标 URL。
- `--skip-local-2fa`：允许源覆盖本地 2FA。（可选）
- `--scopes`：请求此 OAuth2 源的附加范围。（可选）
- `--required-claim-name`：必须设置的声明名称，以允许用户使用此源登录。（可选）
- `--required-claim-value`：必须设置的声明值，以允许用户使用此源登录。（可选）
- `--group-claim-name`：提供此源的组名的声明名称。（可选）
- `--admin-group`：管理员用户的组声明值。（可选）
- `--restricted-group`：受限用户的组声明值。（可选）
- `--group-team-map`：组与组织团队之间的 JSON 映射。（可选）
- `--group-team-map-removal`：根据组自动激活团队成员资格的删除。（可选）
- 示例：
- `--key`：客戶端 ID（Key）。
- `--secret`：客戶端密鑰。
- `--auto-discover-url`：OpenID Connect 自動發現 URL（僅在使用 OpenID Connect 作為提供程式時需要）。
- `--use-custom-urls`：在 GitLab/GitHub OAuth 端點上使用自訂 URL。
- `--custom-tenant-id`：在 OAuth 端點上使用自訂租戶 ID。
- `--custom-auth-url`：使用自訂授權 URL（GitLab/GitHub 的選項）。
- `--custom-token-url`：使用自訂令牌 URL（GitLab/GitHub 的選項）。
- `--custom-profile-url`：使用自訂設定文件 URL（GitLab/GitHub 的選項）。
- `--custom-email-url`：使用自訂電子郵件 URL（GitHub 的選項）。
- `--icon-url`：OAuth2 登入源的自訂圖標 URL。
- `--skip-local-2fa`：允許源覆蓋本地 2FA。（可選）
- `--scopes`：請求此 OAuth2 源的附加範圍。（可選）
- `--required-claim-name`：必須設定的聲明名稱，以允許使用者使用此源登入。（可選）
- `--required-claim-value`：必須設定的聲明值，以允許使用者使用此源登入。（可選）
- `--group-claim-name`：提供此源的組名的聲明名稱。（可選）
- `--admin-group`：管理員使用者的組聲明值。（可選）
- `--restricted-group`：受限使用者的組聲明值。（可選）
- `--group-team-map`：組與組織團隊之間的 JSON 映射。（可選）
- `--group-team-map-removal`：根據組自動激活團隊成員資格的刪除。（可選）
- 範例：
- `gitea admin auth add-oauth --name external-github --provider github --key OBTAIN_FROM_SOURCE --secret OBTAIN_FROM_SOURCE`
- `update-oauth`：
- 选项：
- 選項：
- `--id`：要更新的源的 ID。必填。
- `--name`：应用程序名称。
- `--name`：應用程式名稱。
- `--provider`：OAuth2 提供者。
- `--key`：客户端 ID（Key）。
- `--secret`：客户端密钥。
- `--auto-discover-url`：OpenID Connect 自动发现 URL（仅在使用 OpenID Connect 作为提供程序时需要）。
- `--use-custom-urls`：在 GitLab/GitHub OAuth 端点上使用自定义 URL。
- `--custom-tenant-id`：在 OAuth 端点上使用自定义租户 ID。
- `--custom-auth-url`：使用自定义授权 URL（GitLab/GitHub 的选项）。
- `--custom-token-url`：使用自定义令牌 URL（GitLab/GitHub 的选项）。
- `--custom-profile-url`：使用自定义配置文件 URL（GitLab/GitHub 的选项）。
- `--custom-email-url`：使用自定义电子邮件 URL（GitHub 的选项）。
- `--icon-url`：OAuth2 登录源的自定义图标 URL。
- `--skip-local-2fa`：允许源覆盖本地 2FA。（可选）
- `--scopes`：请求此 OAuth2 源的附加范围。
- `--required-claim-name`：必须设置的声明名称，以允许用户使用此源登录。（可选）
- `--required-claim-value`：必须设置的声明值，以允许用户使用此源登录。（可选）
- `--group-claim-name`：提供此源的组名的声明名称。（可选）
- `--admin-group`：管理员用户的组声明值。（可选）
- `--restricted-group`：受限用户的组声明值。（可选）
- 示例：
- `--key`：客戶端 ID（Key）。
- `--secret`：客戶端密鑰。
- `--auto-discover-url`：OpenID Connect 自動發現 URL（僅在使用 OpenID Connect 作為提供程式時需要）。
- `--use-custom-urls`：在 GitLab/GitHub OAuth 端點上使用自訂 URL。
- `--custom-tenant-id`：在 OAuth 端點上使用自訂租戶 ID。
- `--custom-auth-url`：使用自訂授權 URL（GitLab/GitHub 的選項）。
- `--custom-token-url`：使用自訂令牌 URL（GitLab/GitHub 的選項）。
- `--custom-profile-url`：使用自訂設定文件 URL（GitLab/GitHub 的選項）。
- `--custom-email-url`：使用自訂電子郵件 URL（GitHub 的選項）。
- `--icon-url`：OAuth2 登入源的自訂圖標 URL。
- `--skip-local-2fa`：允許源覆蓋本地 2FA。（可選）
- `--scopes`：請求此 OAuth2 源的附加範圍。
- `--required-claim-name`：必須設定的聲明名稱，以允許使用者使用此源登入。（可選）
- `--required-claim-value`：必須設定的聲明值，以允許使用者使用此源登入。（可選）
- `--group-claim-name`：提供此源的組名的聲明名稱。（可選）
- `--admin-group`：管理員使用者的組聲明值。（可選）
- `--restricted-group`：受限使用者的組聲明值。（可選）
- 範例：
- `gitea admin auth update-oauth --id 1 --name external-github-updated`
- `add-smtp`：
- 选项：
- `--name`：应用程序名称。必填。
- `--auth-type`：SMTP 认证类型（PLAIN/LOGIN/CRAM-MD5）。默认为 PLAIN。
- `--host`：SMTP 主机。必填。
- 選項：
- `--name`：應用程式名稱。必填。
- `--auth-type`：SMTP 認證類型（PLAIN/LOGIN/CRAM-MD5）。預設為 PLAIN。
- `--host`：SMTP 主機。必填。
- `--port`：SMTP 端口。必填。
- `--force-smtps`：SMTPS 始终在端口 465 上使用。设置此选项以强制在其他端口上使用 SMTPS。
- `--skip-verify`：跳过 TLS 验证。
- `--helo-hostname`：发送 HELO 时使用的主机名。留空以发送当前主机名。
- `--force-smtps`：SMTPS 始終在端口 465 上使用。設定此選項以強制在其他端口上使用 SMTPS。
- `--skip-verify`：跳過 TLS 驗證。
- `--helo-hostname`：發送 HELO 時使用的主機名。留空以發送當前主機名。
- `--disable-helo`：禁用 SMTP helo。
- `--allowed-domains`：留空以允许所有域。使用逗号（','）分隔多个域。
- `--skip-local-2fa`：跳过 2FA 登录。
- `--active`：启用此认证源。
备注：
`--force-smtps`、`--skip-verify`、`--disable-helo`、`--skip-local-2fs` 和 `--active` 选项可以采用以下形式使用：
- `--option`、`--option=true` 以启用选项
- `--option=false` 以禁用选项
如果未指定这些选项，则在 `update-smtp` 中不会更改值，或者在 `add-smtp` 中将使用默认的 `false` 值。
- 示例：
- `--allowed-domains`：留空以允許所有域。使用逗號（','）分隔多個域。
- `--skip-local-2fa`：跳過 2FA 登入。
- `--active`：啟用此認證源。
備註：
`--force-smtps`、`--skip-verify`、`--disable-helo`、`--skip-local-2fs` 和 `--active` 選項可以採用以下形式使用：
- `--option`、`--option=true` 以啟用選項
- `--option=false` 以禁用選項
如果未指定這些選項，則在 `update-smtp` 中不會更改值，或者在 `add-smtp` 中將使用預設的 `false` 值。
- 範例：
- `gitea admin auth add-smtp --name ldap --host smtp.mydomain.org --port 587 --skip-verify --active`
- `update-smtp`：
- 选项：
- 選項：
- `--id`：要更新的源的 ID。必填。
- 其他选项与 `add-smtp` 共享
- 示例：
- 其他選項與 `add-smtp` 共享
- 範例：
- `gitea admin auth update-smtp --id 1 --host smtp.mydomain.org --port 587 --skip-verify=false`
- `gitea admin auth update-smtp --id 1 --active=false`
- `add-ldap`：添加新的 LDAP（通过 Bind DN）认证源
- 选项：
- `--name value`：认证名称。必填。
- `--not-active`：停用认证源。
- `--security-protocol value`：安全协议名称。必填。
- `--skip-tls-verify`：禁用 TLS 验证。
- `--host value`：LDAP 服务器的地址。必填。
- `--port value`：连接到 LDAP 服务器时使用的端口。必填。
- `--user-search-base value`：用户帐户将在其中搜索的 LDAP 基础路径。必填。
- `--user-filter value`：声明如何查找试图进行身份验证的用户记录的 LDAP 过滤器。必填。
- `--admin-filter value`：指定是否应授予用户管理员特权的 LDAP 过滤器。
- `--restricted-filter value`：指定是否应将用户设置为受限状态的 LDAP 过滤器。
- `--username-attribute value`：用户 LDAP 记录中包含用户名的属性。
- `--firstname-attribute value`：用户 LDAP 记录中包含用户名字的属性。
- `--surname-attribute value`：用户 LDAP 记录中包含用户姓氏的属性。
- `--email-attribute value`：用户 LDAP 记录中包含用户电子邮件地址的属性。必填。
- `--public-ssh-key-attribute value`：用户 LDAP 记录中包含用户公共 SSH 密钥的属性。
- `--avatar-attribute value`：用户 LDAP 记录中包含用户头像的属性。
- `--bind-dn value`：在搜索用户时绑定到 LDAP 服务器的 DN。
- `--bind-password value`：绑定 DN 的密码（如果有）。
- `--attributes-in-bind`：在绑定 DN 上下文中获取属性。
- `--synchronize-users`：启用用户同步。
- `--page-size value`：搜索页面大小。
- 示例：
- `add-ldap`：添加新的 LDAP（通過 Bind DN）認證源
- 選項：
- `--name value`：認證名稱。必填。
- `--not-active`：停用認證源。
- `--security-protocol value`：安全協議名稱。必填。
- `--skip-tls-verify`：禁用 TLS 驗證。
- `--host value`：LDAP 伺服器的地址。必填。
- `--port value`：連接到 LDAP 伺服器時使用的端口。必填。
- `--user-search-base value`：使用者帳戶將在其中搜索的 LDAP 基礎路徑。必填。
- `--user-filter value`：聲明如何查找試圖進行身份驗證的使用者記錄的 LDAP 過濾器。必填。
- `--admin-filter value`：指定是否應授予使用者管理員特權的 LDAP 過濾器。
- `--restricted-filter value`：指定是否應將使用者設定為受限狀態的 LDAP 過濾器。
- `--username-attribute value`：使用者 LDAP 記錄中包含使用者名稱的屬性。
- `--firstname-attribute value`：使用者 LDAP 記錄中包含使用者名稱字的屬性。
- `--surname-attribute value`：使用者 LDAP 記錄中包含使用者姓氏的屬性。
- `--email-attribute value`：使用者 LDAP 記錄中包含使用者電子電子郵件地址的屬性。必填。
- `--public-ssh-key-attribute value`：使用者 LDAP 記錄中包含使用者公共 SSH 密鑰的屬性。
- `--avatar-attribute value`：使用者 LDAP 記錄中包含使用者頭像的屬性。
- `--bind-dn value`：在搜索使用者時綁定到 LDAP 伺服器的 DN。
- `--bind-password value`：綁定 DN 的密碼（如果有）。
- `--attributes-in-bind`：在綁定 DN 上下文中獲取屬性。
- `--synchronize-users`：啟用使用者同步。
- `--page-size value`：搜索頁面大小。
- 範例：
- `gitea admin auth add-ldap --name ldap --security-protocol unencrypted --host mydomain.org --port 389 --user-search-base "ou=Users,dc=mydomain,dc=org" --user-filter "(&(objectClass=posixAccount)(|(uid=%[1]s)(mail=%[1]s)))" --email-attribute mail`
- `update-ldap`：更新现有的 LDAP（通过 Bind DN）认证源
- 选项：
- `--id value`：认证源的 ID。必填。
- `--name value`：认证名称。
- `--not-active`：停用认证源。
- `--security-protocol value`：安全协议名称。
- `--skip-tls-verify`：禁用 TLS 验证。
- `--host value`：LDAP 服务器的地址。
- `--port value`：连接到 LDAP 服务器时使用的端口。
- `--user-search-base value`：用户帐户将在其中搜索的 LDAP 基础路径。
- `--user-filter value`：声明如何查找试图进行身份验证的用户记录的 LDAP 过滤器。
- `--admin-filter value`：指定是否应授予用户管理员特权的 LDAP 过滤器。
- `--restricted-filter value`：指定是否应将用户设置为受限状态的 LDAP 过滤器。
- `--username-attribute value`：用户 LDAP 记录中包含用户名的属性。
- `--firstname-attribute value`：用户 LDAP 记录中包含用户名字的属性。
- `--surname-attribute value`：用户 LDAP 记录中包含用户姓氏的属性。
- `--email-attribute value`：用户 LDAP 记录中包含用户电子邮件地址的属性。
- `--public-ssh-key-attribute value`：用户 LDAP 记录中包含用户公共 SSH 密钥的属性。
- `--avatar-attribute value`：用户 LDAP 记录中包含用户头像的属性。
- `--bind-dn value`：在搜索用户时绑定到 LDAP 服务器的 DN。
- `--bind-password value`：绑定 DN 的密码（如果有）。
- `--attributes-in-bind`：在绑定 DN 上下文中获取属性。
- `--synchronize-users`：启用用户同步。
- `--page-size value`：搜索页面大小。
- 示例：
- `update-ldap`：更新現有的 LDAP（通過 Bind DN）認證源
- 選項：
- `--id value`：認證源的 ID。必填。
- `--name value`：認證名稱。
- `--not-active`：停用認證源。
- `--security-protocol value`：安全協議名稱。
- `--skip-tls-verify`：禁用 TLS 驗證。
- `--host value`：LDAP 伺服器的地址。
- `--port value`：連接到 LDAP 伺服器時使用的端口。
- `--user-search-base value`：使用者帳戶將在其中搜索的 LDAP 基礎路徑。
- `--user-filter value`：聲明如何查找試圖進行身份驗證的使用者記錄的 LDAP 過濾器。
- `--admin-filter value`：指定是否應授予使用者管理員特權的 LDAP 過濾器。
- `--restricted-filter value`：指定是否應將使用者設定為受限狀態的 LDAP 過濾器。
- `--username-attribute value`：使用者 LDAP 記錄中包含使用者名稱的屬性。
- `--firstname-attribute value`：使用者 LDAP 記錄中包含使用者名稱字的屬性。
- `--surname-attribute value`：使用者 LDAP 記錄中包含使用者姓氏的屬性。
- `--email-attribute value`：使用者 LDAP 記錄中包含使用者電子電子郵件地址的屬性。
- `--public-ssh-key-attribute value`：使用者 LDAP 記錄中包含使用者公共 SSH 密鑰的屬性。
- `--avatar-attribute value`：使用者 LDAP 記錄中包含使用者頭像的屬性。
- `--bind-dn value`：在搜索使用者時綁定到 LDAP 伺服器的 DN。
- `--bind-password value`：綁定 DN 的密碼（如果有）。
- `--attributes-in-bind`：在綁定 DN 上下文中獲取屬性。
- `--synchronize-users`：啟用使用者同步。
- `--page-size value`：搜索頁面大小。
- 範例：
- `gitea admin auth update-ldap --id 1 --name "my ldap auth source"`
- `gitea admin auth update-ldap --id 1 --username-attribute uid --firstname-attribute givenName --surname-attribute sn`
- `add-ldap-simple`：添加新的 LDAP（简单身份验证）认证源
- 选项：
- `--name value`：认证名称。必填。
- `--not-active`：停用认证源。
- `--security-protocol value`：安全协议名称。必填。
- `--skip-tls-verify`：禁用 TLS 验证。
- `--host value`：LDAP 服务器的地址。必填。
- `--port value`：连接到 LDAP 服务器时使用的端口。必填。
- `--user-search-base value`：用户帐户将在其中搜索的 LDAP 基础路径。
- `--user-filter value`：声明如何查找试图进行身份验证的用户记录的 LDAP 过滤器。必填。
- `--admin-filter value`：指定是否应授予用户管理员特权的 LDAP 过滤器。
- `--restricted-filter value`：指定是否应将用户设置为受限状态的 LDAP 过滤器。
- `--username-attribute value`：用户 LDAP 记录中包含用户名的属性。
- `--firstname-attribute value`：用户 LDAP 记录中包含用户名字的属性。
- `--surname-attribute value`：用户 LDAP 记录中包含用户姓氏的属性。
- `--email-attribute value`：用户 LDAP 记录中包含用户电子邮件地址的属性。必填。
- `--public-ssh-key-attribute value`：用户 LDAP 记录中包含用户公共 SSH 密钥的属性。
- `--avatar-attribute value`：用户 LDAP 记录中包含用户头像的属性。
- `--user-dn value`：用户的 DN。必填。
- 示例：
- `add-ldap-simple`：添加新的 LDAP（簡單身份驗證）認證源
- 選項：
- `--name value`：認證名稱。必填。
- `--not-active`：停用認證源。
- `--security-protocol value`：安全協議名稱。必填。
- `--skip-tls-verify`：禁用 TLS 驗證。
- `--host value`：LDAP 伺服器的地址。必填。
- `--port value`：連接到 LDAP 伺服器時使用的端口。必填。
- `--user-search-base value`：使用者帳戶將在其中搜索的 LDAP 基礎路徑。
- `--user-filter value`：聲明如何查找試圖進行身份驗證的使用者記錄的 LDAP 過濾器。必填。
- `--admin-filter value`：指定是否應授予使用者管理員特權的 LDAP 過濾器。
- `--restricted-filter value`：指定是否應將使用者設定為受限狀態的 LDAP 過濾器。
- `--username-attribute value`：使用者 LDAP 記錄中包含使用者名稱的屬性。
- `--firstname-attribute value`：使用者 LDAP 記錄中包含使用者名稱字的屬性。
- `--surname-attribute value`：使用者 LDAP 記錄中包含使用者姓氏的屬性。
- `--email-attribute value`：使用者 LDAP 記錄中包含使用者電子電子郵件地址的屬性。必填。
- `--public-ssh-key-attribute value`：使用者 LDAP 記錄中包含使用者公共 SSH 密鑰的屬性。
- `--avatar-attribute value`：使用者 LDAP 記錄中包含使用者頭像的屬性。
- `--user-dn value`：使用者的 DN。必填。
- 範例：
- `gitea admin auth add-ldap-simple --name ldap --security-protocol unencrypted --host mydomain.org --port 389 --user-dn "cn=%s,ou=Users,dc=mydomain,dc=org" --user-filter "(&(objectClass=posixAccount)(cn=%s))" --email-attribute mail`
- `update-ldap-simple`：更新现有的 LDAP（简单身份验证）认证源
- 选项：
- `--id value`：认证源的 ID。必填。
- `--name value`：认证名称。
- `--not-active`：停用认证源。
- `--security-protocol value`：安全协议名称。
- `--skip-tls-verify`：禁用 TLS 验证。
- `--host value`：LDAP 服务器的地址。
- `--port value`：连接到 LDAP 服务器时使用的端口。
- `--user-search-base value`：用户帐户将在其中搜索的 LDAP 基础路径。
- `--user-filter value`：声明如何查找试图进行身份验证的用户记录的 LDAP 过滤器。
- `--admin-filter value`：指定是否应授予用户管理员特权的 LDAP 过滤器。
- `--restricted-filter value`：指定是否应将用户设置为受限状态的 LDAP 过滤器。
- `--username-attribute value`：用户 LDAP 记录中包含用户名的属性。
- `--firstname-attribute value`：用户 LDAP 记录中包含用户名字的属性。
- `--surname-attribute value`：用户 LDAP 记录中包含用户姓氏的属性。
- `--email-attribute value`：用户 LDAP 记录中包含用户电子邮件地址的属性。
- `--public-ssh-key-attribute value`：用户 LDAP 记录中包含用户公共 SSH 密钥的属性。
- `--avatar-attribute value`：用户 LDAP 记录中包含用户头像的属性。
- `--user-dn value`：用户的 DN。
- 示例：
- `update-ldap-simple`：更新現有的 LDAP（簡單身份驗證）認證源
- 選項：
- `--id value`：認證源的 ID。必填。
- `--name value`：認證名稱。
- `--not-active`：停用認證源。
- `--security-protocol value`：安全協議名稱。
- `--skip-tls-verify`：禁用 TLS 驗證。
- `--host value`：LDAP 伺服器的地址。
- `--port value`：連接到 LDAP 伺服器時使用的端口。
- `--user-search-base value`：使用者帳戶將在其中搜索的 LDAP 基礎路徑。
- `--user-filter value`：聲明如何查找試圖進行身份驗證的使用者記錄的 LDAP 過濾器。
- `--admin-filter value`：指定是否應授予使用者管理員特權的 LDAP 過濾器。
- `--restricted-filter value`：指定是否應將使用者設定為受限狀態的 LDAP 過濾器。
- `--username-attribute value`：使用者 LDAP 記錄中包含使用者名稱的屬性。
- `--firstname-attribute value`：使用者 LDAP 記錄中包含使用者名稱字的屬性。
- `--surname-attribute value`：使用者 LDAP 記錄中包含使用者姓氏的屬性。
- `--email-attribute value`：使用者 LDAP 記錄中包含使用者電子電子郵件地址的屬性。
- `--public-ssh-key-attribute value`：使用者 LDAP 記錄中包含使用者公共 SSH 密鑰的屬性。
- `--avatar-attribute value`：使用者 LDAP 記錄中包含使用者頭像的屬性。
- `--user-dn value`：使用者的 DN。
- 範例：
- `gitea admin auth update-ldap-simple --id 1 --name "my ldap auth source"`
- `gitea admin auth update-ldap-simple --id 1 --username-attribute uid --firstname-attribute givenName --surname-attribute sn`
### cert
生成自签名的 SSL 证书。将输出到当前目录下的`cert.pem`和`key.pem`文件中，并且会覆盖任何现有文件。
生成自簽名的 SSL 證書。將輸出到當前目錄下的`cert.pem`和`key.pem`文件中，並且會覆蓋任何現有文件。
- 选项：
- `--host value`：逗号分隔的主机名和 IP 地址列表，此证书适用于这些主机。支持使用通配符。必填。
- `--ecdsa-curve value`：用于生成密钥的 ECDSA 曲线。可选。有效选项为 P224、P256、P384、P521。
- `--rsa-bits value`：要生成的 RSA 密钥的大小。可选。如果设置了--ecdsa-curve，则忽略此选项。（默认值：3072）。
- `--start-date value`：证书的创建日期。可选。（格式：`Jan 1 15:04:05 2011`）。
- `--duration value`：证书有效期。可选。（默认值：8760h0m0s）
- `--ca`：如果提供此选项，则证书将生成自己的证书颁发机构。可选。
- 示例：
- 選項：
- `--host value`：逗號分隔的主機名和 IP 地址列表，此證書適用於這些主機。支援使用通配符。必填。
- `--ecdsa-curve value`：用於生成密鑰的 ECDSA 曲線。可選。有效選項為 P224、P256、P384、P521。
- `--rsa-bits value`：要生成的 RSA 密鑰的大小。可選。如果設定了--ecdsa-curve，則忽略此選項。（預設值：3072）。
- `--start-date value`：證書的建立日期。可選。（格式：`Jan 1 15:04:05 2011`）。
- `--duration value`：證書有效期。可選。（預設值：8760h0m0s）
- `--ca`：如果提供此選項，則證書將生成自己的證書頒發機構。可選。
- 範例：
- `gitea cert --host git.example.com,example.com,www.example.com --ca`
### dump
将所有文件和数据库导出到一个 zip 文件中。输出文件将保存在当前目录下，类似于`gitea-dump-1482906742.zip`。
將所有文件和資料庫導出到一個 zip 文件中。輸出文件將保存在當前目錄下，類似於`gitea-dump-1482906742.zip`。
- 选项：
- `--file name`，`-f name`：指定要创建的导出文件的名称。可选。（默认值：gitea-dump-[timestamp].zip）。
- `--tempdir path`，`-t path`：指定临时目录的路径。可选。（默认值：/tmp）。
- `--skip-repository`，`-R`：跳过仓库的导出。可选。
- `--skip-custom-dir`：跳过自定义目录的导出。可选。
- `--skip-lfs-data`：跳过 LFS 数据的导出。可选。
- `--skip-attachment-data`：跳过附件数据的导出。可选。
- `--skip-package-data`：跳过包数据的导出。可选。
- `--skip-log`：跳过日志数据的导出。可选。
- `--database`，`-d`：指定数据库的 SQL 语法。可选。
- `--verbose`，`-V`：如果提供此选项，显示附加详细信息。可选。
- `--type`：设置导出的格式。可选。（默认值：zip）
- 示例：
- 選項：
- `--file name`，`-f name`：指定要建立的導出文件的名稱。可選。（預設值：gitea-dump-[timestamp].zip）。
- `--tempdir path`，`-t path`：指定臨時目錄的路徑。可選。（預設值：/tmp）。
- `--skip-repository`，`-R`：跳過儲存庫的導出。可選。
- `--skip-custom-dir`：跳過自訂目錄的導出。可選。
- `--skip-lfs-data`：跳過 LFS 資料的導出。可選。
- `--skip-attachment-data`：跳過附件資料的導出。可選。
- `--skip-package-data`：跳過包資料的導出。可選。
- `--skip-log`：跳過日誌資料的導出。可選。
- `--database`，`-d`：指定資料庫的 SQL 語法。可選。
- `--verbose`，`-V`：如果提供此選項，顯示附加詳細資訊。可選。
- `--type`：設定導出的格式。可選。（預設值：zip）
- 範例：
- `gitea dump`
- `gitea dump --verbose`
### generate
用于在配置文件中生成随机值和令牌。对于自动部署时生成值非常有用。
用於在設定文件中生成隨機值和令牌。對於自動部署時生成值非常有用。
- 命令:
- `secret`:
- 选项:
- `INTERNAL_TOKEN`: 用于内部 API 调用身份验证的令牌。
- `JWT_SECRET`: 用于 LFS 和 OAUTH2 JWT 身份验证的密钥（LFS_JWT_SECRET 是此选项的别名，用于向后兼容）。
- `SECRET_KEY`: 全局密钥。
- 示例:
- 選項:
- `INTERNAL_TOKEN`: 用於內部 API 調用身份驗證的令牌。
- `JWT_SECRET`: 用於 LFS 和 OAUTH2 JWT 身份驗證的密鑰（LFS_JWT_SECRET 是此選項的別名，用於向後相容）。
- `SECRET_KEY`: 全域密鑰。
- 範例:
- `gitea generate secret INTERNAL_TOKEN`
- `gitea generate secret JWT_SECRET`
- `gitea generate secret SECRET_KEY`
### keys
提供一个 SSHD AuthorizedKeysCommand。需要在 sshd 配置文件中进行配置:
提供一個 SSHD AuthorizedKeysCommand。需要在 sshd 設定文件中進行設定:
```ini
...
# -e 的值和 AuthorizedKeysCommandUser 应与运行 Gitea 的用户名匹配
# -e 的值和 AuthorizedKeysCommandUser 應與運行 Gitea 的用戶名匹配
AuthorizedKeysCommandUser git
AuthorizedKeysCommand /path/to/gitea keys -e git -u %u -t %t -k %k
```
该命令将返回适用于提供的密钥的合适 authorized_keys 行。您还应在 `app.ini` 的 `[server]` 部分设置值 `SSH_CREATE_AUTHORIZED_KEYS_FILE=false`。
該命令將返回適用於提供的密鑰的合適 authorized_keys 行。您還應在 `app.ini` 的 `[server]` 部分設定值 `SSH_CREATE_AUTHORIZED_KEYS_FILE=false`。
注意: opensshd 要求 Gitea 程序由 root 拥有，并且不可由组或其他人写入。程序必须使用绝对路径指定。
注意: Gitea 必须在运行此命令时处于运行状态才能成功。
注意: opensshd 要求 Gitea 程式由 root 擁有，並且不可由組或其他人寫入。程式必須使用絕對路徑指定。
注意: Gitea 必須在運行此命令時處於運行狀態才能成功。
### migrate
迁移数据库。该命令可用于在首次启动服务器之前运行其他命令。此命令是幂等的。
遷移資料庫。該命令可用於在首次啟動伺服器之前運行其他命令。此命令是冪等的。
### doctor check
对 Gitea 实例进行诊断，可以修复一些可修复的问题。
默认只运行部分检查，额外的检查可以参考：
對 Gitea 實例進行診斷，可以修復一些可修復的問題。
預設只運行部分檢查，額外的檢查可以參考：
- `gitea doctor check --list` - 列出所有可用的检查
- `gitea doctor check --all` - 运行所有可用的检查
- `gitea doctor check --default` - 运行默认的检查
- `gitea doctor check --run [check(s),]...` - 运行指定的名字的检查
- `gitea doctor check --list` - 列出所有可用的檢查
- `gitea doctor check --all` - 運行所有可用的檢查
- `gitea doctor check --default` - 運行預設的檢查
- `gitea doctor check --run [check(s),]...` - 運行指定的名字的檢查
有些问题可以通过设置 `--fix` 选项进行自动修复。
额外的日志可以通过 `--log-file=...` 进行设置。
有些問題可以透過設定 `--fix` 選項進行自動修復。
額外的日誌可以透過 `--log-file=...` 進行設定。
#### doctor recreate-table
有时，在迁移时，旧的列和默认值可能会在数据库模式中保持不变。这可能会导致警告，如下所示:
有時，在遷移時，舊的列和預設值可能會在資料庫模式中保持不變。這可能會導致警告，如下所示:
```
2020/08/02 11:32:29 ...rm/session_schema.go:360:Sync() [W] Table user Column keep_activity_private db default is , struct default is 0
```
您可以通过以下方式让 Gitea 重新创建这些表，并将旧数据复制到新表中，并适当设置默认值：
您可以透過以下方式讓 Gitea 重新建立這些表，並將舊資料複製到新表中，並適當設定預設值：
```
gitea doctor recreate-table user
```
您可以使用以下方式让 Gitea 重新创建多个表：
您可以使用以下方式讓 Gitea 重新建立多個表：
```
gitea doctor recreate-table table1 table2 ...
```
如果您希望 Gitea 重新创建所有表，请直接调用：
如果您希望 Gitea 重新建立所有表，請直接調用：
```
gitea doctor recreate-table
```
强烈建议在运行这些命令之前备份您的数据库。
強烈建議在運行這些命令之前備份您的資料庫。
### doctor convert
将现有的 MySQL 数据库从 utf8 转换为 utf8mb4，或者把 MSSQL 数据库从 varchar 转换为 nvarchar。
將現有的 MySQL 資料庫從 utf8 轉換為 utf8mb4，或者把 MSSQL 資料庫從 varchar 轉換為 nvarchar。
### manager
管理运行中的服务器操作：
管理運行中的伺服器操作：
- 命令:
- `shutdown`: 优雅地关闭运行中的进程
- `restart`: 优雅地重新启动运行中的进程（对于 Windows 服务器尚未实现）
- `flush-queues`: 刷新运行中的进程中的队列
- 选项:
- `--timeout value`: 刷新过程的超时时间（默认值: 1m0s）
- `--non-blocking`: 设置为 true，以在返回之前不等待刷新完成
- `logging`: 调整日志命令
- `shutdown`: 優雅地關閉運行中的進程
- `restart`: 優雅地重新啟動運行中的進程（對於 Windows 伺服器尚未實現）
- `flush-queues`: 刷新運行中的進程中的隊列
- 選項:
- `--timeout value`: 刷新過程的超時時間（預設值: 1m0s）
- `--non-blocking`: 設定為 true，以在返回之前不等待刷新完成
- `logging`: 調整日誌命令
- 命令:
- `pause`: 暂停日志记录
- `pause`: 暫停日誌記錄
- 注意:
- 如果日志级别低于此级别，日志级别将被临时提升为 INFO。
- Gitea 将在一定程度上缓冲日志，并在超过该点后丢弃日志。
- `resume`: 恢复日志记录
- `release-and-reopen`: 使 Gitea 释放和重新打开用于日志记录的文件和连接（相当于向 Gitea 发送 SIGUSR1 信号）。
- `remove name`: 删除指定的日志记录器
- 选项:
- `--group group`, `-g group`: 从中删除子记录器的组（默认为`default`）
- `add`: 添加日志记录器
- 如果日誌級別低於此級別，日誌級別將被臨時提升為 INFO。
- Gitea 將在一定程度上緩衝日誌，並在超過該點後丟棄日誌。
- `resume`: 恢復日誌記錄
- `release-and-reopen`: 使 Gitea 釋放和重新打開用於日誌記錄的文件和連接（相當於向 Gitea 發送 SIGUSR1 信號）。
- `remove name`: 刪除指定的日誌記錄器
- 選項:
- `--group group`, `-g group`: 從中刪除子記錄器的組（預設為`default`）
- `add`: 添加日誌記錄器
- 命令:
- `console`: 添加控制台日志记录器
- 选项:
- `--group value`, `-g value`: 要添加日志记录器的组 - 默认为"default"
- `--name value`, `-n value`: 新日志记录器的名称 - 默认为模式
- `--level value`, `-l value`: 新日志记录器的日志级别
- `--stacktrace-level value`, `-L value`: 堆栈跟踪日志级别
- `--flags value`, `-F value`: 日志记录器的标志
- `--expression value`, `-e value`: 日志记录器的匹配表达式
- `--prefix value`, `-p value`: 日志记录器的前缀
- `--color`: 在日志中使用颜色
- `--stderr`: 将控制台日志输出到 stderr - 仅适用于控制台
- `file`: 添加文件日志记录器
- 选项:
- `--group value`, `-g value`: 要添加日志记录器的组 - 默认为"default"
- `--name value`, `-n value`: 新日志记录器的名称 - 默认为模式
- `--level value`, `-l value`: 新日志记录器的日志级别
- `--stacktrace-level value`, `-L value`: 堆栈跟踪日志级别
- `--flags value`, `-F value`: 日志记录器的标志
- `--expression value`, `-e value`: 日志记录器的匹配表达式
- `--prefix value`, `-p value`: 日志记录器的前缀
- `--color`: 在日志中使用颜色
- `--filename value`, `-f value`: 日志记录器的文件名
- `--rotate`, `-r`: 轮转日志
- `--max-size value`, `-s value`: 在轮转之前的最大大小（以字节为单位）
- `--daily`, `-d`: 每天轮转日志
- `--max-days value`, `-D value`: 保留的每日日志的最大数量
- `--compress`, `-z`: 压缩轮转的日志
- `--compression-level value`, `-Z value`: 使用的压缩级别
- `conn`: 添加网络连接日志记录器
- 选项:
- `--group value`, `-g value`: 要添加日志记录器的组 - 默认为"default"
- `--name value`, `-n value`: 新日志记录器的名称 - 默认为模式
- `--level value`, `-l value`: 新日志记录器的日志级别
- `--stacktrace-level value`, `-L value`: 堆栈跟踪日志级别
- `--flags value`, `-F value`: 日志记录器的标志
- `--expression value`, `-e value`: 日志记录器的匹配表达式
- `--prefix value`, `-p value`: 日志记录器的前缀
- `--color`: 在日志中使用颜色
- `--reconnect-on-message`, `-R`: 对于每个消息重新连接主机
- `--reconnect`, `-r`: 连接中断时重新连接主机
- `--protocol value`, `-P value`: 设置要使用的协议：tcp、unix 或 udp（默认为 tcp）
- `--address value`, `-a value`: 要连接到的主机地址和端口（默认为:7020）
- `smtp`: 添加 SMTP 日志记录器
- 选项:
- `--group value`, `-g value`: 要添加日志记录器的组 - 默认为"default"
- `--name value`, `-n value`: 新日志记录器的名称 - 默认为模式
- `--level value`, `-l value`: 新日志记录器的日志级别
- `--stacktrace-level value`, `-L value`: 堆栈跟踪日志级别
- `--flags value`, `-F value`: 日志记录器的标志
- `--expression value`, `-e value`: 日志记录器的匹配表达式
- `--prefix value`, `-p value`: 日志记录器的前缀
- `--color`: 在日志中使用颜色
- `--username value`, `-u value`: 邮件服务器用户名
- `--password value`, `-P value`: 邮件服务器密码
- `--host value`, `-H value`: 邮件服务器主机（默认为: 127.0.0.1:25）
- `--send-to value`, `-s value`: 要发送到的电子邮件地址
- `--subject value`, `-S value`: 发送电子邮件的主题标题
- `processes`: 显示 Gitea 进程和 Goroutine 信息
- 选项:
- `--flat`: 以平面表格形式显示进程，而不是树形结构
- `--no-system`: 不显示系统进程
- `--stacktraces`: 显示与进程关联的 Goroutine 的堆栈跟踪
- `--json`: 输出为 JSON 格式
- `--cancel PID`: 向具有 PID 的进程发送取消命令（仅适用于非系统进程）
- `console`: 添加控制檯日誌記錄器
- 選項:
- `--group value`, `-g value`: 要添加日誌記錄器的組 - 預設為"default"
- `--name value`, `-n value`: 新日誌記錄器的名稱 - 預設為模式
- `--level value`, `-l value`: 新日誌記錄器的日誌級別
- `--stacktrace-level value`, `-L value`: 堆棧跟蹤日誌級別
- `--flags value`, `-F value`: 日誌記錄器的標誌
- `--expression value`, `-e value`: 日誌記錄器的匹配表達式
- `--prefix value`, `-p value`: 日誌記錄器的前綴
- `--color`: 在日誌中使用顏色
- `--stderr`: 將控制檯日誌輸出到 stderr - 僅適用於控制檯
- `file`: 添加文件日誌記錄器
- 選項:
- `--group value`, `-g value`: 要添加日誌記錄器的組 - 預設為"default"
- `--name value`, `-n value`: 新日誌記錄器的名稱 - 預設為模式
- `--level value`, `-l value`: 新日誌記錄器的日誌級別
- `--stacktrace-level value`, `-L value`: 堆棧跟蹤日誌級別
- `--flags value`, `-F value`: 日誌記錄器的標誌
- `--expression value`, `-e value`: 日誌記錄器的匹配表達式
- `--prefix value`, `-p value`: 日誌記錄器的前綴
- `--color`: 在日誌中使用顏色
- `--filename value`, `-f value`: 日誌記錄器的文件名
- `--rotate`, `-r`: 輪轉日誌
- `--max-size value`, `-s value`: 在輪轉之前的最大大小（以位元組為單位）
- `--daily`, `-d`: 每天輪轉日誌
- `--max-days value`, `-D value`: 保留的每日日誌的最大數量
- `--compress`, `-z`: 壓縮輪轉的日誌
- `--compression-level value`, `-Z value`: 使用的壓縮級別
- `conn`: 添加網路連接日誌記錄器
- 選項:
- `--group value`, `-g value`: 要添加日誌記錄器的組 - 預設為"default"
- `--name value`, `-n value`: 新日誌記錄器的名稱 - 預設為模式
- `--level value`, `-l value`: 新日誌記錄器的日誌級別
- `--stacktrace-level value`, `-L value`: 堆棧跟蹤日誌級別
- `--flags value`, `-F value`: 日誌記錄器的標誌
- `--expression value`, `-e value`: 日誌記錄器的匹配表達式
- `--prefix value`, `-p value`: 日誌記錄器的前綴
- `--color`: 在日誌中使用顏色
- `--reconnect-on-message`, `-R`: 對於每個消息重新連接主機
- `--reconnect`, `-r`: 連接中斷時重新連接主機
- `--protocol value`, `-P value`: 設定要使用的協議：tcp、unix 或 udp（預設為 tcp）
- `--address value`, `-a value`: 要連接到的主機地址和端口（預設為:7020）
- `smtp`: 添加 SMTP 日誌記錄器
- 選項:
- `--group value`, `-g value`: 要添加日誌記錄器的組 - 預設為"default"
- `--name value`, `-n value`: 新日誌記錄器的名稱 - 預設為模式
- `--level value`, `-l value`: 新日誌記錄器的日誌級別
- `--stacktrace-level value`, `-L value`: 堆棧跟蹤日誌級別
- `--flags value`, `-F value`: 日誌記錄器的標誌
- `--expression value`, `-e value`: 日誌記錄器的匹配表達式
- `--prefix value`, `-p value`: 日誌記錄器的前綴
- `--color`: 在日誌中使用顏色
- `--username value`, `-u value`: 郵件伺服器使用者名稱
- `--password value`, `-P value`: 郵件伺服器密碼
- `--host value`, `-H value`: 郵件伺服器主機（預設為: 127.0.0.1:25）
- `--send-to value`, `-s value`: 要發送到的電子電子郵件地址
- `--subject value`, `-S value`: 發送電子郵件的主題標題
- `processes`: 顯示 Gitea 進程和 Goroutine 資訊
- 選項:
- `--flat`: 以平面表格形式顯示進程，而不是樹形結構
- `--no-system`: 不顯示系統進程
- `--stacktraces`: 顯示與進程關聯的 Goroutine 的堆棧跟蹤
- `--json`: 輸出為 JSON 格式
- `--cancel PID`: 向具有 PID 的進程發送取消命令（僅適用於非系統進程）
### dump-repo
`dump-repo` 从 Git/GitHub/Gitea/GitLab 中转储存储库数据：
`dump-repo` 從 Git/GitHub/Gitea/GitLab 中轉儲儲存庫資料：
- 选项：
- `--git_service service`：Git 服务，可以是 `git`、`github`、`gitea`、`gitlab`。如果 `clone_addr` 可以被识别，则可以忽略此选项。
- `--repo_dir dir`，`-r dir`：存储数据的存储库目录路径。
- `--clone_addr addr`：将被克隆的 URL，目前可以是 git/github/gitea/gitlab 的 http/https URL。例如：https://github.com/lunny/tango.git
- `--auth_username lunny`：访问 `clone_addr` 的用户名。
- `--auth_password <password>`：访问 `clone_addr` 的密码。
- `--auth_token <token>`：访问 `clone_addr` 的个人令牌。
- `--owner_name lunny`：如果非空，数据将存储在具有所有者名称的目录中。
- `--repo_name tango`：如果非空，数据将存储在具有存储库名称的目录中。
- `--units <units>`：要迁移的项目，一个或多个项目应以逗号分隔。允许的项目有 wiki, issues, labels, releases, release_assets, milestones, pull_requests, comments。如果为空，则表示所有项目。
- 選項：
- `--git_service service`：Git 服務，可以是 `git`、`github`、`gitea`、`gitlab`。如果 `clone_addr` 可以被識別，則可以忽略此選項。
- `--repo_dir dir`，`-r dir`：儲存資料的儲存庫目錄路徑。
- `--clone_addr addr`：將被克隆的 URL，目前可以是 git/github/gitea/gitlab 的 http/https URL。例如：https://github.com/lunny/tango.git
- `--auth_username lunny`：訪問 `clone_addr` 的使用者名稱。
- `--auth_password <password>`：訪問 `clone_addr` 的密碼。
- `--auth_token <token>`：訪問 `clone_addr` 的個人令牌。
- `--owner_name lunny`：如果非空，資料將儲存在具有所有者名稱的目錄中。
- `--repo_name tango`：如果非空，資料將儲存在具有儲存庫名稱的目錄中。
- `--units <units>`：要遷移的專案，一個或多個專案應以逗號分隔。允許的專案有 wiki, issues, labels, releases, release_assets, milestones, pull_requests, comments。如果為空，則表示所有專案。
### restore-repo
`restore-repo` 从磁盘目录中还原存储库数据：
`restore-repo` 從磁盤目錄中還原儲存庫資料：
- 选项：
- `--repo_dir dir`，`-r dir`：还原数据的存储库目录路径。
- `--owner_name lunny`：还原目标所有者名称。
- `--repo_name tango`：还原目标存储库名称。
- `--units <units>`：要还原的项目，一个或多个项目应以逗号分隔。允许的项目有 wiki, issues, labels, releases, release_assets, milestones, pull_requests, comments。如果为空，则表示所有项目。
- 選項：
- `--repo_dir dir`，`-r dir`：還原資料的儲存庫目錄路徑。
- `--owner_name lunny`：還原目標所有者名稱。
- `--repo_name tango`：還原目標儲存庫名稱。
- `--units <units>`：要還原的專案，一個或多個專案應以逗號分隔。允許的專案有 wiki, issues, labels, releases, release_assets, milestones, pull_requests, comments。如果為空，則表示所有專案。
### actions generate-runner-token
生成一个供 Runner 使用的新令牌，用于向服务器注册。
生成一個供 Runner 使用的新令牌，用於向伺服器註冊。
- 选项：
- `--scope {owner}[/{repo}]`，`-s {owner}[/{repo}]`：限制 Runner 的范围，没有范围表示该 Runner 可用于所有仓库，但你也可以将其限制为特定的仓库或所有者。
- 選項：
- `--scope {owner}[/{repo}]`，`-s {owner}[/{repo}]`：限制 Runner 的範圍，沒有範圍表示該 Runner 可用於所有儲存庫，但你也可以將其限制為特定的儲存庫或所有者。
要注册全局 Runner：
要註冊全域 Runner：
```
gitea actions generate-runner-token
```
要注册特定组织的 Runner，例如 `org`：
要註冊特定組織的 Runner，例如 `org`：
```
gitea actions generate-runner-token -s org
```
要注册特定仓库的 Runner，例如 `username/test-repo`：
要註冊特定儲存庫的 Runner，例如 `username/test-repo`：
```
gitea actions generate-runner-token -s username/test-repo