前言:在部署时踩了不坑,现总结一下,给有需要人避坑,也作为自己的一个笔记,便于以后查阅及参考。
摘要:采用ASP.NET Core 自托管,Nginx反向代理 。
一、ASP.NET Core Blazor发布。
1.ASP.NET Core 自托管用WINDWS 服务来启动,在项目的Program增加以下代码。
#region 网站发布后,将发布生成的EXE安装到 windows系统服务中启动
var options = new WebApplicationOptions
{
Args = args,
ContentRootPath = WindowsServiceHelpers.IsWindowsService()? AppContext.BaseDirectory : default
};
#endregion
var builder = WebApplication.CreateBuilder(args);
#region 网站发布后,将发布生成的EXE安装到 windows系统服务中启动
builder.Host.UseWindowsService();
#endregion
- 解决Nginx反向代理转发到Blazor端口,请求返回在浏览器地址中少了端口。解决该问题,在项目的Program增加以下代码。
#region 修正-由nginx转发到blazor端口时,返回在浏览器地址中少了端口
builder.Services.Configure<ForwardedHeadersOptions>(options =>
{
options.ForwardedHeaders = ForwardedHeaders.XForwardedFor |
ForwardedHeaders.XForwardedProto |
ForwardedHeaders.XForwardedHost; // 新增 XForwardedHost
options.KnownNetworks.Clear();
options.KnownProxies.Clear();
});
#endregion
// Add services to the container.
builder.Services.AddRazorComponents()
.AddInteractiveServerComponents()
.AddInteractiveWebAssemblyComponents();
var app = builder.Build();
#region 修正-由nginx转发到blazor端口时,返回在浏览器地址中少了端口
app.UseForwardedHeaders();
#endregion
二、Nginx反向代理配置。
修改nginx目录的子目录conf下的 “nginx.conf”配置文件。
listen 8080; # 监听 8080 端口
server_name abc.xyz.com ; # 访问站点的域名
location / {
# 反向代理到 Blazor 应用端口(示例端口 5000)
proxy_pass http://localhost:5000;
# 以下配置确保 WebSocket 正常工作(Blazor Server 必需)
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
#
proxy_set_header X-Real-IP $remote_addr;
# 传递客户端真实 IP
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme; # 必需
proxy_set_header X-Forwarded-Host $host:$server_port; # 传递原始端
}
三、将Nginx与发布的ASP.NET Core Blazor作为Windows服务来启动。
1.下载服务管理工具
https://nssm.cc/download
NSSM(Non-Sucking Service Manager)是一款免费开源、轻量级的 Windows 服务管理工具,专注于将普通应用程序(如 EXE、BAT 脚本、Java JAR 文件等)封装为系统服务,使其具备后台运行、开机自启、故障自动恢复等特性。
- 注册nginx服务
以管理员身份打开CMD,执行以下命令:
cd C:\nginx
nssm install Nginx
在弹出的界面中配置:
- 注册ASP.NET Core Blazor站点服务
以管理员身份打开CMD,执行以下命令(例如blazor web app 发布在c:\tmp\publish目录下):
cd c:\tmp\publish
nssm install BlazorWebApp
在弹出的界面中配置:
四:以后操作完后,生启电脑(会自动启刚注册的服务)或都手动到 windows“服务”中启动刚注册的两个服务,就可以打开部署网站了。