Update zh tw languages and fix some broken links

This commit is contained in:
Lunny Xiao
2026-07-01 14:47:51 -07:00
parent 9558006c39
commit a084bdb556
842 changed files with 31137 additions and 31065 deletions

View File

@@ -10,523 +10,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`:客端 IDKey
- `--secret`:客端密
- `--auto-discover-url`OpenID Connect 自动发现 URL在使用 OpenID Connect 作提供程序时需要)。
- `--use-custom-urls`:在 GitLab/GitHub OAuth 端上使用自定义 URL。
- `--custom-tenant-id`:在 OAuth 端上使用自定义租户 ID。
- `--custom-auth-url`:使用自定义授权 URLGitLab/GitHub 的选项)。
- `--custom-token-url`:使用自定义令牌 URLGitLab/GitHub 的选项)。
- `--custom-profile-url`:使用自定义配置文件 URLGitLab/GitHub 的选项)。
- `--custom-email-url`:使用自定义电子邮件 URLGitHub 的选项)。
- `--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`:客端 IDKey
- `--secret`:客端密
- `--auto-discover-url`OpenID Connect 自動發現 URL在使用 OpenID Connect 作提供程式時需要)。
- `--use-custom-urls`:在 GitLab/GitHub OAuth 端上使用自 URL。
- `--custom-tenant-id`:在 OAuth 端上使用自訂租戶 ID。
- `--custom-auth-url`:使用自訂授權 URLGitLab/GitHub 的選項)。
- `--custom-token-url`:使用自令牌 URLGitLab/GitHub 的選項)。
- `--custom-profile-url`:使用自訂設定文件 URLGitLab/GitHub 的選項)。
- `--custom-email-url`:使用自訂電子郵件 URLGitHub 的選項)。
- `--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`:客端 IDKey
- `--secret`:客端密
- `--auto-discover-url`OpenID Connect 自动发现 URL在使用 OpenID Connect 作提供程序时需要)。
- `--use-custom-urls`:在 GitLab/GitHub OAuth 端上使用自定义 URL。
- `--custom-tenant-id`:在 OAuth 端上使用自定义租户 ID。
- `--custom-auth-url`:使用自定义授权 URLGitLab/GitHub 的选项)。
- `--custom-token-url`:使用自定义令牌 URLGitLab/GitHub 的选项)。
- `--custom-profile-url`:使用自定义配置文件 URLGitLab/GitHub 的选项)。
- `--custom-email-url`:使用自定义电子邮件 URLGitHub 的选项)。
- `--icon-url`OAuth2 登源的自定义图标 URL。
- `--skip-local-2fa`:允源覆本地 2FA。
- `--scopes`求此 OAuth2 源的附加范围
- `--required-claim-name`:必须设置的声明名,以允许用户使用此源登。(可
- `--required-claim-value`:必须设置的声明值,以允许用户使用此源登。(可
- `--group-claim-name`:提供此源的名的明名。(可
- `--admin-group`:管理员用户的组声明值。(可
- `--restricted-group`:受限用户的组声明值。(可
- 例:
- `--key`:客端 IDKey
- `--secret`:客端密
- `--auto-discover-url`OpenID Connect 自動發現 URL在使用 OpenID Connect 作提供程式時需要)。
- `--use-custom-urls`:在 GitLab/GitHub OAuth 端上使用自 URL。
- `--custom-tenant-id`:在 OAuth 端上使用自訂租戶 ID。
- `--custom-auth-url`:使用自訂授權 URLGitLab/GitHub 的選項)。
- `--custom-token-url`:使用自令牌 URLGitLab/GitHub 的選項)。
- `--custom-profile-url`:使用自訂設定文件 URLGitLab/GitHub 的選項)。
- `--custom-email-url`:使用自訂電子郵件 URLGitHub 的選項)。
- `--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