Docker Swarm环境下Nginx HTTPS转HTTP重定向失效问题排查

先理清楚核心问题：在Docker Swarm环境下，请求会先经过Swarm的ingress网络，再流转到Nginx服务，最后到达你的AspNetCore应用。如果Nginx配置没正确处理转发的协议信息，或者AspNetCore没信任代理传递的头信息，重定向逻辑就会失效。下面一步步来解决：

1. 修正Nginx配置 #

根据你的SSL终止位置（Nginx直接处理/Ingress负载均衡处理），配置分两种情况：

情况1：Nginx直接处理SSL证书 #

如果是Nginx负责解密HTTPS请求，配置要监听443端口并直接重定向到HTTP：

server {
    listen 443 ssl;
    server_name your-domain.com;

    # 配置SSL证书路径（建议用Swarm Config挂载证书）
    ssl_certificate /path/to/your/cert.pem;
    ssl_certificate_key /path/to/your/key.pem;

    # 301永久重定向所有HTTPS请求到HTTP
    return 301 http://$server_name$request_uri;
}

server {
    listen 80;
    server_name your-domain.com;

    # 反向代理到AspNetCore服务（Swarm内用服务名访问）
    location / {
        proxy_pass http://your-aspnetcore-service:80;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

情况2：Swarm Ingress处理SSL #

如果是Ingress先解密HTTPS，再以HTTP转发给Nginx，需要通过X-Forwarded-Proto头判断原始请求协议：

server {
    listen 80;
    server_name your-domain.com;

    # 识别原始HTTPS请求，重定向到HTTP
    if ($http_x_forwarded_proto = 'https') {
        return 301 http://$server_name$request_uri;
    }

    # 反向代理到AspNetCore服务
    location / {
        proxy_pass http://your-aspnetcore-service:80;
        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;
    }
}

2. 配置AspNetCore信任代理 #

AspNetCore默认不会信任代理传递的X-Forwarded-*头，必须在Startup.cs里配置信任规则，同时禁用自带的HTTPS重定向：

public void ConfigureServices(IServiceCollection services)
{
    // 配置信任代理传递的协议和IP头
    services.Configure<ForwardedHeadersOptions>(options =>
    {
        options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
        // 信任Swarm内部的私有IP段（生产环境可指定更精确的IP）
        options.KnownProxies.Add(IPAddress.Parse("10.0.0.0/8"));
        options.KnownProxies.Add(IPAddress.Parse("172.16.0.0/12"));
        options.KnownProxies.Add(IPAddress.Parse("192.168.0.0/16"));
    });

    services.AddMvc();
}

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    // 必须在UseMvc前调用，确保先处理代理头
    app.UseForwardedHeaders();

    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    else
    {
        app.UseExceptionHandler("/Home/Error");
        // 禁用HSTS，避免浏览器强制缓存HTTPS规则
        // app.UseHsts();
    }

    // 完全禁用自带的HTTPS重定向，否则会和你的需求冲突
    // app.UseHttpsRedirection();

    app.UseStaticFiles();
    app.UseCookiePolicy();

    app.UseMvc(routes =>
    {
        routes.MapRoute(
            name: "default",
            template: "{controller=Home}/{action=Index}/{id?}");
    });
}

重点提醒：一定要注释掉UseHttpsRedirection()和UseHsts()，否则AspNetCore会自动把HTTP请求重定向回HTTPS，直接抵消你的配置效果。

3. Docker Swarm部署注意事项 #

• 确保Nginx服务和AspNetCore服务加入同一个Swarm Overlay网络，这样Nginx能通过服务名直接访问应用。
• 如果是Nginx处理SSL，用Swarm Config挂载证书文件（比Volume更安全）。
• 如果用Ingress处理SSL，要确保Ingress配置正确传递X-Forwarded-Proto头给Nginx。

4. 最简应用测试步骤 #

你已经准备了Core 2.0最简应用，可以先本地验证配置：

1. 启动AspNetCore容器：docker run -d --name aspnetcore-test -p 5000:80 your-aspnetcore-image
2. 启动Nginx容器，挂载配置并连接到同一网络：docker run -d --name nginx-test --link aspnetcore-test -p 80:80 -p 443:443 -v /local/path/to/nginx.conf:/etc/nginx/nginx.conf nginx
3. 用curl -I https://localhost测试，检查是否返回301重定向到http://localhost。

本地验证通过后，再部署到Swarm环境即可。

内容的提问来源于stack exchange，提问作者Meitsrik