前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Nginx: 最常见的 2 中 http to https 跳转场景

Nginx: 最常见的 2 中 http to https 跳转场景

作者头像
老麦
发布2023-09-07 10:02:54
1.8K0
发布2023-09-07 10:02:54
举报
文章被收录于专栏:Go与云原生Go与云原生

Nginx: 最常见的 2 中 http to https 跳转场景

建议点击 查看原文 查看最新内容。

原文链接: https://typonotes.com/posts/2023/08/28/nginx-http-https-redirect-scenarios/

1. Nginx 上层无代理, 用户直接访问

这种方式比较简单。

  1. 我们对 http 和 https 都具有控权。
  2. 用户是直接访问 Nginx 服务器。

所以可以直接通过在 http server 上配置到 301 跳转 到 https 服务器即可。

代码语言:javascript
复制
# http server
server {
    listen 80;
    server_name _;
    return 301 https://$host$request_uri;
}

# https server
server {
    listen 443 ssl http2;
    server_name www.example.com;

    # ... other
}

通常, 我个人习惯将两个配置写在同一个文件中。更具体的配置逻辑都放在 https server 中。

2. Nginx 上层有代理

这种情况, 稍微麻烦一点。

  1. 最重要的, 用户并不直接访问我们的 Nginx Server, 而是通过上层代理 Proxy 代理。
  2. 实际提供 HTTPS 服务的其实是上层 Proxy, 且 我们并没有管理权限
  3. 因此, Proxy 在访问 Nginx Server 的时候, 始终使用 HTTP 协议。

这种情况下, 我们直接使用 Nginx 提供的 内置变量 scheme 就行不通了。

代码语言:javascript
复制
# 错误配置
server {
    listen 80;
    server_name _;

    if ($scheme = "http"){
        return 301 https://$host$request_uri; 
    }
}

使用上述配置, 无论用户通过任何协议请求, Nginx Server 拿到的都是 http, 即 条件恒等。结果就是永远在跳转, 直到重定向次数过多而报错。

解决方案就是 使用 Proxy 提供的 Header 进行判断。不同的 Proxy 提供的 Header 名称可能不一样,需要具体分析。

代码语言:javascript
复制
# 可用配置
server {
    listen 80;
    server_name _;

    # ... other

    if ($http_x_forward_scheme = "http"){
        return 301 https://$host$request_uri; 
    }
}

注意: 这里的 http_x_forward_scheme 对应的就是 请求头 中的 X-Forward-Scheme。具体规则参考 3. Nginx 获取 Http Header 规则

3. Nginx 获取 Http Header 规则

Nginx 默认提供了获取 HTTP Header 的方法, 参考文档 Nginx 各种头技巧[1]

这里做一个总结,

3.1 HTTP Header 转 Nginx 变量

默认情况下 变量名遵守以下规则:

  1. 将 Header 名称 **所有大写变小些, 所有 -_**,
  2. 以 http_ 开头
  3. Header 名称不支持 下划线
代码语言:javascript
复制
## 正确
Server-Version => http_server_version
X-Forward-Scheme => http_x_forward_scheme
X-Customize-Header => http_x_customize_header

## 错误
Server_Verver (x)

如果要支持 Header 名称下划线, 需要 额外开启 语法 underscores_in_headers[2]

代码语言:javascript
复制
Syntax: underscores_in_headers on | off;
Default: underscores_in_headers off;
Context: http, server
代码语言:javascript
复制
server {
    underscores_in_headers on;
}

开启之后, 即可使用。

代码语言:javascript
复制
Server_Version => http_server_version

3.2 Header 变量的常规操作

  1. 判断 header 是否存在
代码语言:javascript
复制
server {
    if ( $x_customize_header ){
        # statement
    }
}
  1. 判断 header 值是否预期, 参考 nginx if 语法。
代码语言:javascript
复制
server {
    if ( $x_customize_header = "vscode-client/v1.2" ){
        # statement
    }
}

参考文档

  1. Heroku Routing Header: https://devcenter.heroku.com/articles/http-routing
  2. Nginx 各种头技巧: https://liqiang.io/post/nginx-redirect-with-request-header-3c575166
  3. Nginx配置:读取自定义header + 撰写AND条件 + 修改响应体 + 域名重定向: https://segmentfault.com/a/1190000020852253
  4. Nginx If-Condition: https://blog.xinac.cn/archives/nginx%E9%85%8D%E7%BD%AE%E4%B8%ADifelse%E7%9A%84%E5%AE%9E%E7%8E%B0%E6%96%B9%E6%B3%95.html
  5. Nginx if-is-evil: https://www.nginx.com/resources/wiki/start/topics/depth/ifisevil/
  6. Nginx Creating-Nginx-Rewrite-Rules: https://www.nginx.com/blog/creating-nginx-rewrite-rules/
  7. Nginx 中的 If 判断: https://www.ucloud.cn/yun/40533.html

参考资料

[1]

Nginx 各种头技巧: https://liqiang.io/post/nginx-redirect-with-request-header-3c575166

[2]

语法 underscores_in_headers: http://nginx.org/en/docs/http/ngx_http_core_module.html#underscores_in_headers

本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2023-08-28,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 熊猫云原生Go 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • Nginx: 最常见的 2 中 http to https 跳转场景
    • 1. Nginx 上层无代理, 用户直接访问
      • 2. Nginx 上层有代理
        • 3. Nginx 获取 Http Header 规则
          • 3.1 HTTP Header 转 Nginx 变量
          • 3.2 Header 变量的常规操作
        • 参考文档
          • 参考资料
      领券
      问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档