首页 > 文档翻译 > records.config

records.config

2013年7月15日     浏览数:10,553 发表评论 阅读评论

records.config参数详解(基于3.2.4配置文件)

该版本是基于3.2.4的records.config参数整理而来,结合了官网的参数解说进行汉化得来。有很多参数在翻译的过程中可能并不是很准确,或是我的理解有偏差,翻译的完全不对,或者是我不懂没有功能的介绍,都希望大家能够指正,共同维护,将这个版本不断完善,希望通过我们的努力能够早日将ats推广开来

records.config是Traffic Server使用的一系列可以配置的变量合集,很多变量是可以用过使用Traffic_line或者Traffic_shell来使更改生效(不需要重启)。在修改了records.config文件之后,需要切换到Traffic server的bin目录下面使用命令traffic_line -x使修改生效。当修改了集群中的某一个节点的配置的时候,Traffic server会自动将更改应用到集群的其他节点。

格式

每个变量的格式如下:

CONFIG variable_name DATATYPE variable_value

DATATYPE是INT(整数),STRING(字符串),或FLOAT (浮点)。

实例

在下面的示例中,proxy.config.proxy_name是一个字符串类型的参数,值为my_server。这意味着,该Traffic Server代理服务器的名称是my_server。

CONFIG proxy.config.proxy_name STRING my_server

在下面的示例中,proxy.config.arm.enabled一个boolean类型的参数。值为0(零)禁用该选项,值为1表示启用该选项。

CONFIG proxy.config.arm.enabled INT 0

在下面的示例中,变量设置集群的启动超时时间为10秒。

CONFIG proxy.config.cluster.startup_timeout INT 10

配置变量

下面的列表描述的配置变量在records.config文件。

System Variables

proxy.config.proxy_name
STRING
默认值:本机的hostname
该变量可以被reload
Traffic Server的节点的名称。
proxy.config.config_dir
STRING
默认:etc/trafficserver
指定Traffic Server配置文件的目录。
proxy.config.proxy_binary_opts
STRING
默认值:-M
启动Traffic Server的命令行选项。
proxy.config.env_prep
STRING
默认:example_prep.sh
该脚本将在traffic_manager衍生出traffic_server过程之前执行,安装后找不到该文件,不过在源代码的proxy目录下面可以看到。
proxy.config.temp_dir
STRING
默认值:/ tmp目录
用于存放Traffic Server临时文件的目录。
proxy.config.alarm_email
STRING
默认:nobody
该变量可以被reload
Traffic Server发送报警信息的电子邮件地址。
proxy.config.syslog_facility
STRING
默认值:LOG_DAEMON
用于记录系统日志文件。请参阅了解Traffic
Server的日志文件
proxy.config.output.logfile
STRING
默认值:traffic.out
Traffic
Server处理过程中产生的的名称和位置的文件,其中包含的警告,状态消息和错误消息。如果没有指定路径,然后Traffic
Server将会在日志目录中创建。
proxy.config.snapshot_dir
STRING
默认值:snapshots
Traffic Server的目录中存储在本地系统上配置快照。除非您指定一个绝对路径,此目录位于Traffic Server的配置目录。
proxy.config.system.mmap_max
INT
默认值:2097152(2M)
功能暂时未知

MainThreads

主要线程配置(工作线程),同时可以在各自的配置模块进行SSL线程,磁盘I/O线程任务线程的配置。

proxy.config.exec_thread.autoconfig
INT
默认:1
启用时(默认为1),Traffic Server的线程数可以根据可用的CPU内核线程进行设置。
proxy.config.exec_thread.autoconfig.scale
FLOAT
默认值:1.500000
影响Traffic Server的线程数。乘数通常是可用的CPU内核的数量。默认情况下,这是缩放系数是1.5。
proxy.config.exec_thread.limit
INT
默认值:2
这是什么做的?(连官网居然都是这么写的)PS:字面意思看起来是执行线程的限制数!
proxy.config.accept_threads
INT
默认值:0
当启用(1),运行一个单独的线程来接受处理。如果禁用(0),那么只有一个线程。

Local Manager

proxy.config.admin.admin_user
STRING
默认值:admin
该参数目前好像没办法使用哦
proxy.config.admin.number_config_bak
INT
默认值:3
保存修改过的配置文件的副本的最大数量,这些副本例如records.config_123,都在配置文件目录下面。
proxy.config.admin.user_id
STRING
默认值:nobody
选项用于指定运行的traffic_server过程,也可以用来指定的配置文件和日志文件的所有权。

Traffic Server指定的非特权用户帐户。

在2.1.1版本中,如果user_id是井号(#)开头,其余的字符串被认为是数字用户标识。如果该值设置为“-1”,Traffic
Server将不会改变用户在启动过程中。

现在禁止设置user_ID的根或#0,以提高安全性。试图这样做,会造成致命故障的traffic_server。然而,有两种方法来绕过这个限制:指定DBIG_SECURITY_HOLE在CXXFLAGS在编译过程中设置USER_ID
=#-1和trafficserver的作为根。

Process Manager

proxy.config.admin.autoconf_port
INT
默认值:8083
默认管理端口。
proxy.config.process_manager.mgmt_port
INT
默认值:8084
给traffic_manager和traffic_server使用的端口之间的内部通信使用。

Network

proxy.local.incoming_ip_to_bind
STRING
默认:任何地址(0.0.0.0及::)
这个变量可以绑定到一个特定的IP地址在一个多接口的设置。它设置了一个的全局默认使用的所有端口,除非明确覆盖在端口配置描述符。要指定地址的IPv4和IPv6地址在列表这个值。默认的IP地址家庭独立处理。

指定使用的IPv4地址为本地地址的客户端(监听)连接。

当地的 代理。本地。incoming_ip_to_bind STRING 192.168.101.18

指定的IPv4和IPv6的地址为本地地址的客户端(监听)连接使用。

Alarm Manager

proxy.config.alarm.bin
STRING
默认值:example_alarm_bin.sh
脚本文件的名称,可以执行某些操作时报警信号。默认的文件名
为example_alarm_bin.sh的BIN目录是一个示例脚本。您必须编辑该脚本以满足您的需求。安装后找不到该文件,不过在源代码的proxy目录下面可以看到。
proxy.config.alarm.abs_path
STRING
默认值:NULL
脚本文件example_alarm_bin.sh的完整路径。

HTTP Engine

basic

proxy.config.http.server_ports
STRING
默认值:8080,如果加https的则可以写成(8080 8443:ssl)
代理HTTP通信所使用的端口。这是一个列表,由空格或逗号分隔的端口描述符。每个描述符是一个由冒号分隔的关键字和值的序列。并不是所有的关键字值,那些特别指出的。关键字和值可以有一个可选的’='字符分隔的关键字和值。关键字的情况下被忽略。关键字的顺序是无关紧要的,,除非关键字冲突(例如数满和ssl的),在这种情况下,最右边包含占主导地位,但在这种情况下,奇数行为可能会导致。


参数 说明
8080 IP端口。
IPv6 使用IPv6。
IPv4 使用IPv4(默认)。
tr-in 透明入站(客户端)。
tr-out 透明出站(服务器)。
tr-full 完全透明,入站和出站。
SSL SSL terminated port。
blind Blind tunnel port。
ip-in=[addr] 作为当地的入站(听)地址使用该关键字的值。如果没有明确的规定,这也将设置地址族。如果指定的IPv4或IPv6的 IP地址族,它必须同意这个地址。
ip-out=[addr] 为本地地址连接到服务器时使用的价值。这可能是两次,一次是指定为IPv4和曾经为IPv6。实际使用的地址将取决于家庭的原始服务器地址。


示例 -

80 80:IPv6的

为IPv4和IPv6侦听端口80上的任何地址。

IPV4:8080:TR-FULL TR-全:IP-FC02:10:10:1 :: 1]:8080

任何IPv4地址在端口8080上,听着透明和透明的端口8080上的本地地址FC01:10:10:1
:: 1(这意味着IPv6的)。

8080:IPV6:TR-443全:SSL 80:IP = 192.168.17.1,IP输出= [FC01:10:10:1 :: 1]:IP的= 10.10.10.1

听端口8080上的任何地址,IPv6的,完全透明的。设置SSL端口443。侦听,端口80,IPv4的IP地址192.168.17.1,并连接到原始服务器使用本地地址为10.10.10.1的IPv4和FC01:10:10:1
:: 1的IPv6。

注:所有的IPv6地址必须用方括号括起来。

注:SSL,你还必须配置证书,此选项仅处理端口配置。

注:老风格的端口配置仍然可以工作,但支持,在一些点在未来将被删除。

proxy.config.http.connect_ports
STRING
默认:443 563
: proxy.config.http.insert_request_via_str
INT
默认:1
via头的设置有以下四种:

  • 0 =不修改或者设置目前的via头。
  • 1 =修改via头,添加少量信息
  • 2 =修改via头,添加较多信息
  • 3 =修改via头,添加最多信息

注:通过:头字符串的解释,这里可以docoded。

该变量可以被reload
proxy.config.http.insert_response_via_str
INT
默认:0
该变量可以被reload
proxy.config.http.response_server_enabled
INT
默认:1
该变量可以被reload
添加一个Server头,有以下三种选项:

  • 0=不添加/修改目前的Server头。
  • 1=添加一个Server头。
  • 2=只在当前不存在Server头时则添加
proxy.config.http.insert_age_in_response
INT
默认:1
该变量可以被reload
Traffic
Server的此选项指定是否要在响应头中插入age头。age字段中的值是响应由源服务器或重新确认生效的时间量高速缓存的估计。

  • 0=不需要在响应中添加age头
  • 1=需要在响应中添加age头
proxy.config.http.enable_url_expandomatic
INT
默认:0
该变量可以被reload
启用(1)或禁用(0)。com域名扩展。配置Traffic
Server的,解决不合格的主机名前面加上www.和追加.com,然后重定向到的扩展地址。例如:如果用户端发出请求的主机,然后流量重定向请求www.host.com。,
proxy.config.no_dns_just_forward_to_parent
INT
默认:1
proxy.config.uncacheable_requests_bypass_parent
INT
默认:1
proxy.config.keep_alive_enabled_in
INT
默认:1
proxy.config.keep_alive_enabled_out
INT
默认:1
proxy.config.http.chunking_enabled
INT
默认:1
该变量可以被reload
指定Traffic Server可以生成一个分块响应:

  • 0=不启用
  • 1=始终
  • 2=如果服务器返回的HTTP版本小于HTTP/1.1,就生成一个区块的反应,
  • 3=如果客户端请求是HTTP/1.1和源服务器返回HTTP/1.1,生成一个区块的反应

注意:如果使用HTTP/1.1,然后可以使用Traffic
Server的流水线keep-alive连接到原始服务器。如果使用HTTP/0.9,然后流量服务器不使用保持活动状态连接到原始服务器。如果使用了HTTP/1.0,然后可以使用流量服务器保持活动的连接,无需流水线到原始服务器。

proxy.config.http.send_http11_requests
INT

默认:1

发送HTTP1.1请求:

  • 0=从不
  • 1=始终
  • 2=如果服务器返回的HTTP版本小于HTTP/1.1
  • 3=如果客户端请求是HTTP/1.1和源服务器返回HTTP版本小于HTTP/1.1
proxy.config.http.share_server_sessions
INT
默认:2
共享服务器连接

  • 0=不启用
  • 1=启用,使用一个全局共享连接池
  • 2=启用,每个worker线程使用一个共享连接池
proxy.config.origin_server_pipeline
INT
默认:1
proxy.config.user_agent_pipeline
INT

HTTP referer filtering

默认:8
proxy.config.http.referer_filter
INT
默认值:0
: proxy.config.http.referer_format_redirect
INT
默认值:0
: proxy.config.http.referer_default_redirect
STRING
默认值:http://www.example.com

parent proxy configuration

proxy.config.http.parent_proxy_routing_enable
INT
默认值:0
该变量可以被reload
启用(1)或禁用(0)父节点缓存选项。请参阅Hierarchical Caching
proxy.config.http.parent_proxy.retry_time
INT
默认值:300
该变量可以被reload
当父节点缓存不可用时,允许的连接重试的时间。
proxy.config.http.parent_proxy.fail_threshold
INT
默认值:10
该变量可以被reload
探测父节点的次数,如果超过该次数任然未能探测成功,则认为父节点不可用。
proxy.config.http.parent_proxy.total_connect_attempts
INT
默认值:4
该变量可以被reload
在跳过父节点缓存或者是回复请求失败之前允许连接尝试的次数(依赖于bypass.config的go_direct选项)
proxy.config.http.parent_proxy.per_parent_connect_attempts
INT
默认值:2
该变量可以被reload
当有多个父节点的时候,每个父节点允许的连接数。
proxy.config.http.parent_proxy.connect_attempts_timeout
INT
默认值:30
该变量可以被reload
父节点缓存的连接尝试的超时值(以秒计)。
proxy.config.http.forward.proxy_auth_to_parent
INT
默认值:0
该变量可以被reload
配置Traffic Server发送代理身份验证头信息到父缓存。

HTTP connection timeouts (secs)

proxy.config.http.keep_alive_no_activity_timeout_in
INT
默认值:115
该变量可以被reload
指定事务结束后为保证后续请求而继续打开的连接时间。
proxy.config.http.keep_alive_no_activity_timeout_out
INT
默认值:120
该变量可以被reload
指定事务结束后为保证后续传输而继续打开的连接时间。
proxy.config.http.transaction_no_activity_timeout_in
INT
默认值:30
该变量可以被reload
指定如果发生拥塞之后Traffic Server和客户端保持连接的时间。
proxy.config.http.transaction_no_activity_timeout_out
INT
默认值:30
该变量可以被reload
指定如果发生拥塞之后Traffic Server和服务器端保持连接的时间。
proxy.config.http.transaction_active_timeout_in
INT
默认值:900
该变量可以被reload
Traffic
Server和客户端保持连接的最长时间。如果传递给客户端是不完整的,在此之前超时过期,那么流量服务器关闭连接。的默认值0,表示没有超时时间。
proxy.config.http.transaction_active_timeout_out
INT
默认值:0
该变量可以被reload
Traffic Server等待一个连接到源的请求的最大时间。如果在该超时时间结束时还没有传输完成Traffic Server将会断开连接,默认值是0,表示没有超时时间
proxy.config.http.accept_no_activity_timeout
INT
默认值:120
该变量可以被reload
Traffic Server关闭没有活动的连接的超时时间间隔(以秒为单位)。
proxy.config.http.background_fill_active_timeout
INT
默认值:60
该变量可以被reload
Specifies how long Traffic Server continues a background fill before
giving up and dropping the origin server connection.
proxy.config.http.background_fill_completed_threshold
FLOAT
默认值:0.50000
该变量可以被reload
总文件大小的比例已转移时,客户端中止在该代表继续从原始服务器获取的文件,把它转换成高速缓存(一个背景填充)。

origin server connect attempts

proxy.config.http.connect_attempts_max_retries
INT
默认值:6
该变量可以被reload
当源服务器没有响应时,Traffic Server进行连接重试的最大数量。
proxy.config.http.connect_attempts_max_retries_dead_server
INT
默认值:2
该变量可以被reload
当源服务器不可用时,Traffic Server进行连接重试的最大数量。
proxy.config.http.connect_attempts_rr_retries
INT
默认值:2
该变量可以被reload
如果服务器有round-robin的DNS条目
,则该值为在round-robin条目标记为down之前允许尝试连接失败的最大值
proxy.config.http.connect_attempts_timeout
INT
默认值:30
该变量可以被reload
源服务器连接的超时值(以秒计)。
proxy.config.http.post_connect_attempts_timeout
INT
默认值:1800
该变量可以被reload
当客户端请求是POST或PUT请求,源服务器连接的超时值(以秒计)。
proxy.config.http.down_server.cache_time
INT
默认值:900
该变量可以被reload
指定Traffic
Server记录服务器down的时间,在该段时间内认为服务器down(以秒记)。
proxy.config.http.down_server.abort_threshold
INT
默认值:10
该变量可以被reload
在一个客户端因为源服务器相应太慢而放弃请求之后到Traffic
Server标记该服务器不可达之间的秒数

CongestionControl(拥塞控制)

proxy.config.http.congestion_control.enabled
INT
默认值:0
启用(1)或禁用(0)拥塞控制选项,Traffic
Server的配置就已经停止转发到原始服务器的HTTP请求时,他们变得拥挤。流量服务器向客户端发送消息稍后重试拥挤的原始服务器。请参阅使用拥塞控制

negative response caching

proxy.config.http.negative_caching_enabled
INT
默认值:0
该变量可以被reload
当启用(1),Traffic
Server的高速缓存消极反应(如404未找到)当一个请求的页面不存在。下一个客户端请求相同的页面时,流量直接从缓存服务器提供了否定的答复。

:从服务器禁止缓存的缓存控制指令将被忽略以下HTTP响应代码,无论指定的proxy.config.http.negative_caching_enabled变量的价值。下面的消极反应Traffic
Server的缓存:

204 No Content 305 Use Proxy 400 Bad Request 403 Forbidden 404 Not
Found 405 Method Not Allowed 500 Internal Server Error 501 Not
Implemented 502 Bad Gateway 503 Service Unavailable 504 Gateway
Timeout

proxy.config.http.negative_caching_lifetime
INT
默认值:1800

proxy users variables

proxy.config.http.anonymize_remove_from
INT
默认值:0
该变量可以被reload
启用之后将删除From头来保护用户的隐私。
proxy.config.http.anonymize_remove_referer
INT
默认值:0
该变量可以被reload
启用之后将删除Refer头来保护用户和网站的隐私
proxy.config.http.anonymize_remove_user_agent
INT
默认值:0
该变量可以被reload
启用之后将删除user-agent头来保护用户的隐私
proxy.config.http.anonymize_remove_cookie
INT
默认值:0
该变量可以被reload
启用之后将删除cookie头来保护用户的隐私
proxy.config.http.anonymize_remove_client_ip
INT
默认值:0
该变量可以被reload
启用之后将删除Client_IP头来保护更多的隐私。
proxy.config.http.anonymize_insert_client_ip
INT
默认:1
该变量可以被reload
启用之后将添加Client_IP头保留客户端的IP地址。
proxy.config.http.anonymize_other_header_list
STRING
默认值:NULL
该变量可以被reload
Traffic Server传出请求时删除的头列表。
proxy.config.http.insert_squid_x_forwarded_for
INT
默认值:0
该变量可以被reload
启用之后,Traffic Server将添加客户端的IP地址添加到x-forward-for

Security

proxy.config.http.push_method_enabled
INT
默认值:0
该变量可以被reload
启用(1)或禁用(0)HTTP
PUSH选项,该选项允许您直接提供内容到缓存中没有一个用户的请求。

重要提示:如果启用此选项,那么你还必须指定一个过滤规则在filter.config文件只允许某些机器推到高速缓存中的内容。

Cache Control

proxy.config.http.cache.http
INT
默认:1
该变量可以被reload
启用(1)或禁用(0)HTTP请求的缓存。
proxy.config.http.cache.ignore_client_no_cache
INT
默认值:0
该变量可以被reload
启用时Traffic Server将忽略客户端的no-cache。
proxy.config.http.cache.ims_on_client_no_cache
INT
默认值:0
该变量可以被reload
启用时,如果客户端发出的请求有no-cache头,Traffic
Server会发出一个有条件的请求到原始服务器。
proxy.config.http.cache.ignore_server_no_cache
INT
默认值:0
该变量可以被reload
启用时,Traffic Server会忽略源服务器的no-cache。
proxy.config.http.cache.ignore_client_cc_max_age
INT
默认:1
启用时,会忽略所有的客户端的Cache-Control:max-age头。
proxy.config.http.normalize_ae_gzip
INT
默认值:0
该变量可以被reload
启用(1)正常化所有的Accept-Encoding:头下列操作之一:

  • 的Accept-Encoding:gzip的(如果标题gzip压缩或X-gzip的任何q)OR
  • 空白(不包括头,Gzip已为)

最大限度地减少缓存交替的文件(如gzip压缩,gzip压缩DEFLATE与放气,),这是非常有用的。启用此选项是建议,如果您的源服务器的使用GZIP以外没有编码。

proxy.config.http.cache.cache_responses_to_cookies
INT
默认值:3
该变量可以被reload
指定缓存响应含cookies有5个选项:

  • 0 =不缓存任何含cookie的响应
  • 1 =缓存任何内容类型
  • 2 =只缓存图像类型
  • 3 =缓存为所有文字内容类型
  • 4 =缓存为所有除了系统响应的没有”Set-Cookie”或者有”Cache-Control:public”的文字内容类型
proxy.config.http.cache.ignore_authentication
INT
默认值:0
启用时,Traffic Server会忽略服务器传过来的认证头信息
proxy.config.http.cache.cache_urls_that_look_dynamic
INT
默认:1
该变量可以被reload
缓存一些看起来像动态文件的内容,即:以.aps为URL的结尾的,或包含一个问号(?)、分号(;),或CGI。完整的列表,请参阅HttpTransact
::
url_looks_dynamic
proxy.config.http.cache.enable_default_vary_headers
INT
默认值:0
该变量可以被reload
启用(1)或禁用(0)缓存不含vary头的可选http版本的内容。
proxy.config.http.cache.when_to_revalidate
INT
默认值:0
该变量可以被reload
重新验证内容有以下五种选项:

  • 0 =使用缓存指令或启发式(默认值)
  • 1 =启发式
  • 2 =总是陈旧的(总是重新验证)
  • 3 =不刷新
  • 4 =如果请求含有条件则验证,否则使用默认值

如果该请求中包含的If-Modified-since,然后Traffic
Server的总是重新验证缓存的内容,并使用客户端的代理请求的If-Modified-Since的头。

proxy.config.http.cache.when_to_add_no_cache_to_msie_requests
INT
默认值:-1
该变量可以被reload
指定添加到Microsoft Internet
Explorer请求的no-cache指令。您可以指定以下内容:

  • 0 = 无缓存添加到MSIE请求
  • 1 = 无缓存被添加到IMS MSIE请求
  • 2 = 无缓存被添加到所有MSIE请求
proxy.config.http.cache.required_headers
INT
默认值:2
该变量可以被reload
所需的报头的类型的请求的请求可缓存。

  • 0 =不需要使用头来控制文档是否可以缓存
  • 1 =需要Last-Modified,Expires,或者Cache-Control:max-age头
  • 2 =明确的一生是必需的,到期的Cache-Control:max-age的
proxy.config.http.cache.max_stale_age
INT
默认值:604800
该变量可以被reload
在不能缓存该对象之前,旧对象能够响应的最大时间。
proxy.config.http.cache.range.lookup
INT
默认:1
启用时,Traffic Server在缓存中的查找范围。

heuristic expiration

proxy.config.http.cache.heuristic_min_lifetime
INT
默认值:3600(1小时)
该变量可以被reload
一个在缓存中没有过期的并且没有过期时间的对象能被保持的最短时间
proxy.config.http.cache.heuristic_max_lifetime
INT
默认值:86400(1天)
该变量可以被reload
之前被认为是过时的,没有到期日的最高限额时,HTTP对象在缓存中保持新鲜。
proxy.config.http.cache.heuristic_lm_factor
FLOAT
默认值:0.10000
该变量可以被reload
老化系数为新鲜计算。Traffic
Server的存储对象所经过的时间,因为它改变这一比例。
proxy.config.http.cache.fuzz.time
INT
默认值:240
该变量可以被reload
多久Traffic
Server的早期刷新检查,在此期间的的文件陈旧的时间之前的一段期间。在指定的时间间隔必须在几秒钟内。
proxy.config.http.cache.fuzz.probability
FLOAT
默认值:0.00500
该变量可以被reload
一个刷新了一个文档中指定的模糊时间的概率。

dynamic content & content negotiation

proxy.config.http.cache.vary_default_text
STRING
默认值:NULL
该变量可以被reload
Traffic
Server的变化为文本文件的标题上。例如:如果你指定的用户代理,然后Traffic
Server的缓存所有的文件,它遇到不同的用户代理版本。
proxy.config.http.cache.vary_default_images
STRING
默认值:NULL
该变量可以被reload
头Traffic Server的变化的图像。
proxy.config.http.cache.vary_default_other
STRING
默认值:NULL
该变量可以被reload
对于除了文本和图片以外的其他对象,TS 根据这个头来缓存多份。(conan提供)
proxy.config.http.cache.enable_http_stats
INT
默认值:1
统计HTTP状态非常消耗资源,不需要则应当关掉

Customizable User Response Pages

proxy.config.body_factory.enable_customizations
INT
默认值:0
指定定制的响应页面是否被启用或禁用,响应页面使用:

  • 0 =禁用自定义的用户响应页面
  • 1 =仅在默认目录中使用自定义的用户响应页面
  • 2 =使用语言针对性的用户响应页面
proxy.config.body_factory.enable_logging
INT
默认:1

默认:1

启用(1)或禁用(0)登录可定制的响应页面。当启用时,Traffic
Server的错误日志中记录一条消息每次使用或修改自定义的响应页面。
proxy.config.body_factory.response_suppression_mode
INT
默认值:0
指定当Traffic Server的抑制生成响应页面:

  • 0 =永远不会抑制生成响应页面
  • 1 =总是抑制生成响应页面
  • 2 =抑制响应页面仅用于拦截的流量

Net Subsystem

proxy.config.net.connections_throttle
INT
默认值:30000
proxy.config.net.defer_accept
INT
默认值:45
启用推迟接受/接受过滤。在Linux上,这是一个以秒为单位的超时时间

Cluster

proxy.local.cluster.type
INT
默认值:3
设置集群模式:

  • 1 =满集群模式
  • 2 =仅管理模式
  • 3 =非集群
集群类型需要重启才能生效
proxy.config.cluster.cluster_port
INT
默认值:8086
proxy.config.cluster.rsport
INT
默认值:8088
可靠的服务端口。可靠的服务端口被用来发送一个集群中的节点之间的配置信息。集群中的所有节点必须使用相同的可靠的服务端口。
proxy.config.cluster.mcport
INT
默认:8089
proxy.config.cluster.mc_group_addr
STRING
默认:224.0.1.37
proxy.config.cluster.mc_ttl
INT
默认:1
proxy.config.cluster.log_bogus_mc_msgs
INT
默认:1
proxy.config.cluster.ethernet_interface
STRING
默认:lo

Cache

proxy.config.cache.permit.pinning
INT
默认值:0
该变量可以被reload
当使能(1),Traffic
Server将保持一定的HTTP对象在缓存中在一定时间内中指定的cache.config
proxy.config.cache.ram_cache.size
INT
默认值:-1
proxy.config.cache.ram_cache_cutoff
INT
默认值:4194304
proxy.config.cache.ram_cache.algorithm
INT
默认值:0
proxy.config.cache.ram_cache.use_seen_filter
INT
默认值:0
proxy.config.cache.ram_cache.compress
INT
默认值:0
proxy.config.cache.limits.http.max_alts
INT
默认值:5
proxy.config.cache.target_fragment_size
INT
默认值:1048576
proxy.config.cache.max_doc_size
INT
默认值:0
proxy.config.cache.enable_read_while_writer
INT
默认值:0
该变量可以被reload
启用(1)或禁用(0)能力的读取缓存的对象,而另一个连接完成写高速缓存相同的对象。必须启用此连接崩溃的工作
proxy.config.cache.min_average_object_size
INT
默认值:8000
: proxy.config.cache.threads_per_disk
INT
默认值:8
: proxy.config.cache.mutex_retry_delay
INT
默认值:2

DNS

proxy.config.dns.search_default_domains
INT
默认:1
该变量可以被reload
启用(1)或禁用(0)局部领域的扩大,使Traffic
Server可以尝试解决不合格扩大到本地域的主机名。例如:如果用户端发出的请求到不合格的的主机(host_x),Traffic
Server的本地域名y.com,然后将扩大流量服务器的主机名host_x.y.com。
proxy.config.dns.splitDNS.enabled
INT
默认值:0
该变量可以被reload
启用(1)或禁用(0)DNS服务器的选择。当启用时,流量服务器是指选择规范的splitdns.config文件。请参阅配置DNS服务器选择(分割DNS)
proxy.config.dns.max_dns_in_flight
INT
默认:2048
: proxy.config.dns.url_expansions
STRING
默认值:NULL
指定主机名的扩展名会自动添加到主机名失败后,查找列表。例如:如果你想Traffic
Server的添加主机名的扩展名。组织结构,然后指定组织作为这个变量的值(Traffic
Server的自动添加点(。))。

注意:如果变量proxy.config.http.enable_url_expandomatic设置为1(默认值),然后你就没有添加WWWCOM到这个列表,因为流量服务器会自动尝试WWW。后尝试您所指定的值。com。

proxy.config.dns.round_robin_nameservers
INT
默认值:0
该变量可以被reload
启用(1)或禁用(0)DNS服务器循环赛。
proxy.config.dns.nameservers
STRING
默认值:NULL
该变量可以被reload
DNS服务器。
proxy.config.dns.resolv_conf
STRING
默认:/etc/resolv.conf
允许指定的resolv.conf文件用于寻找解析器。虽然这个文件的格式为标准的resolv.conf文件必须是相同的,此选项允许系统管理员来管理在外部配置文件,而不影响其他的操作系统所使用的DNS解析器集。
proxy.config.dns.validate_query_name
INT
默认值:0

HostDB

proxy.config.hostdb.size

INT

默认值:200000

允许在主机数据库中的条目的最大数量。

注:对于20万以上的值,你必须增加值的国税发[
proxy.config.hostdb.storage_size变量在每个条目least44字节。
proxy.config.hostdb.storage_size
INT
默认值:33554432
的空间量(以字节为单位)用于存储hostdb。这个变量必须增加“数值,如果增加的sizeof的proxy.config.hostdb.size的变量。
proxy.config.hostdb.ttl_mode
INT
默认值:0
该变量可以被reload
主机数据库中的生存时间模式。您可以指定下列操作之一:

  • 0 =服从
  • 1 =忽略
  • 2 = MIN(X,TTL)
  • 3 = MAX(X,TTL)
proxy.config.hostdb.timeout
INT
默认值:1440
该变量可以被reload
前景超时时间(以分钟为单位)。
proxy.config.hostdb.strict_round_robin
INT
默认值:0
该变量可以被reload
当禁用时(0),Traffic
Server的始终使用相同的原始服务器相同的客户端,只要原始服务器。

LoggingConfig

proxy.config.log.logging_enabled
INT
默认值:3
该变量可以被reload
启用和禁用事件日志记录:

  • 0 =禁用日志记录
  • 1 =仅记录错误
  • 2 =只记录事务
  • 3 =完整的记录(错误+事务)

请参阅使用日志文件

proxy.config.log.max_secs_per_buffer
INT
默认值:5
该变量可以被reload
将缓冲区中的数据刷新到磁盘的最长时间。
proxy.config.log.max_space_mb_for_logs
INT
默认值:2000
该变量可以被reload
日志目录分配的空间大小(以MB为单位)。注:日志目录中的所有文件使用的空间,即使他们没有日志文件。在整理客户端模式下,如果没有本地磁盘的日志记录,或max_space_mb_for_orphan_logs设置一个较高的价值比max_space_mb_for_logs,TS将proxy.config.log.max_space_mb_for_orphan_logs,允许的最大日志空间。
proxy.config.log.max_space_mb_for_orphan_logs
INT
默认值:25
该变量可以被reload
分配的空间量,如果该节点作为一个整理客户端日志目录(MB)。注:当max_space_mb_for_orphan_logs是在记录系统的的最大allowedlog空间,同样的规则适用于proxy.config.log。也适用于max_space_mb_for_logs
proxy.config.log.max_space_mb_for_orphan_logs,即:日志目录中的所有文件使用的空间,即使他们没有日志文件。你可能需要考虑这一点时,就启用了远程日志记录,和凹凸的大小相同proxy.config.log.max_space_mb_for_logs。
proxy.config.log.max_space_mb_headroom
INT
默认值:10
该变量可以被reload
的日志空间限制(以字节为单位)的耐受性。如果变量proxy.config.log.auto_delete_rolled_file设置为1(启用),然后autodeletion的日志文件在日志目录中的可用空间量小于此处指定的值时,会触发。
proxy.config.log.hostname
STRING
默认值:本机hostname
该变量可以被reload
Traffic Server的机器上运行的主机名。
proxy.config.log.logfile_dir
STRING
默认值:INSTALL_DIR /日志
该变量可以被reload
日志目录的完整路径。这可能是一个绝对路径或相对路径Traffic
Server的安装目录中。注:您指定的目录必须已经存在。
proxy.config.log.logfile_perm
STRING
默认值:RW-R - R -
该变量可以被reload
日志文件的权限。使用标准的UNIX文件权
限(所有者,组和其他)。允许的值有:

-读取权限 没有权限 ŕ 瓦特的写权限 x执行权限

权限是Traffic
Server进程的umask设置。这意味着的umask设置为002,不允许对他人的写权限,即使在配置文件中指定。配置改变现有日志文件的权限时,不会更改。

proxy.config.log.custom_logs_enabled
INT
默认值:0
该变量可以被reload
启用(1)或禁用(0)自定义日志记录。
proxy.config.log.squid_log_enabled
INT
默认:1
该变量可以被reload
启用(1)或禁用(0)鱿鱼日志文件格式
proxy.config.log.squid_log_is_ascii
INT
默认:1
该变量可以被reload
鱿鱼日志文件类型:

  • 1 = ASCII
  • 0 =二进制
proxy.config.log.squid_log_name
STRING
默认值:squid
该变量可以被reload
鱿鱼日志的文件名
proxy.config.log.squid_log_header
STRING
默认值:NULL
鱿鱼日志文件的标题文本。
proxy.config.log.common_log_enabled
INT
默认值:0
该变量可以被reload
启用(1)或禁用(0)Netscape的通用日志文件格式
proxy.config.log.common_log_is_ascii
INT
默认:1
该变量可以被reload
网景常见的日志文件类型:

  • 1 = ASCII
  • 0 =二进制
proxy.config.log.common_log_name
STRING
默认值:common
该变量可以被reload
网景常见的日志文件名
proxy.config.log.common_log_header
STRING
默认值:NULL
该变量可以被reload
网景常见的日志文件头文字。
proxy.config.log.extended_log_enabled
INT
默认值:0
该变量可以被reload
启用(1)或禁用(0)Netscape的扩展日志文件格式
proxy.confg.log.extended_log_is_ascii
INT
默认:1
Netscape的扩展日志文件类型:

  • 1 = ASCII
  • 0 =二进制
proxy.config.log.extended_log_name
STRING
默认值:扩展
Netscape的扩展日志文件名
proxy.config.log.extended_log_header
STRING
默认值:NULL
该变量可以被reload
Netscape的扩展日志文件头文字。
proxy.config.log.extended2_log_enabled
INT
默认值:0
该变量可以被reload
启用(1)或禁用(0)Netscape的扩展2日志文件格式
proxy.config.log.extended2_log_is_ascii
INT
默认:1
该变量可以被reload
网景的Extended-2的日志文件类型:

  • 1 = ASCII
  • 0 =二进制
proxy.config.log.extended2_log_name
STRING
默认值:扩展
该变量可以被reload
网景的Extended-2日志文件名
proxy.config.log.extended2_log_header
STRING
默认值:NULL
该变量可以被reload
网景的Extended-2日志文件的标题文本。
proxy.config.log.separate_icp_logs
INT
默认值:0
该变量可以被reload
当使能(1),Traffic Server的配置在一个单独的日志文件存储ICP交易。

  • 0 =禁用分离,所有的ICP交易都记录在同一个文件作为HTTP交易
  • 1 =所有的ICP交易记录在一个单独的日志文件。
  • ] -1
    =过滤器所有ICP交易的从默认的日志文件,ICP交易还没有登录任何地方。
proxy.config.log.separate_host_logs
INT
默认值:0
该变量可以被reload
当使能(1),配置Traffic
Server的HTTP交易的log_hosts.config文件中列出的每个源服务器创建一个单独的日志文件。请参阅HTTP主机日志分裂
proxy.local.log.collat ion_mode
INT
默认值:0
该变量可以被reload
的日志排序模式:

  • 0 =禁用排序规则
  • 1 =该主机是一个日志整理服务器
  • 2 =主机是整理客户端和发送使用标准格式的项的排序规则服务器
  • 3
    =这台主机是一个整理客户机,将采用传统的自定义格式的项的排序规则服务器
  • 4
    =此主机的整理客户机,将使用传统的标准和自定义格式的排序规则服务器的条目

基于XML的自定义格式发送的整理服务器的信息,请参阅logs_xml.config

注:虽然Traffic
Server支持传统的自定义日志记录,你应该使用更通用的基于XML的自定义格式。

proxy.confg.log.collat ion_host
STRING
默认值:NULL
该变量可以被reload
整理的日志服务器的主机名。
proxy.config.log.collat ion_port
INT
该变量可以被reload
默认值:8085
整理的服务器和客户端之间的通信所使用的端口。
proxy.config.log.collat ion_secret
STRING
默认值:FOOBAR
该变量可以被reload
使用的密码来验证记录数据,并防止未经授权的信息交换,当服务器正在使用的排序规则。
proxy.config.log.collat ion_host_tagged
INT
默认值:0
该变量可以被reload
当使能(1),配置Traffic
Server的客户端生成日志条目,每个条目的整理,包括主机名。
proxy.config.log.collat ion_retry_sec
INT
默认值:5
该变量可以被reload
整理服务器的连接重试间隔的秒数。
proxy.config.log.rolling_enabled
INT
默认:1
该变量可以被reload
指定日志文件的推出。您可以指定以下值:

  • 0 =禁用日志文件滚动
  • 1
    =使日志文件滚动天期间,在特定的时间间隔(与proxy.config.log.rolling_interval_sec
    proxy.config.log.rolling_offset_hr变量指定)
  • 2
    =启用日志文件滚动当日志文件达到特定大小(指定的proxy.config.log.rolling_size_mb
    变量)
  • 3
    =启用日志文件滚动白天或在特定的时间间隔,当日志文件达到特定的大小(以先到为准)
  • 4
    =使能在特定的时间间隔滚动日志文件日志文件达到特定的大小(即在指定的时间,白天的时候,如果该文件是指定的大小)
proxy.config.log.rolling_interval_sec
INT
默认值:86400
该变量可以被reload
日志文件滚动的时间间隔,以秒为单位。的最低值是300(5分钟)。最大值为86400秒(一天)。

注意:如果你开始Traffic
Server的下一个滚动的时间在几分钟之内,然后滚动,直到下一次的滚动时间可能不会发生。

proxy.config.log.rolling_offset_hr
INT
默认值:0
该变量可以被reload
该文件滚动偏移小时。小时的日志滚动期的那一天开始。
proxy.config.log.rolling_size_mb
INT
默认值:10
该变量可以被reload
日志文件的大小,滚动发生之前,必须达到。
proxy.config.log.auto_delete_rolled_files
INT
默认:1
该变量可以被reload
启用(1)或禁用(0)冷轧文件自动删除。
proxy.config.log.sampling_frequency
INT
默认:1
该变量可以被reload
配置Traffic
Server的只是一个示例,而不是每一笔交易的交易记录。您可以指定以下值:

  • 1 =记录每一笔交易
  • 2 =每一秒的交易记录
  • 3 =每第三个交易记录等…

ReverseProxy

proxy.config.reverse_proxy.enabled
INT
默认:1
该变量可以被reload
启用(1)或禁用(0)HTTP反向代理。
proxy.config.header.parse.no_host_url_redirect
STRING
默认值:NULL
该变量可以被reload
到的URL,重定向请求与无主机头(反向代理)。

URLRemapRules

proxy.config.url_remap.default_to_server_pac
INT
默认值:0
该变量可以被reload
启用(1)或禁用(0)PAC文件的请求被重定向到PAC端口的代理服务端口(默认为8080)。对于这种类型的重定向工作,变量proxy.config.reverse_proxy.enabled必须被设置为1。
proxy.config.url_remap.default_to_server_pac_port
INT
默认值:-1
该变量可以被reload
PAC端口设置,使PAC请求将被重定向到Traffic
Server的代理服务端口到此端口。-1是默认设置,即设置PAC端口的自动配置端口(默认的自动配置端口是8083)。这个变量可以一起使用的proxy.config.url_remap.default_to_server_pac变量来获得一个PAC文件从一个不同的端口。您必须创建并运行一个过程,在这个端口上提供一个PAC文件。例如:如果你创建了一个Perl脚本,在端口9000上监听,写一个PAC文件的任何要求,那么你可以这个变量设置为9000。来自代理服务器的8080端口上的浏览器请求的PAC文件将得到PAC文件的Perl脚本提供服务。
proxy.config.url_remap.remap_required
INT
默认:1
该变量可以被reload
这个变量设置为1,如果你想Traffic
Server的服务请求从源服务器的映射的规则的remap.config文件中列出。如果不符合要求,那么浏览器就会收到一个错误。
proxy.config.url_remap.pristine_host_hdr
INT
默认:1
该变量可以被reload
这个变量设置为1,如果你想保留在重映射请求的客户端主机头。

SSL Termination

proxy.config.ssl.enabled
INT
默认值:1
启用(1)或禁用(0)SSL终止选项。
proxy.config.ssl.number.threads
INT
默认:5
SSL线程的数量默认是CPU数量和proxy.config.exec_thread.autoconfig.scale的乘积。在这里您可以覆盖(将其设置为一个非零值)。
proxy.config.ssl.SSLv2
INT
默认:1
启用(1)或禁用(0)SSLv2的。请禁用它。
proxy.config.ssl.SSLv3
INT
默认:1
proxy.config.ssl.TLSv1
INT
默认:1
使用HTTPS连接,是选择客户端还是服务器
proxy.config.ssl.server.cipher_suite
STRING
默认值:RC4-SHA:AES128-SHA:DES-CBC3-SHA:AES256-SHA:ALL:!aNULL:!EXP:!LOW:!MD5:!SSLV2:!NULL
proxy.config.ssl.server.honor_cipher_order
INT
默认值:0
proxy.config.ssl.compression
INT
默认值:1
SSL压缩选项
proxy.config.ssl.server_port
INT
默认值:443
SSL通信所使用的端口。
proxy.config.ssl.client.certification_level
INT
默认值:0
设置客户端认证级别:

  • 0=没有客户端证书
  • 1=客户端证书是可选的
  • 2=需要客户端证书
proxy.config.ssl.server.cert_chain.filename
STRING
默认值:NULL
网站的根证书。
proxy.config.ssl.server.cert.path
STRING
默认值:/配置
Traffic Server的SSL证书(服务器证书)的位置。
proxy.config.ssl.server.private_key.filename
STRING
默认值:NULL
Traffic Server的私钥的文件名。改变这个变量,如果不是位于Traffic
Server的SSL证书文件的私钥。
proxy.config.ssl.server.private_key.path
STRING
默认值:NULL
Traffic
Server的私钥的位置。只有当私有密钥的SSL证书文件不是位于这个变量更改。
proxy.config.ssl.CA.cert.filename
STRING
默认值:NULL
进行验证,客户端证书的证书颁发机构的文件名。
proxy.config.ssl.CA.cert.path
STRING
默认值:NULL
进行验证,客户端证书的证书颁发机构文件的位置。

client related configuration

proxy.config.ssl.client.verify.server
INT
默认值:0
配置Traffic Server的验证原始服务器证书的证书颁发机构(CA)。
proxy.config.ssl.client.cert.filename
STRING
默认值:NULL
Traffic Server上安装SSL客户端证书的文件名。
proxy.config.ssl.client.cert.path
STRING
默认值:/配置
Traffic Server上安装SSL客户端证书的位置。
proxy.config.ssl.client.private_key.filename
STRING
默认值:NULL
Traffic Server的私钥的文件名。改变这个变量,如果不是位于Traffic
Server的SSL客户端证书文件的私钥。
proxy.config.ssl.client.private_key.path
STRING
默认值:NULL
流量服务器的私钥的位置。更改此变量,只有当私钥不会设在SSL客户端证书文件。
proxy.config.ssl.client.CA.cert.filename
STRING
默认值:NULL
原始服务器将验证的证书颁发机构的文件名。
proxy.config.ssl.client.CA.cert.path
STRING
默认值:NULL
指定原始服务器将验证的证书颁发机构文件的位置。

ICP Configuration

NOTE! ICP is currently broken NOTE!

proxy.config.icp.enabled

INT

默认值:0

设置ICP的分层缓存模式:

  • 0 =禁用ICP
  • 1 =只允许Traffic Server接收ICP查询
  • 2 =允许Traffic Server发送和接收ICP查询

详细参阅ICP
Peering

proxy.config.icp.icp_interface

STRING

默认值:NULL

指定用于ICP Traffic的网络接口。

注: Traffic
Server的安装脚本检测您的网络接口,并相应地设置该变量。如果您的系统有多个网络接口,这个变量指定了正确的接口。

proxy.config.icp.icp_port

INT

默认值:3130

该变量可以被reload

指定您要使用的ICP消息的UDP端口。

proxy.config.icp.multicast_enabled

INT

默认值:0

proxy.config.icp.query_timeout

INT

默认值:2

该变量可以被reload

指定用于ICP查询超时。

Scheduled Updates Configuration

proxy.config.update.enabled
INT
0
该变量可以被reload
启用(1)或禁用(0)计划更新选项。
proxy.config.update.force
INT
默认值:0
该变量可以被reload
启用(1)或禁用(0)强制立即更新。当启用时,Traffic
Server覆盖了所有预定的更新项目调度到期时间,并启动更新,直到该选项被禁用。
proxy.config.update.retry_count
INT
默认值:10
该变量可以被reload
指定次Traffic Server的可重试计划的更新在发生故障的URL。
proxy.config.update.retry_interval
INT
默认值:2
该变量可以被reload
发生故障的URL中指定的延迟时间(单位:秒)之间计划的更新重试。
proxy.config.update.concurrent_updates
INT
默认值:100
该变量可以被reload
指定允许在任何时间的最大同步更新请求。此选项可防止计划的更新过程中,负担过重的主机。

Socket send/recv buffer sizes

(0 == don’t call setsockopt() )

out: proxy -> os connection

in : ua -> proxy connection

proxy.config.net.sock_send_buffer_size_in

INT

默认值:262144

从客户端连接到Traffic Server的设置发送缓冲区的大小。

proxy.config.net.sock_recv_buffer_size_in

INT

默认值:0

来自客户端连接到Traffic Server的设置接收缓冲区的大小。

proxy.config.net.sock_send_buffer_size_out

INT

默认值:0

设置流量服务器连接到原始服务器发送缓冲区的大小。

proxy.config.net.sock_recv_buffer_size_out

INT

默认值:0

流量服务器连接到原始服务器设置接收缓冲区的大小。

User Overridden Configurations

proxy.config.core_limit
INT
默认值:-1

Debugging

可以使用正则表达式来匹配debug的主题名字,但是相应的性能也会受到一定影响

proxy.config.diags.debug.enabled
INT
默认值:0
: proxy.config.diags.debug.tags
STRING
默认值:http.*|dns.*
跟踪内存泄漏很好用,但是需要使用ink分配器
proxy.config.dump_mem_info_frequency
INT
默认值:0

Slow Log

记录所有请求时间大于该参数的请求,以毫秒(ms)为单位,当该参数值大于0时即启用

proxy.config.http.slow.log.threshold
INT
默认值:0
该变量可以被reload
proxy.config.task_threads
INT
默认值:2
杂项,插件等类型的线程池最小值(推荐2)。
proxy.config.cluster.cluster_configuration
STRING
默认值:cluster.config
proxy.config.url_remap.filename
STRING
默认值:remap.config
proxy.config.cache.control.filename
STRING
默认值:cache.config
proxy.config.log.xml_config_file
STRING
默认值:logs_xml.config
proxy.config.log.hosts_config_file
STRING
默认值:log_hosts.config
proxy.config.http_ui_enabled
INT
默认值:3
开启http_ui选项

The swiss tavern, built in 1803-4, was in the style of a look at this page swiss chalet later renamed to the humbler swiss cottage
分类: 文档翻译 标签:
  1. Jun
    2014年6月19日17:39 | #1

    请问 , proxy.config.cache.min_average_object_size 最小平均缓存对象大小

    这个参数应该怎么理解 ?

  1. 本文目前尚无任何 trackbacks 和 pingbacks.