跳至主要内容
版本:1.24.5

命令行

用法

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.pemkey.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 配置文件中進行配置:

...
# -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 服务,可以是 gitgithubgiteagitlab。如果 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