config.md

配置文件

kangle配置支持xml格式的配置文件，主配置文件为etc/config.xml，可以在ext目录放置多个配置文件,支持多文件配置.

配置说明

• 属性 指xml元素的属性，如<img src='a.gif'/> 其中src就是img其中之一属性。
• 文本内容 指xml元素的文本内容，如<sex>female</sex>其中female就是sex的文本内容
• 子元素 如<person><name>abc</name></person> 其中name就是person的子元素

加载顺序

在多个配置文件存在时，可以在配置文件的第一行设置加载顺序.格式: <!--#start xxx --> 其中xxx为顺序号数字，数字越小越先加载，主配置文件加载顺序为100。

config

config为根元素，所有xml配置必须在<config></config>之中。

worker_thread

文本内容设置工作线程数.必须是2的n次方,默认是0,自动根据cpu数量调整。

listen

侦听端口,有如下属性：

• ip 侦听ip，如*,127.0.0.1
• port 端口
• type 类型,可以有http https manage manages tcp tcps

1. http/https，端口为http服务。
2. manage/manages，端口为管理端口。
3. tcp/tcps,端口为tcp四层转发

ssl相关属性

当type为https manages tcps时，可以设置如下ssl属性

• certificate ssl公钥
• certificate_key ssl私钥
• cipher ssl算法
• protocols ssl协议
• http2 是否支持http2(0或1)
• http3 是否支持http3(0或1)
• early_data 是否支持early_data
• reject_nosni 是否拒绝无sni的请求(0或1)，注意此配置仅在listen中有效。

例如:
<listen certificate='etc/server.crt' certificate_key='etc/server.key' cipher='' http2='1' ip='127.0.0.1' port='443' protocols='' reject_nosni='1' type='https'/>

cache

配置缓存,kangle支持内存和磁盘两级缓存，也支持普通和智能缓存，智能缓存是指kangle缓存部分内容，可以合并多个部分缓存。 属性:

• default 默认是否缓存(0或1)
• memory 内存缓存大小,可以带单位K M G
• disk 磁盘缓存大小,可以带单位K M G,磁盘缓存在使用前需要格式化缓存目录.
• disk_dir 磁盘缓存目录,如为空，则表示主目录下cache目录。
• refresh_time 默认缓存时间,单位秒.
• max_cache_size 单个普通缓存文件大小，可以带单位K M G，如超过则开启智能缓存(中断了也可以缓存部分)。
• max_bigobj_size 单个最大智能缓存文件大小，可以带单位K M G，如超过将不缓存，一般的max_bigobj_size要大于max_cache_size
• cache_part 是否缓存部分内容(0或1),默认是开启1.
• disk_work_time 磁盘缓存清理时间，格式同crontab，可以设置一个时间段，用于集中清理磁盘缓存。

例如:
<cache cache_part='1' default='1' disk='1g' max_bigobj_size='1g' max_cache_size='256k' memory='1G' refresh_time='30'/>

fiber

协程相关设置，属性：

• stack_size 协程堆栈大小，

ssl_client

ssl发起连接时相关设置，属性:

• ca_path CA目录
• chiper ssl算法设置
• protocols ssl协议设置

run_as

运行身份设置，如果设置了run_as必须以超级用户身份启动kangle,否则无法切换，属性:

• user 运行用户
• group 运行组

dns

设置dns解析工作者数，属性:

• worker 工作者数

io

磁盘io相关设置

• worker 最大工作者数，0不限制
• max 最大io并发数，0不限制，超过此数将拒绝
• buffer 一次读写的buffer数。

timeout

配置超时时间，属性:

• rw 读写超时时间,单位秒。默认60秒。
• connect 连接超时时间，单位秒,如缺失则同rw一样。

compress

压缩配置，属性：

• min_length 最小压缩大小，对于已知大小的并且小于该值的，将不会压缩.
• only_cache 是否只压缩可以被缓存的网页(0或1)，设置为1动态的将不压缩，默认是0.
• gzip_level gzip压缩级别，设置为0，不使用gzip压缩.
• br_level br压缩级别，设置为0，不使用br压缩
• zstd_level zstd压缩别，设置为0，不使用zstd压缩

connect

连接相关配置，属性:

• max 最大连接数,默认是0不限制，超过则拒绝新连接。
• max_per_ip 每ip最大连接数，默认是0不限制，超过则拒绝该ip的新连接。
• per_ip_deny 超过max_per_ip时，是否加入黑名单(0或1),默认是0。
• max_keep_alive 最大长连接数，超过则使用短连接。

admin

设置控制台http认证信息,即listen为manage和manages的服务。 属性:

• user 用户名
• password 密码
• admin_ips 允许ip,多个ip用|分割，可以用*代表所有。
• auth_type http认证类型，可以是Basic或Digest

log

日志设置，属性:

• access 访问日志文件.
• level 日志级别，级别越大，记录信息越多，默认是2
• rotate_time 访问日志翻转时间,格式同crontab
• rotate_size 访问日志翻转大小,可以带单位K M G
• logs_day 总共保存日志天数。
• logs_size 总共保存日志大小。
• error_rotate_size 错误日志翻转大小，可以带单位K M G
• radio 如果日太多，可以抽样，比如3抽1，radio就写3.

server

定义上游服务，包含单节点服务和多节点服务。带属性 host，即是单节点服务，共有属性:

• name 指示服务名称。

单节点

属性:

• host 格式: ip:port ,port可以带s,表示是ssl端口。
• proto 协议，支持http,fcgi,ajp,tcp
• life_time 长连接时间，如果设置为0，则不使用长连接。
• self_ip 连接服务，使用本机ip，在多ip时有用。

多节点

属性:

• url_hash 0或1,根据url进行hash，选择节点.
• ip_hash 0或1,根据访问者ip进行hash,选择节点.
• cookie_stick 0或1, 使用cookie黏着，确保相同的节点服务某个客户，对一些session会话保持有用。
• max_error_count 最多错误次数，对于某一节点，如果连接错误达到该值，将被临时下线。
• error_try_time 对于临时下线的节点，每过多少秒重新测试节点是否健康。

子元素 用于定义节点：

node

属性:

• weight 权重，对于多个节点可以设置不同的权重。
• 其他属性参考，单节点

cmd

定义命令扩展,属性:

• name 指示服务名称。
• proto 协议，支持http,fcgi,ajp,tcp
• life_time 长连接时间，单位:秒，如果设置为0，则不使用长连接。
• idle_time 空闲时间，单位:秒，超过此时间，将关闭相应进程。
• max_request 最多请求数，超过此设置，将关闭进程。
• max_error_count 最多错误次数，对于某一节点，如果连接错误达到该值，将关闭进程。
• file 程序文件名
• param 程序参数
• type 命令扩展类型，sp表示单进程多线程，mp表示多进程单线程。
• port tcp端口号，对于fastcgi协议的，port设置为0。
• worker 工作者数量，对于type是mp的情况，可以指定进程数。

子元素:

env

环境变量,属性用于变量名。

pre_event/post_event

pre_event用于在启动进程前，用于执行批处理，post_event用于启动后执行。

dso_extend

加载dso扩展,属性:

• name 扩展名
• filename dso文件
• 其他属性用于各自dso使用。

request和response

request请求控制，response为回应控制 每一个请求进来时，从request中的BEGIN 表中开始匹配规则目标,直接有命中为止，如没有匹配，则使用request的默认目标 每一个请求回应之前，从 response中的BEGIN 表中开始匹配规则目标,直接有命中为止，如没有匹配，则使用response的默认目标

request和response可以定义 action 属性为默认目标,action可以为:

• deny 拒绝
• allow 接受
• request中可以为server:名称 反向代理到名称

子元素:

named_acl和named_mark

定义命名模块，命名模块可以在acl和mark中引用

属性:

• name 模块id名字,要求唯一
• module 模块类型名称
• 各模块其他属性

table

table用于定义控制表，name属性指示唯一的名称,其中名称BEGIN为开始的默认表,POSTMAP在response中映射完物理路径后开始匹配规则的默认表。

子元素:

chain

规则链,属性 action 指示 目标,子元素:

acl和mark

定义匹配模块和标记模块,可以是引用named_acl和named_mark命名的模块，也可以定义匿名模块.

• ref属性用于引用命名模块,如没有则定义匿名模块，其中module指示模块类型名称
• or 0或1,默认是0,1表示和下一个匹配是逻辑或的关系,否则是逻辑与.
• revers 0或1,表示逻辑非,用于逻辑反转.
• 其他属性用于各模块其他属性。 参考acl和mark.

vhs

虚拟主机全局配置,有如下子元素:

index

默认文件，属性 file 设置文件名。

error

错误代码映射,属性:

• code 错误代码，如403 404
• file 文件

mime_type

文件扩展名类型，属性:

• ext 文件扩展名,如 html
• type 文件类型，如：text/html
• compress 设置压缩(0,1,2)，0表示不明，1表示压缩，2表示永不压缩。默认是0。
• max_age 缓存时间，

alias

别名设置，属性:

• path 目录
• to 别名路径，注意不可以使用绝对路径(以/开头)
• internal 是否是内部别名(0或1)，默认是0，当别名是内部时，仅内部可见。

map_file

基于文件扩展名匹配扩展，看采用何种方式处理请求。属性:

• ext 文件扩展名
• extend 扩展,格式是扩展类型<: 扩展名>，扩展类型可以是:

1. server 单节点或多节点上游服务器。
2. cmd cmd扩展
3. dso dso扩展
4. default 默认，当静态文件直接发送。无扩展名。

• confirm_file 是否确认文件存在，0表示不确认，1表示确认存在，2表示确认不存在。默认是0不确认。
• allow_method 允许方法,*表示所有。多个方法用,隔开。如GET,POST

map_path

基于路径的匹配扩展，看用何种方式处理请求。属性:

• path 路径名
• extend confirm_file allow_method同map_file

vh

配置虚拟主机，有如下属性:

• name 虚拟主机名称，要求唯一。
• doc_root 主目录，可以是绝对地址，也可以是相对地址。
• browse 是否浏览(0或1,默认0),当url是目录时，没有默认首页时，是否列出文件和目录。
• inherit 是否继承(0或1,默认0),是否继承全局vhs的属性设置index,error,mime_type,alias,map_file,map_path。
• user 运行用户
• group 运行组,如果是windows系统，则表示user的密码。
• speed_limit 限速大小. 可以带单位K,M,G
• max_connect 最大连接数
• status 状态，0是正常，其他表示已经关闭。
• max_worker,max_queue 设置最大工作者和最大等待队列.
• fflow 是否开启流量统计(0或1,默认0)
• log_file 访问日志文件
• log_rotate_time 访问日志翻转时间，格式同crontab
• log_rotate_size 访问日志翻转大小，可以带K M G单位
• logs_day 访问日志保存天数
• logs_size 访问日志总大小
• certificate,certificate_key, cipher ,protocols,early_data,http2,http3 等ssl相关属性可以参考ssl相关属性

vh还有有如下子元素:

host

绑定域名，可以有属性``dir表示子目录。 文本内容设置域名。 如:

<host dir='abc'>www.abc.com</host>

绑定www.abc.com域名到abc子目录

bind

绑定到端口,文本内容设置端口格式为:ip:port,ip可以设置为*表示所有，0.0.0.0表示ipv4,::表示ipv6. port可以加s,t等后缀，s表示ssl端口。t表示tcp端口。 如：

<bind>*:443s</bind>

表示绑定到443的ssl端口。

index/error/alias/map_file/map_path

参考vhs

request和response

参考全局request和response