Umbraco 9.5后台内部用户认证问题求助（反向代理场景）

可能的配置遗漏及修复方案 #

1. 配置Forwarded Headers识别反向代理 #

Umbraco运行在容器中时，无法直接获取客户端的真实请求协议和主机，需要反向代理传递转发头，同时在Umbraco中启用转发头处理：

在Program.cs中添加配置，放在app.UseUmbraco()之前：

builder.Services.Configure<ForwardedHeadersOptions>(options =>
{
    options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
    // 添加反向代理的IP或子网（Docker Swarm overlay网络的子网）
    options.KnownNetworks.Add(new IPNetwork(IPAddress.Parse("10.0.0.0"), 8));
});

// 启用Forwarded Headers中间件
app.UseForwardedHeaders();

也可通过容器环境变量简化配置：设置ASPNETCORE_FORWARDEDHEADERS_ENABLED=true，ASP.NET Core会自动启用转发头处理。

2. 确保认证回调URL使用外部可访问地址 #

检查appsettings.json中Umbraco的认证配置，确保回调URL指向反向代理对外暴露的域名，而非容器内部地址：

"Umbraco": {
  "Cms": {
    "Security": {
      "BackOffice": {
        "LoginPath": "/umbraco/backoffice/login",
        "PostLoginRedirectUrl": "/umbraco/backoffice"
      }
    }
  }
}

3. 调整Cookie的安全配置 #

由于反向代理处理SSL，需确保Umbraco生成的Cookie适配HTTPS环境：

builder.Services.ConfigureApplicationCookie(options =>
{
    options.Cookie.SecurePolicy = CookieSecurePolicy.Always;
    options.Cookie.SameSite = SameSiteMode.Lax;
    // 若有多子域名需求，设置主域名
    options.Cookie.Domain = ".your-domain.com";
});

4. 配置反向代理的请求转发规则 #

以Nginx为例，确保/umbraco路径的请求正确转发，且传递必要的请求头：

location /umbraco {
    proxy_pass http://umbraco-service:80;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $remote_addr;
    proxy_set_header X-Forwarded-Proto $scheme;
    # 适配Umbraco后台的WebSocket需求
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

5. 设置Umbraco的Server URL #

在appsettings.json中指定外部可访问的Server URL，避免Umbraco生成容器内部地址：

"Umbraco": {
  "Cms": {
    "WebRouting": {
      "ServerUrl": "https://your-domain.com"
    }
  }
}

6. 检查Docker容器的端口与URL配置 #

确保Umbraco容器的ASPNETCORE_URLS环境变量设置为http://*:80，允许容器内部监听所有网络接口，而非仅localhost。

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