jexus

Posted 2020-08-20 开源、架构、Linux C/C++/python AI BI

Jexus web server V5.1 安装配置要点

一、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，其它的，比如网站配置文件等不必删除，以便将来重新启用）。