AspNetCoreSubdomain 项目使用教程

1. 项目介绍

AspNetCoreSubdomain 是一个用于在 ASP.NET Core 和 ASP.NET Framework MVC 应用程序中实现子域名路由的简单使用库。该库的目标是简化子域名路由的使用，使得开发者可以像处理普通路由一样处理子域名路由。

主要功能

• 子域名路由注册：像注册普通路由一样注册子域名路由。
• 视图中的链接生成：在视图中生成链接时，保持标准的 Razor 语法。
• 控制器中的路由值捕获：在控制器中捕获所有路由值。

重要提示

• 该库目前不支持端点路由（Endpoint Routing）。

2. 项目快速启动

安装

首先，通过 NuGet 安装 AspNetCoreSubdomain 库：

dotnet add package AspNetCoreSubdomain

配置

在 Startup.cs 文件中进行配置：

public void ConfigureServices(IServiceCollection services)
{
    services.AddSubdomains(); // 添加子域名支持
    services.AddMvc(x => x.EnableEndpointRouting = false); // 禁用端点路由
}

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
{
    var hostnames = new[] { "localhost:54575" };
    app.UseMvc(routes =>
    {
        routes.MapRoute(
            hostnames,
            "NormalRoute",
            "{action}",
            new { controller = "SomeController" }
        );

        routes.MapSubdomainRoute(
            hostnames,
            "SubdomainRoute",
            "{controller}", // 子域名参数
            "{action}",
            new { controller = "Home", action = "Action1" }
        );
    });
}

使用

在视图文件（如 cshtml）中生成链接：

<a href="@Url.Action("Action1", "Home")">Hyperlink example</a>

在控制器中捕获路由值：

public class HomeController : Controller
{
    public IActionResult Action1()
    {
        // 处理请求
        return View();
    }
}

3. 应用案例和最佳实践

案例1：多租户应用

在多租户应用中，每个租户可以使用不同的子域名来访问其专属的资源。例如，租户 tenant1 可以通过 tenant1.example.com 访问其资源，而租户 tenant2 可以通过 tenant2.example.com 访问其资源。

案例2：博客和API分离

在一个包含博客和API的Web应用中，可以使用子域名将博客和API分离。例如，博客可以通过 blog.example.com 访问，而API可以通过 api.example.com 访问。

最佳实践

• 避免过度使用子域名：子域名虽然灵活，但过度使用会增加配置和管理的复杂性。
• 确保安全性：在处理子域名路由时，确保安全性，防止恶意请求。

4. 典型生态项目

相关项目

• AspNetCore.RouteAnalyzer：用于分析和调试 ASP.NET Core 路由的工具。
• AspNetCore.Mvc.Routing：提供更多高级路由功能的库。

集成项目

• IdentityServer：用于身份验证和授权的库，可以与 AspNetCoreSubdomain 结合使用，实现基于子域名的身份验证。

通过以上步骤和案例，您可以快速上手并使用 AspNetCoreSubdomain 库来实现子域名路由。