trafficserver records.config参数说明

说明：来源赵永明的ATS-BLOG.

该版本是基于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

用于记录系统日志文件。请参阅 了解TrafficServer的日志文件。

proxy.config.output.logfile

STRING

默认值：traffic.out

TrafficServer处理过程中产生的的名称和位置的文件，其中包含的警告，状态消息和错误消息。如果没有指定路径，然后TrafficServer将会在日志目录中创建。

proxy.config.snapshot_dir

STRING

默认值：snapshots

TrafficServer的目录中存储在本地系统上配置快照。除非您指定一个绝对路径，此目录位于TrafficServer的配置目录。

proxy.config.system.mmap_max

INT

默认值：2097152（2M）

功能暂时未知

MainThreads

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

proxy.config.exec_thread.autoconfig

INT

默认：1

启用时(默认为1)，TrafficServer的线程数可以根据可用的CPU内核线程进行设置。请参阅下面的配置选项。

proxy.config.exec_thread.autoconfig.scale

FLOAT

默认值：1.500000

影响TrafficServer的线程数。乘数通常是可用的CPU内核的数量。默认情况下，这是缩放系数是1.5。

proxy.config.exec_thread.limit

INT

默认值：2

这是什么做的？（连官网居然都是这么写的）

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”，TrafficServer将不会改变用户在启动过程中。

现在禁止设置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

TrafficServer的此选项指定是否要在响应头中插入age头。age字段中的值是响应由源服务器或重新确认生效的时间量高速缓存的估计。

• 0=不需要在响应中添加age头

• 1=需要在响应中添加age头

proxy.config.http.enable_url_expandomatic

INT

默认：0

该变量可以被reload

启用(1)或禁用(0)。com域名扩展。配置TrafficServer的，解决不合格的主机名前面加上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，然后可以使用TrafficServer的流水线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

默认：8proxy.config.http.referer_filterINT默认值：0: proxy.config.http.referer_format_redirectINT默认值：0: proxy.config.http.referer_default_redirectSTRING默认值：http://www.example.com

parent proxy configuration

proxy.config.http.parent_proxy_routing_enable

INT

默认值：0

该变量可以被reload

启用(1)或禁用(0)父节点缓存选项。请参阅 阶层式快取。

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

TrafficServer和客户端保持连接的最长时间。如果传递给客户端是不完整的，在此之前超时过期，那么流量服务器关闭连接。的默认值0，表示没有超时时间。

proxy.config.http.transaction_active_timeout_out

INT

默认值：0

该变量可以被reload

TrafficServer等待一个连接到源的请求的最大时间。如果在该超时时间结束时还没有传输完成TrafficServer将会断开连接，默认值是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 beforegiving 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

指定TrafficServer记录服务器down的时间，在该段时间内认为服务器down(以秒记)。

proxy.config.http.down_server.abort_threshold

INT

默认值：10

该变量可以被reload

在一个客户端因为源服务器相应太慢而放弃请求之后到TrafficServer标记该服务器不可达之间的秒数

CongestionControl(拥塞控制)

proxy.config.http.congestion_control.enabled

INT

默认值：0

启用(1)或禁用(0)拥塞控制选项，TrafficServer的配置就已经停止转发到原始服务器的HTTP请求时，他们变得拥挤。流量服务器向客户端发送消息稍后重试拥挤的原始服务器。请参阅 使用拥塞控制。

negative response caching

proxy.config.http.negative_caching_enabledINT默认值：0该变量可以被reload当启用(1)，TrafficServer的高速缓存消极反应(如404未找到)当一个请求的页面不存在。下一个客户端请求相同的页面时，流量直接从缓存服务器提供了否定的答复。注：从服务器禁止缓存的缓存控制指令将被忽略以下HTTP响应代码，无论指定的proxy.config.http.negative_caching_enabled变量的价值。下面的消极反应TrafficServer的缓存：204 No Content 305 Use Proxy 400 Bad Request 403 Forbidden 404 NotFound 405 Method Not Allowed 500 Internal Server Error 501 NotImplemented 502 Bad Gateway 503 Service Unavailable 504 GatewayTimeoutproxy.config.http.negative_caching_lifetimeINT默认值：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)HTTPPUSH选项，该选项允许您直接提供内容到缓存中没有一个用户的请求。

重要提示：如果启用此选项，那么你还必须指定一个过滤规则在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头，TrafficServer会发出一个有条件的请求到原始服务器。

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，然后TrafficServer的总是重新验证缓存的内容，并使用客户端的代理请求的If-Modified-Since的头。

proxy.config.http.cache.when_to_add_no_cache_to_msie_requests

INT

默认值：-1

该变量可以被reload

指定添加到Microsoft InternetExplorer请求的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

老化系数为新鲜计算。TrafficServer的存储对象所经过的时间，因为它改变这一比例。

proxy.config.http.cache.fuzz.time

INT

默认值：240

该变量可以被reload

多久TrafficServer的早期刷新检查，在此期间的的文件陈旧的时间之前的一段期间。在指定的时间间隔必须在几秒钟内。

proxy.config.http.cache.fuzz.probability

FLOAT

默认值：0.00500

该变量可以被reload

一个刷新了一个文档中指定的模糊时间的概率。

dynamic content & content negotiation

proxy.config.http.cache.vary_default_text

STRING

默认值：NULL

该变量可以被reload

TrafficServer的变化为文本文件的标题上。例如：如果你指定的用户代理，然后TrafficServer的缓存所有的文件，它遇到不同的用户代理版本。

proxy.config.http.cache.vary_default_p_w_picpaths

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)登录可定制的响应页面。当启用时，TrafficServer的错误日志中记录一条消息每次使用或修改自定义的响应页面。

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)，TrafficServer将保持一定的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)局部领域的扩大，使TrafficServer可以尝试解决不合格扩大到本地域的主机名。例如：如果用户端发出的请求到不合格的的主机(host_x)，TrafficServer的本地域名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

指定主机名的扩展名会自动添加到主机名失败后，查找列表。例如：如果你想TrafficServer的添加主机名的扩展名。组织结构，然后指定组织作为这个变量的值(TrafficServer的自动添加点(。))。

注意：如果变量proxy.config.http.enable_url_expandomatic设置为1(默认值)，然后你就没有添加WWW和COM到这个列表，因为流量服务器会自动尝试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)，TrafficServer的始终使用相同的原始服务器相同的客户端，只要原始服务器。

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_logsproxy.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

日志目录的完整路径。这可能是一个绝对路径或相对路径TrafficServer的安装目录中。 注：您指定的目录必须已经存在。

proxy.config.log.logfile_perm

STRING

默认值：RW-R - R -

该变量可以被reload

日志文件的权限。使用标准的UNIX文件权限(所有者，组和其他)。允许的值有：

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

权限是TrafficServer进程的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)，配置TrafficServer的HTTP交易的log_hosts.config文件中列出的每个源服务器创建一个单独的日志文件。请参阅 HTTP主机日志分裂。

proxy.local.log.collat ion_mode

INT

默认值：0

该变量可以被reload

的日志排序模式：

• 0 =禁用排序规则

• 1 =该主机是一个日志整理服务器

• 2 =主机是整理客户端和发送使用标准格式的项的排序规则服务器

• 3=这台主机是一个整理客户机，将采用传统的自定义格式的项的排序规则服务器

• 4=此主机的整理客户机，将使用传统的标准和自定义格式的排序规则服务器的条目

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

注：虽然TrafficServer支持传统的自定义日志记录，你应该使用更通用的基于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)，配置TrafficServer的客户端生成日志条目，每个条目的整理，包括主机名。

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秒(一天)。

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

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

配置TrafficServer的只是一个示例，而不是每一笔交易的交易记录。您可以指定以下值：

• 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请求将被重定向到TrafficServer的代理服务端口到此端口。-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，如果你想TrafficServer的服务请求从源服务器的映射的规则的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的私钥的文件名。改变这个变量，如果不是位于TrafficServer的SSL证书文件的私钥。

proxy.config.ssl.server.private_key.path

STRING

默认值：NULL

TrafficServer的私钥的位置。只有当私有密钥的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的私钥的文件名。改变这个变量，如果不是位于TrafficServer的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查询

详细参阅ICPPeering。

proxy.config.icp.icp_interface

STRING

默认值：NULL

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

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

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)强制立即更新。当启用时，TrafficServer覆盖了所有预定的更新项目调度到期时间，并启动更新，直到该选项被禁用。

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选项，有如下几个选项可选