在虚拟目录中部署 ASP.NET Core 应用

ASP.NET Core 已经发布了 2.0 RC1 (Go Live) 版本, API 已经不在变化, 但是很多人期待的已久的在虚拟目录中部署的功能还是没有出现, 看来只能自己想办法解决这个问题了。

由于 ASP.NET Core 有自己的服务器进程 (kestrel) , 在部署时通常是采用反向代理转发的形式, 对于应用服务器的集成上, 不如传统的 ASP.NET 应用那么友好, 比如在应用服务器的虚拟目录中部署, 一直没有很好的方案。

ASP.NET Core 有一个 UsePathBase 扩展方法, 使用一个中间件向当前 http 请求中添加或者移除根路径 (Pathbase) , 利用这个方法, 添加虚拟路径也就不难实现。

首先来定义并导出一个名称为 ASPNETCORE_PATHBASE 的环境变量,

export ASPNETCORE_PATHBASE=/MvcTestApp

再在 Startup.cs 文件中的 Configure 方法的最前面, 添加下面的代码, 读取这个环境变量, 将环境变量的值作为 PathBase 中间件, 代码如下所示:

public void Configure(IApplicationBuilder app, IHostingEnvironment env) {
    // 读取环境变量 ASPNETCORE_PATHBASE
    var pathBase = Environment.GetEnvironmentVariable("ASPNETCORE_PATHBASE");
    // 如果 ASPNETCORE_PATHBASE 的值不为空, 则使用 Pathbase 中间件
    if (!string.IsNullOrEmpty(pathBase)) {
        app.UsePathBase(new PathString(pathBase));
        Console.WriteLine("Hosting pathbase: " + pathBase);
    }
}

注意, 一定要在 Configure 方法的最前面调用这个方法, 让 Pathbase 中间件成为第一个处理请求的中间件, 才能正确的模拟虚拟路径。

现在输入命令 dotnet run , 开始运行, 输出如下

Hosting pathbase: /MvcTestApp
Hosting environment: Development
Content root path: /Projects/MvcTestApp
Now listening on: https://localhost:5001
Now listening on: http://localhost:5000
Application started. Press Ctrl+C to shut down.

现在, 可以通过 http://localhost:5000/MvcTestApp/ 来访问这个应用了。

如果使用 Visual Studio 或者 VS Code 进行调试, 则需要修改 Properties 目录下的 launchSettings.json 文件, 为不同的 profile 均添加一个 ASPNETCORE_PATHBASE 环境变量, 如下所示:

{
    "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development",
        "ASPNETCORE_PATHBASE": "/MvcTestApp"
    }
}

部署到生产环境下, 如果需要修改虚拟目录的值, 则只要调整环境变量 ASPNETCORE_PATHBASE 的值就行了, 不需要修改代码。

本博客基于 Tabler CSS 框架, 采用 Jekyll 模板引擎, 使用 Markdown 语法编写。

博客源代码及文章内容采用 AS-IS 协议发布,转载时请 AS-IS 。