kestrel web服务默认不开启目录浏览的说明是在官方文档的什么地方

Kestrel 是 ASP.NET Core 的默认 Web 服务器，其默认不开启目录浏览的说明可以在官方文档的以下位置找到：

https://docs.microsoft.com/en-us/aspnet/core/fundamentals/servers/kestrel?view=aspnetcore-5.0#directory-browsing

在该页面的 "Directory browsing" 小节中，明确说明了默认情况下 Kestrel 不开启目录浏览，可以通过设置 `EnableDirectoryBrowsing` 选项来启用此功能。同时也强调了启用目录浏览会增加安全风险。

相关问题

kestrel web服务开启目录浏览

在Kestrel中，您可以使用Microsoft.AspNetCore.StaticFiles包提供的DirectoryBrowser中间件启用目录浏览。

首先，您需要在项目中安装Microsoft.AspNetCore.StaticFiles包。在Visual Studio中，您可以使用NuGet包管理器来安装它。或者，在项目文件中添加以下行，然后运行`dotnet restore`命令：

<ItemGroup>
  <PackageReference Include="Microsoft.AspNetCore.StaticFiles" Version="2.2.0" />
</ItemGroup>

然后，在您的Startup.cs文件中的Configure方法中添加以下代码：

app.UseStaticFiles();

app.UseDirectoryBrowser(new DirectoryBrowserOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(Directory.GetCurrentDirectory(), "wwwroot")),
    RequestPath = "/MyFiles"
});

在上面的代码中，我们使用`UseStaticFiles`方法启用静态文件服务，并使用`UseDirectoryBrowser`方法为wwwroot目录启用目录浏览。`DirectoryBrowserOptions`类中的`FileProvider`属性指定了文件提供程序，它为`PhysicalFileProvider`类型，以便我们指定要浏览的目录。`RequestPath`属性指定了目录浏览器的URL路径。

现在，您可以启动Kestrel服务器并导航到指定的URL路径，以查看wwwroot目录中的文件和子目录。请注意，在生产环境中，我们建议不要启用目录浏览功能，因为它可能会暴露您的应用程序中的敏感文件。

使用Kestrel创建tcp服务器

要使用Kestrel创建TCP服务器，您需要使用`Microsoft.AspNetCore.Server.Kestrel.Transport.Sockets` NuGet包。以下是一个示例，演示如何使用Kestrel创建TCP服务器：

using System;
using System.Net;
using System.Net.Sockets;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Server.Kestrel.Transport.Sockets;

class Program
{
    static async Task Main(string[] args)
    {
        var host = new WebHostBuilder()
            .UseKestrel(options =>
            {
                options.Listen(IPAddress.Any, 1234, listenOptions =>
                {
                    listenOptions.UseConnectionHandler<TcpConnectionHandler>();
                });
            })
            .ConfigureServices(services => services.AddSingleton<TcpConnectionHandler>())
            .Configure(app => app.UseRouting())
            .Build();

        await host.RunAsync();
    }
}

class TcpConnectionHandler : ConnectionHandler
{
    public override async Task OnConnectedAsync(ConnectionContext connection)
    {
        Console.WriteLine($"New client connected: {connection.ConnectionId}");

        while (true)
        {
            var buffer = new byte[1024];
            var result = await connection.Transport.Input.ReadAsync(buffer);
            var input = Encoding.UTF8.GetString(buffer.Slice(0, result.Buffer.Length));
            Console.WriteLine($"Received from client {connection.ConnectionId}: {input}");

            if (result.IsCompleted)
            {
                break;
            }
        }
    }
}

在此示例中，`Listen`方法用于配置Kestrel服务器以侦听TCP连接。使用`UseConnectionHandler`方法指定连接处理程序，该处理程序将处理所有传入的连接。在此示例中，我们使用`TcpConnectionHandler`类作为连接处理程序。在`TcpConnectionHandler`的`OnConnectedAsync`方法中，我们读取来自客户端的数据并打印到控制台上。