HTTP · Elasticsearch 5.4 中文文檔

# HTTP 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.3/modules-http.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/modules-http.html) 譯文鏈接 : [http://www.apache.wiki/display/Elasticsearch/HTTP](http://www.apache.wiki/display/Elasticsearch/HTTP) 貢獻者 : [趙芳城](/display/~zhaofangcheng)，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina) ## HTTP ? http模塊允許通過http的方式暴露Elasticsearch的api,http機制本質上是完全異步的，這意味著沒有阻塞線程等待響應。使用異步通信進行HTTP的好處是解決了[C10k](http://en.wikipedia.org/wiki/C10k_problem)問題。?如果可以，可考慮使用HTTP keep alive來連接以便提升性能。并且不要在客戶端使用HTTP chunking ## Setting（配置） ? 可以為http請求做下表中的配置，但是所有的配置都不是動態加載的，必須重啟elasticsearch后才能生效。配置文件為：elasticsearch.yml | 配置 | 說明 | | --- | --- | | `http.port` | 綁定端口的范圍，默認9200~9300 | | `http.publish_port` | HTTP客戶端在與此節點通信時應使用的端口。集群節點位于代理或防火墻后面并且http.port不能從外部直接尋址時很有用。默認為通過http.port分配的實際端口。 | | `http.bind_host` | 要綁定HTTP服務的主機地址，默認與http.host（如果設置）或network.bind_host配置一致。 | | `http.publish_host` | 要發送給HTTP客戶端以連接的主機地址。默認為http.host（如果設置）或network.publish_host。 | | `http.host` | 用于將http.bind_host和http.publish_host默認設置為http.host或network.host。 | | `http.max_content_length` | HTTP請求的最大內容。默認值為100mb。如果設置為大于Integer.MAX_VALUE，則將重置為100mb。 | | `http.max_initial_line_length` | http url最大值，默認4kb | | `http.max_header_size` | http header（請求頭）的最大值，默認8kb | | `http.compression` | 設置是否壓縮tcp傳輸時的數據，默認為true。 | | `http.compression_level` | 定義HTTP傳輸的壓縮級別。有效值在1（最小壓縮）和9（最大壓縮）的范圍內。默認為3。 | | `http.cors.enabled` | 配置是否允許跨域請求，即另一來源上的瀏覽器是否可以針對Elasticsearch執行請求。設置為true以啟用Elasticsearch以處理“預檢”CORS請求。如果請求中發送的Origin由http.cors.allow-origin列表允許，Elasticsearch將使用Access-Control-Allow-Origin標頭響應這些請求。設置為false（默認值）使Elasticsearch忽略Origin請求頭，有效地禁用CORS請求，因為Elasticsearch永遠不會使用Access-Control-Allow-Origin響應頭響應。請注意，如果客戶端沒有發送帶有Origin標頭的“預檢”請求，或者它不檢查來自服務器的響應報頭來驗證Access-Control-Allow-Origin響應報頭，則跨原點安全性受到損害。如果Elasticsearch上沒有啟用CORS，客戶端知道的唯一方法是發送一個“預檢”請求，并實現所需的響應頭丟失。 | | `http.cors.allow-origin` | 定義允許哪些源請求。可以使用正則表達式，例如/https?:\/\/localhost(:[0-9]+)?/可設置支持本地HTTP和HTTPS請求。也可以設置為*,但是會存在安全隱患，因為任何來源都可訪問 | | `http.cors.max-age` | 瀏覽器會發送一個“預檢”的OPTIONS請求，來檢查CORS設置。max-age定義應該緩存多長時間的結果。默認為1728000（20天） | | `http.cors.allow-methods` | 定義了允許的請求方式，默認允許OPTIONS, HEAD, GET, POST, PUT, DELETE | | `http.cors.allow-headers` | 定義了允許的請求頭信息。默認允許X-Requested-With, Content-Type, Content-Length | | `http.cors.allow-credentials` | 是否返回設置的Access-Control-Allow-Credentials頭信息。默認為false | | `http.detailed_errors.enabled` | 是否輸出詳細的錯誤信息和堆棧。默認為true | | `http.pipelining` | 是否啟用HTTP管道支持, 默認為true | | `http.pipelining.max_events` | 在一個HTTP連接被關閉之前內存隊列中允許的最大的事件數量，默認為10000 該模塊也可使用一些公共的網絡配置(見網絡設置一節) | | `http.content_type.required` | 啟用或禁用對具有內容的所有請求的Content-Type標頭的嚴格檢查和使用，默認為false。 | ## Disable HTTP（禁用HTTP） ?HTTP模塊可以通過將http.enable設置為false來禁用。Elasticsearch節點(和Java客戶端)的內部通信使用transport接口，而非HTTP。這意味著我們可以將不接受直接REST請求的節點的HTTP禁用。比如，可以將數據節點的http禁用，創建非數據節點用來處理所有的REST請求。需要注意的是，不能向一個已經禁用了HTTP的節點直接發送任何REST請求。