******************************************************
*** Jexus web server for linux V5.4.3 版的安装使用 ***
******************************************************

Jexus web server for linux 是一款基于mono环境，运行于Linux/unix操作系统之上，以支持ASP.NET为核心功能的高性能WEB服务器。

Jexus V5.4.3有如下功能特点：
1、高性能ASP.NET服务器。这是Jexus的核心功能。不管是稳定性、易用性还是并发承载能力、并行处理速度，Jexus对ASP.NET的支持都是非常优秀的；
2、支持Fast-CGI协议。通Fast-CGI，Jexus能支持包括PHP在内的所有拥有Fast-CGI服务功能的WEB应用；
3、具有强劲的反向代理功能，同时支持多目标负载均衡。灵活运用Fast-CGI以及反向代理，Jexus可以让你的网站与各种不同类型资源（如aspx/php/jsp）实现无缝整合。
4、具备基于正则表达式的强大的URL重写功能；
5、拥有强大的流媒体支持能力，支持FLV/F4V视频文件拖动播放，支持微软平滑流媒体技术；
6、具备可控的“ASP.NET前置缓存”，能大大提升ASP.NET网站的承载能力和响应速度；
7、支持Https，具有SSL加密数据安全传输能力；
8、具有基础而实用的入侵检测功能，能自动终止已被识别的非法请求；
9、安装部署非常简便，操作使用极为简单。



一、安装：

安装前的准备工作：

* 需要libc2.3.2或更高版本的支持（可用ldd --version查询版本情况），如果需要启用https，系统中还需具备libssl库文件，比如libssl.so.0.9.8。
* 系统已经安装好mono 2.10.8.1 或更高版本（当前最新版本是mono 3.2.1，建议使用）。
  Mono的官方网址是：www.go-mono.com。
  Mono的下载地址：http://www.go-mono.com/mono-downloads/download.html 。
  Mono的具体安装办法，请参考 www.linuxdot.net 上的有关文章。

1、下载：
cd /tmp
wget http://www.linuxdot.net/down/jexus-5.4.3.tar.gz

2、解压：
tar -zxvf jexus-5.4.3.tar.gz
cd jexus-5.4.3

3、安装：
   分全新安装和升级安装，分另由 install和upgrade两个脚本命令完成对应操作。
   A、升级安装：
     sudo /usr/jexus/jws stop
     sudo ./upgrade
     cd /usr/jexus
     强调：如果旧版Jexus不是安装在/usr/jexus文件夹而是在其它路径上的，那么，必需在upgrade命令后带上正确的目标路径参数
   B、全新安装：
     sudo ./install
     cd /usr/jexus

二、运行测试
    复制完Jexus的文件后，Jexus就可以正常工作了。
    所以，如果你的系统只要mono已经成功安装，jexus就可以直接使用，甚至连进一步的配置也完全不需要。

    如果是升级安装，你只需要用运行 “sudo ./jws start”即可启动JWS，如果不能正常工作，常常是新版本的配置方式可能有变，你可以查查jws.conf等配置文件。
    强调：如果你服务器安装有其它的WEB服务器，而且该服务正在运行，请停止它，以免造成端口冲突而造成Jexus无法启动。

    如果是全新安装，请首先建立一个默认的网站文件夹:/var/www/default，并在里面新建一个简单的网页，比如index.html。
    然后在Jexus工作文件夹(/usr/jexus/)中执行“sudo ./jws start”命令(需要root身份)，启动jexus。
    1、用cat log/jws.log,看看jws日志文件有没有什么出错的提示。
    2、如果没有错误提示，请访问一下这台服务器，看看是否有jexus的欢迎页，网址是：http://服务器IP地址/info
    3、如果已经在网站中放有首页或其它网页，你就可以访问这些网页了。



三、Jexus web server 配置（不是必须的，这儿写出来，是为了用户更好的理解jexus的工作原理）：

在 jexus 的工作文件夹中（一般是“/usr/jexus”）有一个基本的配置文件，文件名是“jws.conf”。

jws.conf 中至少有 SiteConfigDir 和 SiteLogDir 两行信息：
SiteConfigDir=siteconf      #指的是存放网站配置文件放在siteconf这个文件夹中，可以使用基于jws.exe文件的相对路径
SiteLogDir=log              #指的是jexus日志文件放在log这个文件夹中，可以使用基于jws.exe文件的相对路径

重要提示：
必须为Jexus指定并创建两个专用文件夹：一个是用于存放日志文件的“日志文件夹”，一个是存放网站配置文件的“网站配置文件夹”。
日志文件夹必须让jexus系统有写入权，因为它会在这儿写入jexus系统日志、网站访问日志等重要内容,安装程序中已经建了一个文件夹，名字是log。
网站配置文件夹是用存放网站配置文件的地方(安装包中已经建了这个文件夹，名字是siteconf)，既使只有一个网站，也必须有这个文件夹，因为jexus启动时会从这个文件夹读取网站配置的内容。
即，默认情况下，Jexus的文件夹结构是：
/usr/jexus             #JWS工作目录
/usr/jexus/siteconf    #网站配置目录
/usr/jexus/log         #日志目录



四、网站配置

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

*** 再次强调：
    1、网站配置文件的文件名不能有空格；
    2、网站配置文件夹中只能有网站配置文件，不能有其它文件文件存在。

下面以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系统含有常用首页名）
addr=0.0.0.0                     # 绑定到服务器本机的某个IP地址，默认情况下是所有地址，即“0.0.0.0”。
aspnet_exts=mspx,ttt             # 添加新出现的或自定义的ASP.NET扩展名（不建议填。多个扩展名用英文逗号分开，不加点号。系统含有常用扩展名）


B、最简配置示例
最简配置只需port和root两项，如：
port=80
root=/ /var/www/default
注：以上两个条目的含义：“port=80”指本网站的服务端口是80（标准的WEB服务端口）；“root=/ /var/www/default”是指该网站的的虚拟根路径是“/”，所对应的物理文件夹的绝对路径是“/var/www/default”，即网站的内容必须放到“/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段访问网站
A、只允许某些IP地址访问网站（白名单功能）
    默认情况下，允许所有IP地址访问。如果手工设置IP地址白名单，那么，白名单之外的IP地址会自动归入黑名单。
    配置格式，形如：
    allowfrom=1.2.3.*
    AllowFrom=2.2.3.3
B、禁止某IP或某IP端访问网站（黑名单功能）
    默认情况下，本配置为空。如果手工添加需要禁止访问的IP地址（段），必须合乎一个规则：黑名单必须是白名单的真子集。
    配置格式，形如：
    denyfrom=111.222.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.4.3版默认值是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、让Jexus的工作进程和网站工作于指定的用户权限（身份）下
在jws.conf中，添加一句：httpd.user=系统中已经存在的一个用户名，如httpd.user=www-data

12、让Jexus的工作进程和ASP.NET网站工作在指定的ASP.NET版本环境中
在jws.conf中，添加一句：Runtime=版本号，如：Runtime=v4.0.30319

13、启用“ASP.NET前置高速缓存”，提高网站ASP.NET应用的反应速度，减小服务器压力
这是Jexus特有的功能。功能很强劲、很实用。
方法是：在需要启用WEB平台级高速缓存的ASPX页面中加入“<%Response.AddHeader("PageCache-Time","60");%>”一句就行了，其中“60”是超时时间，单位为秒。

14、启用HTTPS进行SSL安全传输
本功能是对服务器与客户之间的数据进行加密传送，提高数据转输过程中的保密性。具体方法请访问www.linuxdot.net。



五、操作Jexus：
1、基本操作：
   原jws.start等命令在Jexus V5.4.3中已经合并为一个单一命令，即“jws”，这是一个shell脚本文件。

   命令参数与对应的功效：
   jws start           : 启动Jexus；
   jws start 网站名    : 启动指定的网站
   jws restart         : 重启Jexus
   jws restart 网站名  : 重启指定的网站
   jws stop            : 停止Jexus
   jws stop 网站名     : 停止指定的网站
   jws regsvr          : 注册jexus所需要的全局程序集（本命令只在安装或更新jexus后才用，而且必须用一次）。
   jws status          : Jexus是否在运行中
   jws -v              : 显示Jexus的版本号

   注意，这些脚本的拥有者应该是root，并且拥有可执行权限。

2、让Jexus能随服务器的启动而自动启动：
   方法是：在/etc/rc.local文件的加入“/usr/jexus/jws start”一行。注意，路径应该是你系统中JWS的实际路径，不要把路径写错了。



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



七、信息反馈与技术交流：
技术社区：www.linuxdot.net
QQ群号码：103810355
开发者邮箱：j66x@163.com


八、重要声明：
1，Jexus V5.4.3 是免费软件，可以自由下载、传播和使用。但Jexus作者、发布者、维护者不对Jexus的用途、作用、效果、技术支持以及其它相关内容作任何明确或暗含的承诺，不负担任何直接或间接的责任。
2，为了确保Jexus的良性发展并为您提供更好的服务，Jexus需要得到广大用户和支持免费软件发展事业的热心人的大力支持：
   A、您可以利用各种机会宣传Jexus优良品质和实用价值，为Jexus的发展进步摇旗助威；
   B、您可以为初学者解难答疑，发布使用心得和技术理论，为推广、普及Jexus的部署和应用作出贡献；
   C、你可以将Jexus的一些重要的技术文档翻译为英文或其它文字并公开、免费发布，为Jexus跨出国门走向国际添砖加瓦；
   D、您可以利用开发新工程或升级旧工程的机会，利用Jexus把原来部署在WINDOWS上的WEB应用部署到Linux上；
   E、您可以通过Jexus社区、QQ群、邮箱等各种渠道及时反馈Jexus的BUG，或者向Jexus的开发者、维护者提供富有建设性意义的各种建议；
   F、您可以为Jexus提供广告支持，或向Jexus开发者适量的资金援助，为Jexus的持续发展提供动力源泉。