Gitea HTTPS 反向代理配置

1. 环境信息

项目 值
服务器 IP . ..
Nginx 版本 1.27.0
Nginx 配置文件 /usr/local/nginx/webserver/nginx/conf/nginx.conf
Gitea 监听端口 127.0.0.1:3000
Gitea 配置文件 /etc/gitea/app.ini
SSL 证书路径 /home/work/ssl/xinyultd.dpdns.org/xinyultd.dpdns.org_bundle.crt
SSL 密钥路径 /home/work/ssl/xinyultd.dpdns.org/xinyultd.dpdns.org.key
SSL 证书绑定域名 xinyultd.dpdns.org

2. Nginx 配置(443 Server Block)

在 nginx.conf 的 443 ssl server 块中添加以下 location:

nginx 复制代码
server {
    listen       443 ssl;
    server_name  *.*.*.* ;

    ssl_certificate      /home/work/ssl/org_bundle.crt;
    ssl_certificate_key  /home/work/ssl/org.key;
    ssl_protocols        TLSv1.2 TLSv1.3;

    # Gitea 反向代理
    location /gitea/ {
        proxy_pass http://127.0.0.1:3000/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        client_max_body_size 512M;
    }

    # 文档目录(本页面)
    location /doc/ {
        alias /usr/local/nginx/webserver/nginx/html/doc/;
        index index.md;
    }
}

⚠️ 关键说明:

  • proxy_pass http://127.0.0.1:3000/; 末尾的 / 表示将 /gitea/ 前缀剥离后再转发给 Gitea
  • X-Forwarded-Proto $scheme 确保 Gitea 知道外部使用的是 HTTPS
  • client_max_body_size 512M 允许上传较大的 Git 仓库文件

3. Gitea 配置(app.ini)

修改 /etc/gitea/app.ini 中的 [server] 段:

ini 复制代码
[server]
ROOT_URL = https://*.*.*.* /gitea/
HTTP_PORT = 3000
PROTOCOL  = http

⚠️ ROOT_URL 注意事项:

  • 必须以 https:// 开头,与外部访问协议一致
  • 必须包含子路径 /gitea/,且以 / 结尾
  • 修改后需重启 Gitea:systemctl restart gitea

4. 操作步骤总结

bash 复制代码
# 1. 备份原始配置
cp /etc/gitea/app.ini /etc/gitea/app.ini.bak.$(date +%Y%m%d)
cp /usr/local/nginx/webserver/nginx/conf/nginx.conf \
   /usr/local/nginx/webserver/nginx/conf/nginx.conf.bak.$(date +%Y%m%d)

# 2. 修改 Gitea ROOT_URL(如上第3节所示)
vi /etc/gitea/app.ini

# 3. 重启 Gitea
systemctl restart gitea

# 4. 确认 Nginx 443 server block 包含 /gitea/ location(如上第2节所示)
vi /usr/local/nginx/webserver/nginx/conf/nginx.conf

# 5. 测试 Nginx 配置并重载
/usr/local/nginx/webserver/nginx/sbin/nginx -t
/usr/local/nginx/webserver/nginx/sbin/nginx -s reload

# 6. 验证访问
curl -kI https://*.*.*.* /gitea/

相关推荐
沐知全栈开发1 小时前
基于ClinicalTrials公开数据的临床试验分析系统-毕业设计
数据库·课程设计
半杯咖啡半行码1 小时前
Qt 隐式共享(Implicit Sharing)深度解析:机制、陷阱与 Qt6迁移
开发语言·数据库·qt
Nturmoils2 小时前
空值、日期、字符串:业务 SQL 里的函数先跑一遍
数据库
倔强的石头_5 小时前
数据库选型四步法:我把候选从十几个缩到两个
数据库
bksczm19 小时前
Redis Cluster 分片集群详解:槽路由、故障判定与扩缩容
数据库·redis·分布式
黑十20 小时前
FDE 怎么快速搭一个可演示页面?最小前端方案
java·大数据·前端·数据库·人工智能
Databend21 小时前
OpenRaft 自定义 Membership,按部署拓扑选择 Quorum
大数据·数据库·数据分析
Databend21 小时前
用 SQL 排查支付故障,OpenTelemetry 接入 Databend Cloud 实战
大数据·数据库·sql
kyle~21 小时前
SQLite -- 低成本持久化能力
数据库·sqlite
上海潭龙东海科技有限公司1 天前
智慧堆场动态模型三维实时孪生重构智能管控
大数据·网络·数据库·算法·重构