ASP.NET 5.0 / ASP.NET Core 部署百度编辑器（UEditor）之 UEditorNetCore

本文发布于 5 年前，部分内容可能已经失去参考价值。

通过 nuget 安装 UEditorNetCore

从 UEditor 官网下载最新的包 ueditorx_x_x_x-utf8-net.zip

解压包，并复制到项目的 wwwroot/lib 目录下，删除 net 目录。

根据 UEditorNetCore 官方的使用说明进行操作

步骤中，控制器 UEditorController 接替原 controller.ashx 的功能，用于统一处理上传逻辑

原 config.json 复制到项目根目录，用于配置上传相关设置（若更改文件名和路径在 services.AddUEditorService() 中处理）。

个人喜欢将 xxxPathFormat 值改为：upload/ueditor/{yyyy}{mm}{dd}/{time}{rand:6}，方便日后迁移附件后进行批量替换。

记得配置 catcherLocalDomain 项。

上传相关的身份验证和授权控制请在 UEditorController 中处理，如：

public void Do()
{
    if (用户未登录) { throw new System.Exception("请登录后再试"); }
    _ue.DoAction(HttpContext);
}

如果图片仅仅上传到网站目录下，那么这样配置就结束了，如果要上传到阿里云 OSS 等第三方图床，那么继续往下看。

因 UEditorNetCore 虽然实现了上传到 FTP 和 OSS 的功能，但未提供配置相关的账号信息的途径，所以只能（1）重写 action，或（2）下载 github 的源代码，将核心项目加入到您的项目中进行修改。

重写 action 不方便后期维护，这里记录修改源码的方式。

将源码改造为可配置账号的上传到 OSS 的功能，具体步骤如下：

将 Consts.cs 从项目中排除。
打开 Handlers/UploadHandler.cs，找到 UploadConfig 类，将
FtpUpload 改为 OssUpload，
FtpAccount 改为 OssAccessKeyId，
FtpPwd 改为 OssAccessKeySecret，
FtpIp 改为 OssAccessEndpoint，
再添加一个属性 OssBucketName。
打开 Handlers/UploadHandler.cs，找到 Process() 方法，
将 UploadConfig.FtpUpload 改为 UploadConfig.OssUpload，
将 Consts.AliyunOssServer.* 改为 UploadConfig.Oss*。
打开 Handlers/CrawlerHandler.cs，找到 Fetch() 方法，
将 Config.GetValue<bool>("catcherFtpUpload") 改为 Config.GetValue<bool>("OssUpload")，
将 Consts.AliyunOssServer.* 改为 Config.GetString("Oss*")。

打开 UEditorActionCollection.cs，找到 UploadImageAction，将

FtpUpload = Config.GetValue<bool>("imageFtpUpload"),
FtpAccount = Consts.ImgFtpServer.account,
FtpPwd = Consts.ImgFtpServer.pwd,
FtpIp = Consts.ImgFtpServer.ip,

替换为

OssUpload = Config.GetValue<bool>("OssUpload"),
OssAccessKeyId = Config.GetString("OssAccessKeyId"),
OssAccessKeySecret = Config.GetString("OssAccessKeySecret"),
OssAccessEndpoint = Config.GetString("OssAccessEndpoint"),
OssBucketName = Config.GetString("OssBucketName"),

其余 3 个 Action（UploadScrawlAction、UploadVideoAction、UploadFileAction）按同样的方式修改。

在所有创建 UploadHandler 对象时补充添加 SaveAbsolutePath 属性。

打开 config.json，添加相关配置项（注：配置文件中的 *FtpUpload 全部废弃，统一由 OssUpload 决定）
```
"OssUpload": true,
"OssAccessEndpoint": "",
"OssAccessKeyId": "",
"OssAccessKeySecret": "",
"OssBucketName": "",
```
将 xxxUrlPrefix 的值改为 OSS 对应的 CDN 网址（以 / 结尾，如：//cdn.xoyozo.net/）。