Backport #28302 by @yp05327 Close #28287 ## How to test it in local convert Makefile L34 into: ``` cd .tmp/upstream-docs && git clean -f && git reset --hard && git fetch origin pull/28302/head:pr28302 && git switch pr28302 ``` Co-authored-by: yp05327 <576951401@qq.com>tags/v1.21.2
KEY_FILE = key.pem | KEY_FILE = key.pem | ||||
``` | ``` | ||||
请注意,如果您的证书由第三方证书颁发机构签名(即不是自签名的),则 cert.pem 应包含证书链。服务器证书必须是 cert.pem 中的第一个条目,后跟中介(如果有)。不必包含根证书,因为连接客户端必须已经拥有根证书才能建立信任关系。要了解有关配置值的更多信息,请查看 [配置备忘单](../config-cheat-sheet#server-server)。 | |||||
请注意,如果您的证书由第三方证书颁发机构签名(即不是自签名的),则 cert.pem 应包含证书链。服务器证书必须是 cert.pem 中的第一个条目,后跟中介(如果有)。不必包含根证书,因为连接客户端必须已经拥有根证书才能建立信任关系。要了解有关配置值的更多信息,请查看 [配置备忘单](administration/config-cheat-sheet#server-server)。 | |||||
对于“CERT_FILE”或“KEY_FILE”字段,当文件路径是相对路径时,文件路径相对于“GITEA_CUSTOM”环境变量。它也可以是绝对路径。 | 对于“CERT_FILE”或“KEY_FILE”字段,当文件路径是相对路径时,文件路径相对于“GITEA_CUSTOM”环境变量。它也可以是绝对路径。 | ||||
## Enabling/configuring API access | ## Enabling/configuring API access | ||||
By default, `ENABLE_SWAGGER` is true, and | |||||
`MAX_RESPONSE_ITEMS` is set to 50. See [Config Cheat | |||||
Sheet](administration/config-cheat-sheet.md) for more | |||||
information. | |||||
By default, `ENABLE_SWAGGER` is true, and `MAX_RESPONSE_ITEMS` is set to 50. See [Config Cheat Sheet](administration/config-cheat-sheet.md) for more information. | |||||
## Authentication | ## Authentication | ||||
## 开启/配置 API 访问 | ## 开启/配置 API 访问 | ||||
通常情况下, `ENABLE_SWAGGER` 默认开启并且参数 `MAX_RESPONSE_ITEMS` 默认为 50。您可以从 [Config Cheat | |||||
Sheet](administration/config-cheat-sheet.md) 中获取更多配置相关信息。 | |||||
通常情况下, `ENABLE_SWAGGER` 默认开启并且参数 `MAX_RESPONSE_ITEMS` 默认为 50。您可以从 [Config Cheat Sheet](administration/config-cheat-sheet.md) 中获取更多配置相关信息。 | |||||
## 通过 API 认证 | ## 通过 API 认证 | ||||
- 使用 `gitea generate secret` 创建 `SECRET_KEY` 和 `INTERNAL_TOKEN` | - 使用 `gitea generate secret` 创建 `SECRET_KEY` 和 `INTERNAL_TOKEN` | ||||
- 提供所有必要的密钥 | - 提供所有必要的密钥 | ||||
详情参考 [命令行文档](/zh-cn/command-line/) 中有关 `gitea generate secret` 的内容。 | |||||
详情参考 [命令行文档](administration/command-line.md) 中有关 `gitea generate secret` 的内容。 | |||||
### 配置 Gitea 工作路径 | ### 配置 Gitea 工作路径 | ||||
如果您没有使用 Gitea 内置的 SSH 服务器,您还需要通过在管理选项中运行任务 `Update the '.ssh/authorized_keys' file with Gitea SSH keys.` 来重新编写授权密钥文件。 | 如果您没有使用 Gitea 内置的 SSH 服务器,您还需要通过在管理选项中运行任务 `Update the '.ssh/authorized_keys' file with Gitea SSH keys.` 来重新编写授权密钥文件。 | ||||
> 更多经验总结,请参考英文版 [Troubleshooting](/en-us/install-from-binary/#troubleshooting) | |||||
> 更多经验总结,请参考英文版 [Troubleshooting](https://docs.gitea.com/installation/install-from-binary#troubleshooting) | |||||
如果从本页中没有找到你需要的内容,请访问 [帮助页面](help/support.md) | 如果从本页中没有找到你需要的内容,请访问 [帮助页面](help/support.md) |
- `go` @minGoVersion@ 或更高版本,请参阅 [这里](https://golang.org/dl/) | - `go` @minGoVersion@ 或更高版本,请参阅 [这里](https://golang.org/dl/) | ||||
- `node` @minNodeVersion@ 或更高版本,并且安装 `npm`, 请参阅 [这里](https://nodejs.org/zh-cn/download/) | - `node` @minNodeVersion@ 或更高版本,并且安装 `npm`, 请参阅 [这里](https://nodejs.org/zh-cn/download/) | ||||
- `make`, 请参阅 [这里](/zh-cn/hacking-on-gitea/) | |||||
- `make`, 请参阅 [这里](development/hacking-on-gitea.md) | |||||
为了尽可能简化编译过程,提供了各种 [make任务](https://github.com/go-gitea/gitea/blob/main/Makefile)。 | 为了尽可能简化编译过程,提供了各种 [make任务](https://github.com/go-gitea/gitea/blob/main/Makefile)。 | ||||