Kangle/配置文件

Kangle | Kangle使用

主配置文件etc/config.xml

<config programVersion='1.0' configVersion='0'>
 <!--Listen指令告诉服务器在哪个IP地址哪个端口提供什么类型的服务请求。如果Listen指令仅指定了端口和服务类型，则服务器会监听所有的IP地址；
如果指定了地址+端口+服务类型的组合，则服务器只监听来自此特定地址上特定端口的提定服务请求。至少需要使用一个listen,如果使用多个Listen指令，
可以指定在多个地址和端口上进行监听。
type是指类型,有http,manage,https,manages ,manage是指设定的端口是管理端口，https是指使用ssl加密的http ,manages是指启用加密的manage. -->
 <listen ip='*' port='8088' type='http' />
<listen ip='*' port='3311' type='manage' />
 <!--启用HTTP持久链接,若值设为0，则关闭这个特性，不启用。
 Keep-Alive扩展自HTTP/1.0和HTTP/1.1的持久链接特性。提供了长效的HTTP会话，用以在同一个TCP连接中进行多次请求。
在某些情况下，这样的方式会对包含大量图片的HTML文档造成的延时起到50%的加速作用。	
 kangle在关闭持久连接前等待下一个请求的秒数。一旦收到一个请求，超时值将会被设置为t指令指定的秒数。   -->
 <keep_alive>120</keep_alive>
<!--接受和发送数据的超时时间   -->
<timeout>30</timeout>
<!--进程运行时的用户
User指令用于设置实际提供服务的进程的用户。为了使用这个指令，服务器必须以root身份启动和初始化。
如果你以非root身份启动服务器，进程将不能够切换至非特权用户，并继续以启动服务器的原始用户身份运行。   -->
<run user=''/>
<!--admin是进入kangle管理界面的用户名。
crypt是用户密码加密的类型，有两种md5（密文）和plain（明文）。
allowip提定管理用户名从提定IP地址进行登入。可提定多个IP地址进行登入。*可以从任何一个IP址进行登入。   -->
<admin user='admin' password='kangle'>
<allowip>127.0.0.1</allowip>
<allowip>*</allowip>
</admin>
<!--网页压缩。gzip default='0'不进行网页压缩，gzip default='1'进行网页压缩。
  only_gzip_cache 1表示只压缩可以缓存的网页。
   min_gzip_length 最小压缩长度。压缩长度可进行随意设定。
   gzip_level 压缩级别，有五级。最低是1级，压缩频率低。最高是5级，压缩频率高，同时也更耗cpu资源。-->
<gzip default='0' only_gzip_cache='0' min_gzip_length='256' gzip_level='5'/>
<!--网页缓存。默认是打开。
max_cache_size 单个文件缓存的大小。
memory 总共缓存到内存的文件大小。
refresh_time 缓存最小刷新时间。
 -->
<cache default='1' max_cache_size='5242880'>
<memory>104857600</memory>
<refresh_time>30</refresh_time>
/cache>
<!--connect max_per_ip 每个IP连接数。
max IP的总共连接数。   -->
<connect max_per_ip='20' max='2000' />
<!--启用防刷新攻击
   在total_seconds设定的秒数内，超过max_request设定的值，就认为是在被攻击。-->
<attack enable='1' max_request='30' total_seconds='20' path_info='1'/>
<!--默认字符集   -->
<charset>gbk</charset>
<!--插入VIA头   -->
<insert_via>0</insert_via>
<!--插入X-Forwarded-For   -->
<x_forwarded_for>1</x_forwarded_for>
<!--日志级别，级别越高记录的内容越多。最低级为1，最高级为5，一般设为3.   -->
<log level='3'/>
<!--服务器扩展，支持server,cgi,api扩展 -->
<extends>
<!--
<server name='apache' type='http' host='localhost' port='82'/>
<server name='php' type='fastcgi' host='localhost' port='10080'/>
<cgi name='php' cmd='/usr/bin/php-cgi' env='REDIRECT_STATUS=CGI'/>
<api name='php' file='bin/libphp5.so'/>
-->
</extends>
<!-- 管理回写数据 此处对应管理后台的wback  -->
<writebacks>
</writebacks>
<!-- request控制 此处对应管理后台的request access  --> 
<request action='vhs:kangle' >
<!-- 系统将从BEGIN表开始检查 -->
<table name='BEGIN'>
</table>
</request>
<!-- response控制 此处对应管理后台的response access  -->
<response action='allow' >
<table name='BEGIN'>
</table>
</response>
</config>

注意:每次我们修改了config.xml文件，我们可以运行 bin/kangle -r 来重新加载config.xml文件

虚拟主机配置文件etc/vh.xml

<!-- 定义虚拟主机(vhs) -->
<vhs index='默认文件列表(每个文件列表按,分开)' error_错误代码='网址'>
<!-- 定义虚拟主机(vh) -->
<vh doc_root='主目录' log_file='日志文件' inherit='是否继承虚拟主机集的设置(on或off)' 
browse='是否可以浏览(on或off)'>
<!-- 映射扩展(可以在vhs下也可以在vh下 -->
<!-- 这个是按文件扩展名来映射 -->
<map file_ext='文件扩展名' extend='扩展类型:扩展名'>
<!-- 下面是按目录映射 -->
<map path='路径' extend='扩展类型:扩展名'>
<ip>绑定IP(*表示全部)</ip>
<port>绑定端口(*表示全部)</port>
<host dir='子目录'>主机头(*表示默认)</host>
</vh>
</vhs>

注意:每次修改了vh.xml文件，我们可以运行 bin/kangle --revh 来重新加载vh.xml文件

mime类型etc/mime.type.xml

<mime.types default='默认的mime类型'>
<file ext='文件扩展名' type='mime类型'/>
<file ext='htm' type='text/html'/>
</mime.types>

参考来源

• http://www.kanglesoft.com/doc/zh_CN/ch04.html

Kangle使用手册导航
Kangle安装： Kangle安装及运行 Kangle使用： 基本使用 | 用户论证方式使用kangle代理服务器 | Kangle虚拟web服务器作反向代理服务器 | kangle管理 | 配置文件 KangleFAQ： Kangle常用问题