docs: add zh-tw folder (#195)

Signed-off-by: appleboy <[email protected]> Reviewed-on: https://gitea.com/gitea/docs/pulls/195 Reviewed-by: Lunny Xiao <[email protected]> Co-authored-by: appleboy <[email protected]> Co-committed-by: appleboy <[email protected]>
2026-09-20 04:58:52 +00:00 · 2025-04-04 23:28:16 +00:00
parent 3275094871
commit dbfa0ba454
835 changed files with 72590 additions and 5155 deletions
@@ -0,0 +1,230 @@
+---
+date: "2017-01-01T16:00:00+02:00"
+slug: "command-line"
+sidebar_position: 1
+aliases:
+  - /zh-tw/command-line
+---
+
+# 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 [email protected]`
+    - `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