如何使用代理服务器工具

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

您可以在AEM安装中找到代理服务器，网址为：

crx-quickstart/opt/helpers/proxy-2.1.jar

您可以使用代理服务器监控所有客户端 — 服务器交互，而不管底层通信协议是什么。 例如，可以监视以下协议：

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

例如，您可以在通过TCP/IP网络通信的任意两个应用程序(例如Web浏览器和AEM)之间定位代理服务器。 这样，您就可以监控在请求CQ页面时确切发生的情况。

启动代理服务器工具

在命令行中启动服务器：

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

参数

<host>

这是要连接到的CRX实例的主机地址。 如果实例位于本地计算机上，则它将 localhost.

<remoteport>

这是目标CRX实例的主机端口。 例如，新安装的AEM安装的缺省值为 4502 并且新安装的AEM创作实例的默认值是 4502.

<localport>

这是本地计算机上的端口，您希望连接到该端口以通过代理访问CRX实例。

选项

-q （安静模式）

不将输出写入控制台窗口。 如果不想减慢连接速度，或者将输出记录到文件（请参见 — logfile选项），则使用此选项。

-b（二进制模式）

如果您要在通信量中查找特定的字节组合，请启用二进制模式。 然后，输出将包含十六进制和字符输出。

-t （时间戳日志条目）

向每个日志输出添加时间戳。 时间戳以秒为单位，因此可能不适合检查单个请求。 如果您使用代理服务器的时间较长，则使用它来查找在特定时间发生的事件。

-logfile <filename>（写入日志文件）

将客户端 — 服务器对话写入日志文件。 此参数还可在安静模式下工作。

-i <numIndentions>（添加缩进）

每个活动连接都缩进，以提高可读性。 默认级别为16个。 此功能的引入方式 proxy.jar version 1.16.

日志格式

proxy-2.1.jar生成的日志条目都具有以下格式：

[timestamp (optional)] [Client|Server]-[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)

这显示客户端之间传递的字节数( C)和服务器( S)和以平均速度连接。

日志输出示例

例如，假定一个页面在请求时生成以下代码：

示例

例如，请考虑位于存储库中的一个非常简单的html文档

/content/test.html

图像文件位于

/content/test.jpg

的内容 test.html 为：

<html>
<head>
    <title>Test</title>
</head>
<body>
    Test<br>
    <img src="test.jpg">
</body>
</html>

假定AEM实例正在运行 localhost:4502 我们将启动代理，如下所示：

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

现在可以通过以下位置的代理访问CQ/CRX实例： localhost:4444 通过此端口进行的所有通信都会记录到 test.log.

如果我们现在查看代理的输出，则会看到浏览器与AEM实例之间的交互。

启动时，代理输出以下内容：

starting proxy for localhost:4502 on port 4444
using logfile: <some-dir>/crx-quickstart/opt/helpers/test.log

然后，我们打开浏览器并访问测试页面：

http://localhost:4444/content/test.html

而我们看到浏览器做了一个 GET 页面的请求：

C-0-#000000 -> [GET /content/test.html HTTP/1.1 ]
C-0-#000033 -> [Host: localhost:4444 ]
C-0-#000055 -> [Connection: keep-alive ]
C-0-#000079 -> [User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_4) AppleWebKit/536.11 (KHTML, like Gecko) Chrome/20.0.1132.57 Safari/536.11 ]
C-0-#000212 -> [Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8 ]
C-0-#000285 -> [Accept-Encoding: gzip,deflate,sdch ]
C-0-#000321 -> [Accept-Language: en-US,en;q=0.8 ]
C-0-#000354 -> [Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.3 ]
C-0-#000402 -> [Cookie: login-token=179ba6bd-e0a7-4909-a965-e11c7f2bc2fc%3a618bd8a8-fbaf-43c5-827d-c84c62248c5e_22ee860cc9036fee%3acrx.default%3b21148fb0-eb6c]
C-0-#000543 -> [-43c9-a2b9-c8d40618d8ae%3ad87a3d1a-5e9a-4d5a-bab1-0ee60ad6d8df_d0e4ddce0fcd84b6%3acrx.default%3b5cb95227-ea51-47bf-850b-68ad1dfd7297%3af3bbb6]
C-0-#000684 -> [59-7913-4285-8857-832c087bafd5_c484727d3b3665ad%3acrx.default; ys-cq-siteadmin-tree=o%3Awidth%3Dn%253A240%5EselectedPath%3Ds%253A/content ]
C-0-#000824 -> [ ]

AEM实例使用文件的内容进行响应 test.html：

S-0-#000000 -> [HTTP/1.1 200 OK ]
S-0-#000017 -> [Connection: Keep-Alive ]
S-0-#000041 -> [Server: Day-Servlet-Engine/4.1.24  ]
S-0-#000077 -> [Content-Type: text/html;charset=utf-8 ]
S-0-#000116 -> [Content-Length: 104 ]
S-0-#000137 -> [Date: Mon, 16 Jul 2012 11:23:38 GMT ]
S-0-#000174 -> [Last-Modified: Mon, 16 Jul 2012 11:19:27 GMT ]
S-0-#000220 -> [ ]
S-0-#000222 -> [<html>]
S-0-#000229 -> [<head>]
S-0-#000236 -> [    <title>Test</title>]
S-0-#000260 -> [</head> ]
S-0-#000269 -> [<body>]
S-0-#000276 -> [ Test<br>]
S-0-#000286 -> [    <img src="test.jpg">]
S-0-#000311 -> [</body>]
S-0-#000319 -> [</html>]

代理服务器的使用

以下场景说明了代理服务器的一些用途：

检查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是HTTP的一项功能，它允许客户端重新使用与服务器的TCP连接来发出多个请求（针对页面代码、图片、样式表等）。 如果没有保持活动状态，客户端必须为每个请求建立新连接。

要检查保持活动状态是否有效，请执行以下操作：

  • 启动代理服务器。
  • 请求一个页面。
  • 如果keep-alive运行正常，则连接计数绝不能超过5到10个连接。
  • 如果keep-alive不起作用，则连接计数迅速增加。

查找丢失的请求

如果在复杂的服务器设置中丢失请求，例如防火墙和Dispatcher，则可以使用代理服务器查找请求丢失的位置。 如果是防火墙：

  • 在防火墙之前启动代理
  • 在防火墙后启动另一个代理
  • 使用这些量度可查看请求到达的距离。

请求挂起

如果您不时遇到挂起的请求：

  • 启动代理。
  • 等待或将访问日志写入一个文件，其中每个条目都有时间戳。
  • 当请求开始挂起时，您可以看到打开了多少连接，以及哪个请求引起了问题。

在此页面上