- nginx-tfs
- 这个模块实现了TFS的客户端，为TFS提供了RESTful API。TFS的全称是Taobao File System，是淘宝开源的一个分布式文件系统。
-
TFS模块使用了一个开源的JSON库来支持JSON，请先安装yajl-2.0.1。
-
./configure --add-module=/path/to/nginx-tfs
-
make && make install
Syntax： tfs_upstream tfs_ups_addr
Default： none
Context： http
指定后端TFS服务器的地址，当指令tfs_enable_rcs为on时为RcServer的地址，否则为NameServer的地址。此指令必须配置。例如:
tfs_upstream 10.0.0.1:8108;
Syntax： tfs_enable_rcs [on | off]
Default： off
Context： http, server
是否开启RcServer功能，此指令必须配置。如开启，则指令tfs_upstream指定的地址为RcServer的地址，否则为NameServer的地址。开启此指令需配置RcServer。如需使用自定义文件名功能请开启此指令，使用自定义文件名功能需额外配置MetaServer和RootServer。
Syntax： tfs_pass enable=[1 | 0]
Default： none
Context： location
是否打开TFS模块功能，此指令为关键指令，决定请求是否由TFS模块处理，必须配置。需配置在“/” location。例如：
location / {
tfs_pass enable=1;
}
Syntax： tfs_keepalive max_cached=num bucket_count=num
Default： none
Context： http, server
配置TFS模块使用的连接池的大小，TFS模块的连接池会缓存TFS模块和后端TFS服务器的连接。可以把这个连接池看作由多个hash桶构成的hash表，其中bucket_count是桶的个数，max_cached是桶的容量。此指令必须配置。注意，应该根据机器的内存情况来合理配置连接池的大小。例如：
tfs_keepalive max_cached=100 bucket_count=15;
Syntax： tfs_block_cache_zone size=num
Default： none
Context： http
配置TFS模块的本地BlockCache。配置此指令会在共享内存中缓存TFS中的Block和DataServer的映射关系。注意，应根据机器的内存情况来合理配置BlockCache大小。例如：
tfs_block_cache_zone size=256M;
Syntax： tfs_rcs_zone size=num
Default： none
Context： http
配置TFS应用在RcServer的配置信息。若开启RcServer功能（配置了tfs_enable_rcs on），则必须配置此指令。配置此指令会在共享内存中缓存TFS应用在RcServer的配置信息，并可以通过指令tfs_poll_rcs来和RcServer进行keepalive以保证应用的配置信息的及时更新。例如：
tfs_rcs_zone size=128M;
Syntax： tfs_poll_rcs lock_file=/path/to/file interval=time enable=[1 | 0]
Default： none
Context： http
配置TFS应用和RcServer的keepalive，应用可通过此功能来和RcServer定期交互，以及时更新其配置信息。若开启RcServer功能（配置了tfs_enable_rcs on），则必须配置此指令。例如：
tfs_poll_rcs lock_file=/path/to/nginx/logs/lk.file interval=10s enable=1;
Syntax： tfs_net_device interface
Default： none
Context： http, server
配置TFS模块使用的网卡。若开启RcServer功能（配置了tfs_enable_rcs on），则必须配置此指令。例如：
tfs_net_device eth0;
Syntax： tfs_tackle_log path
Default： none
Context： http, server
是否进行TFS访问记录。配置此指令会以固定格式将访问TFS的请求记录到指定log中，以便进行分析。具体格式参见代码。例如：
tfs_tackle_log "pipe:/usr/sbin/cronolog -p 30min /path/to/nginx/logs/cronolog/%Y/%m/%Y-%m-%d-%H-%M-tfs_access.log";
注：cronolog支持依赖于tengine提供的扩展的日志模块。
Syntax： tfs_body_buffer_size size
Default： 8k|16k
Context： http, server, location
配置用于和后端TFS服务器交互时使用的的body_buffer的大小。默认为页大小的2倍。建议设为2m。例如：
tfs_body_buffer_size 2m;
Syntax： tfs_connect_timeout time
Default： 3s
Context： http, server, location
配置连接后端TFS服务器的超时时间。
Syntax： tfs_send_timeout time
Default： 3s
Context： http, server, location
配置向后端TFS服务器发送数据的超时时间。
Syntax： tfs_read_timeout time
Default： 3s
Context： http, server, location
配置从后端TFS服务器接收数据的超时时间。
能支持上传文件大小决定于client_max_body_size指令配置的大小。