gitea/gitea-docs
1
0
Fork 0
mirror of https://gitea.com/gitea/docs.git synced 2026-07-02 00:54:27 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
c2b6f7108532ac2d7cc17281fd0f46f2c2320249
gitea-docs/i18n/zh-tw/docusaurus-plugin-content-docs/version-1.24/administration/command-line.md
ifurther cb462089e9 docs: update zh-tw (#265) 
Reviewed-on: https://gitea.com/gitea/docs/pulls/265
Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com>
Co-authored-by: ifurther <55025025+ifurther@users.noreply.github.com>
Co-committed-by: ifurther <55025025+ifurther@users.noreply.github.com>
2025-09-03 21:00:35 +00:00

535 lines
30 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
date: "2023-05-23T09:00:00+08:00"
slug: "command-line"
sidebar_position: 1
aliases:
- /zh-tw/command-line
---
# 命令行
## 用法
`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`)
注意：默认的 custom-path、config 和 work-path 也可以在构建时更改（如果需要）。
## 命令
### web
启动服务器：
- 選项：
- `--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 都需要重新執行此操作。
### admin
管理员操作：
- 命令：
- `user`：
- `list`：
- 選项：
- `--admin`：僅列出管理员使用者。可選。
- 描述：列出所有現有使用者。
- 示例：
- `gitea admin user list`
- `delete`：
- 選项：
- `--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）
- 示例：
- `gitea admin user create --username myname --password asecurepassword --email me@example.com`
- `change-password`：
- 選项：
- `--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`：撤销对给定使用者的强制密碼更改
- `regenerate`：
- 選项：
- `hooks`：重新生成所有存放庫的 Git Hooks。
- `keys`：重新生成 authorized_keys 文件。
- 示例：
- `gitea admin regenerate hooks`
- `gitea admin regenerate keys`
- `auth`：
- `list`：
- 描述：列出所有存在的外部認證源。
- 示例：
- `gitea admin auth list`
- `delete`：
- 選项：
- `--id`：要删除的源的 ID。必填。
- 示例：
- `gitea admin auth delete --id 1`
- `add-oauth`：
- 選项：
- `--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`：根据组自动激活团队成员资格的删除。（可選）
- 示例：
- `gitea admin auth add-oauth --name external-github --provider github --key OBTAIN_FROM_SOURCE --secret OBTAIN_FROM_SOURCE`
- `update-oauth`：
- 選项：
- `--id`：要更新的源的 ID。必填。
- `--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`：受限使用者的组声明值。（可選）
- 示例：
- `gitea admin auth update-oauth --id 1 --name external-github-updated`
- `add-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 时使用的主机名。留空以发送当前主机名。
- `--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` 值。
- 示例：
- `gitea admin auth add-smtp --name ldap --host smtp.mydomain.org --port 587 --skip-verify --active`
- `update-smtp`：
- 選项：
- `--id`：要更新的源的 ID。必填。
- 其他選项与 `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`：搜索页面大小。
- 示例：
- `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`：搜索页面大小。
- 示例：
- `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。必填。
- 示例：
- `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。
- 示例：
- `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`文件中，並且会覆盖任何現有文件。
- 選项：
- `--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`。
- 選项：
- `--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`: 全局密钥。
- 示例:
- `gitea generate secret INTERNAL_TOKEN`
- `gitea generate secret JWT_SECRET`
- `gitea generate secret SECRET_KEY`
### keys
提供一个 SSHD AuthorizedKeysCommand。需要在 sshd 配置文件中進行配置:
```ini
...
# -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`。
注意: opensshd 要求 Gitea 程序由 root 拥有，並且不可由组或其他人写入。程序必須使用绝对路径指定。
注意: Gitea 必須在运行此命令时处于运行状态才能成功。
### migrate
迁移数据库。該命令可用于在首次启动服务器之前运行其他命令。此命令是幂等的。
### doctor check
对 Gitea 实例進行诊断，可以修复一些可修复的问题。
默认只运行部分检查，额外的检查可以参考：
- `gitea doctor check --list` - 列出所有可用的检查
- `gitea doctor check --all` - 运行所有可用的检查
- `gitea doctor check --default` - 运行默认的检查
- `gitea doctor check --run [check(s),]...` - 运行指定的名字的检查
有些问题可以通過设置 `--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 doctor recreate-table user
```
您可以使用以下方式让 Gitea 重新建立多个表：
```
gitea doctor recreate-table table1 table2 ...
```
如果您希望 Gitea 重新建立所有表，請直接调用：
```
gitea doctor recreate-table
```
强烈建议在运行这些命令之前备份您的数据库。
### doctor convert
将現有的 MySQL 数据库从 utf8 转换為 utf8mb4，或者把 MSSQL 数据库从 varchar 转换為 nvarchar。
### manager
管理运行中的服务器操作：
- 命令:
- `shutdown`: 优雅地关闭运行中的進程
- `restart`: 优雅地重新启动运行中的進程（對於 Windows 服务器尚未实現）
- `flush-queues`: 刷新运行中的進程中的队列
- 選项:
- `--timeout value`: 刷新過程的超时时间（默认值: 1m0s）
- `--non-blocking`: 设置為 true，以在返回之前不等待刷新完成
- `logging`: 调整日志命令
- 命令:
- `pause`: 暂停日志记录
- 注意:
- 如果日志级别低于此级别，日志级别将被临时提升為 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 的進程发送取消命令（僅适用于非系统進程）
### dump-repo
`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。如果為空，则表示所有项目。
### 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。如果為空，则表示所有项目。
### actions generate-runner-token
生成一个供 Runner 使用的新令牌，用于向服务器注册。
- 選项：
- `--scope {owner}[/{repo}]`，`-s {owner}[/{repo}]`：限制 Runner 的范围，没有范围表示該 Runner 可用于所有存放庫，但你也可以将其限制為特定的存放庫或所有者。
要注册全局 Runner：
```
gitea actions generate-runner-token
```
要注册特定組織的 Runner，例如 `org`：
```
gitea actions generate-runner-token -s org
```
要注册特定存放庫的 Runner，例如 `username/test-repo`：
```
gitea actions generate-runner-token -s username/test-repo
```
Reference in New Issue View Git Blame Copy Permalink