配置 Dispatcher

以下各节介绍如何配置Dispatcher的各个方面。

支持IPv4和IPv6

AEM和Dispatcher的所有元素都可以安装在IPv4和IPv6网络中。 请参阅IPV4和IPV6。

调度程序配置文件

默认情况下，Dispatcher配置存储在dispatcher.any文本文件中，不过您可以在安装过程中更改此文件的名称和位置。

配置文件包含一系列可控制Dispatcher行为的单值或多值属性：

• 属性名称前缀为正斜杠/。
• 多值属性使用大括号{ }将子项括起来。

示例配置的结构如下所示：

# name of the dispatcher
/name "internet-server"

# each farm configures a set off (loadbalanced) renders
/farms
 {
  # first farm entry (label is not important, just for your convenience)
   /website
     {  
     /clientheaders
       {
       # List of headers that are passed on
       }
     /virtualhosts
       {
       # List of URLs for this Web site
       }
     /sessionmanagement
       {
       # settings for user authentification
       }
     /renders
       {
       # List of AEM instances that render the documents
       }
     /filter
       {
       # List of filters
       }
     /vanity_urls
       {
       # List of vanity URLs
       }
     /cache
       {
       # Cache configuration
       /rules
         {
         # List of cachable documents
         }
       /invalidate
         {
         # List of auto-invalidated documents
         }
       }
     /statistics
       {
       /categories
         {
         # The document categories that are used for load balancing estimates
         }
       }
     /stickyConnectionsFor "/myFolder"
     /health_check
       {
       # Page gets contacted when an instance returns a 500
       }
     /retryDelay "1"
     /numberOfRetries "5"
     /unavailablePenalty "1"
     /failover "1"
     }
 }

您可以包含对配置有贡献的其他文件：

• 如果您的配置文件较大，则可以将其拆分为多个较小的文件（更易于管理），然后包含这些文件。
• 包含自动生成的文件。

例如，要在/farms配置中包含文件myFarm.any，请使用以下代码：

/farms
  {
  $include "myFarm.any"
  }

使用星号(*)作为通配符指定要包含的文件范围。

例如，如果文件farm_1.any到farm_5.any包含1到5个场的配置，则可以按如下方式包含它们：

/farms
  {
  $include "farm_*.any"
  }

使用环境变量

您可以在dispatcher.any文件中的字符串值属性中使用环境变量，而不是硬编码值。 要包含环境变量的值，请使用格式${variable_name}。

例如，如果dispatcher.any文件与缓存目录位于同一目录中，则可以使用docroot属性的以下值：

/docroot "${PWD}/cache"

另例如，如果您创建一个名为PUBLISH_IP的环境变量来存储AEM发布实例的主机名，则可以使用/renders属性的以下配置：

/renders {
  /0001 {
    /hostname "${PUBLISH_IP}"
    /port "8443"
  }
}

命名调度程序实例

使用/name属性指定唯一名称以标识Dispatcher实例。 /name属性是配置结构中的顶级属性。

定义场

/farms属性定义一组或多组Dispatcher行为，其中每组都与不同的网站或URL关联。 /farms属性可以包含单个场或多个场：

• 当您希望Dispatcher以相同方式处理所有网页或网站时，请使用单个场。
• 当网站的不同区域或不同网站需要不同的调度程序行为时，创建多个场。

/farms属性是配置结构中的顶级属性。 要定义场，请将子属性添加到/farms属性中。 使用唯一标识Dispatcher实例中场的属性名称。

/farmname属性具有多值，并且包含定义Dispatcher行为的其他属性：

• 场应用到的页面的URL。
• 用于渲染文档的一个或多个服务URL(通常为AEM发布实例)。
• 用于负载平衡多个文档渲染器的统计信息。
• 其他一些行为，例如要缓存哪些文件和位置。

值可以包含任何字母数字(a-z、0-9)字符。 以下示例显示了名为/daycom和/docsdaycom的两个场的骨架定义：

#name of dispatcher
/name "day sites"

#farms section defines a list of farms or sites
/farms
{
   /daycom
   {
       ...
   }
   /docdaycom
   {
      ...
   }
}

每个场属性都可以包含以下子属性：

指定默认页面（仅限IIS） — /homepage

指定要传递的HTTP头

/clientheaders属性定义Dispatcher从客户端HTTP请求传递到呈现器(AEM实例)的HTTP标头列表。

默认情况下，Dispatcher会将标准HTTP标头转发到AEM实例。 在某些情况下，您可能希望转发其他标头，或删除特定的标头：

• 添加AEM实例在HTTP请求中所需的标头，如自定义标头。
• 删除仅与Web服务器相关的标头，如身份验证标头。

如果您自定义要传递的标头集，则必须指定详尽的标头列表，包括通常默认包含的标头。

例如，处理发布实例的页面激活请求的Dispatcher实例需要/clientheaders部分中的PATH标头。 PATH标头支持复制代理与调度程序之间的通信。

以下代码是/clientheaders的示例配置：

/clientheaders
  {
  "CSRF-Token"
  "X-Forwarded-Proto"
  "referer"
  "user-agent"
  "authorization"
  "from"
  "content-type"
  "content-length"
  "accept-charset"
  "accept-encoding"
  "accept-language"
  "accept"
  "host"
  "if-match"
  "if-none-match"
  "if-range"
  "if-unmodified-since"
  "max-forwards"
  "proxy-authorization"
  "proxy-connection"
  "range"
  "cookie"
  "cq-action"
  "cq-handle"
  "handle"
  "action"
  "cqstats"
  "depth"
  "translate"
  "expires"
  "date"
  "dav"
  "ms-author-via"
  "if"
  "lock-token"
  "x-expected-entity-length"
  "destination"
  "PATH"
  }

识别虚拟主机

/virtualhosts属性定义Dispatcher接受此场的所有主机名/URI组合的列表。 可以使用星号(*)字符作为通配符。 / virtualhosts属性的值使用以下格式：

[scheme]host[uri][*]

• scheme:（可选） https:// 或 https://.
• host:主机的名称或IP地址以及端口号（如果需要）。(请参阅https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.23)
• uri:（可选）资源的路径。

以下示例配置处理myCompany的.com和.ch域以及mySubDivision的所有域的请求：

   /virtualhosts
    {
    "www.myCompany.com"
    "www.myCompany.ch"
    "www.mySubDivison.*"
    }

以下配置处理​所有​请求：

   /virtualhosts
    {
    "*"
    }

解析虚拟主机

当Dispatcher收到HTTP或HTTPS请求时，它会找到与请求的host, uri和scheme标头最匹配的虚拟主机值。 Dispatcher按以下顺序计算virtualhosts属性中的值：

• Dispatcher从最低的场开始，并在dispatcher.any文件中向上运行。
• 对于每个场，Dispatcher以virtualhosts属性中最顶部的值开头，并向下显示值列表。

Dispatcher通过以下方式查找最匹配的虚拟主机值：

• 将使用与请求的host、scheme和uri中所有三个匹配的第一个虚拟主机。
• 如果没有virtualhosts值的scheme和uri部分与请求的scheme和uri部分均匹配，则使用与请求的host匹配的首次遇到的虚拟主机。
• 如果没有virtualhosts值的主机部分与请求的主机相匹配，则使用最顶端场的最顶端虚拟主机。

因此，您应将默认虚拟主机放在virtualhosts属性的顶部，位于dispatcher.any文件最上方的场中。

虚拟主机分辨率示例

以下示例代表dispatcher.any文件中定义两个Dispatcher场的代码片段，每个场定义一个virtualhosts属性。

/farms
  {
  /myProducts
    {
    /virtualhosts
      {
      "www.mycompany.com"
      }
    /renders
      {
      /hostname "server1.myCompany.com"
      /port "80"
      }
    }
  /myCompany
    {
    /virtualhosts
      {
      "www.mycompany.com/products/*"
      }
    /renders
      {
      /hostname "server2.myCompany.com"
      /port "80"
      }
    }
  }

使用此示例，下表显示了为给定HTTP请求解析的虚拟主机：

启用安全会话 — /sessionmanagement

创建安全会话以访问呈现场，以便用户需要登录才能访问场中的任何页面。 登录后，用户可以访问场中的页面。 有关将此功能与CUG结合使用的信息，请参阅创建封闭用户组。 此外，在上线之前，请参阅Dispatcher 安全检查列表。

/sessionmanagement属性是/farms的子属性。

/ sessionmanagement作为多个子参数：

/directory （必填）

存储会话信息的目录。 如果目录不存在，则创建该目录。

/sessionmanagement
  {
  /directory "/usr/local/apache/.sessions"
  }

/encode （可选）

会话信息的编码方式。 使用md5进行使用md5算法加密，或使用hex进行十六进制编码。 如果加密会话数据，则具有文件系统访问权限的用户将无法读取会话内容。 默认为 md5.

/header （可选）

存储授权信息的HTTP标头或Cookie的名称。 如果将信息存储在http标头中，请使用HTTP:<header-name>。 要在Cookie中存储信息，请使用Cookie:<header-name>。 如果未指定值HTTP:authorization ，则使用。

/timeout （可选）

会话在上次使用后超时的秒数。 如果未指定"800"，则会话会在用户最后一次请求后13分钟多一点超时。

配置示例如下所示：

/sessionmanagement
  {
  /directory "/usr/local/apache/.sessions"
  /encode "md5"
  /header "HTTP:authorization"
  /timeout "800"
  }

定义页面渲染器

/renders属性定义Dispatcher将请求发送到的URL以呈现文档。 以下示例/renders部分标识要渲染的单个AEM实例：

/renders
  {
    /myRenderer
      {
      # hostname or IP of the renderer
      /hostname "aem.myCompany.com"
      # port of the renderer
      /port "4503"
      # connection timeout in milliseconds, "0" (default) waits indefinitely
      /timeout "0"
      }
  }

以下示例/renders部分标识与调度程序在同一台计算机上运行的AEM实例：

/renders
  {
    /myRenderer
     {
     /hostname "127.0.0.1"
     /port "4503"
     }
  }

以下示例/renders部分在两个AEM实例之间平均分发渲染请求：

/renders
  {
    /myFirstRenderer
      {
      /hostname "aem.myCompany.com"
      /port "4503"
      }
    /mySecondRenderer
      {
      /hostname "127.0.0.1"
      /port "4503"
      }
  }

渲染选项

/timeout

指定访问AEM实例的连接超时（以毫秒为单位）。 默认值为"0"，导致Dispatcher无限期等待。

/receiveTimeout

指定允许响应花费的时间（以毫秒为单位）。 默认值为"600000"，导致Dispatcher等待10分钟。 设置"0"可完全消除超时。

如果在解析响应标头时达到超时，则会返回HTTP状态504（网关错误）。 如果在读取响应正文时达到超时，则Dispatcher将向客户端返回不完整的响应，但删除可能已写入的任何缓存文件。

/ipv4

指定Dispatcher是使用getaddrinfo函数（对于IPv6）还是gethostbyname函数（对于IPv4）来获取呈现器的IP地址。 值为0时，会使用getaddrinfo。 值1会导致使用gethostbyname。 默认值为 0.

getaddrinfo函数返回IP地址列表。 Dispatcher迭代地址列表，直到它建立TCP/IP连接。 因此，当呈现主机名与多个IP地址关联时， ipv4属性很重要，并且主机响应getaddrinfo函数返回始终按相同顺序排列的IP地址列表。 在这种情况下，您应使用gethostbyname函数，以便Dispatcher与之连接的IP地址是随机的。

Amazon Elastic Load Balancing(ELB)是一项服务，它以可能相同的IP地址列表来响应getaddrinfo。

/secure

如果/secure属性的值为"1"，则Dispatcher使用HTTPS与AEM实例通信。 有关更多详细信息，另请参阅将Dispatcher配置为使用SSL。

/always-resolve

使用Dispatcher版本​4.1.6，您可以按如下方式配置/always-resolve属性：

• 当设置为"1"时，它将在每个请求中解析主机名（Dispatcher将永远不会缓存任何IP地址）。 由于需要额外调用来获取每个请求的主机信息，因此可能会对性能产生轻微影响。
• 如果未设置属性，则默认情况下会缓存IP地址。

此外，当您遇到动态IP解析问题时，还可以使用此属性，如以下示例所示：

/renders {
  /0001 {
     /hostname "host-name-here"
     /port "4502"
     /ipv4 "1"
     /always-resolve "1"
     }
  }

配置对内容的访问

使用/filter部分指定Dispatcher接受的HTTP请求。 所有其他请求都将发送回带有404错误代码（页面未找到）的Web服务器。 如果不存在/filter部分，则接受所有请求。

注意： statfile的请 🔗 求始终被拒绝。

/filter部分由一系列规则组成，这些规则根据HTTP请求的请求行部分中的模式拒绝或允许访问内容。 您应该为/filter部分使用允许列表策略：

• 首先，拒绝访问所有内容。
• 允许根据需要访问内容。

定义过滤器

/filter部分中的每个项目都包括与请求行或整个请求行的特定元素匹配的类型和模式。 每个过滤器可以包含以下项目：

• 类型:指 /type 示是允许还是拒绝对与模式匹配的请求的访问。值可以是allow或deny。

• 请求行的元素： 包含 /method、 /url、 /query或 /protocol ，以及用于根据HTTP请求的请求行部分的这些特定部分过滤请求的模式。首选的筛选方法是对请求行的元素（而不是整个请求行）进行筛选。

• 请求行的高级元素： 从Dispatcher 4.2.0开始，提供了四个新的过滤器元素供使用。这些新元素分别为/path、/selectors、/extension和/suffix。 包括一个或多个这些项目以进一步控制URL模式。

• 全局属性:属 /glob 性用于匹配HTTP请求的整个请求行。

HTTP请求的请求行部分

HTTP/1.1定义request-line，如下所示：

Method Request-URI HTTP-Version<CRLF>

<CRLF>字符表示回车符后跟换行符。 以下示例是客户请求WKND网站的美英页面时收到的请求行：

GET /content/wknd/us/en.html HTTP.1.1<CRLF>

您的模式必须考虑请求行中的空格字符和<CRLF>字符。

双引号与单引号

创建过滤器规则时，对于简单模式，请使用双引号"pattern"。 如果您使用的是Dispatcher 4.2.0或更高版本并且您的模式包含正则表达式，则必须在单引号内括住正则表达式模式'(pattern1|pattern2)'。

正则表达式

在高于4.2.0的Dispatcher版本中，您可以在过滤器模式中包含POSIX扩展正则表达式。

过滤器疑难解答

如果您的过滤器未按预期方式触发，请在调度程序上启用跟踪日志记录，以便您能够看到哪个过滤器正在拦截请求。

示例过滤器：全部拒绝

以下示例过滤器部分使Dispatcher拒绝所有文件的请求。 您应拒绝访问所有文件，然后允许访问特定区域。

  /0001  { /glob "*" /type "deny" }

对明确拒绝区域的请求会导致返回404错误代码（页面未找到）。

示例过滤器：拒绝访问特定区域

过滤器还允许您拒绝访问各种元素，例如ASP页面和发布实例中的敏感区域。 以下过滤器拒绝访问ASP页面：

/0002  { /type "deny" /url "*.asp"  }

示例过滤器：启用POST请求

以下示例过滤器允许使用POST方法提交表单数据：

/filter {
    /0001  { /glob "*" /type "deny" }
    /0002 { /type "allow" /method "POST" /url "/content/[.]*.form.html" }
}

示例过滤器：允许访问工作流控制台

以下示例显示了用于拒绝外部访问工作流控制台的过滤器：

/filter {
    /0001  { /glob "*" /type "deny" }
    /0002  {  /type "allow"  /url "/libs/cq/workflow/content/console*"  }
}

如果您的发布实例使用Web应用程序上下文（例如发布），则也可以将此上下文添加到过滤器定义中。

/0003   { /type "deny"  /url "/publish/libs/cq/workflow/content/console/archive*"  }

如果您仍需要访问限制区域内的单个页面，则可以允许访问这些页面。 例如，要允许访问工作流控制台中的存档选项卡，请添加以下部分：

/0004  { /type "allow"  /url "/libs/cq/workflow/content/console/archive*"   }

示例过滤器：使用正则表达式

此过滤器使用正则表达式在非公共内容目录中启用扩展，此处在单引号之间定义此表达式：

/005  {  /type "allow" /extension '(css|gif|ico|js|png|swf|jpe?g)' }

示例过滤器：筛选请求URL的其他元素

下面是一个规则示例，它使用路径、选择器和扩展的过滤器阻止从/content路径及其子树中捕获内容：

/006 {
        /type "deny"
        /path "/content/*"
        /selectors '(feed|rss|pages|languages|blueprint|infinity|tidy)'
        /extension '(json|xml|html)'
        }

示例/filter部分

配置Dispatcher时，应尽可能限制外部访问。 以下示例为外部访客提供了最少的访问权限：

• /content

• 其他内容，如设计和客户端库；例如：

  • /etc/designs/default*
  • /etc/designs/mydesign*

创建过滤器后，请测试页面访问以确保AEM实例的安全。

dispatcher.any文件的以下/filter部分可用作Dispatcher配置文件的基础。

此示例基于随Dispatcher提供的默认配置文件，该文件旨在作为生产环境中使用的示例。 前缀为#的项目被停用（注释掉），如果您决定激活其中的任意项目（通过删除该行上的#），则应当小心，因为这可能会对安全产生影响。

您应拒绝访问所有内容，然后允许访问特定（有限）元素：

  /filter
      {
      # Deny everything first and then allow specific entries
      /0001 { /type "deny" /glob "*" }

      # Open consoles
#     /0011 { /type "allow" /url "/admin/*"  }  # allow servlet engine admin
#     /0012 { /type "allow" /url "/crx/*"    }  # allow content repository
#     /0013 { /type "allow" /url "/system/*" }  # allow OSGi console

      # Allow non-public content directories
#     /0021 { /type "allow" /url "/apps/*"   }  # allow apps access
#     /0022 { /type "allow" /url "/bin/*"    }
      /0023 { /type "allow" /url "/content*" }  # disable this rule to allow mapped content only

#     /0024 { /type "allow" /url "/libs/*"   }
#     /0025 { /type "deny"  /url "/libs/shindig/proxy*" } # if you enable /libs close access to proxy

#     /0026 { /type "allow" /url "/home/*"   }
#     /0027 { /type "allow" /url "/tmp/*"    }
#     /0028 { /type "allow" /url "/var/*"    }

      # Enable extensions in non-public content directories, using a regular expression
      /0041
        {
        /type "allow"
        /extension '(css|gif|ico|js|png|swf|jpe?g)'
        }

      # Enable features
      /0062 { /type "allow" /url "/libs/cq/personalization/*"  }  # enable personalization

      # Deny content grabbing, on all accessible pages, using regular expressions
      /0081
        {
        /type "deny"
        /selectors '((sys|doc)view|query|[0-9-]+)'
        /extension '(json|xml)'
        }
      # Deny content grabbing for /content and its subtree
      /0082
        {
        /type "deny"
        /path "/content/*"
        /selectors '(feed|rss|pages|languages|blueprint|infinity|tidy)'
        /extension '(json|xml|html)'
        }

#     /0087 { /type "allow" /method "GET" /extension 'json' "*.1.json" }  # allow one-level json requests
}

如果您选择扩展访问权限，请考虑以下建议：

• 如果您使用的是CQ版本5.4或更早版本，则对/admin的外部访问应始终完全禁用​**。

• 允许访问/libs中的文件时，必须小心。 应允许单独访问。

• 拒绝对复制配置的访问，以便无法看到该配置：

  • /etc/replication.xml*
  • /etc/replication.infinity.json*

• 拒绝访问Google Gadgets反向代理：

  • /libs/opensocial/proxy*

根据您的安装，/libs、/apps或其他位置下可能存在其他资源，这些资源必须可用。 您可以将access.log文件用作确定外部正在访问的资源的一种方法。

限制查询字符串

自Dispatcher版本4.1.5起，使用/filter部分限制查询字符串。 强烈建议通过allow筛选器元素明确允许查询字符串并排除一般允许。

单个条目可以具有glob或method、url、query和version的某种组合，但不能同时具有这两种组合。 以下示例允许a=*查询字符串并拒绝解析到/etc节点的URL的所有其他查询字符串：

/filter {
 /0001 { /type "deny" /method "POST" /url "/etc/*" }
 /0002 { /type "allow" /method "GET" /url "/etc/*" /query "a=*" }
}

/filter {  
>/0001 { /type "deny" /method “*" /url "/path/*" }  
>/0002 { /type "allow" /method "GET" /url "/path/*" }  
>/0003 { /type “deny" /method "GET" /url "/path/*" /query "*" }  
>/0004 { /type "allow" /method "GET" /url "/path/*" /query "a=*" }  
}  

测试Dispatcher安全性

Dispatcher过滤器应阻止访问AEM发布实例上的以下页面和脚本。 使用Web浏览器尝试像站点访客那样打开以下页面，并验证是否返回了代码404。 如果获得任何其他结果，请调整过滤器。

请注意，您应会看到/content/add_valid_page.html?debug=layout的正常页面呈现。

• /admin
• /system/console
• /dav/crx.default
• /crx
• /bin/crxde/logs
• /jcr:system/jcr:versionStorage.json
• /_jcr_system/_jcr_versionStorage.json
• /libs/wcm/core/content/siteadmin.html
• /libs/collab/core/content/admin.html
• /libs/cq/ui/content/dumplibs.html
• /var/linkchecker.html
• /etc/linkchecker.html
• /home/users/a/admin/profile.json
• /home/users/a/admin/profile.xml
• /libs/cq/core/content/login.json
• /content/../libs/foundation/components/text/text.jsp
• /content/.{.}/libs/foundation/components/text/text.jsp
• /apps/sling/config/org.apache.felix.webconsole.internal.servlet.OsgiManager.config/jcr%3acontent/jcr%3adata
• /libs/foundation/components/primary/cq/workflow/components/participants/json.GET.servlet
• /content.pages.json
• /content.languages.json
• /content.blueprint.json
• /content.-1.json
• /content.10.json
• /content.infinity.json
• /content.tidy.json
• /content.tidy.-1.blubber.json
• /content/dam.tidy.-100.json
• /content/content/geometrixx.sitemap.txt
• /content/add_valid_page.query.json?statement=//*
• /content/add_valid_page.qu%65ry.js%6Fn?statement=//*
• /content/add_valid_page.query.json?statement=//*[@transportPassword]/(@transportPassword%20|%20@transportUri%20|%20@transportUser)
• /content/add_valid_path_to_a_page/_jcr_content.json
• /content/add_valid_path_to_a_page/jcr:content.json
• /content/add_valid_path_to_a_page/_jcr_content.feed
• /content/add_valid_path_to_a_page/jcr:content.feed
• /content/add_valid_path_to_a_page/pagename._jcr_content.feed
• /content/add_valid_path_to_a_page/pagename.jcr:content.feed
• /content/add_valid_path_to_a_page/pagename.docview.xml
• /content/add_valid_path_to_a_page/pagename.docview.json
• /content/add_valid_path_to_a_page/pagename.sysview.xml
• /etc.xml
• /content.feed.xml
• /content.rss.xml
• /content.feed.html
• /content/add_valid_page.html?debug=layout
• /projects
• /tagging
• /etc/replication.html
• /etc/cloudservices.html
• /welcome

在终端或命令提示符下发出以下命令，以确定是否启用了匿名写访问。 您不应能将数据写入节点。

curl -X POST "https://anonymous:anonymous@hostname:port/content/usergenerated/mytestnode"

在终端或命令提示符下发出以下命令以尝试使Dispatcher缓存失效，并确保收到代码404响应：

curl -H "CQ-Handle: /content" -H "CQ-Path: /content" https://yourhostname/dispatcher/invalidate.cache

启用对虚URL的访问

配置Dispatcher以启用对为您的AEM页面配置的虚URL的访问权限。

启用对虚URL的访问后，Dispatcher会定期调用在呈现实例上运行的服务，以获取虚URL列表。 Dispatcher将此列表存储在本地文件中。 当由于/filter部分中的过滤器而拒绝页面请求时，Dispatcher将查阅虚URL的列表。 如果拒绝的URL在列表中，则Dispatcher允许访问虚URL。

要启用对虚URL的访问，请在/farms部分添加/vanity_urls部分，如下例所示：

 /vanity_urls {
      /url "/libs/granite/dispatcher/content/vanityUrls.html"
      /file "/tmp/vanity_urls"
      /delay 300
 }

/vanity_urls部分包含以下属性：

• /url:在呈现实例上运行的虚URL服务的路径。此属性的值必须为"/libs/granite/dispatcher/content/vanityUrls.html"。

• /file:Dispatcher存储虚URL列表的本地文件的路径。确保Dispatcher对此文件具有写权限。

• /delay:（秒）对虚URL服务的调用之间间隔的时间。

请按照以下过程启用对虚URL的访问权限。

1. 如果您的渲染服务是AEM实例，请在发布实例上安装com.adobe.granite.dispatcher.vanityurl.content包（请参阅上面的注释）。
2. 对于您为AEM或CQ页面配置的每个虚URL，请确保/filter配置拒绝该URL。 如有必要，请添加一个过滤器以拒绝URL。
3. 在/farms下添加/vanity_urls部分。
4. 重新启动Apache Web服务器。

转发联合请求 — /propagateSyncPost

联合请求通常仅面向Dispatcher，因此默认情况下，它们不会发送到呈现器(例如，AEM实例)。

如有必要，请将/propagateSyndPost属性设置为"1"以将联合请求转发到Dispatcher。 如果已设置，则必须确保过滤器部分中不拒绝POST请求。

配置调度程序缓存 — /cache

/cache部分控制Dispatcher如何缓存文档。 配置多个子属性以实施缓存策略：

• /docroot
• /statfile
• /serveStaleOnError
• /allowAuthorized
• /rules
• /statfileslevel
• /invalidate
• /invalidateHandler
• /allowedClients
• /ignoreUrlParams
• /headers
• /mode
• /gracePeriod
• /enableTTL

缓存部分的示例如下所示：

/cache
  {
  /docroot "/opt/dispatcher/cache"
  /statfile  "/tmp/dispatcher-website.stat"
  /allowAuthorized "0"

  /rules
    {
    # List of files that are cached
    }

  /invalidate
    {
    # List of files that are auto-invalidated
    }
  }
  

指定缓存目录

/docroot属性标识存储缓存文件的目录。

如果您使用多个场，则每个场必须使用不同的文档根。

命名Statfile

/statfile属性标识要用作statfile的文件。 Dispatcher使用此文件注册最近内容更新的时间。 statfile可以是Web服务器上的任何文件。

statfile没有内容。 更新内容后，Dispatcher会更新时间戳。 默认的statfile名为.stat，存储在docroot中。 Dispatcher阻止访问statfile。

在发生错误时提供过时的文档

/serveStaleOnError属性控制当渲染服务器返回错误时，Dispatcher是否返回无效的文档。 默认情况下，当处理statfile并使缓存内容失效时，Dispatcher会在下次请求时删除缓存内容。

如果将/serveStaleOnError设置为"1"，则除非呈现服务器返回成功响应，否则Dispatcher不会从缓存中删除无效的内容。 来自AEM的5xx响应或连接超时导致Dispatcher提供过时的内容，并使用HTTP状态111做出响应（重新验证失败）。

使用身份验证时缓存

/allowAuthorized属性控制是否缓存包含以下任何身份验证信息的请求：

• authorization标头
• 名为authorization的Cookie
• 名为login-token的Cookie

默认情况下，不会缓存包含此身份验证信息的请求，因为在将缓存的文档返回给客户端时，不会执行身份验证。 此配置可阻止Dispatcher向没有必要权限的用户提供缓存的文档。

但是，如果您的要求允许缓存已验证的文档，请将/allowAuthorized设置为：

/allowAuthorized "1"

指定要缓存的文档

/rules属性控制根据文档路径缓存哪些文档。 无论/rules属性如何，Dispatcher在以下情况下都永远不会缓存文档：

• 如果请求URI包含问号(?)。

  • 这通常表示动态页面，例如不需要缓存的搜索结果。

• 缺失文件扩展名。

  • Web 服务器需要扩展名来确定文档类型（比如 MIME 类型）。

• 设置了身份验证标头（此项可进行配置）.

• 如果AEM实例使用以下标头做出响应：

  • no-cache
  • no-store
  • must-revalidate

/rules属性中的每个项目都包括glob模式和类型：

• glob模式用于匹配文档的路径。
• 类型指示是否缓存与glob模式匹配的文档。 该值可以是允许（缓存文档）或拒绝（始终渲染文档）。

如果您没有动态页面（除了上述规则已排除的页面之外），则可以配置Dispatcher以缓存所有内容。 其规则部分如下所示：

/rules
  {
    /0000  {  /glob "*"   /type "allow" }
  }

有关全局属性的信息，请参阅为全局属性设计模式。

如果您页面的某些部分是动态的（例如，新闻应用程序），或者位于已关闭的用户组内，则可以定义例外：

/rules
  {
   /0000  { /glob "*" /type "allow" }
   /0001  { /glob "/en/news/*" /type "deny" }
   /0002  { /glob "*/private/*" /type "deny"  }
  }

压缩

在Apache Web服务器上，您可以压缩缓存的文档。 如果客户端提出压缩请求，则压缩允许Apache以压缩形式返回文档。 通过启用Apache模块mod_deflate可自动进行压缩，例如：

AddOutputFilterByType DEFLATE text/plain

默认情况下，该模块随Apache 2.x一起安装。

按文件夹级别使文件失效

使用/statfileslevel属性根据缓存文件的路径使其失效：

• Dispatcher在从Docroot文件夹到您指定的级别的每个文件夹中创建.stat文件。 docroot文件夹为0级。

• 通过处理.stat文件，文件将失效。 将.stat文件的上次修改日期与缓存文档的上次修改日期进行比较。 如果.stat文件较新，则会重新获取文档。

• 当位于某一级别的文件失效时，将处理从docroot 到​的所有​.stat文件，其中无效文件或配置的statsfilevel（以较小者为准）的级别。

  • 例如：如果将statfileslevel属性设置为6，并且在级别5中某个文件失效，则将处理从docroot到5的每个.stat文件。 继续此示例，如果文件在级别7失效，则每次。 stat 文件从docroot到6将被触碰(自 /statfileslevel = "6")。

只有路径​到无效文件的资源​会受到影响。 请考虑以下示例：网站使用结构/content/myWebsite/xx/.如果将statfileslevel设置为3，则会创建如下.stat文件：

• docroot
• /content
• /content/myWebsite
• /content/myWebsite/*xx*

当/content/myWebsite/xx中的文件失效时，将处理从docroot向下到/content/myWebsite/xx的每个.stat文件。 这将仅适用于/content/myWebsite/xx，而不适用于/content/myWebsite/yy或/content/anotherWebSite。

自动使缓存文件失效

/invalidate属性定义更新内容时自动失效的文档。

如果自动失效，Dispatcher不会在内容更新后删除缓存的文件，但会在下次请求时检查其有效性。 缓存中未自动失效的文档将保留在缓存中，直到内容更新明确删除它们为止。

HTML页面通常使用自动失效功能。 HTML页面通常包含指向其他页面的链接，因此很难确定内容更新是否会影响页面。 为确保所有相关页面在内容更新时失效，请自动使所有HTML页面失效。 以下配置会使所有HTML页面失效：

  /invalidate
  {
   /0000  { /glob "*" /type "deny" }
   /0001  { /glob "*.html" /type "allow" }
  }

有关全局属性的信息，请参阅为全局属性设计模式。

激活/content/wknd/us/en时，此配置会导致以下活动：

• 所有模式为en的文件。*已从/content/wknd/us文件夹中删除。
• 将删除/content/wknd/us/en./_jcr_content文件夹。
• 所有与/invalidate配置匹配的其他文件不会立即删除。 下次请求时，这些文件将被删除。 在我们的示例中，未删除/content/wknd.html，将在请求/content/wknd.html时将其删除。

如果您提供自动生成的PDF和ZIP文件供下载，则可能还必须自动使这些文件失效。 配置示例如下所示：

/invalidate
  {
   /0000 { /glob "*" /type "deny" }
   /0001 { /glob "*.html" /type "allow" }
   /0002 { /glob "*.zip" /type "allow" }
   /0003 { /glob "*.pdf" /type "allow" }
  }

AEM与Adobe Analytics的集成可在您网站的analytics.sitecatalyst.js文件中提供配置数据。 随Dispatcher提供的示例dispatcher.any文件包含以下此文件的失效规则：

{
   /glob "*/analytics.sitecatalyst.js"  /type "allow"
}

使用自定义失效脚本

利用/invalidateHandler属性，可定义一个脚本，该脚本将为Dispatcher收到的每个失效请求调用。

使用以下参数调用：

• 句柄 — 无效的内容路径
• 操作 — 复制操作（例如激活、停用）
• 操作范围 — 复制操作的范围(为空，除非发送CQ-Action-Scope: ResourceOnly的标头，否则请参阅使从AEM中缓存的页面失效以了解详细信息)

这可用于覆盖许多不同的用例，如使其他应用程序特定缓存失效，或处理页面的外部化URL及其在docroot中的位置与内容路径不匹配的情况。

以下示例脚本将每个无效请求记录到一个文件。

/invalidateHandler "/opt/dispatcher/scripts/invalidate.sh"

失效处理程序脚本

#!/bin/bash

printf "%-15s: %s %s" $1 $2 $3>> /opt/dispatcher/logs/invalidate.log

限制可刷新缓存的客户端

/allowedClients属性定义允许刷新缓存的特定客户端。 通配模式与IP匹配。

以下示例：

1. 拒绝访问任何客户
2. 明确允许访问localhost

/allowedClients
  {
   /0001 { /glob "*.*.*.*"  /type "deny" }
   /0002 { /glob "127.0.0.1" /type "allow" }
  }

有关全局属性的信息，请参阅为全局属性设计模式。

忽略URL参数

ignoreUrlParams部分定义在确定页面是缓存还是从缓存中传送时，将忽略哪些URL参数：

• 当请求URL包含所有被忽略的参数时，将缓存页面。
• 当请求URL包含一个或多个不会忽略的参数时，不会缓存页面。

当某个页面的参数被忽略时，会在首次请求该页面时缓存该页面。 无论请求中的参数值如何，缓存的页面都会提供该页面的后续请求。

要指定要忽略的参数，请将全局规则添加到ignoreUrlParams属性：

• 要忽略参数，请创建允许该参数的全局属性。
• 要阻止缓存页面，请创建一个全局属性以拒绝该参数。

以下示例会导致Dispatcher忽略q参数，以便缓存包含q参数的请求URL:

/ignoreUrlParams
{
    /0001 { /glob "*" /type "deny" }
    /0002 { /glob "q" /type "allow" }
}

使用示例ignoreUrlParams值，由于q参数被忽略，以下HTTP请求会导致页面被缓存：

GET /mypage.html?q=5

使用示例ignoreUrlParams值，以下HTTP请求会导致页面缓存​not，因为p参数未被忽略：

GET /mypage.html?q=5&p=4

有关全局属性的信息，请参阅为全局属性设计模式。

缓存HTTP响应头

利用/headers属性，可定义Dispatcher要缓存的HTTP标头类型。 在向未缓存资源发出第一个请求时，所有与其中一个已配置值匹配的标头（请参阅下面的配置示例）都存储在缓存文件旁边的单独文件中。 在对缓存资源的后续请求中，存储的标头将添加到响应中。

以下是默认配置的示例：

/cache {
  ...
  /headers {
    "Cache-Control"
    "Content-Disposition"
    "Content-Type"
    "Expires"
    "Last-Modified"
    "X-Content-Type-Options"
    "Last-Modified"
  }
}

FileETag none

调度程序缓存文件权限

mode属性指定将哪些文件权限应用于缓存中的新目录和文件。 此设置受调用进程umask的限制。 它是使用以下一个或多个值之和构建的八进制数字：

• 0400 允许所有者读取。
• 0200 允许所有者写入。
• 0100 允许所有者在目录中搜索。
• 0040 允许群组成员读取。
• 0020 允许由群组成员写入。
• 0010 允许群组成员在目录中搜索。
• 0004 允许他人阅读。
• 0002 允许他人写。
• 0001 允许其他人在目录中搜索。

默认值为0755，该值允许所有者读取、写入或搜索，组和其他人读取或搜索。

限制.stat文件处理

使用默认的/invalidate属性，每次激活都会有效地使所有.html文件失效（当其路径与/invalidate部分匹配时）。 如果某个网站的流量很大，则多次后续激活会增加后端的cpu负载。 在这种情况下，最好“限制”.stat文件接触以保持网站响应。 您可以使用/gracePeriod属性执行此操作。

/gracePeriod属性定义在上次发生激活后，仍可从缓存中提供失效的自动失效资源的秒数。 该属性可用于设置中，否则，若进行批量激活，则会重复使整个缓存失效。 建议的值为2秒。

有关更多详细信息，请参阅上面的/invalidate和/statfileslevel部分。

配置基于时间的缓存失效 — /enableTTL

如果设置，/enableTTL属性将从后端评估响应标头，如果响应标头包含Cache-Control max-age或Expires日期，则会创建缓存文件旁边的辅助空文件，修改时间等于到期日期。 在修改时间之后请求缓存文件时，会自动从后端重新请求缓存文件。

配置负载平衡 — /statistics

/statistics部分定义Dispatcher为其对每个呈现器的响应性进行评分的文件类别。 Dispatcher使用得分确定要发送请求的呈现者。

您创建的每个类别都定义全局模式。 Dispatcher将请求内容的URI与这些模式进行比较，以确定请求内容的类别：

• 类别的顺序决定了它们与URI的比较顺序。
• 与URI匹配的第一个类别模式是文件的类别。 不再评估类别模式。

Dispatcher最多支持8个统计类别。 如果定义的类别超过8个，则仅使用前8个类别。

渲染选择

每次Dispatcher需要渲染的页面时，它都会使用以下算法来选择渲染器：

1. 如果请求在renderid Cookie中包含呈现名称，则Dispatcher会使用该呈现。

2. 如果请求不包含renderid Cookie，则Dispatcher会比较呈现统计信息：

   1. Dispatcher确定请求URI的类别。
   2. Dispatcher确定哪个呈现器对该类别的响应得分最低，然后选择该呈现器。

3. 如果尚未选择任何渲染，则使用列表中的第一个渲染。

呈现器类别的得分基于以前的响应时间以及Dispatcher尝试的以前失败和成功的连接。 对于每次尝试，将更新所请求URI类别的得分。

定义统计类别

为要保留用于呈现选择的统计信息的每种类型的文档定义类别。 /statistics部分包含/categories部分。 要定义类别，请在/categories部分下添加一行，该行的格式如下：

/name { /glob "pattern"}

类别name必须对场是唯一的。 pattern在为全局属性设计模式一节中有介绍。

为确定URI的类别，Dispatcher会将URI与每个类别模式进行比较，直到找到匹配项。 Dispatcher从列表中的第一个类别开始，并按顺序继续。 因此，请首先放置具有更具体模式的类别。

例如，默认dispatcher.any文件的Dispatcher定义了HTML类别和其他类别。 HTML类别更具体，因此它首先显示：

/statistics
  {
  /categories
    {
      /html { /glob "*.html" }
      /others  { /glob "*" }
    }
  }

以下示例还包括搜索页面的类别：

/statistics
  {
  /categories
    {
      /search { /glob "*search.html" }
      /html { /glob "*.html" }
      /others  { /glob "*" }
    }
  }

在调度程序统计信息中反映服务器不可用性

/unavailablePenalty属性设置在与渲染器的连接失败时应用于渲染统计信息的时间（以秒为单位）。 Dispatcher将时间添加到与请求的URI匹配的统计类别中。

例如，当无法建立到指定主机名/端口的TCP/IP连接时，将应用惩罚，原因可能是AEM未运行（且未侦听），或者由于网络相关问题。

/unavailablePenalty属性是/farm部分（/statistics部分的同级项）的直接子项。

如果不存在/unavailablePenalty属性，则使用值"1"。

/unavailablePenalty "1"

识别粘性连接文件夹 — /stickyConnectionsFor

/stickyConnectionsFor属性定义一个包含粘性文档的文件夹；将使用URL访问该地址。 Dispatcher将此文件夹中的所有请求从单个用户发送到同一呈现实例。 粘性连接可确保所有文档的会话数据都存在且一致。 此机制使用renderid Cookie。

以下示例定义到/products文件夹的置顶连接：

/stickyConnectionsFor "/products"

当页面由来自多个内容节点的内容组成时，请包括列出内容路径的/paths属性。 例如，页面包含/content/image、/content/video和/var/files/pdfs中的内容。 以下配置为页面上的所有内容启用置顶连接：

/stickyConnections {
  /paths {
    "/content/image"
    "/content/video"
    "/var/files/pdfs"
  }
}

httpOnly

启用粘性连接后，调度程序模块会设置renderid Cookie。 此Cookie没有httponly标记，应添加该标记以增强安全性。 为此，可以在dispatcher.any配置文件的/stickyConnections节点中设置httpOnly属性。 属性的值（0或1）定义renderid Cookie是否附加了HttpOnly属性。 默认值为0，这表示不会添加属性。

有关httponly标记的其他信息，请阅读此页面。

安全

启用粘性连接后，调度程序模块会设置renderid Cookie。 此Cookie没有secure标记，应添加该标记以增强安全性。 为此，可以在dispatcher.any配置文件的/stickyConnections节点中设置secure属性。 属性的值（0或1）定义renderid Cookie是否附加了secure属性。 默认值为0，这表示如果​传入请求安全，将添加属性。 如果将该值设置为1，则将添加安全标志，无论传入请求是否安全。

处理渲染连接错误

在呈现服务器返回500错误或不可用时配置Dispatcher行为。

指定运行状况检查页面

使用/health_check属性指定在发生500状态代码时要检查的URL。 如果此页还返回500状态代码，则实例将被视为不可用，并且在重试之前对渲染应用可配置的时间惩罚(/unavailablePenalty)。

/health_check
  {
  # Page gets contacted when an instance returns a 500
  /url "/health_check.html"
  }

指定页面重试延迟

/retryDelay属性可设置Dispatcher在场呈现的连接尝试轮次之间等待的时间（以秒为单位）。 对于每轮，Dispatcher尝试连接到渲染器的最大次数是场中的渲染次数。

如果未明确定义/retryDelay，则Dispatcher使用值"1"。 默认值在大多数情况下都适用。

/retryDelay "1"

配置重试次数

/numberOfRetries属性设置Dispatcher对呈现器执行的连接尝试的最大轮次数。 如果Dispatcher在进行此次重试后无法成功连接到呈现器，则Dispatcher返回失败的响应。

对于每轮，Dispatcher尝试连接到渲染器的最大次数是场中的渲染次数。 因此，Dispatcher尝试连接的最大次数为(/numberOfRetries)x（呈现次数）。

如果未明确定义该值，则其默认值为5。

/numberOfRetries "5"

使用故障切换机制

在原始请求失败时，在Dispatcher场上启用故障转移机制，以向不同呈现器重新发送请求。 启用故障转移后，Dispatcher的行为如下：

• 当对呈现器的请求返回HTTP状态503（不可用）时，Dispatcher会将该请求发送到其他呈现器。
• 当对呈现器的请求返回HTTP状态50x（503除外）时，Dispatcher会发送针对为health_check属性配置的页面的请求。
  • 如果运行状况检查返回500(INTERNAL_SERVER_ERROR)，则Dispatcher将原始请求发送到其他呈现器。
  • 如果运行状况检查返回HTTP状态200，则Dispatcher会将初始HTTP 500错误返回给客户端。

要启用故障转移，请将以下行添加到场（或网站）：

/failover "1"

忽略中断错误 — /ignoreEINTR

如果系统调用的对象位于通过NFS访问的远程系统上，则任何面向文件系统的系统调用都可能中断EINTR。 这些系统调用是否可以超时或中断取决于底层文件系统在本地计算机上的装载方式。

如果您的实例具有此类配置，并且日志包含以下消息，请使用/ignoreEINTR参数：

Error while reading response: Interrupted system call

在内部，Dispatcher使用可表示为以下代码的循环从远程服务器(即AEM)读取响应：

while (response not finished) {  
read more data  
}

当EINTR出现在“read more data”部分中时，可以生成此类消息，这些消息是在收到任何数据之前接收信号所引起的。

要忽略此类中断，可以将以下参数添加到dispatcher.any（/farms之前）：

/ignoreEINTR "1"

将/ignoreEINTR设置为"1"会导致Dispatcher继续尝试读取数据，直到读取完整响应。 默认值为0并停用选项。

设计全局属性的模式

Dispatcher配置文件的几个部分使用glob属性作为客户端请求的选择标准。 glob属性的值是Dispatcher与请求方面（如请求资源的路径或客户端的IP地址）进行比较的模式。 例如，/filter部分中的项目使用glob模式来标识Dispatcher执行或拒绝操作的页面的路径。

glob值可以包含通配符和字母数字字符来定义模式。

记录

在Web服务器配置中，您可以设置：

• Dispatcher日志文件的位置。
• 日志级别。

有关更多信息，请参阅Web服务器文档和Dispatcher实例的自述文件。

Apache旋转/管道日志

如果使用​Apache Web服务器，则可以对旋转和/或管道日志使用标准功能。 例如，使用管道日志：

DispatcherLog "| /usr/apache/bin/rotatelogs logs/dispatcher.log%Y%m%d 604800"

此操作将自动旋转：

• 调度程序日志文件；扩展中具有时间戳(logs/dispatcher.log%Y%m%d)。
• 每周(60 x 60 x 24 x 7 = 604800秒)。

请参阅Log Rotation和Puical Logs上的Apache Web服务器文档；例如Apache 2.4。

跟踪日志记录

在Dispatcher的其他增强功能中，版本4.2.0还引入了跟踪日志记录。

这比调试日志记录级别更高，日志中显示了其他信息。 它会为添加日志记录：

• 转发标头的值；
• 正在应用于特定操作的规则。

您可以通过在Web服务器中将日志级别设置为4来启用跟踪日志记录。

以下是启用跟踪的日志示例：

[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[Host] = "localhost:8443"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[User-Agent] = "curl/7.43.0"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[Accept] = "*/*"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[X-Forwarded-SSL-Client-Cert] = "(null)"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[Via] = "1.1 localhost:8443 (dispatcher)"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[X-Forwarded-For] = "::1"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[X-Forwarded-SSL] = "on"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[X-Forwarded-SSL-Cipher] = "DHE-RSA-AES256-SHA"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[X-Forwarded-SSL-Session-ID] = "ba931f5e4925c2dde572d766fdd436375e15a0fd24577b91f4a4d51232a934ae"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[X-Forwarded-Port] = "8443"
[Thu Mar 03 16:05:38 2016] [T] [17183] request.headers[Server-Agent] = "Communique-Dispatcher"

请求与阻止规则匹配的文件时记录的事件：

[Thu Mar 03 14:42:45 2016] [T] [11831] 'GET /content.infinity.json HTTP/1.1' was blocked because of /0082

确认基本操作

要确认Web服务器、Dispatcher和AEM实例的基本操作和交互，您可以执行以下步骤：

1. 将loglevel设置为3。

2. 启动Web服务器；这也会启动Dispatcher。

3. 启动AEM实例。

4. 检查Web服务器和Dispatcher的日志和错误文件。

   • 根据您的Web服务器，您应会看到以下消息：
     • [Thu May 30 05:16:36 2002] [notice] Apache/2.0.50 (Unix) configured 和
     • [Fri Jan 19 17:22:16 2001] [I] [19096] Dispatcher initialized (build XXXX)

5. 通过Web服务器浏览网站。 确认内容是否按需要显示。
   例如，在本地安装中，AEM在端口4502上运行，而Web服务器在80上则使用以下两种方式访问网站控制台：

   • https://localhost:4502/libs/wcm/core/content/siteadmin.html
   • https://localhost:80/libs/wcm/core/content/siteadmin.html
   • 结果应该相同。 使用相同机制确认对其他页面的访问权限。

6. 检查缓存目录是否已填写。

7. 激活页面以检查缓存是否正确刷新。

8. 如果一切运行正常，您可以将loglevel降至0。

使用多个 Dispatcher

在复杂设置中，您可以使用多个 Dispatcher。例如，您可以使用：

• 一个 Dispatcher 用于在内联网上发布网站
• 第二个 Dispatcher，通过不同的地址和不同的安全设置，在内联网上发布相同的内容。

在这种情况下，请确保每个请求只通过一个 Dispatcher。一个 Dispatcher 不能处理来自另一个 Dispatcher 的请求。因此，请确保两个 Dispatcher 都能直接访问 AEM 网站。

调试

在向请求添加标头X-Dispatcher-Info时，Dispatcher会回答目标是否已缓存、从缓存返回还是根本不可缓存。 响应标头X-Cache-Info以可读形式包含此信息。 您可以使用这些响应标头来调试与由Dispatcher缓存的响应有关的问题。

默认情况下，此功能未启用，因此要包含响应标头X-Cache-Info，场必须包含以下条目：

/info "1"

例如，

/farm
{
    /mywebsite
    {
        # Include X-Cache-Info response header if X-Dispatcher-Info is in request header
        /info "1"
    }
}

此外，X-Dispatcher-Info标头不需要值，但如果使用curl进行测试，则必须提供值才能发送标头，例如：

curl -v -H "X-Dispatcher-Info: true" https://localhost/content/wknd/us/en.html

以下是包含X-Dispatcher-Info将返回的响应标头的列表：

• 缓存
  目标文件包含在缓存中，调度程序已确定交付该文件是有效的。
• 缓存
  目标文件未包含在缓存中，调度程序已确定缓存输出并交付该输出是有效的。
• 缓存：stat文件更新
  目标文件包含在缓存中，但是，由更新的stat文件使其失效。调度程序将删除目标文件，从输出中重新创建并交付该文件。
• 无法缓存：无文
  档根场的配置不包含文档根（配置元素）
  cache.docroot)。
• 无法缓存：缓存文件路径太长
  目标文件（文档根文件和URL文件的拼接）超过了系统上可能的最长文件名。
• 无法缓存：临时文件路径太长
  临时文件名模板超出了系统上可能的最长文件名。 调度程序会先创建临时文件，然后再实际创建或覆盖缓存的文件。 临时文件名是目标文件名，其后面附加有字符_YYYYXXXXXX，其中将替换Y和X以创建唯一名称。
• 无法缓存：请求URL没有扩展
  请求URL没有扩展名，或者文件扩展名后有一个路径，例如：/test.html/a/path。
• 无法缓存：请求不是GET或
  HEAD HTTP方法既不是GET也不是HEAD。调度程序假定输出将包含不应缓存的动态数据。
• 无法缓存：包含查询字符串的请求
  请求包含查询字符串。 调度程序假定输出取决于给定的查询字符串，因此不进行缓存。
• 无法缓存：会话管理器未验证
  场的缓存由会话管理器（配置包含sessionmanagement节点）管理，并且请求中不包含相应的身份验证信息。
• 无法缓存：请求包含授权
  不允许场缓存输出(allowAuthorized 0)，并且请求包含身份验证信息。
• 无法缓存：target是一个目录
  目标文件是目录。 这可能会指出一些概念性错误，即URL和某些子URL都包含可缓存的输出，例如，如果对/test.html/a/file.ext的请求排在首位并包含可缓存的输出，则调度程序将无法将后续请求的输出缓存到/test.html。
• 无法缓存：请求URL具有尾随斜杠
  请求URL具有尾随斜杠。
• 无法缓存：请求URL不在缓存规则中
  场的缓存规则明确拒绝缓存某些请求URL的输出。
• 无法缓存：授权检查程序被拒绝访问
  场的授权检查程序拒绝访问缓存的文件。
• 无法缓存：会话无
  效场的缓存受会话管理器(配置包含节 sessionmanagement 点)控制，并且用户的会话无效或不再有效。
• 无法缓存：响应包no_cache
  含远程服务器返回
  Dispatcher: no_cache 标头，禁止调度程序缓存输出。
• 无法缓存：响应内容长
  度为零响应的内容长度零；调度程序不会创建零长度文件。