博客 (47)

在 ASP.NET Core 或 ASP.NET 5 中部署百度编辑器请跳转此文。

本文记录百度编辑器 ASP.NET 版的部署过程，对其它语言版本也有一定的参考价值。

【2020.02.21 重新整理】

下载

从 GitHub 下载最新发布版本：https://github.com/fex-team/ueditor/releases

按编码分有 gbk 和 utf8 两种版本，按服务端编程语言分有 asp、jsp、net、php 四种版本，按需下载。

目录介绍

以 v1.4.3.3 utf8-net 为例，

客户端部署

本例将上述所有目录和文件拷贝到网站目录 /libs/ueditor/ 下。

当然也可以引用 CDN 静态资源，但会遇到诸多跨域问题，不建议。

在内容编辑页面引入：

<script src="/libs/ueditor/ueditor.config.js"></script>
<script src="/libs/ueditor/ueditor.all.min.js"></script>

在内容显示页面引入：

<script src="/libs/ueditor/ueditor.parse.min.js"></script>

如需修改编辑器资源文件根路径，参 ueditor.config.js 文件内顶部文件。（一般不需要单独设置）

如果使用 CDN，那么在初始化 UE 实例的时候应配置 serverUrl 值（即 controller.ashx 所在路径）。

客户端配置

初始化 UE 实例：

var ue = UE.getEditor('tb_content', {
    // serverUrl: '/libs/ueditor/net/controller.ashx', // 指定服务端接收文件路径
    initialFrameWidth: '100%'
});

其它参数见官方文档，或 ueditor.config.js 文件。

服务端部署

net 目录是 ASP.NET 版的服务端程序，用来实现接收上传的文件等功能。

本例中在网站中的位置是 /libs/ueditor/net/。如果改动了位置，那么在初始化 UE 的时候也应该配置 serverUrl 值。

这是一个完整的 VS 项目，可以单独部署为一个网站。其中：

net/config.json  服务端配置文件
net/controller.ashx  文件上传入口
net/App_Code/CrawlerHandler.cs  远程抓图动作
net/App_Code/ListFileManager.cs  文件管理动作
net/App_Code/UploadHandler.cs  上传动作

该目录不需要转换为应用程序。

服务端配置

根据 config.json 中 *PathFormat 的默认配置，一般地，上传的图片会保存在 controller.ashx 文件所在目录（即本例中的 /libs/ueditor/）的 upload 目录中：
/libs/ueditor/upload/image/
原因是 UploadHandler.cs 中 Server.MapPath 的参数是由 *PathFormat 决定的。

以修改 config.json 中的 imagePathFormat 为例：

原值："imagePathFormat": "upload/image/{yyyy}{mm}{dd}/{time}{rand:6}"

改为："imagePathFormat": "/upload/ueditor/{yyyy}{mm}{dd}/{time}{rand:6}"

以“/”开始的路径在 Server.MapPath 时会定位到网站根目录。

此处不能以“~/”开始，因为最终在客户端显示的图片路径是 imageUrlPrefix + imagePathFormat，若其中包含符号“~”就无法正确显示。

在该配置文件中查找所有 PathFormat，按相同的规则修改。

说到客户端的图片路径，我们只要将

原值："imageUrlPrefix": "/ueditor/net/"

改为："imageUrlPrefix": ""

即可返回客户端正确的 URL。

当然也要同步修改 scrawlUrlPrefix、snapscreenUrlPrefix、catcherUrlPrefix、videoUrlPrefix、fileUrlPrefix。

特殊情况，在复制包含图片的网页内容的操作中，若图片地址带“?”等符号，会出现无法保存到磁盘的情况，需要修改以下代码：

打开  CrawlerHandler.cs 文件，找到

ServerUrl = PathFormatter.Format(Path.GetFileName(this.SourceUrl), Config.GetString("catcherPathFormat"));

替换成：

ServerUrl = PathFormatter.Format(Path.GetFileName(SourceUrl.Contains("?") ? SourceUrl.Substring(0, SourceUrl.IndexOf("?")) : SourceUrl), Config.GetString("catcherPathFormat"));

如果你将图片保存到第三方图库，那么 imageUrlPrefix 值设为相应的域名即可，如：

改为："imageUrlPrefix": "//cdn.***.com"

然后在 UploadHandler.cs 文件（用于文件上传）中找到

File.WriteAllBytes(localPath, uploadFileBytes);

在其下方插入上传到第三方图库的代码，以阿里云 OSS 为例：

// 上传到 OSS
client.PutObject(bucketName, savePath.Substring(1), localPath);

在 CrawlerHandler.cs 文件（无程抓图上传）中找到

File.WriteAllBytes(savePath, bytes);

在其下方插入上传到第三方图库的代码，以阿里云 OSS 为例：

// 上传到 OSS
client.PutObject(bucketName, ServerUrl.Substring(1), savePath);

最后有还有两个以 UrlPrefix 结尾的参数名 imageManagerUrlPrefix 和 fileManagerUrlPrefix 分别是用来列出上传目录中的图片和文件的，

对应的操作是在编辑器上的“多图上传”功能的“在线管理”，和“附件”功能的“在线附件”。

最终列出的图片路径是由 imageManagerUrlPrefix + imageManagerListPath + 图片 URL 组成的，那么：

"imageManagerListPath": "/upload/ueditor/image",

"imageManagerUrlPrefix": "",

以及：

"fileManagerListPath": "/upload/ueditor/file",

"fileManagerUrlPrefix": "",

即可。

如果是上传到第三方图库的，且图库上的文件与本地副本是一致的，那么将 imageManagerUrlPrefix 和 fileManagerUrlPrefix 设置为图库域名，

服务端仍然以 imageManagerListPath 指定的路径来查找本地文件（非图库），但客户端显示图库的文件 URL。

因此，如果文件仅存放在图库上，本地没有副本的情况就无法使用该功能了。

综上，所有的 *UrlPrefix 应该设为一致。

另外记得配置不希望被远程抓图的域名，参数 catcherLocalDomain。

服务端授权

现在来判断一下只有登录用户才允许上传。

首先打开服务端的统一入口文件 controller.ashx，

继承类“IHttpHandler”改为“IHttpHandler, System.Web.SessionState.IRequiresSessionState”，即同时继承两个类，以便可使用 Session，
找到“switch”，其上插入：

if (用户未登录) { throw new System.Exception("请登录后再试"); }

即用户已登录或 action 为获取 config 才进入 switch。然后，

else
{
    action = new NotAllowedHandler(context);
}

这里的 NotAllowedHandler 是参照 NotSupportedHandler 创建的，提示语 state 可以是“登录后才能进行此操作。”

上传目录权限设置

上传目录（即本例中的 /upload/ueditor/ 目录）应设置允许写入和禁止执行。

基本用法

设置内容：

ue.setContent("Hello world.");

获取内容：

var a = ue.getContent();

更多用法见官方文档：http://fex.baidu.com/ueditor/#api-common

其它事宜

配置上传附件的文件格式

找到文件：config.json，更改“上传文件配置”的 fileAllowFiles 项，

同时在 Web 服务器上允许这些格式的文件可访问权限。以 IIS 为例，在“MIME 类型”模块中添加扩展名。

遇到从客户端(......)中检测到有潜在危险的 Request.Form 值。请参考此文

另外，对于不支持上传 .webp 类型的图片的问题，可以作以下修改：
config.json 中搜索“".bmp"”，替换为“".bmp", ".webp"”
IIS 中选中对应网站或直接选中服务器名，打开“MIME 类型”，添加，文件扩展名为“.webp”，MIME 类型为“image/webp”

最后，为了在内容展示页面看到跟编辑器中相同的效果，请参照官方文档引用 uParse

若有插入代码，再引用：
<link href="/lib/ueditor/utf8-net/third-party/SyntaxHighlighter/shCoreDefault.css" rel="stylesheet" />
<script src="/lib/ueditor/utf8-net/third-party/SyntaxHighlighter/shCore.js"></script>

其它插件雷同。

若对编辑器的尺寸有要求，在初始化时设置即可：

var ue = UE.getEditor('tb_content', {

  initialFrameWidth: '100%',
  initialFrameHeight: 320
});

图片等附件上传到阿里云 OSS 参考此文

本教程使用 U 盘 OS X 启动盘和 U 盘 Windows 安装盘，硬盘安装稍有不同。

系统安装前

准备工作

• 各系统下所有资料备份到移动硬盘或网盘

• 先看一些关于当前苹果电脑支持的 Boot Camp 及 Windows 版本的知识

制作系统盘

• 如果 OS X 系统已经无法进入，则只能用 Internet Recovery 重装了（联网下载 5G 左右的安装包）。否则可以进入 OS X，从 App Store 下载最新的 OS X 安装包制作 USB 启动盘。

• 制作 USB OS X 启动盘教程：适用于 Mavericks（10.9） 及更旧版本、适用于 Yosemite（10.10） 及更新版本

• 使用 OS X 的 Boot Camp 助手制作 U 盘 Windows 安装盘（若使用一般的 Windows 安装盘，安装完成后会遇到无法安装 Boot Camp 的问题，即使是正确的版本）

安装 OS X

版本

• 本文适用且不限于 OS X 10.8.4 - 10.9.3

分区与安装

• 插入 USB OS X 启动盘，开机，出现白屏即按住 option / Alt 键，选择相应的启动盘（联网恢复方式：开机按“option”+“command”+“R”，在磁盘工具分区时如果遇到“未能卸载磁盘”，就可以用联网恢复的方式重新分区）

• 进入磁盘工具，分区：3 个分区：（安装 OS X 的分区必须放在最后）

• 选中第 3 个分区：Macintosh HD，Mac OS 扩展（日志式），100G，选项：GUID 分区表，用于安装 OS X

• 选中第 2 个分区：BOOTCAMP，MS-DOS(FAT)，100G，用于安装 Windows

• 选中第 1 个分区：DATA，ExFAT，用于存放数据（公共盘）

• 应用，退出磁盘工具，选择重新安装 OS X，选择安装在 Macintosh HD 分区

• 等待约 30 分钟安装完成

• Finder 中推出并拔除 USB OS X 启动盘

安装 Windows

安装

• 插入 USB Windows 安装盘

• 在 OS X 中进入：系统偏好设置 - 启动磁盘 - 选择 USB Windows 启动盘 或者 重新启动系统 - 响完“当”且白屏前按住 Option 或 Alt 键，选择 USB 图标的 Windows 项（不是 EFI Boot 那项）

• 全新安装，选中 BOOTCAMP 分区并格式化，安装。（注：[待测]下次尝试删除全部分区并重新分区，如果能安装并启动成功，就是没有 OS X 的 Windows 单系统了。由于制作 U 盘 OS X 启动盘和 Windows 安装盘都需要在 OS X 环境下进行，所以必须权衡是否真的只需要单系统，否则下次只能用 Internet Recovery 方式重装了）

• 安装完成后，安装 Boot Camp 支持软件（已集成到 Windows 安装盘内）

• 必须通过右下角的 Boot Camp 来重启进入 OS X，否则在移除 USB Windows 安装盘的情况下无法进入各系统。（此条为真？待测）

• 正常弹出并拔除 USB Windows 安装盘

其它

Apple Wireless Keyboard

• 确保设备管理器的蓝牙设备中有 Apple 字样的驱动名称（即蓝牙驱动是通过 Boot Camp 安装的）

• 打开键盘电源

• 右击 Windows 任务栏小图标中的蓝牙图标，添加新设备

• 配对

版本区别

下载地址

根据下面的 SHA1 或文件名在网上搜索下载地址，下载完成后验证其 SHA1 即可。

Windows 8 (x86) - DVD (Chinese-Simplified)
文件名： cn_windows_8_x86_dvd_915414.iso
SHA1: 0C4A168E37E38EFB59E8844353B2535017CBC587


Windows 8 (x64) - DVD (Chinese-Simplified)
文件名： cn_windows_8_x64_dvd_915407.iso
SHA1: A87C4AA85D55CD83BAE9160560D1CB3319DD675C


Windows 8 Pro VL (x86) - DVD (Chinese-Simplified)
文件名： cn_windows_8_pro_vl_x86_dvd_917720.iso
SHA1: EEEF3C3F6F05115C7F7C9C1D19D6A6A6418B5059


Windows 8 Pro VL (x64) - DVD (Chinese-Simplified) 推荐
文件名： cn_windows_8_pro_vl_x64_dvd_917773.iso
SHA1: 9C4EC9FC4FB561F841E22256BC9DEA6D9D6611FF


Windows 8 Enterprise (x86) - DVD (Chinese-Simplified)
文件名： cn_windows_8_enterprise_x86_dvd_917682.iso
SHA1: 951565D8579C5912FB4A407B3B9F715FBDB77EFE


Windows 8 Enterprise (x64) - DVD (Chinese-Simplified)
文件名： cn_windows_8_enterprise_x64_dvd_917570.iso
SHA1: 1280BC3A38A7001FDE981FA2E465DEB341478667

激活方式

目前流行 KMSmicro 激活，写此文时的最新版本是 4.0，下载地址网上搜之（或联系我）。

离 VS2008 发布已经过去多年了，最近有个项目必须用到，我觉得还是有必要把它的一些信息写下来，特别是下载和注册方式，方便日后查看。我关心的当然是 Team Suite 版本。

zh-hans_visual_studio_team_system_2008_team_suite_trial_x86_dvd_x14-29243.iso 是 90 天试用版 （需要序列号，网上有很多）

这里推荐 MSDN 版（无需序列号，没有使用期限）：

有了用这个 SHA1 去网上搜一下，就可以看到一大堆下载地址，譬如：

ed2k://|file|zh-Hans_visual_studio_team_system_2008_team_suite_x86_dvd_X14-26452.iso|4663904256|8E2D6430D819328940B9BF83568589FA|/

SP1 补丁包：

Visual Studio 2008 Service Pack 1 (x86, x64 WoW) - DVD (Chinese-Simplified)

文件名：zh-hans_visual_studio_2008_service_pack_1_x86_dvd_x15-12981.iso
SHA1：8C3EA92CBC60CECB30B6262DB475BDE1E2620B36
ed2k://|file|zh-hans_visual_studio_2008_service_pack_1_x86_dvd_x15-12981.iso|941703168|E1647161AA5CA4567B787A5606D2A065|/

下载最新的免费CodeHighlighter组件 http://www.CodeHighlighter.com

1。确保web.config中的languages节点的.xml文件路径正确。
2。可以在insertCode.aspx更改编辑的默认设置，如checkbox的check等。(或在项目中搜索相关代码)

DotNetTextBox 已集成CodeHighlighter，我的修改如下：

2000/XP/2003 下 IIS+PHP+MySQL+Zend Optimizer+GD库+phpMyAdmin安装配置

（假设 C:\ 为你现在所使用操作系统的系统盘，如果你目前操作系统不是安装在 C:\ ，请自行修改。）

一、安装 IIS（Windows2003只要安装“应用程序服务器(IIS,ASP.NET)”即可跳过此步）：

（1）插入系统盘；
（2）进入控制面板-》添加或删除程序-》添加/删除Windows组件-》在“Internet信息服务(IIS)打勾-》下一步安装。
（3）安装完成后在浏览器地址栏输入 htt://127.0.0.1 检查是否安装正常。
如果没有系统盘，那么下载 IIS 5.1 的安装包（for XP），重复上述步骤，安装时指定路径即可。
IIS下载地址：http://soft.mumayi.net/downinfo/2597.html

二、安装 PHP：

（1）官方下载：http://www.php.net/downloads.php。
（2）下载后得到 php 的 zip 压缩包，解压至 C:\php（这个路径可以随意，下面要是用到这个路径，请相应修改）；
（3）将 C:\php\libmysql.dll 和 C:\php\ext\php_mysql.dll 复制到 C:\Windows\system32 下；
将 C:\php\php.ini-recommended 复制到 C:\Windows （Windows 2000 下为 C:\WINNT）并将改名为php.ini，
然后用记事本打开，利用记事本的查找功能搜索：
搜索“; Windows Extensions”并仅打开需要的模块以节省内存（去掉每个模块前的;号即可）：

extension=php_gd2.dll
GD库支持，支持水印。
extension=php_mbstring.dll
支持phpMyAdmin
extension=php_mysql.dll
支持MySQL。

（4）配置 IIS 使其支持 PHP

在“控制面板”的“管理工具”中选择“Internet 服务管理器”，
然后在左侧选择你需要支持 PHP 的 Web 站点上单击右键选择“属性”，
在打开的“Web 站点属性”窗口的“ISAPI 筛选器”标签里找到并点击“添加”按钮，在弹出的“筛选器属性”窗口中的“筛选器名称”栏中输入：PHP，再将可执行文件指向 php5isapi.dll 所在路径，如：C:\php\php5isapi.dll。
打开“Web 站点属性”窗口的“主目录”标签，找到并点击“配置”按钮，在弹出的“应用程序配置”窗口中找到并点击“添加”按钮，在弹出的窗口中新增一个扩展名映射，扩展名为 .php ，单击“浏览”将可执行文件指向 php5isapi.dll 所在路径，如：C:\php\php5isapi.dll，然后一路确定即可。
再打开“Web 站点属性”窗口的“文档”标签，找到并点击“添加”按钮，向默认的 Web 站点启动文档列表中添加 index.php 项。您可以将 index.php 升到最高优先级，这样，访问站点时就会首先自动寻找并打开 index.php 文档。
确定 Web 目录的应用程序设置和执行许可中选择为纯脚本，然后关闭 Internet 信息服务管理器。

2003系统配置：在“Internet 服务管理器”左边的“WEB服务扩展”中设置:
ISAPI 扩展允许

开始-》运行-》输入“iisreset”，重启IIS。

在 IIS 根目录下新建一个 phpinfo.php，内容如下：

<?php
phpinfo();
?>

打开浏览器，输入：http://127.0.0.1/phpinfo.php，将显示当前服务器所支持 PHP 的全部信息。

三、安装 MySQL：

（1）官方下载：http://dev.mysql.com/downloads/mysql/5.2.html
custom
安装
Skip Sign-Up
Finish
Next
Standard Comfiguration
设置数据库密码

（重要）重新启动电脑！

四、安装 Zend Optimizer ：（有需要时安装）

（1）官方下载：http://www.zend.com/products/zend_optimizer
（2）安装时只需选择Web服务器为iis，指定php.ini路径即可。

五、安装 phpMyAdmin：（用于管理MYSQL数据库，可选择）

下载 http://www.phpmyadmin.net，将其解压到站点根目录，
找到 ./libraties/config.default.php，做以下修改：

方案一：
搜索 $cfg['Servers'][$i]['auth_type'] 设置为config
搜索 $cfg['Servers'][$i]['user'] 用户名一般为root
搜索 $cfg['Servers'][$i]['password'] 设置MySQL的密码
打开浏览器，输入：http://127.0.0.1/phpMyAdmin/ ，若 IIS 和 MySQL 均已启动，即可浏览数据库内容。
（此设置允许任何人通过以上路径登录管理数据库，安全性极低）

方案二：
搜索 $cfg['Servers'][$i]['auth_type'] 设置为cookie
搜索 $cfg['Servers'][$i]['user'] 用户名一般为root
搜索 $cfg['PmaAbsoluteUri'] 访问路径，设置为http://127.0.0.1/phpmyadmin/
搜索 $cfg['blowfish_secret'] 这是cookie作用域，设置为127.0.0.1
（此设置只允许本机上登录，并且需要输入用户名密码才能登录，安全性极高）

-----------------------------------------------------------------------------------
至此所有安装完毕。以上配置在所有老版本软件中不一定有效，强烈推荐下载最新版本的软件。