当前中文文档翻译不是最新版，访问英文版本查看最新内容，或帮助我们翻译

反向代理

使用 Nginx 作为反向代理服务

如果您想使用 Nginx 作为 Gitea 的反向代理服务，您可以参照以下 nginx.conf 配置中 server 的 http 部分：

  1. server {
  2.     listen 80;
  3.     server_name git.example.com;
  5.     location / {
  6.         proxy_pass http://localhost:3000;
  7.         proxy_set_header Host $host;
  8.         proxy_set_header X-Real-IP $remote_addr;
  9.         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  10.         proxy_set_header X-Forwarded-Proto $scheme;
  11.     }
  12. }

使用 Nginx 作为反向代理服务并将 Gitea 路由至一个子路径

如果您已经有一个域名并且想与 Gitea 共享该域名，您可以增加以下 nginx.conf 配置中 server 的 http 部分，为 Gitea 添加路由规则：

  1. server {
  2.     listen 80;
  3.     server_name git.example.com;
  5.     # 注意: /git/ 最后需要有一个路径符号
  6.     location /git/ {
  7.         # 注意: 反向代理后端 URL 的最后需要有一个路径符号
  8.         proxy_pass http://localhost:3000/;
  9.         proxy_set_header Host $host;
  10.         proxy_set_header X-Real-IP $remote_addr;
  11.         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  12.         proxy_set_header X-Forwarded-Proto $scheme;
  13.     }
  14. }

然后您必须在 Gitea 的配置文件中正确的添加类似 [server] ROOT_URL = http://git.example.com/git/ 的配置项。

使用 Apache HTTPD 作为反向代理服务

如果您想使用 Apache HTTPD 作为 Gitea 的反向代理服务，您可以为您的 Apache HTTPD 作如下配置（在 Ubuntu 中，配置文件通常在 /etc/apache2/httpd.conf 目录下）：

  1. <VirtualHost *:80>
  2.     ...
  3.     ProxyPreserveHost On
  4.     ProxyRequests off
  5.     AllowEncodedSlashes NoDecode
  6.     ProxyPass / http://localhost:3000/ nocanon
  7. </VirtualHost>

注：必须启用以下 Apache HTTPD 组件：proxy， proxy_http

使用 Apache HTTPD 作为反向代理服务并将 Gitea 路由至一个子路径

如果您已经有一个域名并且想与 Gitea 共享该域名，您可以增加以下配置为 Gitea 添加路由规则（在 Ubuntu 中，配置文件通常在 /etc/apache2/httpd.conf 目录下）：

  1. <VirtualHost *:80>
  2.     ...
  3.     <Proxy *>
  4.          Order allow,deny
  5.          Allow from all
  6.     </Proxy>
  7.     AllowEncodedSlashes NoDecode
  8.     # 注意: 路径和 URL 后面都不要写路径符号 '/'
  9.     ProxyPass /git http://localhost:3000 nocanon
  10. </VirtualHost>

然后您必须在 Gitea 的配置文件中正确的添加类似 [server] ROOT_URL = http://git.example.com/git/ 的配置项。

注：必须启用以下 Apache HTTPD 组件：proxy， proxy_http

使用 Caddy 作为反向代理服务

如果您想使用 Caddy 作为 Gitea 的反向代理服务，您可以在 Caddyfile 中添加如下配置：

  1. git.example.com {
  2.     proxy / http://localhost:3000
  3. }

使用 Caddy 作为反向代理服务并将 Gitea 路由至一个子路径

如果您已经有一个域名并且想与 Gitea 共享该域名，您可以在您的 Caddyfile 文件中增加以下配置，为 Gitea 添加路由规则：

  1. git.example.com {
  2.     # 注意: 路径 /git/ 最后需要有路径符号
  3.     proxy /git/ http://localhost:3000
  4. }

然后您必须在 Gitea 的配置文件中正确的添加类似 [server] ROOT_URL = http://git.example.com/git/ 的配置项。

使用 Traefik 作为反向代理服务

如果您想使用 traefik 作为 Gitea 的反向代理服务，您可以在 docker-compose.yaml 中添加 label 部分（假设使用 docker 作为 traefik 的 provider）：

  1. gitea:
  2.   image: gitea/gitea
  3.   ...
  4.   labels:
  5.     - "traefik.enable=true"
  6.     - "traefik.http.routers.gitea.rule=Host(`example.com`)"
  7.     - "traefik.http.services.gitea-websecure.loadbalancer.server.port=3000"

这份配置假设您使用 traefik 来处理 HTTPS 服务，并在其和 Gitea 之间使用 HTTP 进行通信。