records.config中文详解

records.config参数的一些备注

CONFIG proxy.config.admin.user_id STRING #-1

CONFIG proxy.config.http.cache.ignore_accept_mismatch INT 2

CONFIG proxy.config.http.cache.ignore_accept_language_mismatch INT 2

CONFIG proxy.config.http.cache.ignore_accept_encoding_mismatch INT 2 #这个参数删掉，设置成2会导致gzip有vary头才能分辨，设置成1不管有没有vary头都不能分辨压缩不压缩了都是存成一份，删掉后不管gzip的有没有vary头vcache都可以分辨。

CONFIG proxy.config.http.cache.ignore_accept_charset_mismatch INT 2

CONFIG proxy.config.dns.resolv_conf STRING NULL #关掉dns使用本地resolv.conf功能

CONFIG proxy.config.hostdb.strict_round_robin INT 1 #终端客户请求过来，该域名解析有多个ip地址的时候，设置成1，按照每次过来轮询访问，设置为0按照client固定一个ip地址访问。

CONFIG proxy.config.http.insert_request_via_str INT 0 #之前默认是1，修改成0，这个参数设置成1的时候，会再到上一层或者源请求的时候，request头信息里面带有via信息，这个时候源认为这是一个代理，有的源设置的gzip压缩再认为是代理的时候是不返回压缩文件的，比如nginx如果不开gzip_proxied any;那么vcache请求gzip的时候也会返回非gzip的文件。

#走父回源超时时间设置

CONFIG proxy.config.http.parent_proxy.retry_time INT 60

CONFIG proxy.config.http.parent_proxy.fail_threshold INT 10

CONFIG proxy.config.http.parent_proxy.total_connect_attempts INT 6

CONFIG proxy.config.http.parent_proxy.per_parent_connect_attempts INT 2

CONFIG proxy.config.http.parent_proxy.connect_attempts_timeout INT 5

CONFIG proxy.config.http.transaction_no_activity_timeout_out INT 120

CONFIG proxy.config.http.connect_attempts_max_retries INT 2

CONFIG proxy.config.http.connect_attempts_max_retries_dead_server INT 2

CONFIG proxy.config.http.connect_attempts_timeout INT 10

# Process Records Config File

# <RECORD-TYPE> <NAME> <TYPE> <VALUE (till end of line)>

# RECORD-TYPE: CONFIG, LOCAL

# NAME: name of variable

# TYPE: INT, STRING, FLOAT

# VALUE: Initial value for record

#range

# *NOTE*: All options covered in this file should be documented in the

# administration guide or the addendum:

##############################################################################

# System Variables

# 系统变量

##############################################################################

#TS的名字，初始化的时候会自动配置，取本机的hostname

CONFIG proxy.config.proxy_name STRING 平台-运营商-区域-C-IP

#配置文件目录

CONFIG proxy.config.config_dir STRING etc/trafficserver

#?命令行启动ts时的选项

CONFIG proxy.config.proxy_binary_opts STRING -M

#该脚本在traffice_manager启动traffice_server前执行

CONFIG proxy.config.env_prep STRING example_prep.sh

#设置接收告警邮件的邮箱

CONFIG proxy.config.alarm_email STRING nobody

#用于记录系统日志的设备

CONFIG proxy.config.syslog_facility STRING LOG_DAEMON

#ts进程日志文件名

CONFIG proxy.config.output.logfile STRING traffic.out

#快照路径

CONFIG proxy.config.snapshot_dir STRING snapshots

#应该是内存映射的参数

CONFIG proxy.config.system.mmap_max INT 2097152

##############################################################################

# Main threads configuration (worker threads). Also see configurations for

# SSL threads, disk I/O threads and task threads in their respective areas.

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

##############################################################################

#ts的线程数量根据可用的CPU核数进行调整，默认值为1，即开启。

CONFIG proxy.config.exec_thread.autoconfig INT 1

#当proxy.config.exec_thread.autoconfig INT 值为1时，CPU核数与TS线程数量的默认比例，默认的缩放比例是1.5。CPU核数*缩放比例=TS线程数量

CONFIG proxy.config.exec_thread.autoconfig.scale FLOAT 1.5

#当proxy.config.exec_thread.autoconfig值为0时，TS线程数量

CONFIG proxy.config.exec_thread.limit INT 2

#当启用时（1），运行一个单独的线程来处理请求。如果禁用（0），那么只有一个线程

CONFIG proxy.config.accept_threads INT 1

##############################################################################

# 本地管理

# Local Manager

##############################################################################

#ts管理员用户名

CONFIG proxy.config.admin.admin_user STRING admin

#配置文件备份数量

CONFIG proxy.config.admin.number_config_bak INT 3

#设置ts进程的权限，设置为#-1表示启动之后不更改进程的权限。Set the user_id=#-1 and start trafficserver as root.

CONFIG proxy.config.admin.user_id STRING nobody

##############################################################################

# 进程管理

# Process Manager

##############################################################################

#配置管理端口

CONFIG proxy.config.admin.autoconf_port INT 8083

#traffic_manager和traffic_server内部通讯管理端口

CONFIG proxy.config.process_manager.mgmt_port INT 8084

##############################################################################

#如果要绑定一个特定的IP，可以使用如下的配置，如同下面的例子。注意–这可以包含两个IP，一个是IPv4一个是IPv6

# In order to only bind a specific IP, use the following config, as in

# the example below. Note – this can contain two addresses, one for IPv4

# sockets and one for IPv6 sockets.

##############################################################################

#LOCAL proxy.local.incoming_ip_to_bind STRING 192.168.101.17

#LOCAL proxy.local.incoming_ip_to_bind STRING 192.168.101.17 fc07:192:168:101::17

##############################################################################

# 告警配置

# Alarm Configuration

##############################################################################

# execute alarm as “<abs_path>/<bin> “<MSG_STRING_FROM_PROXY>””

#当发现告警时，可以触发一个指定的脚本。默认名称是example_alarm_bin.sh，脚本位于bin目录下。你必须编辑该脚本满足需求

CONFIG proxy.config.alarm.bin STRING example_alarm_bin.sh

#example_alarm_bin.sh的完整路径

CONFIG proxy.config.alarm.abs_path STRING NULL

##############################################################################

#HTTP引擎

# HTTP Engine

##############################################################################

##########

# 基础设置#

# basics #

##########

# The server ports are listed here. These are separated by spaces or commas.

# 服务监听的端口在这里列出。可以使用空格和逗号进行分隔

# Each port is a colon separated list of values, which must include a

# port number. The order is irrelevant. Other options are

# 每个端口都是一个冒号分隔的列表里的值，必须包含一个端口号。没有顺序要求。其他选项都有

# ipv4 – Use IPv4 (default)

# ipv6 – Use IPv6

# tr-in – Transparent inbound.

# tr-out – Transparent outbound.

# tr-full – Fully transparent (inbound and outbound).

# tr-pass – Transparently Pass-through non-HTTP traffic (in conjuction with tr-in).

# ssl – SSL terminated port.

# blind – Blind tunnel port (CONNECT only)

# ip-in=[addr] – Bind inbound IP address (listen for client).

# ip-out=[addr] – Bind outbound IP address (connect to origin server).

# ip-resolve=[style] – Set the IP resolution style.

# Note – address types must agree with each other and the ipv4/ipv6

# option if specified. IPv6 addresses must be enclosed in brackets.

# ip-out can be repeated as long as each address is a different

# family. If ip-in is specified as an IPv6 address, the port is

# forced to IPv6. Transparent ports cannot be bound to an IP

# address on the transparent side.

# The ‘=’ is optional for any option with a value.

# Example 1: Port 8080 IPv6 inbound transparent, and port 80 IPv4

# “8080:ipv6:tr-in 80”

# Example 2: Listen on standard http and https ports for IPv4 and IPv6,

# fully transparent on the http ports. Also provide an non-transparent

# port at address 192.168.1.56 on port 8080.

# “80:ipv4:tr-full tr-full:80:ipv6 443:ipv4:ssl 443:ssl:ipv6 ip-in=192.168.1.56:8080”

#HTTP通讯所使用的端口列表（对外提供服务的端口）

CONFIG proxy.config.http.server_ports STRING 8080

# Ports on the origin server to which a blind tunnel may connect.

#?SSL端口列表

CONFIG proxy.config.http.connect_ports STRING 443 563

# The via settings have four values

# via的设置有四种值

# 0 – Do not modify / set this via header

# 0 – 不做任何修改 /设置目前的via头

# 1 – Update the via, with normal verbosity

# 1 – 更新via，添加正常的信息

# 2 – Update the via, with higher verbosity

# 2 – 更新via，添加较多的信息

# 3 – Update the via, with highest verbosity

# 3 – 更新via，添加最多的信息

#设置如何处理via请求到源服务器

CONFIG proxy.config.http.insert_request_via_str INT 1

#设置如何处理via响应到源服务器

CONFIG proxy.config.http.insert_response_via_str INT 0

# Insert a Server: header, this has three values

# 插入一个server:头有一下四种选项

# 0 – 不添加

# 0 – Don’t add or modify the Server: header

# 1 – 添加一个服务器头部

# 1 – Add a Server: header

# 2 – 只在没有Server:头部的时候添加

# 2 – Only add a Server: header if one doesn’t exist already

#设置ts响应服务状态

CONFIG proxy.config.http.response_server_enabled INT 1

#设置ts在响应头中是否插入age头

CONFIG proxy.config.http.insert_age_in_response INT 1

#?启用or禁用com域名扩展。解决不合格的主机名前面加上www.和追加.com，然后重定向到的扩展地址。

#?例如：如果用户端发出请求的主机，然后流量重定向请求www.host.com

CONFIG proxy.config.http.enable_url_expandomatic INT 0

#？不使用dns解析，只转发到父（将所有的dns请求至父cache）

CONFIG proxy.config.http.no_dns_just_forward_to_parent INT 0

#将无法缓存请求使用旁路方式请求父

CONFIG proxy.config.http.uncacheable_requests_bypass_parent INT 1

#对于进来连接是否开启keep-alive

CONFIG proxy.config.http.keep_alive_enabled_in INT 1

#对于出口连接是否开启keep-alive

CONFIG proxy.config.http.keep_alive_enabled_out INT 1

#指定ts是否可以生成一个分块响应(chunk)

CONFIG proxy.config.http.chunking_enabled INT 1

# send http11 requests:

# 发送HTTP1.1请求：

# 0 – 从不

# 0 – Never

# 1 – 始终

# 1 – Always

# 2 – 如果服务器端返回的HTTP版本小于1.1，那么就生产一个区块

# 2 – if the server has returned http1.1 before

#? 3 – 如果客户端请求是HTTP/1.1和源服务器返回HTTP/1.1，生产一个区块的反应

# 3 – if the client request is 1.1 & the server has returned 1.1 before

# 如果use_client_addr的参数设置为1，那么这里设置2或3会导致TS使用客户端的HTTP版本来请求上游服务器

# If use_client_addr is set to 1, options 2 and 3 cause the proxy to use

# the client HTTP version for upstream requests.

#设置TS发送http 1.1请求

CONFIG proxy.config.http.send_http11_requests INT 1

# 共享服务器连接

# Share server connections

# 0 – 从不

# 0 – Never

# 1 – 共享，使用一个全局共享连接池

# 1 – Share, with a single global connection pool

# 2 – 共享，为每个工作线程创建一个共享连接池

# 2 – Share, with a connection pool per worker thread

#?启用or禁用重用服务器会话

CONFIG proxy.config.http.share_server_sessions INT 2

CONFIG proxy.config.http.origin_server_pipeline INT 1

CONFIG proxy.config.http.user_agent_pipeline INT 8

##########################

# HTTP referer过滤器 #

# HTTP referer filtering #

##########################

#HTTP referer防盗链开关

CONFIG proxy.config.http.referer_filter INT 0

#是否为格式化重定向。详见remap.conf

CONFIG proxy.config.http.referer_format_redirect INT 0

#默认的防盗链重定向地址

CONFIG proxy.config.http.referer_default_redirect STRING http://www.example.com/

##############################

# 父节点代理配置 #

# parent proxy configuration #

##############################

#是否开启父节点

CONFIG proxy.config.http.parent_proxy_routing_enable INT 0

#当父节点不可用时，重试父节点的时间

CONFIG proxy.config.http.parent_proxy.retry_time INT 300

#父节点不可用的阈值为重试一定次数失败后即标记为失败

# Parent fail threshold is the number of request that must

# fail within the retry window for the parent to be marked

# down

#父节点探测次数，失败则任务父节点不可用

CONFIG proxy.config.http.parent_proxy.fail_threshold INT 10

#在跳过父节点缓存或者是回复请求失败之前允许连接尝试的次数（依赖于bypass.config的go_direct选项）

CONFIG proxy.config.http.parent_proxy.total_connect_attempts INT 4

#当有多个父节点时，每个父节点允许的连接数

CONFIG proxy.config.http.parent_proxy.per_parent_connect_attempts INT 2

#父节点缓存的连接超时的超时时间

CONFIG proxy.config.http.parent_proxy.connect_attempts_timeout INT 30

#配置ts发送代理身份验证头信息到父缓存

CONFIG proxy.config.http.forward.proxy_auth_to_parent INT 0

###################################

# HTTP连接超时时间(秒) #

# HTTP connection timeouts (secs) #

###################################

# 出：代理服务器 -> 源服务器连接

# out: proxy -> origin server connection

# 进：user agent -> 代理服务器连接

# in : ua -> proxy connection

#指定事务结束后为保证后续进入请求而继续保持连接的时间

CONFIG proxy.config.http.keep_alive_no_activity_timeout_in INT 115

#指定事务结束后为保证后续出口请求而继续保持连接的时间

CONFIG proxy.config.http.keep_alive_no_activity_timeout_out INT 120

#指定如果发生网络拥塞时（入），ts服务器多长时间与客户端断开连接

CONFIG proxy.config.http.transaction_no_activity_timeout_in INT 30

#知道如果发生网络拥塞时（出），ts服务器多长时间后与客户端断开连接

CONFIG proxy.config.http.transaction_no_activity_timeout_out INT 30

#和客户端保持连接的最长时间（入）

CONFIG proxy.config.http.transaction_active_timeout_in INT 900

#和客户端保持连接的最长时间（出）

CONFIG proxy.config.http.transaction_active_timeout_out INT 0

#关闭没有活动的连接的超时时间

CONFIG proxy.config.http.accept_no_activity_timeout INT 120

#指定预缓存服务器连接多久后断开与源服务器的连接

CONFIG proxy.config.http.background_fill_active_timeout INT 60

#?总文件大小的比例已转移时，客户端中止在该代表继续从原始服务器获取的文件，把它转换成高速缓存

CONFIG proxy.config.http.background_fill_completed_threshold FLOAT 0.5

##################################

# 源服务器连接尝试 #

# origin server connect attempts #

##################################

#当源服务器没有响应时，ts最大重试次数

CONFIG proxy.config.http.connect_attempts_max_retries INT 6

#当源服务器不可用时，ts最大重试次数

CONFIG proxy.config.http.connect_attempts_max_retries_dead_server INT 3

#如果该服务器DNS有做轮询，则在轮询条目标记为down之前允许尝试连接失败的最大值

CONFIG proxy.config.http.connect_attempts_rr_retries INT 3

#源服务器连接的超时时间

CONFIG proxy.config.http.connect_attempts_timeout INT 30

#POST/PUT请求时，源服务器的超时值

CONFIG proxy.config.http.post_connect_attempts_timeout INT 1800

#Server记录服务器down的时间，在该段时间内认为服务器down(以秒记)

CONFIG proxy.config.http.down_server.cache_time INT 300

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

CONFIG proxy.config.http.down_server.abort_threshold INT 10

##################################

# 拥塞控制 #

# congestion control #

##################################

#开启/禁用拥塞控制选项。这个配置就停止TS服务器转发请求至源服务器

#TS向客户端发送消息让其稍后重试源服务器

CONFIG proxy.config.http.congestion_control.enabled INT 0

#############################

# 负响应缓存 #

# negative response caching #

#############################

#开启/禁用负响应缓存。当TS缓存到一个非正常响应时（如404），下一客户端请求响应URL时，直接由TS服务器返回非正常响应

#非正常响应包括：204 305 400 403 404 405 500 501 502 503 504

CONFIG proxy.config.http.negative_caching_enabled INT 0

#缓存非正常响应时间

CONFIG proxy.config.http.negative_caching_lifetime INT 1800

#########################

# 代理用户变量 #

# proxy users variables #

#########################

#启用之后将删除From头

CONFIG proxy.config.http.anonymize_remove_from INT 0

#启用之后将删除Refer头

CONFIG proxy.config.http.anonymize_remove_referer INT 0

#启用之后将删除user-agent头

CONFIG proxy.config.http.anonymize_remove_user_agent INT 0

#启用之后将删除cookie头

CONFIG proxy.config.http.anonymize_remove_cookie INT 0

#启用之后将删除client_ip

CONFIG proxy.config.http.anonymize_remove_client_ip INT 0

#启用之后将添加Client_IP头保留客户端的IP地址

CONFIG proxy.config.http.anonymize_insert_client_ip INT 1

#启用之后，TS传出请求后，删除的头部列表

CONFIG proxy.config.http.anonymize_other_header_list STRING NULL

#启用后，将添加客户端的IP地址添加到x-forward-for

CONFIG proxy.config.http.insert_squid_x_forwarded_for INT 1

############

# 安全 #

# security #

############

#启用/禁用HTTP PUSH的选项

CONFIG proxy.config.http.push_method_enabled INT 0

# ###################################

# # HTTP快速过滤器（安全） #

# # HTTP Quick filtering (security) #

# ###################################

# 该功能转移到了ip_allow.config

# this functionality is moved to ip_allow.config

#################

# 缓存控制 #

# cache control #

#################

#配置是否开启http缓存

CONFIG proxy.config.http.cache.http INT 1

# Enabling this setting allows the proxy to cache empty documents. This currently

# requires that the response has a Content-Length: header, with a value of “0”.

#是否缓存Content-Length为0的缓存数据

CONFIG proxy.config.http.cache.allow_empty_doc INT 0

#是否忽略客户端的no-cache头信息

CONFIG proxy.config.http.cache.ignore_client_no_cache INT 1

#?启用时，如果客户端的请求带有no-cache头信息，Traffic Server会发出一个有条件的请求到原始服务器。

CONFIG proxy.config.http.cache.ims_on_client_no_cache INT 1

#是否忽略服务端的no-cache头信息

CONFIG proxy.config.http.cache.ignore_server_no_cache INT 0

#是否忽略客户端中的max-age头信息

CONFIG proxy.config.http.cache.ignore_client_cc_max_age INT 0

#启用后使所有的Accept-Encoding头部规范化

CONFIG proxy.config.http.normalize_ae_gzip INT 0

# 缓存响应cookies的五个选项

# cache responses to cookies has 5 options:

# 0 – 不缓存带有cookies响应

# 0 – do not cache any responses to cookies

# 1 – 缓存所有contnet-type

# 1 – cache for any content-type

# 2 – 只缓存图片类型的请求

# 2 – cache only for image types

# 3 – 除了content-type为text的缓存所有

# 3 – cache for all but text content-types

# 4 – 缓存content-type为text以外的所有，除非响应头信息没有”Set-Cookie”或者带有”Cache-Control: public”

# 4 – cache for all but text content-types except OS response

# without “Set-Cookie” or with “Cache-Control: public”

# See also cache-responses-to-cookies in cache.config.

#ts缓存cookies操作

CONFIG proxy.config.http.cache.cache_responses_to_cookies INT 1

#启用/关闭TS是否忽略服务器传过来的认证头信息

CONFIG proxy.config.http.cache.ignore_authentication INT 0

#缓存动态文件内容

CONFIG proxy.config.http.cache.cache_urls_that_look_dynamic INT 1

#启用/禁用缓存不含vary头的可选http版本的内容

CONFIG proxy.config.http.cache.enable_default_vary_headers INT 0

# 重新严重内容的5个选项

# when_to_revalidate has 5 options:

#? 0 – 默认。使用缓存之类或启发式缓存

# 0 – default. use cache directives or heuristic

# 1 – 启发式缓存

# 1 – stale if heuristic

# 2 – 总是陈旧的（总是重新验证）

# 2 – always stale (always revalidate)

# 3 – 不刷新

# 3 – never stale

# 4 – 如果请求含有条件则验证，否则使用默认值。如果该请求中包含的If-Modified-since，然后TS的总是重新验证缓存的内容，并使用客户端的代理请求的If-modified-Since的头。

# 4 – always revalidate if request is conditional, else default is used

#TS重新验证缓存机制

CONFIG proxy.config.http.cache.when_to_revalidate INT 0

# 一些老的MSIE浏览器不发送no-cache头部到TS，这个变量可以控制为MSIE请求添加no-cache头信息

# Some old MSIE browsers don’t send no-cache headers to

# reverse proxies or transparent caches, this variable controls

# when to add no-cache headers to MSIE requests:

# -1 – no-cache从不被添加，统计数据不更新

# -1 – no-cache is never added, stats are not updated

# 0 – 默认；no-cache不添加到MSIE的请求

# 0 – default; no-cache not added to MSIE requests

# 1 – no-cache被添加到MSIE IMS的请求

# 1 – no-cache added to IMS MSIE requests

# 2 – no-cache被添加到所有的MSIE的请求中

# 2 – no-cache added to all MSIE requests

#配置TS处理MSIE的no-cache请求

CONFIG proxy.config.http.cache.when_to_add_no_cache_to_msie_requests INT -1

# 所需头部的三个选项：

# required headers: three options:

# 0 – 不需要使用头部来决定文档是否可以缓存

# 0 – No required headers to make document cachable

# 1 – 需要”Last-Modified:”,”Expires:”,或者”Cache-Control: max-age”

# 1 – “Last-Modified:”, “Expires:”, or “Cache-Control: max-age” required

# 2 – 明确缓存生命周期需要的”Expires:”或者”Cache-Control: max-age”

# 2 – explicit lifetime required, “Expires:” or “Cache-Control: max-age”

#配置TS缓存所需要的头信息

CONFIG proxy.config.http.cache.required_headers INT 2

#在不能被缓存前，旧对象能够响应的最大时间

CONFIG proxy.config.http.cache.max_stale_age INT 604800

#?启用时，TS在缓存中的查找范围

CONFIG proxy.config.http.cache.range.lookup INT 1

########################

# 预定过期 #

# heuristic expiration #

########################

#一个在缓存中没有过期的并且没有过期时间的对象能被保存的最短时间

CONFIG proxy.config.http.cache.heuristic_min_lifetime INT 3600

#一个在缓存中没有过期的并且没有过期时间的对象能被保存的最长时间

CONFIG proxy.config.http.cache.heuristic_max_lifetime INT 86400

#设置这个变量来指定计算有效期的老化因子。TS存储该对象从其上次修改后的这个百分比的时间。默认值为0.1

CONFIG proxy.config.http.cache.heuristic_lm_factor FLOAT 0.10

#在此文档过期之前，多久之内对于ts进行刷新检查一次

CONFIG proxy.config.http.cache.fuzz.time INT 240

#指定刷新一个文档指定模糊时间的概率

CONFIG proxy.config.http.cache.fuzz.probability FLOAT 0.005

#########################################

# 动态内容和内容协商 #

# dynamic content & content negotiation #

#########################################

#设置这个变量是用来指定在请求是文本时HTTP头部的多种格式：比如HTML

CONFIG proxy.config.http.cache.vary_default_text STRING NULL

#设置这个变量是用来指定在请求是图片时HTTP头部的多种格式：比如GIF

CONFIG proxy.config.http.cache.vary_default_images STRING NULL

#设置这个变量是用来指定在请求不是文本和图片时HTTP头部的多种格式

CONFIG proxy.config.http.cache.vary_default_other STRING NULL

##############################################################

# HTTP统计是非常消耗资源的，不需要的话关闭掉 #

# The HTTP stats are expensive, turn off you don’t need them #

##############################################################

CONFIG proxy.config.http.enable_http_stats INT 1

##############################################################################

# 自定义用户响应页面

# Customizable User Response Pages

##############################################################################

# 0 – 禁用用户自定义响应页面

# 0 – turn off customizable user response pages

# 1 – 仅在默认目录中使用自定义的用户响应页面

# 1 – enable customizable user response pages in only the “default” directory

#? 2 – 使用语言针对性的用户响应页面

# 2 – enable language-targeted user response pages

CONFIG proxy.config.body_factory.enable_customizations INT 1

#启用/禁用自定义响应页面的日志记录。当启用时，TS服务器会记录请求自定义响应页面的每次使用或修改

CONFIG proxy.config.body_factory.enable_logging INT 0

# 0 – 永远不会抑制生成响应页面

# 0 – never suppress generated responses

# 1 – 总是抑制生成响应页面

# 1 – always suppress generated responses

# 2 – 抑制响应页面仅用于拦截的流量

# 2 – suppress responses for intercepted traffic

CONFIG proxy.config.body_factory.response_suppression_mode INT 0

##############################################################################

# Net Subsystem

# 网络子系统

##############################################################################

#配置最大网络连接数

CONFIG proxy.config.net.connections_throttle INT 30000

# Enable defer accept / accept filtering. On Linux, this is a timeout, sec.

#启用推迟接受/接受过滤。在Linux上，这是一个以秒为单位的超时时间

CONFIG proxy.config.net.defer_accept INT 45

##############################################################################

# Cluster Subsystem

# 集群子系统

##############################################################################

# 集群类型需要重启后才能生效

# cluster type requires restart to change

# 1=全集群模式，2=管理模式，3=非集群模式

# 1 is full clustering, 2 is mgmt only, 3 is no clustering

LOCAL proxy.local.cluster.type INT 3

#配置集群端口

CONFIG proxy.config.cluster.cluster_port INT 8086

#配置可靠的服务端口。可靠端口用于发送配置信息在集群节点间。所有的集群节点间必须使用相同的可靠服务端口

CONFIG proxy.config.cluster.rsport INT 8088

#指定组播端口。组播端口是用于节点识别。在集群中所有节点必须使用相同的组播端口

CONFIG proxy.config.cluster.mcport INT 8089

#指定一个组播地址

CONFIG proxy.config.cluster.mc_group_addr STRING 224.0.1.37

#指定组播的TTL值

CONFIG proxy.config.cluster.mc_ttl INT 1

#配置记录组播冲突信息

CONFIG proxy.config.cluster.log_bogus_mc_msgs INT 1

#设置集群模式的以太网口

CONFIG proxy.config.cluster.ethernet_interface STRING lo

##############################################################################

# 缓存

# Cache

##############################################################################

#当值为1即开启时，TS在一定的时间内会保持cache.config内指定的HTTP对象

CONFIG proxy.config.cache.permit.pinning INT 0

# 默认情况下内存的缓存大小根据缓存大小自动设置的

# default the ram cache size to AUTO_SIZE (-1) based on cache size

# （每GB的磁盘缓存大约有10MB的内存缓存）

# (approximately 10 MB of RAM cache per GB of disk cache)

# 当然它也可以设置为一个固定值，比如21474836480 (20GB)

# alternatively, set to a fixed value such as 21474836480 (20GB)

#trafficserver的cache层分为两层：磁盘disk与缓存ram cache

#在用户第一次请求一个页面时，ts回源取出object返回给用户的同时将object写入disk。当用户第二次请求object时，直接disk命中，这时如果条件符合就将object写入ram cache，以后用户再次请求相同object时，就可能直接缓存命中，从而提高响应速度

#设置RAM缓存大小

CONFIG proxy.config.cache.ram_cache.size INT -1

#用于确定写入ram缓存的object大小，只有小于该数值的object才会缓存，默认为4M

CONFIG proxy.config.cache.ram_cache_cutoff INT 4194304

# 替换算法

# Replacement algorithm

# 0：CLFUS算法-TS特有的算法。分析见 http://blog.chinaunix.net/uid-23242010-id-147989.html

# 0 : Clocked Least Frequently Used by Size (CLFUS) w/optional compression

# 1 : LRU算法-最久未使用算法（LRU）：最久没有访问的内容作为替换对象。可选压缩，且非常简单。但缓存污染情况比较严重，见http://www.cnblogs.com/-OYK/archive/2012/12/05/2803317.html

# 1 : LRU w/o optional compression – trivially simple

#配置RAM缓存算法

CONFIG proxy.config.cache.ram_cache.algorithm INT 0

# Filter inserts into the RAM cache to ensure that they have been seen at

# least once. For LRU, this provides scan resistance. Note that CLFUS

# already requires that a document have history before it is inserted, so

# for CLFUS, setting this option means that a document must be seen three

# times before it is added to the RAM cache.

#启用这个选项将过滤器插入到RAM缓存，以确保他们已经见过至少一次。对于LRU，这将增加扫描的阻力。

CONFIG proxy.config.cache.ram_cache.use_seen_filter INT 0

# 压缩RAM缓存内容

# Compress the content of the ram cache:

# 0 ：不压缩

# 0 : no compression

# 1 ：非常快，但相对较低的压缩比

# 1 : fastlz (extremely fast, relatively low compression)

# 2 ：中等速度，合理压缩

# 2 : libz (moderate speed, reasonable compression)

# 3 ：非常慢，高度压缩

# 3 : liblzma (very slow, high compression)

# 注意：压缩任务运行在线程。需要使用更多核压缩时，就需要调整proxy.config.task_threads参数

# NOTE: compression runs on task threads. To use more cores for

# compression, increase proxy.config.task_threads.

#这是针对于CLFUS算法RAM缓存压缩选项。不要混淆于Content-Encoding: gzip选项。RAM缓存压缩的目的是尽量节省内存空间。对用户和代理都是不可见的

#配置RAM缓存压缩类型

CONFIG proxy.config.cache.ram_cache.compress INT 0

# The maximum number of alternates that are allowed for any given URL.

# It is not possible to strictly enforce this if the variable

# ‘proxy.config.cache.vary_on_user_agent’ is set to 1.

# The default value for ‘proxy.config.cache.vary_on_user_agent’ is 0.

# (0 disables the maximum number of alts check)

#指定TS缓存一个对象不同版本的最大数目。默认为5

CONFIG proxy.config.cache.limits.http.max_alts INT 5

# 目标对象尺寸可使用磁盘上连续的片段（简单点说就是对大文件进行分块存储）

# The target size of a contiguous fragment on disk.

# 可接受的值是2的幂值，比如：65536，131072，262144，524288，1048576，2097152.

# Acceptable values are powers of 2, e.g. 65536, 131072, 262144, 524288, 1048576, 2097152.

# 太大会在慢连接时浪费内存，太小会花费更多的搜索时间

# Larger could waste memory on slow connections, smaller could waste seeks.

#配置RAM缓存的单个分片大小

CONFIG proxy.config.cache.target_fragment_size INT 1048576

#存储在缓存中最大文件的大小

# The maximum size of a document that will be stored in the cache.

#设置为0即禁用最大尺寸检查

# (0 disables the maximum document size check)

CONFIG proxy.config.cache.max_doc_size INT 0

# 开启read while write机制（合并回源？）。如果开启read while write机制，有读取相同object请求到来时，此时object还没有写到cache中去，cache查找会失败，但可以直接从这个负责写操作的CacheVC中读取object。这样不仅读取速度快，同时也避免了回源，减少了到源服务器的请求连接数。

# enable the cache to read from an object while it is being added to the cache

CONFIG proxy.config.cache.enable_read_while_writer INT 0

# This controls how many objects (average) the disk caches can hold, and

# how much memory it’ll consume for the directory structure.

#配置最小平均对象大小。默认是8000byte

CONFIG proxy.config.cache.min_average_object_size INT 8000

# How many I/O threads to allocate per disk (spindle). Be aware that RAID

# disks would show up to TS as a single spindle.

# 每块磁盘分配多少的I/O线程。当使用RAID时TS会把多块硬盘当成一块硬盘。

CONFIG proxy.config.cache.threads_per_disk INT 8

#重新尝试重新获取一个缓存锁的时间(ms)。这个设置在某些情况下可以减少延迟，但是会消耗更多的CPU，如果你有CPU调整的经验，可以尝试增加该设置。

# Time (in ms) to delay until retrying to acquire a cache lock. Setting

# this low can reduce latencies in some cases, but can consume more CPU.

# If you experience CPU spinning, try increasing this setting.

CONFIG proxy.config.cache.mutex_retry_delay INT 2

# 临时存储磁盘。必须是使用裸设备

# The interim storage disks. Must use raw disks.

# 最多支持8块临时磁盘

# Only support at most 8 interim disks now. e.g.

# proxy.config.cache.interim.storage STRING /dev/sda /dev/sdb/

LOCAL proxy.config.cache.interim.storage STRING NULL

##############################################################################

# DNS

##############################################################################

#?启用或禁用本地域名的放大。

#TS可以尝试解决不合格的主机名通过扩大到本地域名

#例如，一个客户端发出请求到一个不合格的主机(host_x)和TS本地域名是y.com，然后TS将扩大host_x.y.com主机名

CONFIG proxy.config.dns.search_default_domains INT 0

#启用或禁用DNS服务器选择。当启用时，TS将选择标准的splitdns.config配置文件

CONFIG proxy.config.dns.splitDNS.enabled INT 0

#？

CONFIG proxy.config.dns.max_dns_in_flight INT 2048

# ?指定的主机名扩展列表会自动添加到主机名查找失败后

# Additional URL expansions for http DNS lookup

# 比如你需要TS添加一个主机名为.org的扩展然后指定org为该变更的值

CONFIG proxy.config.dns.url_expansions STRING NULL

#启用或禁用DNS服务器轮询

CONFIG proxy.config.dns.round_robin_nameservers INT 0

#指定DNS服务器

CONFIG proxy.config.dns.nameservers STRING NULL

#指定DNS解析文件

CONFIG proxy.config.dns.resolv_conf STRING /etc/resolv.conf

#这里对DNS伪造提供了额外的适应性，尤其是转发或者透明代理，但是这个需要解析器响应的查询部分

# This provides additional resilience against DNS forgery, particularly in

# forward or transparent proxies, but requires that the resolver populates

# the queries section of the response properly.

CONFIG proxy.config.dns.validate_query_name INT 0

##############################################################################

# HostDB

##############################################################################

# TS运行中该配置更改将不会生效

# in entries, may not be changed while running

# 需要注意的是，如果更改数据库中最大文件的数目，同时也必须修改数据库存储的空间大小

# note that in order to increase hostdb.size, hostdb.storage_size should

# also be increase. These are best guesses, you will have to monitor this.

#存在数据库中最大的文件条目数

CONFIG proxy.config.hostdb.size INT 120000

#用于存储hostdb的空间大小(bytes)。如果调整了proxy.config.hostdb.size的值，就必须要更改这个。

CONFIG proxy.config.hostdb.storage_size INT 32M

# ttl模式：

# ttl modes:

# 0 – 遵循DNS响应的TTL

# 0 = obey

# 1 – 忽略。使用内部超时值

# 1 = ignore

# 2 = 使用DNS和内部TTL较小的值。内部超时值成为最大的TTL

# 2 = min(X,ttl)

# 3 = 使用DNS和内部TTL较大的值。内部超时值成为最小的TTL

# 3 = max(X,ttl)

CONFIG proxy.config.hostdb.ttl_mode INT 0

# in minutes…

#内部数据条目的超时时间(min)

CONFIG proxy.config.hostdb.timeout INT 1440

# round-robin addresses for single clients

# (can cause authentication problems)

#设置使用更加严格的DNS轮询策略。

#当这个选项和proxy.config.hostdb.timed_round_robin禁用时(0)，那么只要原始服务器可用TS会将相同的客户端始终使用相同的原始服务器。如果不这样做，每个请求的IP地址是会变化的。

#这个设置优先级要高于proxy.config.hostdb.timed_round.robin。

CONFIG proxy.config.hostdb.strict_round_robin INT 0

##############################################################################

# 日志配置

# Logging Config

##############################################################################

# 可启用的日志记录：

# possible values for logging_enabled:

# 0: 全部不记录

# 0: no logging at all

# 1: 只记录错误日志

# 1: log errors only

# 2: 只记录事务日志

# 2: log transactions only

# 3: 全部记录(错误日志+事务日志)

# 3: full logging (errors + transactions)

CONFIG proxy.config.log.logging_enabled INT 3

#数据刷新到磁盘之前的最大缓冲时间

CONFIG proxy.config.log.max_secs_per_buffer INT 5

#分配给日志目录的最大空间(MB)

CONFIG proxy.config.log.max_space_mb_for_logs INT 25000

#孤儿日志的最大容量，孤儿日志是指原本发送到网络上的日志，由于网络的原因，如日志服务器连接中断、网络传输速度太慢、导致发送端的日志对计量超过指定的阈值

#（这个阈值可由collation_max_send_buffers等参数控制），则会把这些日志，写到本地磁盘上，变成孤儿日志

#max_space_mb_for_orphan_logs的配置值，常令用户感觉到困惑，这里详细解释一下：

#TS在往磁盘写日志前，会计算日志的容量以及磁盘的容量，检查他们是否达到指定的阈值，如果达到则会丢弃日志。

#TS在计算已经写到磁盘上的日志的总容量时，是把普通日志与孤独日志一起计算的。

#因此，TS需要确定日志的最大容量，该采用max_space_mb_for_logs还是max_space_mb_for_orphan_logs？TS采用下面的规则计算：

#如果Logs_xml.config里，没有任何LogObject配置了CollationHosts，则采用max_space_mb_for_logs的值。

#如果所有LogObject都不写本地磁盘（注意若打开了squid_log，会自动创建一个写本地磁盘的LogObject），则采用max_space_mb_for_orphan_logs的值。

#如果既有写本地磁盘的LogObject，又有写网络的LogObject，则取这两者的较大的值。

#这个算法太绕口了，建议大家把两者配位相同的值，防止出错。

CONFIG proxy.config.log.max_space_mb_for_orphan_logs INT 25

#这个值，用来防止磁盘被日志打满，它能确保：普通日志+孤儿日志+动态余量 < 磁盘容量。

#但值得一提的是：traffic.out不属于普通日志，更不属于孤儿日志，traffic.out不会被rolling，在旧版的TS里，磁盘有可能被traffic.out打满。

#虽然traffic.out不属于普通日志，也不属于孤儿日志，但在计算日志的总大小时，TS只是简单地把/var/log/trafficserver/目录下（这个目录只是默认配置，实际的看各自的环境而定）的所有文件的size加起来。

#当日志的总大小，超过了配置值，TS就会报如下告警：

#logging space exhausted，…

#这时TS会试图回收（reclaim）日志，就是把后缀为.old的普通日志、孤儿日志（.old后缀的日志，由rolling产生）

#先按创建时间排序，先删掉最老的，知道所有日志的大小，满足配置的要求。

#但如前面所言，由于traffic.out不会被rolling，一旦traffic.out的文件大小超过了配置值，就会一直处于“logging space exhausted的状态”。

#这个问题在master版本里已经基金，在master奔波里traffic.out的大部分内容，会写到diags.out里，diags.out的内容会作为普通日志对待，会被rolling，当磁盘不够时，会被日志进程回收。

CONFIG proxy.config.log.max_space_mb_headroom INT 1000

#设置运行TS服务器主机名

CONFIG proxy.config.log.hostname STRING localhost

#日志文件的完整路径

CONFIG proxy.config.log.logfile_dir STRING var/log/trafficserver

#日志文件默认权限

CONFIG proxy.config.log.logfile_perm STRING rw-r–r–

#自定义日志文件格式

CONFIG proxy.config.log.custom_logs_enabled INT 0

#开启/禁用squid日志格式

CONFIG proxy.config.log.squid_log_enabled INT 1

#squid日志格式类型。1=ASCII 2=binary

CONFIG proxy.config.log.squid_log_is_ascii INT 0

#定义squid日志文件名

CONFIG proxy.config.log.squid_log_name STRING squid

#squid日志文件头部文本

CONFIG proxy.config.log.squid_log_header STRING NULL

#开启/禁用Netscape common日志格式

CONFIG proxy.config.log.common_log_enabled INT 0

#Netscape common日志格式类型。1=ASCII 2=binary

CONFIG proxy.config.log.common_log_is_ascii INT 1

#定义Netscape common日志文件名

CONFIG proxy.config.log.common_log_name STRING common

#定义Netscape common日志文件头部文本

CONFIG proxy.config.log.common_log_header STRING NULL

#开启/禁用Netscape extended日志格式

CONFIG proxy.config.log.extended_log_enabled INT 0

#Netscape extended日志格式类型。1=ASCII 2=binary

CONFIG proxy.config.log.extended_log_is_ascii INT 0

#定义Netscape extended日志文件名

CONFIG proxy.config.log.extended_log_name STRING extended

#定义Netscape extended日志文件头部文本

CONFIG proxy.config.log.extended_log_header STRING NULL

#开启/禁用Netscape extended2日志格式

CONFIG proxy.config.log.extended2_log_enabled INT 0

#Netscape extended2日志格式类型。1=ASCII 2=binary

CONFIG proxy.config.log.extended2_log_is_ascii INT 1

#定义Netscape extended2日志文件名

CONFIG proxy.config.log.extended2_log_name STRING extended2

#定义Netscape extended2日志头部文本

CONFIG proxy.config.log.extended2_log_header STRING NULL

#当设置为1时，TS服务器会将ICP事务单独保存为一个日志文件

#0 – 禁用分离。所有ICP事务都会被记录至HTTP事务中

#1 – 所有的ICP事务都会被记录在一个独立的文件中

#-1 – 在默认的日志文件中过滤掉所有的ICP事务。也就是说ICP事务不会被记录

CONFIG proxy.config.log.separate_icp_logs INT 0

#当设置为1时，TS服务器会为每一个源服务器的HTTP事务单独创新一个日志文件。配置在log_hosts.config

CONFIG proxy.config.log.separate_host_logs INT 0

# 设置日志收集模式

# 0 – 客户端模式。即表示，TS不负责从别的机器接收日志。

# 1 – 服务端模式。可接收别的机器发送的日志，值得一提的是，它还可以继续充当「客户端」。

# 2 – 服务端模式。客户端发送自定义的日志格式到服务端。

# 3 – 服务端模式。客户端发送标准的和自定义的日志格式到服务端。

# Log collation allows you to do “remote logging”

LOCAL proxy.local.log.collation_mode INT 0

#设置日志收集服务器主机名

CONFIG proxy.config.log.collation_host STRING NULL

#日志收集服务器端口

CONFIG proxy.config.log.collation_port INT 8085

#日志收集服务器认证密码

CONFIG proxy.config.log.collation_secret STRING foobar

#当设置为1时，TS服务器会为每一个收集客户端生成一个单独的日志条目

CONFIG proxy.config.log.collation_host_tagged INT 0

#重试重新连接日志收集服务器秒数

CONFIG proxy.config.log.collation_retry_sec INT 5

#日志文件的滚动

#0 – 禁用日志文件的滚动

#1 – 启用在特定的时间间隔对日志文件进行滚动.(需要配合proxy.config.log.rolling_interval_sec和proxy.config.log.rolling_offset_hr)

#2 – 启用在指定文件大小对日志文件进行滚动（需要配合proxy.config.log.rolling_size_mb）

#3 – 启用在指定文件大小或特定的时间间隔对日志文件进行滚动（以先发生优先）

#4 – 启用在指定的时间间隔中日志文件打到特定大小进行滚动

CONFIG proxy.config.log.rolling_enabled INT 1

#日志滚动间隔秒数。最低位300秒，最大为86400

CONFIG proxy.config.log.rolling_interval_sec INT 86400

#日志滚动偏移小时。

CONFIG proxy.config.log.rolling_offset_hr INT 0

#当日志文件多大的时对日志进行滚动

CONFIG proxy.config.log.rolling_size_mb INT 10

#是否启用滚动文件的自动删除

CONFIG proxy.config.log.auto_delete_rolled_files INT 1

#配置日志文件只是对事务进行采样，而不是记录所有的事务

#1 – 记录所有的事务

#2 – 每秒只记录一次事务

#3 – 每三次事务记录一次

CONFIG proxy.config.log.sampling_frequency INT 1

##############################################################################

# 反向代理

# Reverse Proxy

##############################################################################

#启用/关闭HTTP反向代理

CONFIG proxy.config.reverse_proxy.enabled INT 1

#对于没有主机头的请求重定向至的URL

CONFIG proxy.config.header.parse.no_host_url_redirect STRING NULL

##############################################################################

# URL映射规则

# URL Remap Rules

##############################################################################

#启用/禁用使用PAC文件请求请求代理服务器默认端口（8080）时重定向到PAC端口

#这个开关必须是proxy.config.reverse_proxy.enabled变量为1

CONFIG proxy.config.url_remap.default_to_server_pac INT 0

#PAC端口设置，使PAC请求将被重定向到TS的代理服务器端口到此端口。

#-1是默认配置，即设置PAC端口的自动配置端口（默认的自动配置端口是8083）。

#这个变量可以和proxy.config.url_remap.default_to_server_pac变量一起使用来获得一个PAC文件从一个不同的端口。

CONFIG proxy.config.url_remap.default_to_server_pac_port INT -1

# To enable forward proxy, you must turn off remap_required

#设置为1时，如果你想TS服务请求从源服务器的映射的规则的remap.config文件中列出

CONFIG proxy.config.url_remap.remap_required INT 1

# Pristine host header is the “original” (request) header. Make sure your

# origin expects them in reverse proxy.

#设置为1时，将保留在重映射请求的客户端主机头

CONFIG proxy.config.url_remap.pristine_host_hdr INT 1

##############################################################################

# SSL终止

# SSL Termination

##############################################################################

# The number of SSL threads is a multiplier of number of CPUs and

# proxy.config.exec_thread.autoconfig.scale by default. You can

# override that here (set it to a non-zero value).

#SSL线程数量。默认是CPU数量和proxy.config.exec_thread.autoconfig.scale的乘积。

#你可以在这里覆盖（设置非零的值）

CONFIG proxy.config.ssl.number.threads INT 0

# The following three variables can be

# set to 0 to disable SSLv2, SSLv3, and/or TLSv1.

# SSLv2 is disabled by default for security concern.

#启用/禁用各SSL协议

CONFIG proxy.config.ssl.SSLv2 INT 0

CONFIG proxy.config.ssl.SSLv3 INT 1

CONFIG proxy.config.ssl.TLSv1 INT 1

# The following two variables control the Cipher Suite traffic Server

# uses for HTTPS connnections and whether to prefer the client

# selected (default) or the server selected

# Our default SSL Cipher Suite tries to be reasonably fast and strong.

#下面两个变更设置TS使用HTTPS连接使用的加密方法

CONFIG proxy.config.ssl.server.cipher_suite STRING RC4-SHA:AES128-SHA:DES-CBC3-SHA:AES256-SHA:ALL:!aNULL:!EXP:!LOW:!MD5:!SSLV2:!NULL

CONFIG proxy.config.ssl.server.honor_cipher_order INT 0

# Control if SSL should perform content compression or not

#控制是否启用内容压缩选项

CONFIG proxy.config.ssl.compression INT 0

# 设置客户端认证级别：

# Client certification level should be:

# 0 没有客户端证书

# 0 no client certificates

# 1 客户端证书是可选的

# 1 client certificates optional

# 2 需要客户端证书

# 2 client certificates required

CONFIG proxy.config.ssl.client.certification_level INT 0

# Server cert chain filename is the name of the global cert chain file

# that is added to every cert in ssl_multicert.config. This file is only

# loaded if there are configurations in ssl_multicert.config.

#网站根证书的文件名

CONFIG proxy.config.ssl.server.cert_chain.filename STRING NULL

# This is the path that SSL certificates files are relative to. Certificate

# names specified in ssl_multicert.config will be located relative to this path.

#TS服务器证书的路径

CONFIG proxy.config.ssl.server.cert.path STRING etc/trafficserver

# If any private key is not contained in the certificate file, you must

# fill in the private key path. Private key names specified in

# ssl_multicert.config will be located relative to this path.

#TS密钥证书的路径

CONFIG proxy.config.ssl.server.private_key.path STRING etc/trafficserver

# The CA file name and path are the

# certificate authority certificate that

# client certificates will be verified against.

#CA证书的文件名

CONFIG proxy.config.ssl.CA.cert.filename STRING NULL

#CA证书的文件路径

CONFIG proxy.config.ssl.CA.cert.path STRING etc/trafficserver

################################

# 客户端相关的配置

# client related configuration #

################################

#配置TS验证原始服务器证书的CA

CONFIG proxy.config.ssl.client.verify.server INT 0

#SSL客户证书安装在TS的文件名

CONFIG proxy.config.ssl.client.cert.filename STRING NULL

#SSL客户证书安装在TS的路径

CONFIG proxy.config.ssl.client.cert.path STRING etc/trafficserver

# Fill in private key file and path only if the client’s

# private key is not contained in the client certificate file.

#TS私钥的文件名。改变这个变量只有私钥不是位于TS的SSL客户证书文件。

CONFIG proxy.config.ssl.client.private_key.filename STRING NULL

CONFIG proxy.config.ssl.client.private_key.path STRING etc/trafficserver

# The CA file name and path are the

# certificate authority certificate that

# server certificates will be verified against.

#指定CA签发文件的位置

CONFIG proxy.config.ssl.client.CA.cert.filename STRING NULL

#指定CA签发文件的路径

CONFIG proxy.config.ssl.client.CA.cert.path STRING etc/trafficserver

##############################################################################

# ICP配置。

# ICP Configuration. NOTE! ICP is currently broken NOTE!

##############################################################################

# ICP模式

# icp modes

# 0 ICP关闭

# enabled=0 ICP disabled

# 1 允许接收ICP查询

# enabled=1 Allow receive of ICP queries

# 2 允许发送、接收ICP查询

# enabled=2 Allow send/receive of ICP queries

CONFIG proxy.config.icp.enabled INT 0

#指定用于ICP流量的网络接口

CONFIG proxy.config.icp.icp_interface STRING NULL

#指定用于ICP通信的UDP端口

CONFIG proxy.config.icp.icp_port INT 3130

#是否开启ICP组播

CONFIG proxy.config.icp.multicast_enabled INT 0

#ICP查询超时设置

CONFIG proxy.config.icp.query_timeout INT 2

##############################################################################

# Scheduled Update Configuration

# 计划更新配置

##############################################################################

#是否开启计划更新

CONFIG proxy.config.update.enabled INT 0

#是否启用强制立即更新。当启用时，TS会覆盖所有预定的更新项目，并启动更新，直到该选项被禁用。

CONFIG proxy.config.update.force INT 0

#TS在计划更新发生故障的URL时，重试次数

CONFIG proxy.config.update.retry_count INT 10

#TS在计划更新发生故障的URL时，重试的延迟时间

CONFIG proxy.config.update.retry_interval INT 2

CONFIG proxy.config.update.concurrent_updates INT 100

##############################################################################

# Socket send/recv buffer sizes (0 == don’t call setsockopt() )

# Socket 发送/接收缓存区尺寸

##############################################################################

# out: TS到源服务器

# out: proxy -> os connection

# in : 客户端到TS

# in : ua -> proxy connection

#设置从客户端到TS连接的发送缓存区大小

CONFIG proxy.config.net.sock_send_buffer_size_in INT 262144

#设置从客户端到TS连接的接收缓存区大小

CONFIG proxy.config.net.sock_recv_buffer_size_in INT 0

#设置从TS到源服务器连接的发送缓存区大小

CONFIG proxy.config.net.sock_send_buffer_size_out INT 0

#设置从TS到源服务器连接的接收缓存区大小

CONFIG proxy.config.net.sock_recv_buffer_size_out INT 0

##############################################################################

# User Overridden Configurations Below

##############################################################################

CONFIG proxy.config.core_limit INT -1

##############################################################################

# 调试

# Debugging

##############################################################################

# Uses a regular expression to match the debugging topic name, performance

# will be affected!

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

CONFIG proxy.config.diags.debug.enabled INT 0

CONFIG proxy.config.diags.debug.tags STRING http.*|dns.*

# Great for tracking down memory leaks, but you need to use the

# ink allocators

#跟踪内存泄露的利器，但是需要使用ink分配器

CONFIG proxy.config.dump_mem_info_frequency INT 0

# Log the source code location of diagnostic messages.

#记录诊断消息的源码位置

CONFIG proxy.config.diags.show_location INT 0

##############################################################################

# 配置和回收的InkFreeList内存池

# Configuration for Reclaimable InkFreeList memory pool

# NOTE: The following options are meaningfull only when Traffic Server is

# compiled with the following option to configure:

# 这个选项只有当TS在编译时使用下面的选项：–enable-reclaimable-freelist

# –enable-reclaimable-freelist

##############################################################################

#禁用、启用内存回收

CONFIG proxy.config.allocator.enable_reclaim INT 1

# The value of reclaim_factor should be in the 0.0 to 1.0 range. Allocators

# use it to calculate size of unused memory, which is used to determine when

# to reclaim memory. The larger the value, the more aggressive reclaims.

#控制回收的阈值的，0.0-1.0的浮点数，默认0.3。越高越主动回收

CONFIG proxy.config.allocator.reclaim_factor FLOAT 0.300000

# Allocator will reclaim memory only when it continuously satisfy the reclaim

# condition for max_overage continuous checks.

#定义超过阈值几次才回收。

CONFIG proxy.config.allocator.max_overage INT 3

# 由于debug，开启debug_filter

# For debugging, enable debug_filter, which is a bit-map with these fields:

# 0: 在ink_freelist_new上回收内存

# bit 0: reclaim memory in ink_freelist_new

# 1: 在空间块或操作系统上回收内存

# bit 1: allocate memory from partial-free Chunks(if exist) or OS

CONFIG proxy.config.allocator.debug_filter INT 0

##############################################################################

# 慢日志

# Slow Log

##############################################################################

# 记录满日止的阈值。当请求大于多少毫秒时会被记录至慢日志，当该参数大于0时即启用

# Log any request that takes more then x number of milliseconds, needs

# to be > 0 to be enabled

CONFIG proxy.config.http.slow.log.threshold INT 0

##############################################################################

# 在线。任务的线程池、插件的一些选项。推荐2

# Thread pool for “misc” tasks, plugins etc. 2 is a good minimum.

##############################################################################

CONFIG proxy.config.task_threads INT 2

##############################################################################

# Dnion record.conf param

##############################################################################

# For qq one minute traffic.

# Default 0 unused

#CONFIG proxy.config.http.one_minute_host INT 0;

原创文章，作者：赛福，如若转载，请注明出处：https://www.safecdn.cn/375.html

本站不销售、不代购、不提供任何支持，仅分享网络信息，请自行辨别，请遵纪守法、文明上网。

records.config中文详解

相关推荐