CKFinder 3.4.2 MVC集成：文件上传配置及Connector疑问求助

Hey Scott, let's break down what you need to do to get file uploads working with CKFinder in your MVC app—no need to manually create that connector folder from your old WebForms project, since MVC uses routing instead of physical directories for this. Here's the step-by-step fix:

1. 理解Connector的差异：WebForms vs MVC #

Your old WebForms project uses a physical connector folder with handler files, but CKFinder 3.x for ASP.NET MVC relies on route mapping to handle file operations. The ckfinderRoute value in your web.config is just the URL path that routes requests to CKFinder's backend logic—you don't need a real folder for it.

2. 配置MVC路由映射 #

You need to register CKFinder's route so your app knows how to handle requests to /connector. Open your RouteConfig.cs (in the App_Start folder) and add this route before your default MVC route to avoid conflicts:

using System.Web.Mvc;
using System.Web.Routing;

public class RouteConfig
{
    public static void RegisterRoutes(RouteCollection routes)
    {
        routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

        // CKFinder route
        routes.MapRoute(
            name: "CKFinder",
            url: "connector/{*pathInfo}",
            defaults: new { controller = "CKFinder", action = "Index" }
        );

        // Default MVC route
        routes.MapRoute(
            name: "Default",
            url: "{controller}/{action}/{id}",
            defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
        );
    }
}

Alternatively, if you're using OWIN, you can register the route via CKFinder's built-in method in Startup.cs:

using CKFinder.Connector.Host.Owin;

public void Configuration(IAppBuilder app)
{
    // Other OWIN configs...
    app.MapCKFinder("/connector");
}

3. 完善web.config配置 #

Make sure your web.config has all the necessary CKFinder settings, including handler registration for IIS and authorization hints:

<appSettings>
    <!-- Keep your existing ckfinderRoute setting -->
    <add key="ckfinderRoute" value="/connector"/>
</appSettings>

<system.web>
    <!-- For IIS Classic Mode -->
    <httpHandlers>
        <add verb="*" path="connector" type="CKFinder.Connector.ConnectorHandler, CKFinder"/>
    </httpHandlers>
</system.web>

<system.webServer>
    <!-- For IIS Integrated Mode (most common) -->
    <handlers>
        <add name="CKFinder" verb="*" path="connector" type="CKFinder.Connector.ConnectorHandler, CKFinder" preCondition="integratedMode"/>
    </handlers>
</system.webServer>

4. 设置CKFinder授权与存储路径 #

CKFinder blocks all requests by default—you need to create a configuration class to grant access and define where uploaded files are stored.

Create a CKFinderConfig.cs file in your project (e.g., in the App_Code folder) with this code:

using CKFinder.Connector.Config;
using CKFinder.Connector.Core;
using System.Web;

public class CKFinderConfig : ICKFinderConfig
{
    // 验证用户权限：根据你的MVC身份验证逻辑调整
    public CheckAuthenticationResult CheckAuthentication()
    {
        // 示例：允许已登录用户访问CKFinder
        if (HttpContext.Current.User.Identity.IsAuthenticated)
        {
            return CheckAuthenticationResult.Allow;
        }
        return CheckAuthenticationResult.Deny;
    }

    // 设置文件存储的根目录（确保这个物理文件夹存在！）
    public string RootPath => "~/Uploads/";
    // 设置对应URL路径
    public string RootUrl => "/Uploads/";

    // 可选：配置允许上传的文件类型、大小限制等
    public int MaxUploadSize => 5242880; // 5MB
}

Then register this config in Global.asax.cs (or Startup.cs if using OWIN):

using CKFinder.Connector.Config;

protected void Application_Start()
{
    // Other app start logic...
    ConfigManager.Current.SetConfig(new CKFinderConfig());
}

5. 修正CKEditor的上传URL #

Your current filebrowserUploadUrl is missing the type parameter, which CKFinder requires to know which file category to upload to. Update your JS code to:

CKEDITOR.replace('editor11', {
    filebrowserBrowseUrl: '/CKFinderScripts/ckfinder.html',
    filebrowserUploadUrl: '/connector?command=QuickUpload&type=Files'
});

6. 确保文件夹权限 #

Don't forget to give write permissions to the Uploads folder you defined in RootPath. For IIS, grant access to the application pool identity (e.g., IIS AppPool\YourAppPoolName) or the IIS_IUSRS group.

Once you've done all these steps, restart your app and test the file upload functionality in CKEditor—everything should work as expected!

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