Update zh tw languages and fix some broken links (#455)

---------

Co-authored-by: silverwind <me@silverwind.io>
Co-authored-by: silverwind <2021+silverwind@noreply.gitea.com>
Reviewed-on: https://gitea.com/gitea/docs/pulls/455
Reviewed-by: silverwind <2021+silverwind@noreply.gitea.com>
This commit is contained in:
Lunny Xiao
2026-07-09 23:41:46 +00:00
parent c0f8a04185
commit 965c269495
652 changed files with 30864 additions and 30792 deletions

View File

@@ -6,266 +6,268 @@ aliases:
- /zh-tw/faq
---
# 常见问题
# 常見問題
面包含一些常见问题和答案。
面包含一些常見問題和答案。
更多帮助资源,查看所有[持选项](help/support.md)。
更多幫助資源,查看所有[援選項](help/support.md)。
## 1.x 和 1.x.x 下载之间的区别
## 1.x 和 1.x.x 下載之間的區別
以 1.7.x 版本例。
以 1.7.x 版本例。
**注意:**此例也适用于 Docker 像!
**注意:**此例也適用於 Docker 像!
在我的[载页](https://dl.gitea.com/gitea/)上,您看到一 1.7 目,以及 1.7.0、1.7.1、1.7.2、1.7.3、1.7.4、1.7.5 和 1.7.6 的目
在我的[載頁](https://dl.gitea.com/gitea/)上,您看到一 1.7 目,以及 1.7.0、1.7.1、1.7.2、1.7.3、1.7.4、1.7.5 和 1.7.6 的目
1.7 目和 1.7.0 目是**不同**的。1.7 目是在每个合并到[`release/v1.7`](https://github.com/go-gitea/gitea/tree/release/v1.7)分支的提交上建的。
1.7 目和 1.7.0 目是**不同**的。1.7 目是在每個合併到[`release/v1.7`](https://github.com/go-gitea/gitea/tree/release/v1.7)分支的提交上建的。
然而1.7.0 目是在建[`v1.7.0`](https://github.com/go-gitea/gitea/releases/tag/v1.7.0)标签时创建的构建。
然而1.7.0 目是在建[`v1.7.0`](https://github.com/go-gitea/gitea/releases/tag/v1.7.0)標籤時建立的構建。
意味 1.x 的下载会随着提交合到各自的分支而改变(将其视为每个版本的单独的“main”分支
意味 1.x 的下載會隨著提交合到各自的分支而改變(將其視為每個版本的單獨的“main”分支
另一方面1.x.x 的下载应该永远不会改变
另一方面1.x.x 的下載應該永遠不會改變
## 如何 Gogs/GitHub 等移到 Gitea
## 如何 Gogs/GitHub 等移到 Gitea
Gogs 移到 Gitea
Gogs 移到 Gitea
- [Gogs 版本 0.11.46.0418](https://github.com/go-gitea/gitea/issues/4286)
GitHub 移到 Gitea您可以使用 Gitea 置的移表
GitHub 移到 Gitea您可以使用 Gitea 置的移表
为了迁移诸如问题、拉取求等项目,您需要至少入您的用户名
為了遷移諸如問題、拉取求等專案,您需要至少入您的使用者名稱
[Example (requires login)](https://demo.gitea.com/repo/migrate)
GitLab 移到 Gitea您可以使用这个非关联的工具:
GitLab 移到 Gitea您可以使用這個非關聯的工具:
https://github.com/loganinak/MigrateGitlabToGogs
## Gitea 存储文件的位置
<a id="where-does-gitea-store-what-file"></a>
<a id="Gitea儲存文件的位置"></a>
## Gitea 儲存文件的位置
- _`AppWorkPath`_
- `--work-path`标志
- 或者环境变`GITEA_WORK_DIR`
- 或者在构建时设置的内置值
- 或者包含 Gitea 二制文件的目
- `%(APP_DATA_PATH)`数据库、索引器等的默认路径
- `--work-path`標誌
- 或者環境變`GITEA_WORK_DIR`
- 或者在構建時設定的內置值
- 或者包含 Gitea 二制文件的目
- `%(APP_DATA_PATH)`資料庫、索引器等的預設路徑
- `app.ini`中的`APP_DATA_PATH`
- 或者*`AppWorkPath`*`/data`
- _`CustomPath`_定义模板)
- `--custom-path`标志
- 或者环境变`GITEA_CUSTOM`
- 或者在构建时设置的内置值
- _`CustomPath`_模板)
- `--custom-path`標誌
- 或者環境變`GITEA_CUSTOM`
- 或者在構建時設定的內置值
- 或者*`AppWorkPath`*`/custom`
- HomeDir
- Unix环境变`HOME`
- Windows环境变`USERPROFILE`,或者环境变`HOMEDRIVE`+`HOMEPATH`
- Unix環境變`HOME`
- Windows環境變`USERPROFILE`,或者環境變`HOMEDRIVE`+`HOMEPATH`
- RepoRootPath
- `app.ini`中\[repository]部分的`ROOT`(如果是绝对路径
-*`AppWorkPath`*`/ROOT`(如果`app.ini`中\[repository]部分的`ROOT`是相对路径
- 默认值为`%(APP_DATA_PATH)/gitea-repositories`
- INI配置文件)
- `--config`标志
- 或者在构建时设置的可能置值
- `app.ini`中\[repository]部分的`ROOT`(如果是絕對路徑
-*`AppWorkPath`*`/ROOT`(如果`app.ini`中\[repository]部分的`ROOT`是相對路徑
- 預設值為`%(APP_DATA_PATH)/gitea-repositories`
- INI設定文件)
- `--config`標誌
- 或者在構建時設定的可能置值
- 或者 _`CustomPath`_`/conf/app.ini`
- SQLite 数据库
- SQLite 資料庫
- app.ini 中 database 部分的 PATH
- 或者`%(APP_DATA_PATH)/gitea.db`
## 看不到克隆 URL 或克隆 URL 不正
## 看不到克隆 URL 或克隆 URL 不正
几个地方可能会导致显示不正
幾個地方可能會導致顯示不正
1. 如果使用反向代理,请确保按照[反向代理指南](../administration/reverse-proxies.md)中的正确说明进行设置
2. 保在`app.ini``server`部分中正确设置`ROOT_URL`
1. 如果使用反向代理,請確保按照[反向代理指南](../administration/reverse-proxies.md)中的正確說明進行設定
2. 保在`app.ini``server`部分中正確設定`ROOT_URL`
如果某些克隆选项未显HTTP/S 或 SSH可以在`app.ini中`
如果某些克隆選項未顯HTTP/S 或 SSH可以在`app.ini中`
- `DISABLE_HTTP_GIT`: 如果设为 true, 将会没有 HTTP/HTTPS
- `DISABLE_SSH`: 如果设为 true, 将会没有 SSH
- `SSH_EXPOSE_ANONYMOUS`: 如果设为 false, SSH 链接将会对匿名用户隐
- `DISABLE_HTTP_GIT`: 如果設為 true, 將會沒有 HTTP/HTTPS
- `DISABLE_SSH`: 如果設為 true, 將會沒有 SSH
- `SSH_EXPOSE_ANONYMOUS`: 如果設為 false, SSH 鏈接將會對匿名使用者隱
## 文件上传失败413 Request Entity Too Large
## 文件上傳失敗413 Request Entity Too Large
反向代理限制文件上大小时,会出现此错误
反向代理限制文件上大小時,會出現此錯誤
使用 nginx 解决此问题,请参阅[反向代理指南](../administration/reverse-proxies.md)。
使用 nginx 解決此問題,請參閱[反向代理指南](../administration/reverse-proxies.md)。
## 自定义模板法加载或运行错误
## 自模板法加載或運行錯誤
Gitea 的自定义模板必须将其添加到正的位置,否 Gitea 将无法找到使用自定义模板。
Gitea 的自模板必須將其添加到正的位置,否 Gitea 將無法找到使用自模板。
模板的正确路径应该相对于`CustomPath`
模板的正確路徑應該相對於`CustomPath`
1. 要找到`CustomPath`在站管理 -> 配置 中查找自定义文件根路
1. 要找到`CustomPath`在站管理 -> 設定 中查找自文件根路
如果找不到,请尝试`echo $GITEA_CUSTOM`
如果找不到,請嘗試`echo $GITEA_CUSTOM`
2. 如果仍然找不到,默认值可以被[计算](faq.md#Gitea存储文件的位置)
3. 如果仍然找不到路径,则可以考[定义 Gitea](../administration/customizing-gitea.md)面,模板添加到正的位置。
2. 如果仍然找不到,預設值可以被計算
3. 如果仍然找不到路徑,則可以考[ Gitea](../administration/customizing-gitea.md)面,模板添加到正的位置。
## Gitea 是否有"GitHub/GitLab Pages"功能?
Gitea 不提供置的 Pages 服器。您需要一个专用的域名提供静态页面,以避免 CSRF 安全风险
Gitea 不提供置的 Pages 服器。您需要一個專用的域名提供靜態頁面,以避免 CSRF 安全風險
对于简单的用法,您可以使用反向代理来重写和提供 Gitea 的原始文件 URL 中的静态内容。
對於簡單的用法,您可以使用反向代理來重寫和提供 Gitea 的原始文件 URL 中的靜態內容。
有一些已可用的第三方服,比如立[pages server](https://codeberg.org/Codeberg/pages-server)的或[caddy plugin](https://github.com/42wim/caddy-gitea),可以提供所需的功能。
有一些已可用的第三方服,比如立[pages server](https://codeberg.org/Codeberg/pages-server)的或[caddy plugin](https://github.com/42wim/caddy-gitea),可以提供所需的功能。
## 活跃用户与禁止登录用户
## 活躍使用者與禁止登入使用者
在 Gitea 中,"活跃用户"是指通过电子邮件激活其帐户的用户
在 Gitea 中,"活躍使用者"是指通過電子郵件激活其帳戶的使用者
"禁止登录用户"是指不允再登到 Gitea 的用户
"禁止登入使用者"是指不允再登到 Gitea 的使用者
## 设置日志记录
## 設定日誌記錄
- [官方文](../administration/logging-config.md)
- [官方文](../administration/logging-config.md)
## 什是 Swagger
## 什是 Swagger
[Swagger](https://swagger.io/) 是 Gitea 用其 API 文的工具。
[Swagger](https://swagger.io/) 是 Gitea 用其 API 文的工具。
所有 Gitea 例都有置的 API法完全禁用它。
但是,您可以在 app.ini 的 api 部分 ENABLE_SWAGGER 设置为 false以禁用其文档显示。
更多信息,请参阅 Gitea 的[API 文](development/api-usage.md)。
所有 Gitea 例都有置的 API法完全禁用它。
但是,您可以在 app.ini 的 api 部分 ENABLE_SWAGGER 設定為 false以禁用其文件顯示。
更多資訊,請參閱 Gitea 的[API 文](development/api-usage.md)。
您可以在上查看最新的 API例如https://gitea.com/api/swagger
可以在上查看`swagger.json`文件的例 https://gitea.com/swagger.v1.json
可以在上查看`swagger.json`文件的例 https://gitea.com/swagger.v1.json
## 调整服务器用公共/私有使用
## 調整伺服器用公共/私有使用
### 防止垃圾邮件发送者
### 防止垃圾郵件發送者
有多方法可以合使用防止垃圾邮件发送者:
有多方法可以合使用防止垃圾郵件發送者:
1.过设置电子邮件域名的白名或黑名
2.过设置一些域名或者 OpenID 白名单(见下文)。
3. 在您的`app.ini``ENABLE_CAPTCHA`设置为`true`并正确配置`RECAPTCHA_SECRET``RECAPTCHA_SITEKEY`
4. `DISABLE_REGISTRATION`设置为`true`并通过 [CLI](../administration/command-line.md)、[API](development/api-usage.md) 或 Gitea 的管理界面创建新用户
1.過設定電子郵件域名的白名或黑名
2.過設定一些域名或者 OpenID 白名單(見下文)。
3. 在您的`app.ini``ENABLE_CAPTCHA`設定為`true`並正確設定`RECAPTCHA_SECRET``RECAPTCHA_SITEKEY`
4. `DISABLE_REGISTRATION`設定為`true`並通過 [CLI](../administration/command-line.md)、[API](development/api-usage.md) 或 Gitea 的管理介面建立新使用者
### 仅允许/阻止特定的电子邮件域名
### 僅允許/阻止特定的電子郵件域名
您可以在`app.ini`中的`[service]`下的配置`EMAIL_DOMAIN_WHITELIST``EMAIL_DOMAIN_BLOCKLIST`
您可以在`app.ini`中的`[service]`下的設定`EMAIL_DOMAIN_WHITELIST``EMAIL_DOMAIN_BLOCKLIST`
### 仅允许/阻止特定的 OpenID 提供商
### 僅允許/阻止特定的 OpenID 提供商
您可以在`app.ini``[openid]`配置`WHITELISTED_URI``BLACKLISTED_URIS`
您可以在`app.ini``[openid]`設定`WHITELISTED_URI``BLACKLISTED_URIS`
**注意** 白名单优先,如果白名非空,忽略黑名
**注意** 白名單優先,如果白名非空,忽略黑名
### 仅允许发布问题的用户
### 僅允許發佈問題的使用者
目前实现这一点的方法是建/修改一具有最大仓库创建限制 0 的用户
目前實現這一點的方法是建/修改一具有最大儲存庫建立限制 0 的使用者
### 受限制的用户
### 受限制的使用者
受限制的用户仅能访问其组织/团队成员和协作所在的容的子集,而忽略组织/仓库等的公共标志
受限制的使用者僅能訪問其組織/團隊成員和協作所在的容的子集,而忽略組織/儲存庫等的公共標誌
例用例:一公司行一需要登的 Gitea 例。大多数仓库是公的(所有同事都可以访问/浏览)。
例用例:一公司行一需要登的 Gitea 例。大多數儲存庫是公的(所有同事都可以訪問/瀏覽)。
在某些情下,某个客户或第三方需要访问特定的仓库,并且只能访问该仓库。通过将此类客户帐户设置为受限制帐户,并使用团队成员身份和/或协作来授予所需的任何访问权限,可以简单地实现这一点,而需使所有容都变为私有。
在某些情下,某個客戶或第三方需要訪問特定的儲存庫,並且只能訪問該儲存庫。通過將此類客戶帳戶設定為受限制帳戶,並使用團隊成員身份和/或協作來授予所需的任何存取權限,可以簡單地實現這一點,而需使所有容都變為私有。
### 用 Fail2ban
### 用 Fail2ban
使用 [Fail2Ban](../administration/fail2ban-setup.md) 监视并阻止基于日志模式的自动登录尝试或其他意行
使用 [Fail2Ban](../administration/fail2ban-setup.md) 監視並阻止基於日誌模式的自動登入嘗試或其他意行
## SSHD vs 建 SSH
## SSHD vs 建 SSH
SSHD 是大多 Unix 系统上内建的 SSH 服器。
SSHD 是大多 Unix 系統上內建的 SSH 服器。
Gitea 提供了自己的 SSH 服器,用在 SSHD 不可用使用。
Gitea 提供了自己的 SSH 服器,用在 SSHD 不可用使用。
## Gitea 运行缓
## Gitea 運行緩
致此问题的最常原因是加载联合头像。
致此問題的最常原因是加載聯合頭像。
您可以通过`app.ini``ENABLE_FEDERATED_AVATAR`设置为`false`来关闭此功能。
您可以透過`app.ini``ENABLE_FEDERATED_AVATAR`設定為`false`來關閉此功能。
有一可能需要更改的选项是在`app.ini``DISABLE_GRAVATAR`设置为`true`
有一可能需要更改的選項是在`app.ini``DISABLE_GRAVATAR`設定為`true`
## 无法创建仓库/文件
## 無法建立儲存庫/文件
请确保 Gitea 具有足够的权限来写入其主目录和数据目录
請確保 Gitea 具有足夠的權限來寫入其主目錄和資料目錄
参见[AppDataPath 和 RepoRootPath](faq.md#Gitea存储文件的位置)
參見AppDataPath 和 RepoRootPath
**适用于 Arch 用户的注意事**在撰本文Arch 软件包的 systemd 文件包含了以下行:
**適用於 Arch 使用者的注意事**在撰本文Arch 套件的 systemd 文件包含了以下行:
`ReadWritePaths=/etc/gitea/app.ini`
这将使得 Gitea 无法写入其他路
這將使得 Gitea 無法寫入其他路
## 翻不正/如何添加更多翻
## 翻不正/如何添加更多翻
们当前的翻是在我的[Crowdin 项目](https://crowdin.com/project/gitea)上众包进行的
們當前的翻是在我的[Crowdin 專案](https://crowdin.com/project/gitea)上眾包進行的
无论您想要更改翻译还是添加新的翻,都需要在 Crowdin 集成中进行,因所有翻译都会被 CI 覆
無論您想要更改翻譯還是添加新的翻,都需要在 Crowdin 整合中進行,因所有翻譯都會被 CI 覆
## 推送子/ Webhook / Actions 未
## 推送子/ Webhook / Actions 未
如果您可以推送但法在主页仪表板上看到推送活,或者推送不触发 Webhook 和 Actions可能是 git 子不工作而致的。
如果您可以推送但法在主頁儀表板上看到推送活,或者推送不觸發 Webhook 和 Actions可能是 git 子不工作而致的。
可能是由以下原因:
可能是由以下原因:
1. Git 子不同步:在站管理面板上行“重新同步所有仓库的 pre-receive、update 和 post-receive 子”
2. Git 仓库(和子)存在一些不支持脚本执行的文件系上(例如由 NAS 挂载),请确保文件系统支持`chmod a+x any-script`
3. 如果您使用的是 Docker请确保 Docker Server而不是客端)的版本 >= 20.10.6
1. Git 子不同步:在站管理面板上行“重新同步所有儲存庫的 pre-receive、update 和 post-receive 子”
2. Git 儲存庫(和子)存在一些不支援腳本執行的文件系上(例如由 NAS 掛載),請確保文件系統支援`chmod a+x any-script`
3. 如果您使用的是 Docker請確保 Docker Server而不是客端)的版本 >= 20.10.6
## SSH 问题
## SSH 問題
如果法通`ssh`访问仓库,但`https`正常工作,请考虑以下情
如果法通`ssh`訪問儲存庫,但`https`正常工作,請考慮以下情
首先,请确保您可以通过 SSH 访问 Gitea。
首先,請確保您可以透過 SSH 訪問 Gitea。
`ssh git@myremote.example`
如果接成功,您应该会收到以下错误消息:
如果接成功,您應該會收到以下錯誤消息:
```
Hi there, You've successfully authenticated, but Gitea does not provide shell access.
If this is unexpected, please log in with password and setup Gitea under another user.
```
如果您收到以上消息但仍然接成功,意味您的 SSH 密**有**由 Gitea 管理。意味着钩子不会运行,在其他一些潜在问题中也包括在
如果您收到以上消息但仍然接成功,意味您的 SSH 密**有**由 Gitea 管理。意味著鉤子不會運行,在其他一些潛在問題中也包括在
如果您无法连接,可能是因您的 SSH 密在本地配置不正
这是针对 SSH 而不是 Gitea 的问题,因此在此不涉及。
如果您無法連接,可能是因您的 SSH 密在本地設定不正
這是針對 SSH 而不是 Gitea 的問題,因此在此不涉及。
### SSH 常见错误
### SSH 常見錯誤
```
Permission denied (publickey).
fatal: Could not read from remote repository.
```
错误表示服务器拒绝登录尝试
请检查以下事
錯誤表示伺服器拒絕登入嘗試
請檢查以下事
- 在客端:
- 保公和私已添加到正的 Gitea 用户
- 确保远程 URL 中有任何问题。特是,请确保 ∂
Git 用户@ 之前的部分)的名称拼写正确
- 保客户端机器上的公和私钥正确无误
- 在服器上:
- 在客端:
- 保公和私已添加到正的 Gitea 使用者
- 確保遠程 URL 中有任何問題。特是,請確保 ∂
Git 使用者@ 之前的部分)的名稱拼寫正確
- 保客戶端機器上的公和私鑰正確無誤
-服器上:
- 确保存储库存在且命名正
- 查系统用户主目中的 `.ssh`录的权限。
- 验证正确的公是否已添加到 `.ssh/authorized_keys` 中。
- 確保儲存庫存在且命名正
- 查系統使用者主目中的 `.ssh`錄的權限。
- 驗證正確的公是否已添加到 `.ssh/authorized_keys` 中。
尝试在 Gitea 管理面板上
嘗試在 Gitea 管理面板上
`Rewrite '.ssh/authorized_keys' file (for Gitea SSH keys)`
- 查看 Gitea 日
- 查看 /var/log/auth似的文件)。
- 检查存储库的权限。
- 查看 Gitea 日
- 查看 /var/log/auth似的文件)。
- 檢查儲存庫的權限。
以下是一个示例,其中缺少公共 SSH 密
认证成功,但是其他设置导致 SSH 无法访问正确
存储库
以下是一個範例,其中缺少公共 SSH 密
認證成功,但是其他設定導致 SSH 無法訪問正確
儲存庫
```
fatal: Could not read from remote repository.
@@ -274,34 +276,34 @@ Please make sure you have the correct access rights
and the repository exists.
```
这种情况下,请检查以下设置
這種情況下,請檢查以下設定
- 在服器上:
- `git`统用户设置了可用的 shell
- 使用`getent passwd git | cut -d: -f7`进行验证
- 可以使用`usermod``chsh`行修改。
- `.ssh/authorized_keys`中的`gitea serv`命令使用
确的配置文件。
-服器上:
- `git`統使用者設定了可用的 shell
- 使用`getent passwd git | cut -d: -f7`進行驗證
- 可以使用`usermod``chsh`行修改。
- `.ssh/authorized_keys`中的`gitea serv`命令使用
確的設定文件。
## 迁移带有标签的存储库后缺失发布版本
## 遷移帶有標籤的儲存庫後缺失發佈版本
迁移带有所有标签的存储库,您需要执行两个操作:
遷移帶有所有標籤的儲存庫,您需要執行兩個操作:
- 推送标签到存储库
- 推送標籤到儲存庫
```
git push --tags
```
- 在 Gitea 中重新同步所有存储库的标签
- 在 Gitea 中重新同步所有儲存庫的標籤
```
gitea admin repo-sync-releases
```
## LFS 问题
## LFS 問題
针对涉及 LFS 数据上传的问题
針對涉及 LFS 資料上傳的問題
```
batch response: Authentication required: Authorization error: <GITEA_LFS_URL>/info/lfs/objects/batch
@@ -309,125 +311,125 @@ Check that you have proper access to the repository
error: failed to push some refs to '<GIT_REPO_URL>'
```
`app.ini`文件中的`LFS_HTTP_AUTH_EXPIRY`值。
`app.ini`文件中的`LFS_HTTP_AUTH_EXPIRY`值。
默认情况LFS 令牌在 20 分钟后过期。如果您的接速度慢或文件大(或者都是),可能法在时间限制完成上
預設情況LFS 令牌在 20 分鐘後過期。如果您的接速度慢或文件大(或者都是),可能法在時間限制完成上
您可以此值设置为`60m``120m`
您可以此值設定為`60m``120m`
## 如何在启动 Gitea 之前创建用户
## 如何在啟動 Gitea 之前建立使用者
Gitea 提供了一子命令`gitea migrate`初始化数据库,然您可以使用[管理 CLI 命令](../administration/command-line.md#admin)像正常情下添加用户
Gitea 提供了一子命令`gitea migrate`初始化資料庫,然您可以使用[管理 CLI 命令](../administration/command-line.md#admin)像正常情下添加使用者
## 如何用密重置
## 如何用密重置
有密重置的设置。当配置了[件服](../administration/email-setup.md),密重置将自动启用;否则将被禁用。
有密重置的設定。當設定了[件服](../administration/email-setup.md),密重置將自動啟用;否則將被禁用。
## 如何更改用户的密
## 如何更改使用者的密
-管理,您可以更改任何用户的密码(并可选择强制其在下次登录时更改密...
- 到您的`站管理 -> 用户账户`页面并编辑用户
-管理,您可以更改任何使用者的密碼(並可選擇強制其在下次登入時更改密...
- 到您的`站管理 -> 用戶賬戶`頁面並編輯使用者
- 使用[管理 CLI 命令](../administration/command-line.md#admin)。
注意,大多命令需要一[局标志](../administration/command-line.md#全局选项)指向正确的配置
注意,大多命令需要一[域標誌](../administration/command-line.md#全域選項)指向正確的設定
-**用户**,您可以更改密...
-**使用者**,您可以更改密...
- 在您的账户`设置 -> 账户`面(此方法**需要**您知道前密)。
- 使用`忘记密码`接。
- 在您的帳號`設定 -> 帳號`面(此方法**需要**您知道前密)。
- 使用`忘記密碼`接。
如果`忘记密码/账户恢复`面被禁用,请联系管理员配置[件服](../administration/email-setup.md)。
如果`忘記密碼/賬戶恢復`面被禁用,請聯繫管理員設定[件服](../administration/email-setup.md)。
## 为什么我的 Markdown 显示错误
## 為什麼我的 Markdown 顯示錯誤
在 Gitea 版本 `1.11` 中,我们转换为使用[goldmark](https://github.com/yuin/goldmark)行 Markdown 渲染,它符合[CommonMark](https://commonmark.org/)标准
在 Gitea 版本 `1.11` 中,我們轉換為使用[goldmark](https://github.com/yuin/goldmark)行 Markdown 渲染,它符合[CommonMark](https://commonmark.org/)標準
如果您在版本`1.11`之前的 Markdown 正常工作,但在升级后无法正常工作,请仔细阅读 CommonMark 规范,看看问题是由错误还是非容的法引起的。
如果您在版本`1.11`之前的 Markdown 正常工作,但在升級後無法正常工作,請仔細閱讀 CommonMark 規範,看看問題是由錯誤還是非容的法引起的。
如果是者,通常规范中会列出一符合标准的替代方法。
如果是者,通常規範中會列出一符合標準的替代方法。
## 使用 MySQL 行升级时出现的错误
## 使用 MySQL 行升級時出現的錯誤
如果在使用 MySQL 升 Gitea 收到以下错误
如果在使用 MySQL 升 Gitea 收到以下錯誤
> `ORM engine initialization failed: migrate: do migrate: Error: 1118: Row size too large...`
请运`gitea doctor convert`对数据库中的每个表运`ALTER TABLE table_name ROW_FORMAT=dynamic;`
請運`gitea doctor convert`對資料庫中的每個表運`ALTER TABLE table_name ROW_FORMAT=dynamic;`
潜在问题是默认行格式分配给每个表的索引空
太小。Gitea 要求其表的`ROWFORMAT``DYNAMIC`
潛在問題是預設行格式分配給每個表的索引空
太小。Gitea 要求其表的`ROWFORMAT``DYNAMIC`
如果收到包含`Error 1071: Specified key was too long; max key length is 1000 bytes...`
错误行,表示您正在尝试在使用 ISAM 引擎的表上行 Gitea。管在先前版本的 Gitea 中可能是巧能工作的,但它未得到官方支
您必使用 InnoDB。您应该对数据库中的每个表运`ALTER TABLE table_name ENGINE=InnoDB;`
錯誤行,表示您正在嘗試在使用 ISAM 引擎的表上行 Gitea。管在先前版本的 Gitea 中可能是巧能工作的,但它未得到官方支
您必使用 InnoDB。您應該對資料庫中的每個表運`ALTER TABLE table_name ENGINE=InnoDB;`
## 为什么 Emoji 只显示占位符或单色图
## 為什麼 Emoji 只顯示佔位符或單色圖
Gitea 需要系统或浏览器安其中一受支的 Emoji 字,例如 Apple Color Emoji、Segoe UI Emoji、Segoe UI Symbol、Noto Color Emoji 和 Twemoji Mozilla。通常操作系统应该已经提供了其中一个字体,但特是在 Linux 上,可能需要手动安装它们
Gitea 需要系統或瀏覽器安其中一受支的 Emoji 字,例如 Apple Color Emoji、Segoe UI Emoji、Segoe UI Symbol、Noto Color Emoji 和 Twemoji Mozilla。通常操作系統應該已經提供了其中一個字體,但特是在 Linux 上,可能需要手動安裝它們
## SystemD 和 Docker 上的标准输出日
## SystemD 和 Docker 上的標準輸出日
SystemD 上的标准输出默认会写入日志记录中。您可以尝试使用 `journalctl``journalctl -u gitea``journalctl <path-to-gitea-binary>`查看。
SystemD 上的標準輸出預設會寫入日誌記錄中。您可以嘗試使用 `journalctl``journalctl -u gitea``journalctl <path-to-gitea-binary>`查看。
似地Docker 上的标准输出可以使用`docker logs <container>`查看。
似地Docker 上的標準輸出可以使用`docker logs <container>`查看。
要收集日志以进行帮助和问题报告,请参阅[支持选项](help/support.md)。
要收集日誌以進行幫助和問題報告,請參閱[支援選項](help/support.md)。
## 初始日志记录
## 初始日誌記錄
在 Gitea 读取配置文件并设置其日志记录之前,它会将一些内容记录到标准输出,以帮助调试日志记录无法工作的情
在 Gitea 讀取設定文件並設定其日誌記錄之前,它會將一些內容記錄到標準輸出,以幫助調試日誌記錄無法工作的情
您可以通过设置`--quiet``-q`选项来停止此日志记录。请注意,这只会在 Gitea 设置自己的日志记录之前停止日志记录
您可以透過設定`--quiet``-q`選項來停止此日誌記錄。請注意,這只會在 Gitea 設定自己的日誌記錄之前停止日誌記錄
如果您告了错误或问题,必提供这些信息以恢初始日志记录
如果您告了錯誤或問題,必提供這些資訊以恢初始日誌記錄
只有在完全配置了所有容之,您才应该设置此选项
只有在完全設定了所有容之,您才應該設定此選項
## 在数据库启动期间出现有关结构默认值的警告
## 在資料庫啟動期間出現有關結構預設值的警告
,在迁移过程中,列和默认值可能在数据库架构中保持不
可能会导致警告,例如:
,在遷移過程中,列和預設值可能在資料庫架構中保持不
可能會導致警告,例如:
```
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 重新创建多个表:
您可以使用以下命令要求 Gitea 重新建立多個表:
```
gitea doctor recreate-table table1 table2 ...
```
如果您希望 Gitea 重新建所有表,使用以下命令:
如果您希望 Gitea 重新建所有表,使用以下命令:
```
gitea doctor recreate-table
```
运行这些命令之前,烈建议您备份数据库
運行這些命令之前,烈建議您備份資料庫
## 为什么查看文件时制表符/缩进显示错误
## 為什麼查看文件時製表符/縮進顯示錯誤
如果您正在使用 Cloudflare请在仪表板中关闭自动缩小选项
如果您正在使用 Cloudflare請在儀表板中關閉自動縮小選項
`Speed` -> `Optimization` -> 在 `Auto-Minify` 设置中取消`HTML`
`Speed` -> `Optimization` -> 在 `Auto-Minify` 設定中取消`HTML`
## 如何从磁盘采用存储库
## 如何從磁盤採用儲存庫
- 您的(裸)存储库添加到正的位置,即您的配置所在的地方(`repository.ROOT`保它们位于正确的布`<REPO_ROOT>/[user]/[repo].git`
- **注意:**目名必须为小写
-可以在`<ROOT_URL>/admin/config`检查存储库根路
- 保存在要采用存储库的用户/组织
-管理员,转`<ROOT_URL>/admin/repos/unadopted`搜索。
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../administration/config-cheat-sheet.md#仓库) 获得类似的限。
- 如果上述步都正确执行,您应该能够选择要采用的存储库
- 如果有找到存储库,请启用[调试日志记录](../administration/config-cheat-sheet.md#仓库)以查是否有特定错误
- 您的(裸)儲存庫添加到正的位置,即您的設定所在的地方(`repository.ROOT`保它們位於正確的佈`<REPO_ROOT>/[user]/[repo].git`
- **注意:**目名必須為小寫
-可以在`<ROOT_URL>/admin/config`檢查儲存庫根路
- 保存在要採用儲存庫的使用者/組織
-管理員,轉`<ROOT_URL>/admin/repos/unadopted`搜索。
- 使用者也可以透過設定[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../administration/config-cheat-sheet.md) 獲得類似的限。
- 如果上述步都正確執行,您應該能夠選擇要採用的儲存庫
- 如果有找到儲存庫,請啟用[調試日誌記錄](../administration/config-cheat-sheet.md)以查是否有特定錯誤

View File

@@ -6,64 +6,64 @@ aliases:
- /zh-tw/seek-help
---
# 支持选项
# 支援選項
- [费商业支持](https://about.gitea.com/)
- [費商業支援](https://about.gitea.com/)
- [Discord](https://discord.gg/Gitea)
- [论坛](https://forum.gitea.com/)
- [論壇](https://forum.gitea.com/)
- [Matrix](https://matrix.to/#/#gitea-space:matrix.org)
- 注意:大多 Matrix 道都 Discord 中的对应频道桥接,可能在桥接过程中会出现一定程度的不定性。
- 中文支
- [Discourse 中文分](https://forum.gitea.com/c/5-category/5)
- 注意:大多 Matrix 道都 Discord 中的對應頻道橋接,可能在橋接過程中會出現一定程度的不定性。
- 中文支
- [Discourse 中文分](https://forum.gitea.com/c/5-category/5)
- QQ 群 328432459
# Bug
# Bug
如果您发现了 Bug在 GitHub 上 [创建一个问题](https://github.com/go-gitea/gitea/issues)。
如果您發現了 Bug在 GitHub 上 [建立一個問題](https://github.com/go-gitea/gitea/issues)。
**注意:**求支持时,可能需要准备以下信息,以便助者得所需的所有信息
**注意:**求支援時,可能需要準備以下資訊,以便助者得所需的所有資訊
1. 您的 `app.ini`任何敏感数据进行必要的清除)。
2. 您看到的任何错误消息。
3. Gitea 日以及与情况相关的所有其他日
- 收集 `trace` / `debug` 级别的日更有用(参见下一)。
- 在使用 systemd ,使用 `journalctl --lines 1000 --unit gitea` 收集日
- 在使用 Docker ,使用 `docker logs --tail 1000 <gitea-container>` 收集日
4. 可重的步,以便他人能更快速、更容易地重和理解问题
- [demo.gitea.com](https://demo.gitea.com) 可用于重现问题
5. 如果遇到慢速/起/死锁等问题,请在出现问题时报告堆栈跟踪
到 "Site Admin" -> "Monitoring" -> "Stacktrace" -> "Download diagnosis report"。
1. 您的 `app.ini`任何敏感資料進行必要的清除)。
2. 您看到的任何錯誤消息。
3. Gitea 日以及與情況相關的所有其他日
- 收集 `trace` / `debug` 級別的日更有用(參見下一)。
- 在使用 systemd ,使用 `journalctl --lines 1000 --unit gitea` 收集日
- 在使用 Docker ,使用 `docker logs --tail 1000 <gitea-container>` 收集日
4. 可重的步,以便他人能更快速、更容易地重和理解問題
- [demo.gitea.com](https://demo.gitea.com) 可用於重現問題
5. 如果遇到慢速/起/死鎖等問題,請在出現問題時報告堆棧跟蹤
到 "Site Admin" -> "Monitoring" -> "Stacktrace" -> "Download diagnosis report"。
# 高 Bug 告提示
# 高 Bug 告提示
## 更多日志的配置选项
## 更多日誌的設定選項
默认情况下,日`info` 级别输出到控制
如果您需要设置日志级别和/或文件中收集日
您只需以下配置复制到您的 `app.ini` 中(除所有其他 `[log]` 部分),
后您将在 Gitea 的日志目录中找到 `*.log` 文件(默认为 `%(GITEA_WORK_DIR)/log`)。
預設情況下,日`info` 級別輸出到控制
如果您需要設定日誌級別和/或文件中收集日
您只需以下設定複製到您的 `app.ini` 中(除所有其他 `[log]` 部分),
後您將在 Gitea 的日誌目錄中找到 `*.log` 文件(預設為 `%(GITEA_WORK_DIR)/log`)。
```ini
; 要示所有 SQL 日,您可以在 [database] 部分中置 LOG_SQL=true
; 要示所有 SQL 日,您可以在 [database] 部分中置 LOG_SQL=true
[log]
LEVEL=debug
MODE=console,file
```
## 使用命令行收集堆栈跟踪
## 使用命令行收集堆棧跟蹤
Gitea 可以使用 Golang 的 pprof 理程和工具链来收集堆栈跟踪和其他运行时信息
Gitea 可以使用 Golang 的 pprof 理程和工具鏈來收集堆棧跟蹤和其他運行時資訊
如果 Web UI 停止工作,您可以尝试通过命令行收集堆栈跟踪
如果 Web UI 停止工作,您可以嘗試通過命令行收集堆棧跟蹤
1. 设置 app.ini
1. 設定 app.ini
```
[server]
ENABLE_PPROF = true
```
2. 重新启动 Gitea
2. 重新啟動 Gitea
3. 尝试触发 bug当请求卡住一段时间,使用或浏览器访问:获取堆栈跟踪
3. 嘗試觸發 bug當請求卡住一段時間,使用或瀏覽器訪問:獲取堆棧跟蹤
`curl http://127.0.0.1:6060/debug/pprof/goroutine?debug=1`