跳至主要内容
版本：1.23.7

Gitea 命令行

用法​

gitea [全局選項] 命令 [命令或全局選項] [參數...]

全局選項​

所有全局選項都可以放在命令級別。

  • --help, -h: 顯示幫助文本並退出。可選。
  • --version, -v: 顯示版本並退出。可選。（示例：Gitea version 1.1.0+218-g7b907ed built with: bindata, sqlite）。
  • --work-path path, -w path: Gitea 的工作路徑。可選。（默認：二進制文件的路徑或 $GITEA_WORK_DIR）
  • --custom-path path, -C path: Gitea 的自定義文件夾路徑。可選。（默認：WorkPath/custom 或 $GITEA_CUSTOM）。
  • --config path, -c path: Gitea 配置文件路徑。可選。（默認：CustomPath/conf/app.ini）。

注意：默認的 custom-path、config 和 work-path 也可以在構建時更改（如果需要）。

命令​

web​

啟動服務器：

  • 選項：
    • --port number, -p number: 端口號。可選。（默認：3000）。覆蓋配置文件。
    • --install-port number: 運行安裝頁面的端口號。可選。（默認：3000）。覆蓋配置文件。
    • --pid path, -P path: Pidfile 路徑。可選。
    • --quiet, -q: 只在控制台上發出致命日誌，適用於日誌設置之前的日誌。
    • --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。可以通過 --must-change-password=false 禁用。
          • --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: 新密碼。必需。
          • --must-change-password: 用戶在登錄後需要設置新密碼，默認：true。可以通過 --must-change-password=false 禁用。
        • 示例：
          • gitea admin user change-password --username myname --password asecurepassword
      • must-change-password:
        • 參數：
          • [username...]: 必須更改密碼的用戶
        • 選項：
          • --all, -A: 強制所有用戶更改密碼
          • --exclude username, -e username: 排除給定的用戶。可以多次設置。
          • --unset: 撤銷給定用戶的強制密碼更改
      • generate-access-token:
        • 選項：
          • --username value, -u value: 用戶名。必需。
          • --token-name value, -t value: 令牌名稱。必需。
          • --scopes value: 逗號分隔的範圍列表。範圍遵循格式 [read|write]:<block> 或 all，其中 <block> 是可見組之一，您可以在打開顯示可用路由的 API 頁面時看到（例如 repo）。
        • 示例：
          • gitea admin user generate-access-token --username myname --token-name mytoken
          • gitea admin user generate-access-token --help
    • regenerate
      • 選項：
        • hooks: 為所有存儲庫重新生成 Git 鉤子
        • 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（密鑰）。
          • --secret: 客戶端密鑰。
          • --auto-discover-url: OpenID Connect 自動發現 URL（僅在使用 OpenID Connect 作為提供者時需要）。
          • --use-custom-urls: 使用自定義 URL 用於 GitLab/GitHub OAuth 端點。
          • --custom-tenant-id: 使用自定義租戶 ID 用於 OAuth 端點。
          • --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: 自定義圖標 URL 用於 OAuth2 登錄源。
          • --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（密鑰）。
          • --secret: 客戶端密鑰。
          • --auto-discover-url: OpenID Connect 自動發現 URL（僅在使用 OpenID Connect 作為提供者時需要）。
          • --use-custom-urls: 使用自定義 URL 用於 GitLab/GitHub OAuth 端點。
          • --custom-tenant-id: 使用自定義租戶 ID 用於 OAuth 端點。
          • --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: 自定義圖標 URL 用於 OAuth2 登錄源。
          • --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-loca-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 記錄的屬性。
          • --avatar-attribute value: 包含用戶頭像的用戶 LDAP 記錄的屬性。
          • --bind-dn value: 在搜索用戶時綁定到 LDAP 服務器的 DN。
          • --bind-password value: 綁定 DN 的密碼（如果有）。注意：密碼使用服務器上的 SECRET_KEY 加密存儲。仍然建議確保 Bind 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