Jexus for linux 安装说明

Jexus是一款跨平台的WEB服务器力作，支持windows、linux、unix等多种平台。由于Jexus本身的DotNET特性，因此Jexus对ASP.NET有一种天然的亲和力，是Linux/Unix等非Windows平台架设ASP.NET WEB服务器的首选方案，同时，由于Jexus拥有强大的Urlwrite等特殊功能和防止非法请求(如SQL注入)等入侵检测机制，Jexus也是Windows平台搭建ASP.NET WEB服务器的重要选择。

* LINUX平台的Jexus V2.3 版的安装使用：

一、安装：

前提：
A、安装好mono 2.2 或以上版本,建议用mono 2.4，下载地址www.go-mono.com 。
B、以 root 身份登入服务器
C、特别注意，如果安装过Jexus的其它版本，请在安装这个版本之前卸载旧版本。
   卸载旧版的方法：
      1、终止jexus进程,命令格式形如:/etc/jws/jws.stop
      2、注销全局程序集jxAspx，命令格式如：gacutil -u jxAspx
      3、删除原jws文件夹中所有内容。

1、下载 Jexus V2.3:
下载地址是：http://linux.j66.net/down/jexus-2.3.tar.gz

2、解压 jexus-2.3.tar.gz
tar -zxvf jexus-2.3.tar.gz

3、建立/etc/jws目录，并把jexus-2.3文件夹中的文件全部复制到/etc/jws文件夹内。
    注：可以使用其它的文件夹，但我们建议使用/etc/jws这个文件夹，因为一些操作脚本中默认位置就是这个文件夹

4、把 jxAspx.dll 注册为全局程序集：
cd /etc/jws
gacutil -i jxAspx.dll

二、配置：
在/etc/jws文件夹中建立一个网站配置文件，文件名假设为 site.conf。
vim site.conf

A、主站配置：
一个Jexus进程必须有一个主站，即默认网站，当用户使用IP地址或者不属于任何子站的域名访问服务器时，服务器就会认为是访问这个网站。

#服务器基本配置
port=80                 #jexus WEB服务器侦听端口（必填，如果不填，端口就会默认为8088）
addr=0.0.0.0            #侦听地址（可以不填）
maxworker=100           #最大工作线程数（取值范围是10到320之间，每G内存不超过100，默认100，可以不填）
jwslog=/etc/jws.log    #jexus程序的日志文件（必填）
aspnet_exts=mspx        #添加新出现的或自定义的ASP.NET扩展名，多个扩展名用英文逗号分开，不加点号，常用扩展名已经写入系统中了（没必要就不填）

#主站配置
path=/var/www               # 网站文件夹（必填）
log=/var/log/jwssite.log    # 主网站日志文件（必填）
# checkquery=false               # 主站的URL是否需要进行安全检查，默认true，可以不填
# index=index.aspx,index.html    # 默认首页例表，多个用英文逗号分开，可以不填，系统以默认index.aspx、index.html、default.aspx等常用首页命名

输入以上内容之后，一个WEB服务器就配置好了。把网站内容复制或上传到指定的网站文件夹后，就可以用服务器IP地址访问这个网站了。

B、子站配置
如果除主站之外还有多个网站，那么这些网站可以配置为子站，示例如下：

newsite=abc                 #添加新网站，名为“abc”（必填，并且不能与其它子站同名）
abc.root=/                  #这个网站的url根路径（应填）
abc.path=/var/abc           #这个网站的物理路径（必填）
abc.host=abc.com,*.abc.com  #这个网站的域名，多个域名为英文“,”号分开，*表示这个位置可以是任意字母，当“abc.root=/”时,host是必填项
abc.log=/var/log/abc.log    #子网站的日志文件（可选项）


这样，一个新网站就基本配置好了。

C、高级设置

1、使URL重写功能。
比如，希望别人访问 .php等文件时，服务器返回 /404.html文件
abc.rewrite=^/.+?/.(asp|php|cgi)$ /404.html    #标准与目标之间用空格分开，格式是正则表达式
双如，把RUL地址 /bbs/file-1 解析为 /bbs/show.aspx?id=1
abc.rewrite=^/bbs/file-([0-9]{1,6})$ /bbs/show.aspx?id=$1

2、禁止某IP段访问服务器
abc.denyfrom=111.222.111.*
abc.denyfrom=101.202.111.*

3、是否对请求的URL等进行安全检测
本选项默认是true，即需要检查，除非你要关掉这个选项，否则可以不填，格式如下：
abc.checkquery=false

4、修改默认首页
程序系统已经配备了常用的默认首页，内容和顺序为：index.aspx,default.aspx,index.htm,default.htm,index.html,default.html，
如果这个内容不符合你的需要，可以修改，多个首页用英文逗号分开，如：
abc.index=login.aspx,index.html


三、运行：

1、基本的启动命令的格式（仅作例子，不建议使用）
mono /etc/jws/jws.exe -f 配置文件路径及文件名
如：mono /etc/jws/jws.exe -f /etc/jws/site.conf
这个命令运行后，用 Ctrl+c 组合键退出程序

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

3、开机自动启动（仅作例子，不建议使用）：
在/etc/rc.local 中加入下面这一行命令：
mono /etc/jws/jws.exe -f /etc/jws/site.conf >/dev/null 2>&1 &
或者添加下面一句：
/etc/jws/jws.start
或者添加下面一句：
/etc/jws/jws start

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

jws.start 的作用是启动JEXUS服务，可以写入rc.local文件中，从而达到开机自启动的目的；
jws.restart 的作用是重启Jexus （注：jws.restart 加上子站名作参数时，只重启这个子站的ASPX引擎，当仅仅某个子站因ASPX出错而挂起时，就可以用选项）；
jws.stop 的作用是停止Jexus的运行。

另外，还有一个脚本：jws
使用方法是：
启动jexus： jws start 
重启jexus： jws restart
停止jexus： jws stop

使用脚本时，请一定要注意Jexus安装文件夹的位置，脚本默认的文件夹是“/etc/jws”，配置文件名是site.conf，如果你的配置不同，请修改脚本内容。

5、查看运行情况
在浏览器中输入服务器IP地址（如果端口不是80，需在地址栏填写“http://”和端口号），如果指定的网站目录内有首页文件，比如index.aspx,那么你就可以看到首页，如果没有，可以看到Jexus的提示信息。
另外，在正常工作状态下，可以输入 “http://IP:端口/info”这种格式查看Jexus工作信息。

四、卸载：
1、注销全局程序集jxAspx.dll，命令是： 
gacutil -u jxAspx
2、在rc.local文件中删除你手工添加的开机自动启动Jexus的命令行
3、删除 /etc下的jws文件夹及全部内容。