mirror of
https://gitea.com/gitea/docs.git
synced 2026-09-17 19:55:34 +00:00
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]>
This commit is contained in:
@@ -4,7 +4,6 @@ slug: "faq"
|
||||
sidebar_position: 5
|
||||
aliases:
|
||||
- /zh-cn/faq
|
||||
|
||||
---
|
||||
|
||||
# 常见问题
|
||||
@@ -13,128 +12,128 @@ aliases:
|
||||
|
||||
有关更多帮助资源,请查看所有[支持选项](seek-help.md)。
|
||||
|
||||
## 1.x和1.x.x下载之间的区别
|
||||
## 1.x 和 1.x.x 下载之间的区别
|
||||
|
||||
以1.7.x版本为例。
|
||||
以 1.7.x 版本为例。
|
||||
|
||||
**注意:**此示例也适用于Docker镜像!
|
||||
**注意:**此示例也适用于 Docker 镜像!
|
||||
|
||||
在我们的[下载页面](https://dl.gitea.io/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.io/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.9.146或更低](installation/upgrade-from-gogs.md)
|
||||
- [Gogs版本0.11.46.0418](https://github.com/go-gitea/gitea/issues/4286)
|
||||
- [Gogs 版本 0.9.146 或更低](installation/upgrade-from-gogs.md)
|
||||
- [Gogs 版本 0.11.46.0418](https://github.com/go-gitea/gitea/issues/4286)
|
||||
|
||||
要从GitHub迁移到Gitea,您可以使用Gitea内置的迁移表单。
|
||||
要从 GitHub 迁移到 Gitea,您可以使用 Gitea 内置的迁移表单。
|
||||
|
||||
为了迁移诸如问题、拉取请求等项目,您需要至少输入您的用户名。
|
||||
|
||||
[Example (requires login)](https://try.gitea.io/repo/migrate)
|
||||
|
||||
要从GitLab迁移到Gitea,您可以使用这个非关联的工具:
|
||||
要从 GitLab 迁移到 Gitea,您可以使用这个非关联的工具:
|
||||
|
||||
https://github.com/loganinak/MigrateGitlabToGogs
|
||||
|
||||
## Gitea存储文件的位置
|
||||
## Gitea 存储文件的位置
|
||||
|
||||
- _`AppWorkPath`_
|
||||
- `--work-path`标志
|
||||
- 或者环境变量`GITEA_WORK_DIR`
|
||||
- 或者在构建时设置的内置值
|
||||
- 或者包含Gitea二进制文件的目录
|
||||
- 或者包含 Gitea 二进制文件的目录
|
||||
- `%(APP_DATA_PATH)`(数据库、索引器等的默认路径)
|
||||
- `app.ini`中的`APP_DATA_PATH`
|
||||
- 或者_`AppWorkPath`_`/data`
|
||||
- 或者*`AppWorkPath`*`/data`
|
||||
- _`CustomPath`_(自定义模板)
|
||||
- `--custom-path`标志
|
||||
- 或者环境变量`GITEA_CUSTOM`
|
||||
- 或者在构建时设置的内置值
|
||||
- 或者_`AppWorkPath`_`/custom`
|
||||
- 或者*`AppWorkPath`*`/custom`
|
||||
- HomeDir
|
||||
- Unix:环境变量`HOME`
|
||||
- Windows:环境变量`USERPROFILE`,或者环境变量`HOMEDRIVE`+`HOMEPATH`
|
||||
- RepoRootPath
|
||||
- `app.ini`中\[repository]部分的`ROOT`(如果是绝对路径)
|
||||
- 否则_`AppWorkPath`_`/ROOT`(如果`app.ini`中\[repository]部分的`ROOT`是相对路径)
|
||||
- 否则*`AppWorkPath`*`/ROOT`(如果`app.ini`中\[repository]部分的`ROOT`是相对路径)
|
||||
- 默认值为`%(APP_DATA_PATH)/gitea-repositories`
|
||||
- INI(配置文件)
|
||||
- `--config`标志
|
||||
- 或者在构建时设置的可能内置值
|
||||
- 或者 _`CustomPath`_`/conf/app.ini`
|
||||
- SQLite数据库
|
||||
- app.ini中database部分的PATH
|
||||
- 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`。
|
||||
|
||||
如果某些克隆选项未显示(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
|
||||
|
||||
当反向代理限制文件上传大小时,会出现此错误。
|
||||
|
||||
有关使用nginx解决此问题,请参阅[反向代理指南](../administration/reverse-proxies.md)。
|
||||
有关使用 nginx 解决此问题,请参阅[反向代理指南](../administration/reverse-proxies.md)。
|
||||
|
||||
## 自定义模板无法加载或运行错误
|
||||
|
||||
Gitea的自定义模板必须将其添加到正确的位置,否则Gitea将无法找到并使用自定义模板。
|
||||
Gitea 的自定义模板必须将其添加到正确的位置,否则 Gitea 将无法找到并使用自定义模板。
|
||||
|
||||
模板的正确路径应该相对于`CustomPath`。
|
||||
|
||||
1. 要找到`CustomPath`,请在站点管理 -> 配置 中查找自定义文件根路径。
|
||||
|
||||
如果找不到,请尝试`echo $GITEA_CUSTOM`。
|
||||
如果找不到,请尝试`echo $GITEA_CUSTOM`。
|
||||
|
||||
2. 如果仍然找不到,默认值可以被[计算](faq.md#Gitea存储文件的位置)
|
||||
3. 如果仍然找不到路径,则可以参考[自定义Gitea](../administration/customizing-gitea.md)页面,将模板添加到正确的位置。
|
||||
3. 如果仍然找不到路径,则可以参考[自定义 Gitea](../administration/customizing-gitea.md)页面,将模板添加到正确的位置。
|
||||
|
||||
## Gitea是否有"GitHub/GitLab Pages"功能?
|
||||
## 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),可以提供所需的功能。
|
||||
|
||||
## 活跃用户与禁止登录用户
|
||||
|
||||
在Gitea中,"活跃用户"是指通过电子邮件激活其帐户的用户。
|
||||
在 Gitea 中,"活跃用户"是指通过电子邮件激活其帐户的用户。
|
||||
|
||||
"禁止登录用户"是指不允许再登录到Gitea的用户。
|
||||
"禁止登录用户"是指不允许再登录到 Gitea 的用户。
|
||||
|
||||
## 设置日志记录
|
||||
|
||||
- [官方文档](../administration/logging-documentation.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://try.gitea.io/api/swagger
|
||||
您可以在上查看最新的 API(例如)https://try.gitea.io/api/swagger
|
||||
|
||||
您还可以在上查看`swagger.json`文件的示例 https://try.gitea.io/swagger.v1.json
|
||||
|
||||
@@ -145,7 +144,7 @@ Gitea不提供内置的Pages服务器。您需要一个专用的域名来提供
|
||||
有多种方法可以组合使用来防止垃圾邮件发送者:
|
||||
|
||||
1. 通过设置电子邮件域名的白名单或黑名单。
|
||||
2. 通过设置一些域名或者OpenID白名单(见下文)。
|
||||
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 的管理界面创建新用户。
|
||||
|
||||
@@ -186,13 +185,13 @@ Gitea 目前支持三个官方主题,分别是 `gitea`(亮色)、`arc-gree
|
||||
|
||||
通过将`arc-blue`添加到`app.ini`中的`THEMES`列表中,允许用户使用该主题
|
||||
|
||||
## SSHD vs 内建SSH
|
||||
## SSHD vs 内建 SSH
|
||||
|
||||
SSHD是大多数Unix系统上内建的SSH服务器。
|
||||
SSHD 是大多数 Unix 系统上内建的 SSH 服务器。
|
||||
|
||||
Gitea还提供了自己的SSH服务器,用于在SSHD不可用时使用。
|
||||
Gitea 还提供了自己的 SSH 服务器,用于在 SSHD 不可用时使用。
|
||||
|
||||
## Gitea运行缓慢
|
||||
## Gitea 运行缓慢
|
||||
|
||||
导致此问题的最常见原因是加载联合头像。
|
||||
|
||||
@@ -202,35 +201,35 @@ Gitea还提供了自己的SSH服务器,用于在SSHD不可用时使用。
|
||||
|
||||
## 无法创建仓库/文件
|
||||
|
||||
请确保Gitea具有足够的权限来写入其主目录和数据目录。
|
||||
请确保 Gitea 具有足够的权限来写入其主目录和数据目录。
|
||||
|
||||
参见[AppDataPath 和 RepoRootPath](faq.md#Gitea存储文件的位置)
|
||||
|
||||
**适用于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未运行
|
||||
## 推送钩子/ Webhook 未运行
|
||||
|
||||
如果您可以推送但无法在主页仪表板上看到推送活动,或者推送不触发Webhook,有几种可能性:
|
||||
如果您可以推送但无法在主页仪表板上看到推送活动,或者推送不触发 Webhook,有几种可能性:
|
||||
|
||||
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访问Gitea。
|
||||
首先,请确保您可以通过 SSH 访问 Gitea。
|
||||
|
||||
`ssh [email protected]`
|
||||
|
||||
@@ -258,16 +257,18 @@ fatal: Could not read from remote repository.
|
||||
|
||||
- 在客户端:
|
||||
- 确保公钥和私钥已添加到正确的 Gitea 用户。
|
||||
- 确保远程 URL 中没有任何问题。特别是,请确保∂
|
||||
Git 用户(@ 之前的部分)的名称拼写正确。
|
||||
- 确保远程 URL 中没有任何问题。特别是,请确保 ∂
|
||||
Git 用户(@ 之前的部分)的名称拼写正确。
|
||||
- 确保客户端机器上的公钥和私钥正确无误。
|
||||
- 在服务器上:
|
||||
|
||||
- 确保存储库存在并且命名正确。
|
||||
- 检查系统用户主目录中的 `.ssh` 目录的权限。
|
||||
- 验证正确的公钥是否已添加到 `.ssh/authorized_keys` 中。
|
||||
|
||||
尝试在 Gitea 管理面板上运行
|
||||
`Rewrite '.ssh/authorized_keys' file (for Gitea SSH keys)`。
|
||||
|
||||
- 查看 Gitea 日志。
|
||||
- 查看 /var/log/auth(或类似的文件)。
|
||||
- 检查存储库的权限。
|
||||
@@ -339,7 +340,9 @@ Gitea 提供了一个子命令`gitea migrate`来初始化数据库,然后您
|
||||
- 使用[管理 CLI 命令](../administration/command-line.md#admin)。
|
||||
|
||||
请注意,大多数命令还需要一个[全局标志](../administration/command-line.md#全局选项)来指向正确的配置。
|
||||
|
||||
- 作为**用户**,您可以更改密码...
|
||||
|
||||
- 在您的账户的`设置 -> 账户`页面(此方法**需要**您知道当前密码)。
|
||||
- 使用`忘记密码`链接。
|
||||
|
||||
@@ -349,7 +352,7 @@ Gitea 提供了一个子命令`gitea migrate`来初始化数据库,然后您
|
||||
|
||||
在 Gitea 版本 `1.11` 中,我们转换为使用[goldmark](https://github.com/yuin/goldmark)进行 Markdown 渲染,它符合[CommonMark](https://commonmark.org/)标准。
|
||||
|
||||
如果您在版本`1.11`之前的Markdown正常工作,但在升级后无法正常工作,请仔细阅读CommonMark规范,看看问题是由错误还是非兼容的语法引起的。
|
||||
如果您在版本`1.11`之前的 Markdown 正常工作,但在升级后无法正常工作,请仔细阅读 CommonMark 规范,看看问题是由错误还是非兼容的语法引起的。
|
||||
|
||||
如果是后者,通常规范中会列出一种符合标准的替代方法。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user