代理服务器工具(proxy.jar)

代理服务器充当在客户机和服务器之间中继请求的中间服务器。 代理服务器跟踪所有客户端与服务器的交互,并输出整个TCP通信的日志。 这样,您就可以准确地监视正在进行的操作,而无需访问主服务器。

您可以在相应的安装文件夹中找到代理服务器:

  • <cq_install_path>/opt/helpers/proxy.jar
  • <crx_install_path>/opt/helpers/proxy.jar

您可以使用代理服务器监视所有客户端与服务器的交互,而不管底层的通信协议如何。 例如,您可以监视以下协议:

  • 网页的HTTP
  • 安全网页的HTTPS
  • 电子邮件的SMTP
  • 用于用户管理的LDAP

例如,可以在通过TCP/IP网络通信的任何两个应用程序之间放置代理服务器;例如,Web浏览器和AEM。 这样,您就可以监视请求AEM页面时发生的具体情况。

启动代理服务器工具

该工具位于AEM安装的/opt/helpers文件夹中。 要开始其类型:

java -jar proxy.jar <host> <remoteport> <localport> [options]

选项

  • q(静默模式) 不将请求写入控制台窗口。如果不想降低连接速度,或者将输出记录到文件(请参阅-logfile选项),请使用此选项。
  • b(二进制模式) 如果您要在流量中查找特定字节组合,请启用二进制模式。然后,输出将包含十六进制和字符输出。
  • t(时间戳日志条目) 向每个日志输出添加时间戳。时间戳以秒为单位,因此它可能不适合检查单个请求。 如果在较长的时间段内使用代理服务器,则使用它查找在特定时间发生的事件。
  • 日志 <filename> 文件(写入日志文 件)将客户端服务器对话写入日志文件。此参数也在安静模式下工作。
  • i(添 <numindentions> 加缩进)每 个活动连接都进行缩进,以提高可读性。默认为16级。 (proxy.jar版本1.16中的新增功能)。

代理服务器工具的使用

以下场景说明了可以使用代理服务器工具的几个用途:

检查Cookie及其值

以下日志条目示例显示自代理开始以来第6个连接打开时客户端发送的所有cookie及其值:

C-6-#000635 -> [Cookie: cq3session=7e39bc51-ac72-3f48-88a9-ed80dbac0693; Show=ShowMode; JSESSIONID=68d78874-cabf-9444-84a4-538d43f5064d ]

检查标题及其 值以下日志条目示例显示服务器能够建立保持活动连接并且内容长度标题设置正确:

S-7-#000017 -> [Connection: Keep-Alive ]
...
S-7-#000107 -> [Content-Length: 124 ]

检查“保持活动”是否有效

“保持” 意味着客户端重新使用与服务器的连接来传输多个文件(页面代码、图片、样式表等)。如果不保持连接,客户端必须为每个请求建立新的连接。

要检查“保持活动”是否有效:

  1. 开始代理服务器。
  2. 请求页面。
  • 如果“保持活动”正常工作,则连接计数器不应超过5到10个连接。
  • 如果保持活动不工作,则连接计数器会迅速增加。

查找丢失的请求

如果在复杂的服务器设置(例如防火墙和调度程序)中丢失请求,您可以使用代理服务器查找请求丢失的位置。 在防火墙的情况下:

  1. 开始防火墙前的代理
  2. 在防火墙后开始另一个代理
  3. 使用这些可了解请求的距离。

请求挂起

如果您经常遇到挂起请求:

  1. 开始proxy.jar。
  2. 等待或将访问日志写入文件——每个条目都有时间戳。
  3. 挂起的请求开始时,您可以看到打开的连接数以及导致问题的请求数。

日志消息的格式

proxy.jar生成的日志条目均采用以下格式:

[timestamp (optional)] [<b>C</b>lient|<b>S</b>erver]-[ConnectionNumber]-[BytePosition] ->[Character Stream]

例如,网页请求可能如下所示:

C-0-#000000 -> [GET /author/prox.html?CFC_cK=1102938422341 HTTP/1.1 ]
  • C表示此条目来自客户端(它是对网页的请求)
  • 0是连接号(连接计数器开始为0)
  • ​# 00000字节流中的偏移。 这是第一个条目,因此偏移量为0。
  • [GET <?>] 是请求的内容,在示例中,其中一个HTTP头(url)。

当连接关闭时,将记录以下信息:

C-6-Finished: 758 bytes (1.0 kb/s)
S-6-Finished: 665 bytes (1.0 kb/s)

这显示在第6个连接上以平均速度在客户端和服务器之间传递的字节数。

日志输出示例

我们将审核一个简单的模板,该模板会根据要求生成以下代码:

<html>
  <head>
    <title>Welcome</title>
  </head>
  <body>
    Welcome to Playground<br>
    <img src="/logo.gif">
  </body>
</html>

如果AEM在localhost:4303上运行,请按如下方式开始代理服务器:

java -jar proxy.jar localhost 4303 4444 -logfile test.log

无需代理服务器即可访问服务器(),但如果通过访问它,代理服务器将记录通信。 打开浏览器并访问使用上述模板创建的页面。 之后,查看日志文件。

注意

在proxy.jar版本1.14之前,一个连接的日志条目未同步,这意味着一个客户端/服务器连接的日志条目不必按正确的顺序排列。 代理服务器的较新版本(>=1.14)不存在此问题。

启动时,以下信息将写入日志:

starting proxy for localhost:4303 on port 4444
using logfile: C:\CQUnify355default\opt\helpers\test.log

第一个连接(0)的开始处列出以下标题字段,该连接请求主HTML页:

C-0-#000000 -> [GET /author/prox.html?CFC_cK=1102936796533 HTTP/1.1 ]
C-0-#000053 -> [Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd.ms-powerpoint, application/vnd.ms-excel, application/msword, appl]
C-0-#000194 -> [ication/x-shockwave-flash, */* ]
C-0-#000227 -> [Accept-Language: de-ch ]
C-0-#000251 -> [Accept-Encoding: gzip, deflate ]
C-0-#000283 -> [User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0) ]
C-0-#000347 -> [Host: localhost:4444 ]

客户端请求保持连接,以便服务器可以通过同一连接发送多个文件:

C-0-#000369 -> [Connection: Keep-Alive ]

代理服务器是验证cookies设置是否正确的好工具。 这里,我们看到:

  • aem生成的cq3session cookie
  • 由CFC生成的显示模式切换cookie
  • 名为JSESSIONID的cookie;如果未使用<%@ page session="false" %>显式关闭,则JSP会自动创建此内容:
C-0-#000393 -> [Cookie: Show=ShowMode; cq3session=3bce15cf-1575-1b4e-8ea6-0d1a0c64738e; JSESSIONID=4161a56b-f193-d748-88a5-e09c5ff7ef2a ]
C-0-#000514 -> [ ]
S-0-#000000 -> [HTTP/1.0 200 OK ]

服务器将在请求后关闭连接0。 无法保持活动,因为请求带有问号。 这意味着服务器无法返回缓存版本,因此无法确定此时的内容长度(保持活动连接所需)。

S-0-#000017 -> [Connection: Close ]
S-0-#000036 -> [Server: Communique Servlet Engine/3.5.5 ]
S-0-#000077 -> [Content-Type: text/html;charset=iso-8859-1 ]
S-0-#000121 -> [Date: Tue, 14 Dec 2004 09:46:44 GMT ]
S-0-#000158 -> [Set-Cookie: JSESSIONID=4161a56b-f193-d8-88a5-e09c5ff7ef2a;Path=/author ]
S-0-#000232 -> [ ]

此处,在连接0上发送HTML代码的服务器开始:

S-0-#000234 -> [<html> ]
S-0-#000242 -> [.<head> ]
S-0-#000251 -> [..<title>Welcome</title> ]
S-0-#000277 -> [.</head> ]
S-0-#000287 -> [.<body> ]
S-0-#000296 -> [..Welcome to Playground<br> ]
S-0-#000325 -> [..<img src="/author/logo.gif"> ]
S-0-#000357 -> [.</body> ]
S-0-#000367 -> [</html>]

在提供HTML文件后,连接0立即关闭:

C-0-Finished: 516 bytes (0.0 kb/s)
S-0-Finished: 374 bytes (0.0 kb/s)

现在,连接1的输出开始下载HTML代码中包含的图像:

C-1-#000000 -> [GET /author/logo.gif HTTP/1.1 ]
C-1-#000031 -> [Accept: */* ]
C-1-#000044 -> [Referer: http://localhost:4444/author/prox.html?CFC_cK=1102936796533 ]
C-1-#000114 -> [Accept-Language: de-ch ]
C-1-#000138 -> [Accept-Encoding: gzip, deflate ]
C-1-#000170 -> [User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0) ]
C-1-#000234 -> [Host: localhost:4444 ]

同样,客户端请求保持连接:

C-1-#000256 -> [Connection: Keep-Alive ]
C-1-#000280 -> [Cookie: Show=ShowMode; cq3session=3bce15cf-1575-1b4e-8ea6-0d1a0c64738e; JSESSIONID=4161a56b-f193-d748-88a5-e09c5ff7ef2a ]
C-1-#000401 -> [ ]
S-1-#000000 -> [HTTP/1.0 200 OK ]

对于连接1,服务器可以提供保持活动状态,因为图像是静态的,因此内容长度是已知的。

S-1-#000017 -> [Connection: Keep-Alive ]
S-1-#000041 -> [Server: Communique Servlet Engine/3.5.5 ]
S-1-#000082 -> [Content-Type: image/gif ]

服务器在连接1上返回图像的内容长度:

S-1-#000107 -> [Content-Length: 124 ]
S-1-#000128 -> [Date: Tue, 14 Dec 2004 09:46:44 GMT ]
S-1-#000165 -> [ ]

既然内容长度已建立,服务器将在连接1上发送图像数据:

S-1-#000167 -> [GIF87a..........................,.......
...I....0.A..8......YDA.W...1..`i.`..6...Z...$@.F..)`..f..A.....iu.........$..;]

在达到保持活动超时后,连接1也会关闭:

S-1-Finished: 291 bytes (0.0 kb/s)
C-1-Finished: 403 bytes (0.0 kb/s)

以上示例相对简单,因为两个连接按顺序发生:

  • 首先,服务器返回HTML代码
  • 然后浏览器请求图像并打开新连接

实际上,页面可以为图像、样式表、JavaScript文件等生成许多并行请求。 这意味着日志具有并行打开连接的重叠条目。 在这种情况下,我们建议使用选项-i来提高可读性。

在此页面上

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free