mirror of https://codeberg.org/forgejo/forgejo.git synced 2024-11-01 14:59:06 +00:00

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>

2023-12-11 22:53:59 +08:00

4.5 KiB

Raw Blame History

date

title

slug

sidebar_position

toc

draft

2023-04-09T11:00:00+02:00

HTTPS配置

https-setup

false

sidebar

parent	name	sidebar_position	identifier
administration	HTTPS setup	12	https-setup

HTTPS setup to encrypt connections to Gitea

使用内置服务器

在启用HTTPS之前，确保您拥有有效的SSL/TLS证书。建议在测试和评估情况下使用自签名证书，请运行 gitea cert --host [HOST] 以生成自签名证书

如果您在服务器上使用阿帕奇（Apache）或Nginx，建议参考反向代理指南。

要使用Gitea内置HTTPS支持，您必须编辑app.ini文件。

[server]
PROTOCOL  = https
ROOT_URL  = https://git.example.com:3000/
HTTP_PORT = 3000
CERT_FILE = cert.pem
KEY_FILE  = key.pem

请注意，如果您的证书由第三方证书颁发机构签名（即不是自签名的），则 cert.pem 应包含证书链。服务器证书必须是 cert.pem 中的第一个条目，后跟中介（如果有）。不必包含根证书，因为连接客户端必须已经拥有根证书才能建立信任关系。要了解有关配置值的更多信息，请查看配置备忘单。

对于“CERT_FILE”或“KEY_FILE”字段，当文件路径是相对路径时，文件路径相对于“GITEA_CUSTOM”环境变量。它也可以是绝对路径。

设置HTTP重定向

Gitea服务器仅支持监听一个端口；要重定向HTTP请求致HTTPS端口，您需要启用HTTP重定向服务：

[server]
REDIRECT_OTHER_PORT = true
; Port the redirection service should listen on
PORT_TO_REDIRECT = 3080

如果您使用Docker，确保端口已配置在 docker-compose.yml 文件

使用 ACME (默认: Let's Encrypt)

ACME 是一种证书颁发机构标准协议，允许您自动请求和续订 SSL/TLS 证书。Let`s Encrypt 是使用此标准的免费公开信任的证书颁发机构服务器。仅实施“HTTP-01”和“TLS-ALPN-01”挑战。为了使 ACME 质询通过并验证您的域所有权，“80”端口（“HTTP-01”）或“443”端口（“TLS-ALPN-01”）上 gitea 域的外部流量必须由 gitea 实例提供服务。可能需要设置 HTTP 重定向和端口转发才能正确路由外部流量。否则，到端口“80”的正常流量将自动重定向到 HTTPS。您必须同意ACME提供商的服务条款（默认为Let's Encrypt的服务条款。

使用默认 Let's Encrypt 的最小配置如下：

[server]
PROTOCOL=https
DOMAIN=git.example.com
ENABLE_ACME=true
ACME_ACCEPTTOS=true
ACME_DIRECTORY=https
;; Email can be omitted here and provided manually at first run, after which it is cached
ACME_EMAIL=email@example.com

小型配置请使用 smallstep CA, 点击教程了解更多信息。

[server]
PROTOCOL=https
DOMAIN=git.example.com
ENABLE_ACME=true
ACME_ACCEPTTOS=true
ACME_URL=https://ca.example.com/acme/acme/directory
;; Can be omitted if using the system's trust is preferred
;ACME_CA_ROOT=/path/to/root_ca.crt
ACME_DIRECTORY=https
ACME_EMAIL=email@example.com

要了解关于配置, 请访问配置备忘单获取更多信息

使用反向代理服务器

按照 reverse proxy guide 的规则设置你的反向代理服务器

然后，按照下面的向导启用 HTTPS：

注意：仅在代理层启用 HTTPS 被称为 TLS 终止代理。代理服务器接受传入的 TLS 连接，解密内容，然后将现在未加密的内容传递给 Gitea。只要代理和 Gitea 实例在同一台计算机上或在私有网络中的不同计算机上（代理暴露给外部网络），这通常是可以接受的。如果您的 Gitea 实例与代理隔离在公共网络上，或者如果您想要全端到端的加密，您还可以直接在 Gitea 中启用内置服务器的 HTTPS 支持，并将连接转发到 HTTPS 上。

4.5 KiB Raw Blame History Unescape Escape