代理服务器工具(proxy.jar) proxy-server-tool-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页面时确切发生的情况。
启动代理服务器工具 starting-the-proxy-server-tool
该工具位于AEM安装的/opt/helpers文件夹中。 要启动它，请键入：
java -jar proxy.jar <host> <remoteport> <localport> [options]
选项 options
- q（安静模式） 不会将请求写入控制台窗口。 如果不想减慢连接速度，或者将输出记录到文件（请参见 — logfile选项），则使用此选项。
- b（二进制模式） 如果您要在流量中查找特定的字节组合，请启用二进制模式。 输出包含十六进制和字符输出。
- t（时间戳日志条目） 向每个日志输出添加时间戳。 时间戳以秒为单位，因此它可能不适合检查单个请求。 如果您使用代理服务器的时间较长，则使用它来查找在特定时间发生的事件。
- logfile <filename> （写入日志文件） 将客户端 — 服务器对话写入日志文件。 此参数还可在安静模式下使用。
- i <numindentions> （添加缩进） 每个活动连接都进行缩进，以提高可读性。 默认值为16级。 （proxy.jar版本1.16中的新增功能）。
使用代理服务器工具 uses-of-the-proxy-server-tool
以下场景说明了可以使用代理服务器工具的一些目的：
检查Cookie及其值
以下日志条目示例显示了自代理启动以来在第六个连接上由客户端发送的所有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 ]
正在检查Keep-Alive是否有效
保持活动状态 这意味着客户端会重复使用与服务器的连接来传输多个文件（页面代码、图片、样式表等）。 如果没有保持活动状态，客户端必须为每个请求建立新的连接。
要检查保持活动状态是否有效，请执行以下操作：
- 启动代理服务器。
- 请求一个页面。
- 如果keep-alive运行正常，则连接计数绝不能超过5到10个连接。
- 如果保持活动不工作，则连接计数迅速增加。
查找丢失的请求
如果在复杂的服务器设置中丢失请求，例如，在防火墙和Dispatcher中，您可以使用代理服务器查找请求丢失的位置。 如果有防火墙：
- 在防火墙之前启动代理
- 在防火墙后启动另一个代理
- 使用这些量度可查看请求到达的距离。
请求挂起
如果您偶尔遇到挂起的请求：
- 启动proxy.jar。
- 等待或将访问日志写入文件中 — 每个条目都具有时间戳。
- 当请求开始挂起时，您可以看到打开了多少连接，以及哪个请求导致了问题。
日志消息的格式 the-format-of-log-messages
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)
这显示了第六次连接中客户机和服务器之间以平均速度传递的字节数。
日志输出示例 an-example-of-log-output
查看一个简单模板，该模板会在请求时生成以下代码：
<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
您可以访问服务器(localhost:4303)，但如果您通过 localhost:4444，代理服务器将记录通信。 打开浏览器并访问使用上述模板创建的页面。 之后，查看日志文件。
启动时，将以下信息写入日志：
starting proxy for localhost:4303 on port 4444
using logfile: C:\CQUnify355default\opt\helpers\test.log
在请求主HTML页的第一连接(0)的开头处列出了以下标头字段：
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 ]
代理服务器是验证Cookie是否正确设置的有用工具。 在这里，您会看到以下内容：
- AEM生成的cq3session Cookie
- CFC生成的show mode开关Cookie
- 名为JSESSIONID的Cookie；如果未使用<%@页面会话="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>]
连接0在提供HTML文件后立即关闭：
C-0-Finished: 516 bytes (0.0 kb/s)
S-0-Finished: 374 bytes (0.0 kb/s)
现在，输出从连接1开始，连接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文件等的多个并行请求。 这意味着日志具有重叠的并行打开连接条目。 在这种情况下，Adobe建议使用选项 — i来提高可读性。