如何使用代理伺服器工具 how-to-use-the-proxy-server-tool
代理伺服器充當在客戶機和伺服器之間中繼請求的中間伺服器。 代理伺服器跟蹤所有客戶端與伺服器的交互，並輸出整個TCP通信的日誌。 這可讓您不需存取主伺服器，即可精確監視目前的情況。
您可以在AEM安裝程式中找到Proxy伺服器，位置如下：
crx-quickstart/opt/helpers/proxy-2.1.jar
您可以使用代理伺服器來監視所有客戶端與伺服器的交互，而不管基礎的通信協定如何。 例如，您可以監視下列通訊協定：
- 網頁的HTTP
- HTTPS用於安全網頁
- 電子郵件的SMTP
- 用於用戶管理的LDAP
例如，您可以在通過TCP/IP網路通信的任何兩個應用程式之間定位代理伺服器；例如網頁瀏覽器和AEM。 這可讓您監控要求CQ頁面時的確切情況。
啟動代理伺服器工具 starting-the-proxy-server-tool
在命令行上啟動伺服器：
java -jar proxy-2.1.jar <host> <remoteport> <localport> [options]
參數
<host>
這是您要連線的CRX執行個體的主機位址。 如果執行個體位於您的本機電腦上，則此 localhost.
<remoteport>
這是目標CRX實例的主機埠。 例如，新安裝的AEM安裝的預設值為 4502 而新安裝的AEM製作例項的預設值為 4502.
<localport>
這是您本機電腦上要連線的埠，以透過Proxy存取CRX執行個體。
選項
-q （靜音模式）
不會將輸出寫入控制台窗口。 如果您不想減緩連線速度，或將輸出記錄到檔案（請參閱 — logfile選項），請使用此選項。
-b（二進位模式）
如果要在流量中查找特定的位元組組合，請啟用二進位模式。 輸出將包含十六進位和字元輸出。
-t （時間戳記日誌條目）
將時間戳添加到每個日誌輸出。 時間戳記以秒為單位，因此可能不適合檢查單一請求。 如果您使用代理伺服器的時間較長，則可使用它查找在特定時間發生的事件。
-logfile <filename>（寫入日誌檔案）
將客戶端 — 伺服器對話寫入日誌檔案。 此參數也可在安靜模式下運作。
-i <numIndentions>（添加縮進）
每個作用中的連線都會縮排，以提高可讀性。 預設為16個層級。 此功能於 proxy.jar version 1.16.
記錄格式 log-format
由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)，且以平均速度執行。
記錄輸出的範例
例如，請考慮請求時會產生下列程式碼的頁面：
範例 example
例如，請考慮位於
/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例項現在可透過下列位置的Proxy來存取 localhost:4444 並且通過此埠的所有通信都記錄到 test.log.
如果現在觀看Proxy的輸出，就會看到瀏覽器與AEM例項之間的互動。
啟動時，Proxy會輸出下列內容：
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>]
代理伺服器的使用 uses-of-the-proxy-server
以下情形說明了可以使用代理伺服器的一些用途：
檢查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 ]
檢查「保留」是否有效
「保活」是HTTP的一項功能，它允許客戶端重新使用與伺服器的TCP連接，以發出多個請求（對於頁碼、圖片、樣式表等）。 若不保持運作，用戶端必須為每個請求建立新連線。
檢查保持活動是否有效：
- 啟動代理伺服器。
- 要求頁面。
- 如果保持活動正常運作，連線計數器的連線數不應超過5到10個。
- 如果「保活」不起作用，則連接計數器會迅速增加。
查找丟失的請求
如果您在複雜的伺服器設定（例如防火牆和Dispatcher）中遺失請求，可以使用Proxy伺服器來找出請求遺失的位置。 如果是防火牆：
- 在防火牆之前啟動代理
- 在防火牆後啟動另一個代理
- 使用這些項目可了解請求的深入程度。
請求掛起
如果您不時遇到掛起的請求：
- 啟動代理。
- 等待或將訪問日誌寫入檔案，每個條目都有時間戳。
- 當請求開始掛起時，您可以查看已開啟的連接數，以及哪個請求導致了問題。