一、Jexus简介：
Jexus web server for linux 是一款基于.NET兼容环境，运行于Linux/unix操作系统之上，以支持ASP.NET为核心功能的高性能WEB服务器。
Jexus V5.1有如下功能特点：
01、支持ASP.NET。这是Jexus的核心功能。无论是稳定性、易用性还是并发承载能力、并行处理速度，Jexus对ASP.NET的支持都是非常优秀的；
02、支持Fast-CGI。通Fast-CGI，Jexus能支持包括PHP在内的所有拥有Fast-CGI服务功能的WEB应用；
03、具备基于正则表达式的强大的URL重写功能；
04、具有强劲的反向代理功能。支持多目标负载均衡，支持本地网站与远程网站无缝整合；
05、拥有强大的流媒体支持能力，支持FLV/F4V视频文件拖动播放，支持微软平滑流媒体技术；
06、支持“服务器推送”技术，配备了相应的服务器端、客户端开发接口，是开发现代WEB应用的利器；
07、具备可控的“ASP.NET前置缓存”，能最大限度地提高ASP.NET网站的承载能力和响应速度；
08、支持Https，具有SSL加密数据安全传输能力；
09、具有基础而实用的入侵检测功能，能自动终止已被识别的非法请求；
10、安装部署非常简便，操作使用极为简单。

二、安装前的准备工作：

1、系统已经安装好mono 2.10.8 或更高版本，至于如何在linux上安装mono，请参考www.linuxdot.net上的相关文章。
2、请确认Linux系统中存在 libc.so.6、libdl.so.2两个库文件，如果需要启用https，系统中还需要具备libssl.so.x.x.x库文件，比如libssl.so.0.9.8，如果没有，请安装OpenSSH。

三、下载并解压Jexus安装包：
1、下载：
地址：http://www.linuxdot.net/down/jexus-5.1.tar.gz，可以用wget下载，如：wget http://www.linuxdot.net/down/jexus-5.1.tar.gz

2、解压：
tar -zxvf jexus-5.1.tar.gz

3、安装：
Jexus安装非常简单，仅仅就是一个复制、粘帖和注册全局程序集的过程，但要特别注意：需要用root身份进行操作。
A、复制文件，建议把jexus安装到/usr/jexus中：
sudo cp -rf jexus-5.1 /usr/jexus
B、注册全局程序集：
cd /usr/jexus
sudo ./jws.regsvr
C、请查看 jws.start、jws.stop、jws.restart、jws.regsvr这几个脚本文件的权限，确定是否具有可执行权限。

四、运行测试
    复制完Jexus的文件后，Jexus就可以正常工作了，甚至连进一步的配置也完全不需要。
    强调：如果你服务器安装有其它的WEB服务器，而且该服务正在运行，请停止它，以免造成端口冲突而造成Jexus无法启动。

    如果是最新安装，请首先建立一个默认的网站文件夹:/var/www/default，并在里面放一个首页文件，如index.htm或default.htm
    进入jexus工作文件夹，启动jexus，命令如下：
    cd /usr/jexus
    sudo ./jws.start
    启动后，请尝试访问一下这个网站，看看是否能看到你放的首页或者jexus的欢迎页，网址是：“http://服务器IP地址”或者“http://服务器IP地址/info”。

五、Jexus 系统配置
Jexus按默认配置就能很好的工作，进一步配置是为了Jexus更适合自己的需要。
Jexus最核心的一个配置文件，固定文件名是jws.conf，这个文件与jexus的其它工作文件在同一个文件夹中。
jws.conf有如果基本配置内容：

SiteLogDir=log    #网站日志以及Jexus系统日志的存放位置，必填项。可以使用基于jws.exe文件的相对路径
SiteConfigDir=siteconf     #网站配置文件存放的位置，是必填项。可以使用绝对路径，也可以使用基于jws.conf文件的相对路径
Runtime=v4.0.30319    #设定Jexus工作进程运行于哪个.NET版本
httpd.processes=1     #工作进程的数量，建议每6-8核CPU用一个进程，最多可设4个进程
httpd.user=www-data     #工作进程以什么用户身份和对应权限工作，默认为root
php-fcgi.set=/usr/bin/php-cgi,6    #如果需要Jexus同时充当PHP FastCGI服务器，这一句就是fast-cgi设置，分两个部分，逗号前为php-cgi这个文件的路径，逗号后是php进程数
CertificateFile=/xxxx/xx.crt    #SSL证书路径（如果需要使用https协议才填）
CertificateKeyFile=/xxxx/xx.key    #SSL密钥文件路径（如果需要使用https协议才填）

注：jws.conf 中,SiteConfigDir 和 SiteLogDir 两项是必填项。

六、网站配置

Jexus支持多站点，可以用不同的端口、域名、虚拟路径设置任意多的网站，配置时，首先要注意如下三个规则：
1）必须把所有网站配置文件放到jws.conf指定的网站配置文件夹内，这个文件夹除了网站配置文件，不能有其它任何文件，因为jexus会认为这儿的任何一个文件都代表着一个不同的网站。
2）每个网站有且只有一个配置文件，配置文件的文件名就是这个网站的名称，比如 www.mysite.cn这个网站，配置文件名可以写成“mysite”，当然也可以写成其它文件名，以便管理员容易记忆和识别，但要特别注意：文件名不能有空格！
3）一个网站可以拥有任意多的域名，不同网站不能有相同的域名，没有域名的网站只能有一个，这个没有域名的网站叫做“默认网站”，而一台服务器最多只能有一个默认网站。

下面以www.mysite.cn为例，说说网站的配置
在网站配置文件夹中建立一个文件，这个文件的名称应该有一些意义（至少要能让服务器管理员了解这个配置文件是属于哪一个网站的）
设这个网站的配置文件的文件名为：mysite

sudo miv mysite

A、网站配置的基本内容：
port=80                          # jexus WEB服务器侦听端口（必填。当然可以是其它端口）
root=/ /var/www/mysite           # 网站URL根路径（虚拟目录）和对应的物理路径，两个路径字串之间必须用空格分开（必填。既使这个网站是一个纯粹的反向代理站，也得填）

#可选项
hosts=mysite.cn,www.mysite.cn    # 网站域名（建议填写），可以用泛域名，比如：*.mysite.cn（不填此项或只填一个“*”号表示这是默认网站，一个端口只能有一个默认站）
indexs=index.aspx,index.htm      # 首页文件名，可以写多个，用英文逗号分开（可以不填。因为JWS系统含有常用首页名）
aspnet_exts=mspx,ttt             # 添加新出现的或自定义的ASP.NET扩展名（不建议填。多个扩展名用英文逗号分开，不加点号。系统含有常用扩展名）

B、最简配置示例
port=80
root=/ /var/www/default

C、网站配置的高级选项
网站配置的高级选项全是可选项，应该根据网站的实际需要选填。
灵活使用高级选项，可以架设出一台与众不同的、功能强大的服务器平台或者服务器群组。

1、使用“URL重写”功能
URL重写是指WEB服务器将访问者的请求URL路径资源按指定的匹配规则解释和匹配为另外的一个真实RUL路径资源。

比如，希望别人访问“.php”类型的文件时，服务器返回 /404.html 这个文件：
rewrite=^/.+?\.(asp|php|cgi)$ /404.html
# 格式：
# “rewrite=”的后面是两部分阻成，两部分之间由一个空格分开。
  空格前是匹配的条件：用正则表达式描述URL的匹配条件。
  空格后是匹配的目标：指的是如果用户访问的路径合乎前面的匹配条件，服务器将以哪个规则回应。

又如：
把“/bbs”解析为“/bbs/index.aspx”，把“/bbs/file-1” 匹配为 “/bbs/show.aspx?id=1”：
rewrite=^/bbs$ /bbs/index.aspx
rewrite=^/bbs/file-([0-9]{1,6})$ /bbs/show.aspx?id=$1
格式解释：rewrite的等号后含有两部分内容，用空隔分开。前半部分是一个正则表达式，用于描述需要URL重写的（用户浏览器中的）url路径样式，后半部分是当用户的URL合乎前面的正则表达式时，JWS应该重写和访问的真实URL路径。

2、禁止某IP或IP段访问本网站
denyfrom=111.222.111.*
denyfrom=101.202.111.*
denyfrom=101.201.1.132

3、禁止访问某文件夹及其子文件夹中的内容
DenyDirs=网站文件夹路径的URL路径，如 “/abcfiles”或 “~/abcfiles”，多个路径，用英文逗号分开

4、是否对请求的URL等进行安全检测
本选项默认是true，即需要检查，除非你的确需要关掉这个选项，否则可以不填，格式如下：
checkquery=false
（关掉本项可以提高服务器速度，但就安全而言，不建议关掉它）

5、NOFILE（无文件）功能
nofile=/mvc/controller.aspx
（注：这是Jexus特有的功能，指的是如果服务器不存在用户要访问的文件，服务器将使用什么文件应答。）
（提示：路由后，原RUL路径会存贮在Jexus特有一个服务器变量“X-Real-Uri”中）
（技巧：用这个功能，或者再加上URL Rewrite功能，你完全可以把URL路径与真实路径隔离开来，达到信息隐藏和简化URL的作用。）

6、NOLOG（无日志）功能
nolog=yes
（注：禁用网站日志功能会提高WEB服务器系统的的处理速度，但不足也是明显的，就是你无法详细了解网站的访问情况了）

7、长连接开关
keep_alive=true
注：V5.1版默认值是true，即默认使用长连接，可以不填。

8、反向代理功能
reproxy= /abc/ http://www.xxxx.com:890/abc/
参数的值由本站RUL根路径和目标网站URL根路径两部分组成，之间用空隔分开。
*技巧：反向代量的目标地址可以有多个，用英文逗号分隔，如：
reproxy=/abc/ http://192.168.0.3/abc/,http://192.168.0.4/abc/
这时，当用户访问/abc/时，jexus就会随机选择一台服务器进行访问，达到负载均衡或服务器集群的效果。

9、接受FAST-CGI提供的服务
对于TCP连接：
fastcgi.add=需要fast-cgi处理的文件扩展名|tcp:fast-cgi服务的IP地址:端口
如：fastcgi.add=php,php3|tcp:127.0.0.1:9000
对于unix sockets：
fastcgi.add=需要fcgi处理的文件扩展名|socket:路径
如:fastcgi.add=php,php3|socket:/tmp/phpsvr

10、启用gzip压缩功能
usegzip=true    #即UseGzip
解释：启用这个功能后，当用户访问“.htm”“.js”等文件时，Jexus会将这些文件进行GZIP压缩后发送给用户浏览器，这样，可以节约更多的网络带宽。

11、启用HTTPS进行SSL安全传输
本功能是对服务器与客户之间的数据进行加密传送，提供数据的保密性。具体方法请访问www.linuxdot.net的专题讲解。

七、Jexus操作：

1、基本的启动命令的格式（仅作例子，不建议使用）
mono /usr/jexus/jws.exe
如：mono /usr/jexus/jws.exe
这个命令运行后，用 Ctrl+c 组合键退出程序

2、以“服务”方式进行后台运行, 只需要基本命令后加一空格再加一“&”号（仅作例子，不建议使用）
mono /usr/jexus/jws.exe &

3、开机自动启动：
在/etc/rc.local 或类试的开机启动脚本中加入下面这一行命令：
mono /usr/jexus/jws.exe >/dev/null 2>&1 &
或者
/usr/jexus/jws.start  #推荐方式

（注意：不同的Linux系统可能有不同的启动方式，用户应根据不同系统的特点灵活定制）
（提示：jws.start是脚本文件，用户可以根据自己系统的特点去适当修改它，以便其启动）

4、使用脚本操作Jexus（推荐使用）：
Jexus自带了三个脚本，分别是：jws.start、jws.restart、jws.stop。

功能1，对Jexus服务器操作：
jws.start     #启动JEXUS服务，可以写入rc.local文件中，从而达到开机自启动的目的；
jws.stop      #停止Jexus的运行。
jws.restart   #重启Jexus；

功能2，对某个指定的网站操作：
jws.restart 网站名     #加载/启动/重启一个指定的网站
jws.stop 网站名        #停止一个指定的网站

注意，这些脚本需要具有可执行权限，同时操作者也必须拥有管理员（root）权限。

八、卸载：
1、在rc.local文件中删除你手工添加的开机自动启动Jexus的命令行（如果本来就没有添加过，这步操作就不必做了）
2、删除jexus文件夹及全部内容（建议只删除*.exe和*.dll，其它的，比如网站配置文件等不必删除，以便将来重新启用）。

九、信息反馈与技术交流：
网址：www.linuxdot.net

十、重要声明：
Jexus V5.1 是免费软件，可以自由下载、传播和使用。但Jexus作者、发布者、维护者不对Jexus的用途、作用、效果、技术支持以及其它相关内容作任何明确或暗含的承诺，不负担任何直接或间接的责任。

楼主开源吧

Jexus是“有条件开源软件”，即针对特定用户进行协议开源。

确认一下jexus是不是不支持304？不检测e-tag？

jexus支持静态文件的e-tag。

[root@~~~ jexus]# sudo ./jws.regsvr
./jws.regsvr: line 6: gacutil: command not found
./jws.regsvr: line 7: gacutil: command not found

这个我弄了挺久没弄好，centos 5.8, mono-2.10.8的，现在是只有mono /usr/jexus/jws.exe 或者 mono /usr/jexus/jws.exe & 可以启动，并且关掉SshClient又会掉,

1、证明你没有把mono安装到系统默认的路径上，造成了command not found这个找不到命令的错误。处理方法是用VIM编辑一下 jws.regsvr jws.start jws.restart jws.stop这几个文件，把mono的路径加到PATH变量中。
2、启动 jexus的正式命令是 jws.start，安装好后，应该把这个命令（含路径）写到rc.local中，以便随服务器自动启动。

多谢楼主，已经解决，确实是这么回事，是我不按照默认路径安装，改jws.start jws.restart jws.stop 这几个文件就可以了

我在mvc3网站中使用了sqlite数据库数据库文件在App_Data目录中,使用xsp４的时候是正常的，但是使用jexus时却发现数据库路径不能识别,jexus不识别|DataDirectory|，这个数据库文件在网站的根目录,我把路径设置为绝对路径也不行，提示不能打开些数据库文件

<add name="AgentContext" connectionString="Data Source=|DataDirectory|agent.sqlite3;Pooling=true;FailIfMissing=false;V    ersion=3;" providerName="Mono.Data.SQLite" />

有两个办法处理这个情况：
1，使用jexus 5.2及以上版本；
2，对于低于jexus 5.2的版本，你可以在网站的Global.asax的Application_Start方法指，用“AppDomain.CurrentDomain.SetData”指定位置，如：
string p = System.IO.Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "App_Data");
AppDomain.CurrentDomain.SetData("DataDirectory", p);

请问Jexus 中的 ASP.NET 前置缓存体现在哪里？

    实现方法：在需要前端缓存的ASPX网页靠前的部分，加上下面一句就行：
    <%Response.AddHeader("PageCache-Time","60");%>

解释：
    一、ASP.NET前置缓存，是Jexus把指定的ASP.NET网页内容缓存起来，在指定的时间内，所有对这个网页的访问，Jexus都用这个缓存内容回应，而不再驱动ASP.NET引擎对这个网页反复处理。
    二、前端缓存的优点在性能方面，本质上是以最简单的方式把“动态网页静态化”，因此，缓存期中，被缓存的网页的响应速度绝不亚于普通的静态文件，比原ASPX，快3-6倍；弱点是，在缓存期中，这张网页无法反映数据的变化（因为已经静态化），所以，不适合数据内容随时都在发生变化的交互式网页。
    三、ASP.NET前置缓存的指令是通过Resonse.AddHeader向Jexus发出的。AddHeader含两个参数，在这里，第一个参数必须是“PageCache-Time”，目的是告诉Jexus，这是一条缓存指令，第二个参数是缓存的时间，单位是秒，这里的“60”即是指缓存60秒的意思。

在FreeBSD+vmware环境下搭建了Jexus，配置了一个站点进行测试，发现系统的WCPU一直是100%，一个页面第一次打开都非常慢，用top命令查看系统资源，CPU: 49.0% user,  0.0% nice,  1.0% system,  0.0% interrupt, 50.0% idle
请问是什么原因呢？

我想问下作者，这个框架能够支持全部的c#开发的程序吗，一些windows上的.net特性都能用吗，比如用vs开发，然后很多类库。。

多个站点，怎么让它们彼此不能相互影响？如让每个站点用独立用户权限运行，这样一个站点的webshell不能看另一个站点的内容。

个人也建议作者开源到github上吧，一旦彻底开源其影响力与发展都会变得不一样~~

我对开源的看法是辩证的，目前还没有开源的计划。

楼主，你好，我想问个问题。
既然jexus在linux+mono+jexus中扮演的角色是windows+.NET+IIS中的IIS，那其中IIS的许多配置，比如：响应头，映射等是否支持呢？若支持，望指导！谢谢。

Jexus是linux的，以支持ASP.NET为主的web服务器，与IIS并没有严格的对等关系。比如Jexus支持的URL重写与IIS的就有区别。

您好,
     我在VM9虚拟机中,安装了 CENTOS6.4 64位版本.我想将VS2013开发的MVC4网站程序移植到这个系统中.CENTOS6.4系统中,有哪些默认软件会影响即将安装的jexus和MONO?

您好，多个站点，可以配置各个站点不同.net 版本吗？如站点1 .net2.0
站点2 .net 4.0

mono3.8.1-3.12.1上，当jexus以.NET4.0运行时，会同时兼容ASP.NET2.0，由于mono 4.x已经不带.net2.0的类库，所以不能再兼容ASP.NET2.0，这时，需要你把这个网站用VS重新用.NET4编译。

mono 2.10.8+jexus 5.0.1 配置.net2.0 提示： Type System.Data.DataRow is not marked as Serializable.   是mono版本导致的吗?  运行在iis上是正常的
Description: HTTP 500. Error processing request.

Stack Trace: 

System.Runtime.Serialization.SerializationException: Type System.Data.DataRow is not marked as Serializable.
  at System.Runtime.Serialization.Formatters.Binary.BinaryCommon.CheckSerializable (System.Type type, ISurrogateSelector selector, StreamingContext context) [0x00000] in <filename unknown>:0 
  at System.Runtime.Serialization.Formatters.Binary.ObjectWriter.GetObjectData (System.Object obj, System.Runtime.Serialization.Formatters.Binary.TypeMetadata& metadata, System.Object& data) [0x00000] in <filename unknown>:0 
  at System.Runtime.Serialization.Formatters.Binary.ObjectWriter.WriteObject (System.IO.BinaryWriter writer, Int64 id, System.Object obj) [0x00000] in <filename unknown>:0 
  at System.Runtime.Serialization.Formatters.Binary.ObjectWriter.WriteObjectInstance (System.IO.BinaryWriter writer, System.Object obj, Boolean isValueObject) [0x00000] in <filename unknown>:0 
  at System.Runtime.Serialization.Formatters.Binary.ObjectWriter.WriteQueuedObjects (System.IO.BinaryWriter writer) [0x00000] in <filename unknown>:0 
  at System.Runtime.Serialization.Formatters.Binary.ObjectWriter.WriteObjectGraph (System.IO.BinaryWriter writer, System.Object obj, System.Runtime.Remoting.Messaging.Header[] headers) [0x00000] in <filename unknown>:0 
  at System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Serialize (System.IO.Stream serializationStream, System.Object graph, System.Runtime.Remoting.Messaging.Header[] headers) [0x00000] in <filename unknown>:0 
  at System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Serialize (System.IO.Stream serializationStream, System.Object graph) [0x00000] in <filename unknown>:0 
  at System.Web.Util.AltSerialization.Serialize (System.IO.BinaryWriter w, System.Object value) [0x00000] in <filename unknown>:0 
  at System.Web.SessionState.SessionStateItemCollection.Serialize (System.IO.BinaryWriter writer) [0x00000] in <filename unknown>:0 
  at System.Web.SessionState.SessionStateServerHandler.SetAndReleaseItemExclusive (System.Web.HttpContext context, System.String id, System.Web.SessionState.SessionStateStoreData item, System.Object lockId, Boolean newItem) [0x00000] in <filename unknown>:0 
 

系统是Centos7，Mono 4.0.1，Jexus 5.6.5
同样的程序在WIN SERVER 2008, IIS 7.5
并发500，请求20000次，CPU 单核 3.2G，内存2G
IIS处理请求数 AVG：333个/秒；MAX：900个/秒
JEXUS处理处理请求数 AVG：48个/秒；MAX：83个/秒
是不是我JEXUS哪里设置有问题啊

对于一个有数据库操作的完整网页，在单核虚拟机上，以500并发压测时，不可能每秒完成300多次完整的处理，相反，Jexus的数据更具有可靠性。建议您找一款能统计状态码的压测软件进行测试，才能看到那每秒300多个应答，到底是什么东西，当然，也能返回的字节数量去确定数据的真实性。

无法序列化会话状态。请注意，当会话状态模式为“StateServer”或“SQLServer”时，不允许使用无法序列化的对象或 MarshalByRef 对象。

Novell.Directory.Ldap.dll在linux下控制台调用没问题，但web站点调用后站点立即无响应，之后卡死，站点部署在jexus下，我想问一下，这个问题跟jexus有关系吗？   在windows下完全正常

同一个目录下，第一个件请求通过，第二个却不成功。
rewrite=^autoupdate/300/([a-z_0-9]+.*) ad/pics/{R:1}
请求该目录下a1.jpg成功，请求a2.jpg却找不到资源。
下一条重写命令，完全一样的，只是换了个目录，却找不到资源了。
rewrite=^autoupdate/400/[a-z_0-9]+.*) hp/down/{R:1}

用这个试试：
rewrite=^/autoupdate/300/([a-z_0-9]+.*) /ad/pics/{R:1}

how to config file mime type

我用的是 Jexus 独立安装包（内置 Mono），怎样才能实现 ASP （注意是 ASP 而不是 ASP.NET）解析？

Runtime Error
A runtime error has occurred

Description: An application error occurred on the server. The current custom error settings for this application prevent the details of the application error from being viewed (for security reasons).
Details: To enable the details of this specific error message to be viewable, please create a <customErrors> tag within a "web.config" configuration file located in the root directory of the current web application. This <customErrors> tag should then have its "mode" attribute set to "Off".
<!-- Web.Config Configuration File -->

<configuration>
    <system.web>
        <customErrors mode="Off"/>
    </system.web>
</configuration>

Notes: The current error page you are seeing can be replaced by a custom error page by modifying the "defaultRedirect" attribute of the application's <customErrors> configuration tag to point to a custom error page URL.
<!-- Web.Config Configuration File -->

<configuration>
    <system.web>
        <customErrors mode="RemoteOnly" defaultRedirect="mycustompage.htm"/>
    </system.web>
</configuration>

rewrite怎么配置301 302？

rewrite是服务器端URL重写（替换）的意思，所以，没有重定向的功能。

求asp支持

楼主您好，我目前用的版本是centos6.5+mono5.4.1.6+jexus5.8.2。是这样的，我现在环境部署已经完成，在导入我自己的项目时所有的html页面都可以成功访问，但是所有的aspx页面都不行，在firefox上提示连接被重置，我把防火墙和代理都关了，还是不行，以为是路径的问题我就把MONO_IOMAP设为all结果还是一样。后来以为是浏览器的原因我就换成Google浏览器，结果提示:192.168.x.x未发送任何数据。请问这是什么原因呢，有什么解决方法？

楼主，您好！
我按照操作配置了，我通过localhost可以访问网站，通过http://IP/网站  却访问不了，说是网络错误，不知道怎么解决？

locahost能访问，ip不能访问，那么有两种可能：一，linux系统上的防火墙阻止了80端口上的请求，二，如果是公网IP，这个公网IP的80端口可能被有关方面禁用。

楼主,您好,请问Jexus支持websocket吗?
我使用的.net core signalr 发现好像不支持websocket

根据各种资料搭建好网站后，可以访问。

但是执行了一个查询操作后，返回的内容居然“部分”乱码。

内容是钉钉接口提供的数据，一开始怀疑是接口问题，尝试在服务器用curl获取数据后发现获取的内容并不是乱码，那么只能怀疑是我写的程序问题了。

可是我只是把两组数据用linq 做了一个 join而已呀，为什么其中一部分就乱码了，很是想不通。

<configuration>
    <system.web>
        <customErrors mode="Off"/>
    </system.web>
</configuration>