代理伺服器工具(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網路通信的任何兩個應用程式之間定位代理伺服器；例如網頁瀏覽器和AEM。 這可讓您監控要求AEM頁面時的確切情況。
啟動代理伺服器工具 starting-the-proxy-server-tool
此工具可在AEM安裝程式的/opt/helpers資料夾中找到。 要啟動它，請鍵入：
java -jar proxy.jar <host> <remoteport> <localport> [options]
選項 options
- q（安靜模式） 不會將請求寫入主控台視窗。 如果您不想減緩連線速度，或將輸出記錄到檔案（請參閱 — logfile選項），請使用此選項。
- b（二進位模式） 如果要在流量中查找特定的位元組組合，請啟用二進位模式。 輸出將包含十六進位和字元輸出。
- t（時間戳記記錄項） 將時間戳添加到每個日誌輸出。 時間戳記以秒為單位，因此可能不適合檢查單一請求。 如果您使用代理伺服器的時間較長，則可使用它查找在特定時間發生的事件。
- 記錄檔 <filename> （寫入日誌檔案） 將客戶端 — 伺服器對話寫入日誌檔案。 此參數也可在安靜模式下運作。
- i <numindentions> （添加縮進） 每個作用中的連線都會縮排，以提高可讀性。 預設為16個層級。 （proxy.jar 1.16版中的新功能）。
使用代理伺服器工具 uses-of-the-proxy-server-tool
下列案例說明了可以使用代理伺服器工具的一些用途：
檢查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 ]
檢查「保留」是否有效
保存 表示用戶端會重新使用與伺服器的連線來傳輸多個檔案（頁面程式碼、圖片、樣式表等）。 若不保持運作，用戶端必須為每個請求建立新連線。
檢查保持活動是否有效：
- 啟動代理伺服器。
- 要求頁面。
- 如果保持活動正常運作，連線計數器的連線數不應超過5到10個。
- 如果「保活」不起作用，則連接計數器會迅速增加。
查找丟失的請求
如果您在複雜的伺服器設定（例如防火牆和Dispatcher）中遺失請求，可以使用Proxy伺服器來找出請求遺失的位置。 如果是防火牆：
- 在防火牆之前啟動代理
- 在防火牆後啟動另一個代理
- 使用這些項目可了解請求的深入程度。
請求掛起
如果您不時遇到掛起的請求：
- 啟動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)
這顯示在第6個連接上以平均速度在客戶端和伺服器之間傳遞的位元組數。
記錄輸出的範例 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
您可以在沒有代理伺服器的情況下存取伺服器()，但如果您透過存取，代理伺服器將記錄通訊。 開啟瀏覽器並存取使用上述範本建立的頁面。 之後，查看記錄檔。
開始時，會將下列資訊寫入記錄檔：
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 ]
代理伺服器是驗證Cookie是否已正確設定的好工具。 在此，我們看到：
- cq3session cookie由AEM產生
- 顯示模式切換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的輸出會開始，而連線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來改善可讀性。